20. Funções e Variáveis ​​¶

A função Regex é usada para analisar a resposta anterior (ou o valor de uma variável) usando qualquer expressão regular (fornecida pelo usuário). A função retorna a string do modelo com os valores das variáveis ​​preenchidos.

O __regexFunction também pode armazenar valores para uso futuro. No sexto parâmetro, você pode especificar um nome de referência. Depois que essa função for executada, os mesmos valores poderão ser recuperados posteriormente usando a sintaxe para valores definidos pelo usuário. Por exemplo, se você inserir " refName " como o sexto parâmetro, poderá usar:

• ${refName} para se referir ao resultado calculado do segundo parâmetro ("Modelo para a string de substituição") analisado por esta função
• ${refName_g0} para se referir a toda a correspondência analisada por esta função.
• ${refName_g1} para se referir ao primeiro grupo analisado por esta função.
• ${refName_g#} para se referir ao ^enésimo grupo analisado por esta função.
• ${refName_matchNr} para se referir ao número de grupos encontrados por esta função.

O contador gera um novo número cada vez que é chamado, começando com 1 e incrementando em +1 a cada vez. O contador pode ser configurado para manter os valores de cada usuário simulado separados ou para usar o mesmo contador para todos os usuários. Se os valores de cada usuário forem incrementados separadamente, é como contar o número de iterações por meio do plano de teste. Um contador global é como contar quantas vezes esse pedido foi executado.

O contador usa uma variável inteira para manter a contagem, que, portanto, tem um máximo de 2.147.483.647.

As instâncias da função de contador são completamente independentes. O contador global - " FALSE " - é mantido separadamente por cada instância do contador.

Várias chamadas de função __counter na mesma iteração não incrementarão ainda mais o valor.
Se você quiser ter uma contagem que aumenta para cada amostra, use a função em um pré-processador, como User Parameters .

A função de número de encadeamento simplesmente retorna o número do encadeamento que está sendo executado no momento. Esses números são apenas localmente únicos em relação ao seu ThreadGroup, o que significa que o thread #1 em um threadgroup é indistinguível do thread #1 em outro threadgroup, do ponto de vista desta função.

ctx.getThreadNum()

Não há argumentos para esta função.

Exemplo de uso:

${__threadNum}

A função de nome do grupo de threads simplesmente retorna o nome do grupo de threads que está sendo executado.

Não há argumentos para esta função.

Exemplo de uso:

${__threadGroupName}

A função intSum pode ser usada para calcular a soma de dois ou mais valores inteiros.

A função longSum pode ser usada para calcular a soma de dois ou mais valores longos, use isso em vez de __intSum sempre que você souber que seus valores não estarão no intervalo -2147483648 a 2147483647.

A função StringFromFile pode ser usada para ler strings de um arquivo de texto. Isso é útil para executar testes que exigem muitos dados variáveis. Por exemplo, ao testar um aplicativo bancário, 100s ou 1000s de diferentes números de conta podem ser necessários.

Consulte também o elemento de teste CSV Data Set Config, que pode ser mais fácil de usar. No entanto, isso atualmente não oferece suporte a vários arquivos de entrada.

Cada vez que é chamado, ele lê a próxima linha do arquivo. Todos os encadeamentos compartilham a mesma instância, portanto, encadeamentos diferentes obterão linhas diferentes. Quando o final do arquivo for atingido, ele começará a ler novamente desde o início, a menos que a contagem máxima de loops tenha sido atingida. Se houver várias referências à função em um script de teste, cada uma abrirá o arquivo independentemente, mesmo que os nomes dos arquivos sejam os mesmos. [Se o valor for usado novamente em outro lugar, use nomes de variáveis ​​diferentes para cada chamada de função.]

Se ocorrer um erro ao abrir ou ler o arquivo, a função retornará a string " **ERR** "

A função machineName retorna o nome do host local. Isso usa o método Java InetAddress.getLocalHost() e o passa para getHostName()

A função machineIP retorna o endereço IP local. Isso usa o método Java InetAddress.getLocalHost() e o passa para getHostAddress()

A função javaScript executa uma parte do código JavaScript (não Java!) e retorna seu valor

A função JMeter Javascript chama um interpretador JavaScript autônomo. Javascript é usado como uma linguagem de script, para que você possa fazer cálculos etc.

As seguintes variáveis ​​são disponibilizadas para o script:

• log - o Logger para a função
• ctx - objeto JMeterContext
• vars - objeto JMeterVariables
• threadName - String contendo o nome do thread atual
• sampler - objeto Sampler atual (se houver)
• sampleResult - objeto SampleResult anterior (se houver)
• props - objeto JMeterProperties (class java.util.Properties )

Rhinoscript permite acesso a métodos estáticos através de seu objeto Packages. Consulte a documentação Java de script . Por exemplo, pode-se acessar os métodos estáticos JMeterContextService assim: Java.type("org.apache.jmeter.threads.JMeterContextService").getTotalThreads()

A função aleatória retorna um número aleatório que fica entre os valores mínimo e máximo fornecidos.

A função RandomDate retorna uma data aleatória que fica entre os valores de data de início e data de término fornecidos.

A função RandomString retorna uma String aleatória de comprimento usando caracteres em chars para usar.

A função RandomFromMultipleVars retorna um valor aleatório com base nos valores de variáveis ​​fornecidos por Source Variables .

• Extrator de limite
• Extrator de Expressão Regular
• Extrator de seletor de CSS
• Extrator JSON
• Extrator XPath
• Extrator XPath2

A função UUID retorna um tipo pseudo aleatório 4 Universally Unique IDentifier (UUID).

A função CSVRead retorna uma string de um arquivo CSV (cf StringFromFile )

NOTA: O JMeter suporta vários nomes de arquivo.

Na maioria dos casos, o elemento CSV Data Set Config mais recente é mais fácil de usar.

Quando um nome de arquivo é encontrado pela primeira vez, o arquivo é aberto e lido em uma matriz interna. Se uma linha em branco for detectada, isso será tratado como fim de arquivo - isso permite que comentários finais sejam usados.

Todas as referências subsequentes ao mesmo nome de arquivo usam a mesma matriz interna. NB o caso do nome do arquivo é significativo para a função, mesmo que o sistema operacional não se importe, então CSVRead(abc.txt,0) e CSVRead(aBc.txt,0) se refeririam a diferentes arrays internos.

O recurso *ALIAS permite que o mesmo arquivo seja aberto mais de uma vez e também permite nomes de arquivo mais curtos.

Cada thread tem seu próprio ponteiro interno para sua linha atual na matriz de arquivos. Quando um encadeamento se refere ao arquivo pela primeira vez, ele será alocado na próxima linha livre na matriz, de modo que cada encadeamento acessará uma linha diferente de todos os outros encadeamentos. [A menos que haja mais threads do que linhas na matriz.]

A função de propriedade retorna o valor de uma propriedade JMeter. Se o valor da propriedade não puder ser encontrado e nenhum padrão tiver sido fornecido, ele retornará o nome da propriedade. Ao fornecer um valor padrão, não há necessidade de fornecer um nome de função - o parâmetro pode ser definido como nulo e será ignorado.

• ${__property(user.dir)} - valor de retorno de user.dir
• ${__property(user.dir,UDIR)} - retorna o valor de user.dir e salva em UDIR
• ${__property(abcd,ABCD,atod)} - retorna o valor da propriedade abcd (ou " atod " se não definido) e salva em ABCD
• ${__property(abcd,,atod)} - retorna o valor da propriedade abcd (ou " atod " se não estiver definida) mas não a salva

Esta é uma função de propriedade simplificada que se destina ao uso com propriedades definidas na linha de comando. Ao contrário da função __property , não há opção para salvar o valor em uma variável e, se nenhum valor padrão for fornecido, assume-se que é 1. O valor 1 foi escolhido porque é válido para variáveis ​​de teste comuns, como loops, contagem de threads, rampa acima etc.

Defina o valor da propriedade:

jmeter -Jgroup1.threads=7 -Jhostname1=www.realhost.edu

A função log registra uma mensagem e retorna sua string de entrada

A função logn registra uma mensagem e retorna a string vazia

A função BeanShell avalia o script passado para ela e retorna o resultado.

Para obter detalhes completos sobre o uso do BeanShell, consulte o site do BeanShell em http://www.beanshell.org/

Uma única instância de uma função pode ser chamada de vários threads. No entanto, o método execute() da função é sincronizado.

Se a propriedade " beanshell.function.init " for definida, ela será passada para o Interpreter como o nome de um arquivo de origem. Isso pode ser usado para definir métodos e variáveis ​​comuns. Há um arquivo init de amostra no diretório bin: BeanShellFunction.bshrc .

As seguintes variáveis ​​são definidas antes da execução do script:

• log - o Logger para a função BeanShell (*)
• ctx - objeto JMeterContext
• vars - objeto JMeterVariables
• props - objeto JMeterProperties (class java.util.Properties )
• threadName - o threadName (String)
• Sampler - o Sampler atual , se houver
• SampleResult - o SampleResult atual , se houver

A função __groovy avalia os scripts Apache Groovy passados ​​para ela e retorna o resultado.

Se a propriedade " groovy.utilities " estiver definida, ela será carregada pelo ScriptEngine. Isso pode ser usado para definir métodos e variáveis ​​comuns. Há um arquivo init de amostra no diretório bin : utility.groovy .

As seguintes variáveis ​​são definidas antes da execução do script:

• log - o Logger para a função groovy (*)
• ctx - objeto JMeterContext
• vars - objeto JMeterVariables
• props - objeto JMeterProperties (class java.util.Properties )
• threadName - o threadName (String)
• sampler - o Sampler atual , se houver
• prev - o SampleResult anterior , se houver
• OUT - System.out

(*) significa que isso é definido antes do arquivo init, se houver, ser processado. Outras variáveis ​​variam de invocação para invocação.

Por exemplo , não faça o seguinte:

${__groovy("${myVar}".substring(0\,2))}

Imagine que a variável myVar muda a cada transação, o Groovy acima não pode ser armazenado em cache, pois o script muda a cada vez.

Em vez disso, faça o seguinte, que pode ser armazenado em cache:

${__groovy(vars.get("myVar").substring(0\,2))}

A função split divide a string passada a ela de acordo com o delimitador e retorna a string original. Se algum delimitador for adjacente, " ? " será retornado como o valor. As strings divididas são retornadas nas variáveis ​​${VAR_1} , ${VAR_2} etc. A contagem de variáveis ​​é retornada em ${VAR_n} . Um delimitador à direita é tratado como uma variável ausente e " ? " é retornado. Além disso, para permitir que funcione melhor com o controlador ForEach, __split agora exclui a primeira variável não utilizada caso ela tenha sido definida por uma divisão anterior.

${__split(${VAR},VAR,|)}

A função XPath lê um arquivo XML e corresponde ao XPath. Cada vez que a função é chamada, a próxima correspondência será retornada. No final do arquivo, ele será contornado até o início. Se nenhum nó corresponder, a função retornará a string vazia e uma mensagem de aviso será gravada no arquivo de log do JMeter.

${__XPath(/path/to/build.xml, //target/@name)}

A função setProperty configura o valor de uma propriedade JMeter. O valor de retorno padrão da função é a string vazia, portanto, a chamada da função pode ser usada em qualquer lugar em que as funções sejam válidas.

O valor original pode ser retornado configurando o ^3º parâmetro opcional para " true ".

As propriedades são globais para o JMeter, portanto, podem ser usadas para comunicação entre threads e grupos de threads

A função time retorna a hora atual em vários formatos.

A função jexl retorna o resultado da avaliação de uma expressão Commons JEXL . Consulte os links abaixo para obter mais informações sobre expressões JEXL.

A função __jexl2 usa Commons JEXL 2

• Descrição da sintaxe JEXL
• Exemplos JEXL

A função jexl retorna o resultado da avaliação de uma expressão Commons JEXL . Consulte os links abaixo para obter mais informações sobre expressões JEXL.

A função __jexl3 usa Commons JEXL 3

• Descrição da sintaxe JEXL
• Exemplos JEXL

A função V (variável) retorna o resultado da avaliação de uma expressão de nome de variável. Isso pode ser usado para avaliar referências de variáveis ​​aninhadas (que não são suportadas no momento).

Por exemplo, se houver variáveis ​​A1 , A2 e N = 1 :

• ${A1} - funciona bem
• ${A${N}} - não funciona (referência de variável aninhada)
• ${__V(A${N})} - funciona bem. A${N} se torna A1 e a função __V retorna o valor de A1

A função evalVar retorna o resultado da avaliação de uma expressão armazenada em uma variável.

Isso permite ler uma string de um arquivo e processar qualquer referência de variável nele. Por exemplo, se a variável " query " contiver " selecione ${column} de ${table} " e " column " e " table " contiver " name " e " clientes ", ${__evalVar(query)} será avaliado como " selecione o nome dos clientes ".

A função eval retorna o resultado da avaliação de uma expressão de string.

Isso permite interpolar referências de variáveis ​​e funções em uma string que é armazenada em uma variável. Por exemplo, dadas as seguintes variáveis:

• nome = Smith
• coluna = idade
• mesa = aniversários
• SQL = selecione ${column} de ${table} onde name='${name}'

Isso pode ser usado em conjunto com CSV Dataset, por exemplo, onde as instruções SQL e os valores são definidos no arquivo de dados.

A função char retorna o resultado da avaliação de uma lista de números como caracteres Unicode. Veja também __unescape() , abaixo.

Isso permite adicionar valores de caracteres arbitrários em campos.

A função unescape retorna o resultado da avaliação de uma string com escape Java. Veja também __char() acima.

Isso permite adicionar caracteres a campos que são complicados (ou impossíveis) de definir por meio da GUI.

Função para liberar uma string contendo escapes de entidade HTML para uma string contendo os caracteres Unicode reais correspondentes aos escapes. Suporta entidades HTML 4.0.

Por exemplo, a cadeia

${__unescapeHtml(<Français>)}

Se uma entidade não for reconhecida, ela será deixada sozinha e inserida literalmente na string de resultado. por exemplo ${__unescapeHtml(>&zzzz;x)} retornará >&zzzz;x .

Usa StringEscapeUtils#unescapeHtml(String) do Commons Lang.

Função que escapa os caracteres em uma String usando entidades HTML. Suporta entidades HTML 4.0.

Por exemplo,

${__escapeHtml("pão" & "manteiga")}

Usa StringEscapeUtils#escapeHtml(String) do Commons Lang.

Função para decodificar uma string application/x-www-form-urlencoded . Nota: use UTF-8 como esquema de codificação.

Por exemplo, a cadeia

${__urldecode(Word+%22school%22+is+%22%C3%A9cole%22+in+francês)}

Usa a classe Java URLDecoder .

Função para codificar uma string para uma string application/x-www-form-urlencoded .

Por exemplo, a cadeia

${__urlencode(A palavra "escola" é "école" em francês)}

Usa a classe Java URLEncoder .

A função FileToString pode ser usada para ler um arquivo inteiro. Cada vez que é chamado, ele lê o arquivo inteiro.

Se ocorrer um erro ao abrir ou ler o arquivo, a função retornará a string " **ERR** "

A função samplerName retorna o nome (ou seja, rótulo) do amostrador atual.

A função não funciona em elementos de teste que não possuem um amostrador associado. Por exemplo, o Plano de Teste. Os elementos de configuração também não têm um amostrador associado. No entanto, alguns elementos de configuração são referenciados diretamente pelos samplers, como o HTTP Header Manager e o Http Cookie Manager, e neste caso as funções são resolvidas no contexto do Http Sampler. Pré-processadores, Pós-Processadores e Asserções sempre têm um Sampler associado.

Exemplo:

${__samplerName()}

A função TestPlanName retorna o nome do plano de teste atual (pode ser usado em Incluindo Planos para saber o nome do plano de teste de chamada).

Função que escapa dos metacaracteres ORO Regexp, é o equivalente a \Q \E no Java Regexp Engine.

Por exemplo,

${__escapeOroRegexpChars([^"].+?,)}

Usa Perl5Compiler#quotemeta(String) do ORO.

Função que escapa os caracteres em uma String usando entidades XML 1.0.

Por exemplo,

${__escapeXml("pão" & 'manteiga')}

Usa StringEscapeUtils#escapeXml10(String) do Commons Lang.

A função timeShift retorna uma data no formato fornecido com a quantidade especificada de segundos, minutos, horas, dias ou meses adicionados

A função digest retorna um valor criptografado no algoritmo de hash específico com o salt opcional, maiúsculas e nome da variável.

A função __dateTimeConvert converte uma data que está no formato de origem em um formato de destino armazenando o resultado opcionalmente no nome da variável.

A função __isPropDefined retorna true se a propriedade existir ou false se não existir.

A função __isVarDefined retorna true se a variável existir ou false se não existir.

A função change case retorna um valor de string cujo case foi alterado seguindo um modo específico. O resultado pode opcionalmente ser salvo em uma variável JMeter.

A função __StringToFile pode ser usada para gravar uma string em um arquivo. Cada vez que é chamado, ele grava uma string no arquivo anexando ou substituindo.

O valor de retorno padrão da função é a string vazia