20. 함수와 변수 ¶

Regex 함수는 사용자가 제공한 정규식을 사용하여 이전 응답(또는 변수 값)을 구문 분석하는 데 사용됩니다. 이 함수는 변수 값이 채워진 템플릿 문자열을 반환합니다.

__regexFunction 은 나중에 사용할 수 있도록 값을 저장할 수도 있습니다. 여섯 번째 매개변수에는 참조 이름을 지정할 수 있습니다. 이 함수가 실행된 후 사용자 정의 값에 대한 구문을 사용하여 나중에 동일한 값을 검색할 수 있습니다. 예를 들어 " refName "을 여섯 번째 매개변수로 입력하면 다음을 사용할 수 있습니다.

• ${refName} 은(는) 이 함수에 의해 구문 분석된 두 번째 매개변수("대체 문자열에 대한 템플릿")의 계산된 결과를 참조합니다.
• ${refName_g0} - 이 함수로 구문 분석된 전체 일치를 참조합니다.
• ${refName_g1} 이 함수에 의해 구문 분석된 첫 번째 그룹을 참조합니다.
• ${refName_g#} 는 이 함수에 의해 구문 분석된 n ^번째 그룹을 참조합니다.
• ${refName_matchNr} 은 이 함수에서 찾은 그룹 수를 나타냅니다.

카운터는 호출될 때마다 1부터 시작하여 매번 +1씩 증가하는 새 번호를 생성합니다. 카운터는 시뮬레이션된 각 사용자의 값을 별도로 유지하거나 모든 사용자에 대해 동일한 카운터를 사용하도록 구성할 수 있습니다. 각 사용자의 값이 별도로 증가하면 테스트 계획을 통해 반복 횟수를 계산하는 것과 같습니다. 전역 카운터는 해당 요청이 실행된 횟수를 계산하는 것과 같습니다.

카운터는 정수 변수를 사용하여 카운트를 유지하므로 최대값은 2,147,483,647입니다.

카운터 함수 인스턴스는 완전히 독립적입니다. 전역 카운터 - " FALSE " -는 각 카운터 인스턴스에 의해 별도로 유지 관리됩니다.

동일한 반복에서 여러 __counter 함수 호출은 값을 더 이상 증가시키지 않습니다.
각 샘플에 대해 증가하는 카운트를 원하면 사용자 매개변수 와 같은 전처리기의 기능을 사용하십시오 .

스레드 번호 함수는 단순히 현재 실행 중인 스레드의 번호를 반환합니다. 이 숫자는 해당 ThreadGroup과 관련하여 로컬에서만 고유합니다. 즉, 이 기능의 관점에서 한 스레드 그룹의 스레드 #1은 다른 스레드 그룹의 스레드 #1과 구별할 수 없습니다.

ctx.getThreadNum()

이 함수에 대한 인수가 없습니다.

사용 예:

${__threadNum}

스레드 그룹 이름 함수는 단순히 실행 중인 스레드 그룹의 이름을 반환합니다.

이 함수에 대한 인수가 없습니다.

사용 예:

${__threadGroupName}

intSum 함수는 둘 이상의 정수 값의 합을 계산하는 데 사용할 수 있습니다.

longSum 함수는 둘 이상의 긴 값의 합을 계산하는 데 사용할 수 있습니다. 값이 -2147483648 ~ 2147483647 사이에 있지 않을 것임을 알 때마다 __intSum 대신 이 함수를 사용하십시오.

StringFromFile 함수는 텍스트 파일에서 문자열을 읽는 데 사용할 수 있습니다. 이것은 많은 변수 데이터가 필요한 테스트를 실행하는 데 유용합니다. 예를 들어 뱅킹 애플리케이션을 테스트할 때 100개 또는 1000개의 다른 계좌 번호가 필요할 수 있습니다.

사용하기 더 쉬울 수 있는 CSV 데이터 세트 구성 테스트 요소 도 참조하세요 . 그러나 현재 여러 입력 파일을 지원하지 않습니다.

호출될 때마다 파일에서 다음 줄을 읽습니다. 모든 스레드는 동일한 인스턴스를 공유하므로 다른 스레드는 다른 행을 갖게 됩니다. 파일의 끝에 도달하면 최대 루프 수에 도달하지 않는 한 처음부터 다시 읽기 시작합니다. 테스트 스크립트에 함수에 대한 여러 참조가 있는 경우 파일 이름이 같더라도 각각은 파일을 독립적으로 엽니다. [값을 다른 곳에서 다시 사용하려면 각 함수 호출에 대해 다른 변수 이름을 사용하십시오.]

파일을 열거나 읽는 중에 오류가 발생하면 함수는 " **ERR** " 문자열을 반환합니다.

machineName 함수는 로컬 호스트 이름을 반환합니다. 이것은 Java 메소드 InetAddress.getLocalHost() 를 사용하고 이를 getHostName() 에 전달합니다.

machineIP 함수는 로컬 IP 주소를 반환합니다. 이것은 Java 메소드 InetAddress.getLocalHost() 를 사용하여 getHostAddress() 에 전달합니다.

javaScript 함수는 JavaScript(Java가 아님!) 코드를 실행하고 해당 값을 반환합니다.

JMeter Javascript 기능은 독립형 JavaScript 인터프리터를 호출합니다. Javascript는 스크립팅 언어로 사용되므로 계산 등을 할 수 있습니다.

스크립트에서 다음 변수를 사용할 수 있습니다.

• log - 함수에 대한 로거
• ctx - JMeterContext 객체
• vars - JMeterVariables 객체
• threadName - 현재 스레드 이름을 포함하는 문자열
• sampler - 현재 Sampler 객체(있는 경우)
• sampleResult - 이전 SampleResult 객체(있는 경우)
• props - JMeterProperties(클래스 java.util.Properties ) 객체

Rhinoscript에서는 Packages 개체를 통해 정적 메서드에 액세스할 수 있습니다. 스크립팅 Java 문서를 참조하십시오 . 예를 들어 다음과 같이 JMeterContextService 정적 메소드에 액세스할 수 있습니다. Java.type("org.apache.jmeter.threads.JMeterContextService").getTotalThreads()

random 함수는 주어진 최소값과 최대값 사이에 있는 난수를 반환합니다.

RandomDate 함수는 지정된 시작 날짜와 종료 날짜 값 사이에 있는 임의의 날짜를 반환합니다.

RandomString 함수는 사용할 문자의 문자를 사용하여 길이의 임의의 문자열을 반환합니다.

RandomFromMultipleVars 함수는 소스 변수 에서 제공하는 변수 값을 기반으로 임의의 값을 반환합니다 .

• 경계 추출기
• 정규식 추출기
• CSS 선택기 추출기
• JSON 추출기
• XPath 추출기
• XPath2 추출기

UUID 함수는 의사 임의 유형 4 UUID(Universally Unique IDentifier)를 반환합니다.

CSVRead 함수는 CSV 파일에서 문자열을 반환합니다(cf StringFromFile ).

참고: JMeter는 여러 파일 이름을 지원합니다.

대부분의 경우 최신 CSV 데이터 세트 구성 요소 를 사용하는 것이 더 쉽습니다.

파일 이름이 처음 발견되면 파일이 열리고 내부 배열로 읽힙니다. 빈 줄이 감지되면 파일의 끝으로 처리됩니다. 이를 통해 후행 주석을 사용할 수 있습니다.

동일한 파일 이름에 대한 모든 후속 참조는 동일한 내부 배열을 사용합니다. NB 파일 이름 대소문자는 함수에 중요합니다. OS가 상관하지 않더라도 CSVRead(abc.txt,0) 및 CSVRead(aBc.txt,0) 는 다른 내부 배열을 참조합니다.

*ALIAS 기능을 사용하면 동일한 파일을 두 번 이상 열 수 있으며 더 짧은 파일 이름도 사용할 수 있습니다.

각 스레드에는 파일 배열의 현재 행에 대한 자체 내부 포인터가 있습니다. 스레드가 파일을 처음 참조할 때 배열의 다음 빈 행이 할당되므로 각 스레드는 다른 모든 스레드와 다른 행에 액세스합니다. [배열에 있는 행보다 스레드가 더 많지 않은 경우.]

속성 함수는 JMeter 속성 값을 반환합니다. 속성 값을 찾을 수 없고 기본값이 제공되지 않은 경우 속성 이름을 반환합니다. 기본값을 제공할 때 함수 이름을 제공할 필요가 없습니다. 매개변수는 null로 설정될 수 있으며 무시됩니다.

• ${__property(user.dir)} - user.dir 의 반환 값
• ${__property(user.dir,UDIR)} - user.dir 의 값을 반환 하고 UDIR 에 저장
• ${__property(abcd,ABCD,atod)} - 속성 abcd (또는 정의되지 않은 경우 " atod ")의 값을 반환하고 ABCD 에 저장
• ${__property(abcd,,atod)} - 속성 abcd (또는 정의되지 않은 경우 " atod ")의 값을 반환하지만 저장하지 않습니다.

이것은 명령줄에 정의된 속성과 함께 사용하기 위한 단순화된 속성 함수입니다. __property 함수 와 달리 변수에 값을 저장하는 옵션이 없으며, 기본값이 제공되지 않으면 1로 가정합니다. 루프, 스레드 수, 램프 업 등

속성 값을 정의합니다.

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

log 함수는 메시지를 기록하고 입력 문자열을 반환합니다.

logn 함수는 메시지를 기록하고 빈 문자열을 반환합니다.

BeanShell 함수는 전달된 스크립트를 평가하고 결과를 반환합니다.

BeanShell 사용에 대한 자세한 내용은 BeanShell 웹 사이트 http://www.beanshell.org/ 를 참조하십시오.

함수의 단일 인스턴스는 여러 스레드에서 호출될 수 있습니다. 그러나 함수 execute() 메서드는 동기화됩니다.

" beanshell.function.init " 속성 이 정의되면 소스 파일의 이름으로 인터프리터에 전달됩니다. 이것은 공통 메소드 및 변수를 정의하는 데 사용할 수 있습니다. bin 디렉토리에 샘플 초기화 파일이 있습니다: BeanShellFunction.bshrc .

스크립트가 실행되기 전에 다음 변수가 설정됩니다.

• log - BeanShell 함수에 대한 로거 (*)
• ctx - JMeterContext 객체
• vars - JMeterVariables 객체
• props - JMeterProperties(클래스 java.util.Properties ) 객체
• threadName - threadName(문자열)
• Sampler - 현재 Sampler (있는 경우)
• SampleResult - 현재의 SampleResult (있는 경우)

__groovy 함수는 전달된 Apache Groovy 스크립트를 평가 하고 결과 를 반환합니다.

속성 " groovy.utilities "가 정의되면 ScriptEngine에 의해 로드됩니다. 이것은 공통 메소드 및 변수를 정의하는 데 사용할 수 있습니다. bin 디렉토리 에 샘플 초기화 파일이 있습니다 : utility.groovy .

스크립트가 실행되기 전에 다음 변수가 설정됩니다.

• log - 그루비 함수에 대한 로거 (*)
• ctx - JMeterContext 객체
• vars - JMeterVariables 객체
• props - JMeterProperties(클래스 java.util.Properties ) 객체
• threadName - threadName(문자열)
• sampler - 현재의 Sampler (있는 경우)
• prev - 이전의 SampleResult , 존재하는 경우
• 아웃 - 시스템 아웃

(*)는 초기화 파일(있는 경우)이 처리되기 전에 설정됨을 의미합니다. 다른 변수는 호출마다 다릅니다.

예를 들어 다음 을 수행하지 마십시오.

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

myVar 변수가 트랜잭션마다 변경되고 스크립트가 매번 변경되므로 위의 Groovy를 캐시할 수 없다고 상상해 보십시오.

대신 다음을 수행하여 캐시할 수 있습니다.

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

split 함수는 전달된 문자열을 구분 기호에 따라 분할하고 원래 문자열을 반환합니다. 구분 기호가 인접하면 " ? "가 값으로 반환됩니다. 분할 문자열은 ${VAR_1} , ${VAR_2} 등의 변수에 반환됩니다. 변수 개수는 ${VAR_n} 에 반환됩니다 . 후행 구분 기호는 누락된 변수로 처리되고 " ? "가 반환됩니다. 또한 ForEach 컨트롤러에서 더 잘 작동할 수 있도록 __split 은 이전 분할에서 설정한 경우 첫 번째 사용하지 않는 변수를 삭제합니다.

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

XPath 함수는 XML 파일을 읽고 XPath와 일치시킵니다. 함수가 호출될 때마다 다음 일치 항목이 반환됩니다. 파일의 끝에서 시작 부분으로 줄 바꿈됩니다. 일치하는 노드가 없으면 함수는 빈 문자열을 반환하고 경고 메시지가 JMeter 로그 파일에 기록됩니다.

${__XPath(/경로/to/build.xml, //대상/@이름)}

setProperty 함수는 JMeter 속성의 값을 설정합니다. 함수의 기본 반환 값은 빈 문자열이므로 함수 호출은 함수가 유효한 모든 곳에서 사용할 수 있습니다.

선택적 세 ^번째 매개변수를 " true "로 설정하면 원래 값을 반환할 수 있습니다.

속성은 JMeter에 전역적이므로 스레드와 스레드 그룹 간에 통신하는 데 사용할 수 있습니다.

time 함수는 현재 시간을 다양한 형식으로 반환합니다.

jexl 함수는 Commons JEXL 표현식 을 평가한 결과를 반환합니다 . JEXL 표현식에 대한 자세한 내용은 아래 링크를 참조하십시오.

__jexl2 함수는 Commons JEXL 2를 사용합니다 .

• JEXL 구문 설명
• JEXL 예제

jexl 함수는 Commons JEXL 표현식 을 평가한 결과를 반환합니다 . JEXL 표현식에 대한 자세한 내용은 아래 링크를 참조하십시오.

__jexl3 함수는 Commons JEXL 3을 사용합니다 .

• JEXL 구문 설명
• JEXL 예제

V(변수) 함수는 변수 이름 식을 평가한 결과를 반환합니다. 이것은 중첩 변수 참조(현재 지원되지 않음)를 평가하는 데 사용할 수 있습니다.

예를 들어, 변수 A1 , A2 및 N = 1 이 있는 경우 :

• ${A1} - 정상 작동
• ${A${N}} - 작동하지 않음(중첩 변수 참조)
• ${__V(A${N})} - 정상적으로 작동합니다. A${N} 은 A1 이 되고 __V 함수는 A1 값을 반환합니다.

evalVar 함수는 변수에 저장된 표현식을 평가한 결과를 반환합니다.

이를 통해 파일에서 문자열을 읽고 그 안의 모든 변수 참조를 처리할 수 있습니다. 예를 들어 " query " 변수에 " select ${column} from ${table} "이 포함되어 있고 " column " 및 " table "에 " name " 및 " customers " 가 포함되어 있으면 ${__evalVar(query)} 는 다음과 같이 평가됩니다. " 고객의 이름 선택 ".

eval 함수는 문자열 식을 평가한 결과를 반환합니다.

이를 통해 변수에 저장된 문자열에서 변수 및 함수 참조를 보간할 수 있습니다. 예를 들어, 다음 변수가 주어졌을 때:

• 이름 = 스미스
• 열 = 나이
• 테이블 = 생일
• SQL = ${table}에서 ${column} 선택(name='${name}')

이것은 예를 들어 SQL 문과 값이 모두 데이터 파일에 정의되어 있는 경우 CSV 데이터 세트와 함께 사용할 수 있습니다.

char 함수는 숫자 목록을 유니코드 문자로 평가한 결과를 반환합니다. 아래의 __unescape() 도 참조 하세요.

이를 통해 필드에 임의의 문자 값을 추가할 수 있습니다.

unescape 함수는 Java 이스케이프된 문자열을 평가한 결과를 반환합니다. 위의 __char() 도 참조하십시오 .

이를 통해 GUI를 통해 정의하기 어려운(또는 불가능한) 필드에 문자를 추가할 수 있습니다.

HTML 엔티티를 포함하는 문자열을 이스케이프에 해당하는 실제 유니코드 문자를 포함하는 문자열로 이스케이프 해제하는 함수입니다. HTML 4.0 엔터티를 지원합니다.

예를 들어, 문자열

${__unescapeHtml(<Français>)}

엔터티를 인식할 수 없으면 그대로 남겨두고 결과 문자열에 그대로 삽입됩니다. 예 를 들어 ${__unescapeHtml(>&zzzz;x)} 는 >&zzzz;x 를 반환 합니다.

Commons Lang의 StringEscapeUtils#unescapeHtml(String)을 사용합니다 .

HTML 엔터티를 사용하여 문자열의 문자를 이스케이프하는 함수입니다. HTML 4.0 엔터티를 지원합니다.

예를 들어,

${__escapeHtml("빵" & "버터")}

Commons Lang의 StringEscapeUtils#escapeHtml(String) 을 사용합니다 .

application/x-www-form-urlencoded 문자열 을 디코딩하는 기능 입니다. 참고: 인코딩 체계로 UTF-8을 사용하십시오.

예를 들어, 문자열

${__urldecode(단어+%22학교%22+is+%22%C3%A9cole%22+in+프랑스어)}

Java 클래스 URLDecoder 를 사용합니다 .

문자열을 application/x-www-form-urlencoded 문자열 로 인코딩하는 함수 입니다.

예를 들어, 문자열

${__urlencode(단어 "school"은 프랑스어로 "école"입니다)}

Java 클래스 URLEncoder 를 사용합니다 .

FileToString 함수를 사용하여 전체 파일을 읽을 수 있습니다. 호출될 때마다 전체 파일을 읽습니다.

파일을 열거나 읽는 중에 오류가 발생하면 함수는 " **ERR** " 문자열을 반환합니다.

samplerName 함수는 현재 샘플러의 이름(즉, 레이블)을 반환합니다.

연결된 샘플러가 없는 테스트 요소에서는 함수가 작동하지 않습니다. 예를 들어 테스트 계획. 구성 요소에는 연결된 샘플러도 없습니다. 그러나 일부 구성 요소는 HTTP 헤더 관리자 및 Http 쿠키 관리자와 같은 샘플러에서 직접 참조하며 이 경우 기능은 Http 샘플러의 컨텍스트에서 해결됩니다. 전처리기, 후처리기 및 어설션에는 항상 연결된 샘플러가 있습니다.

예시:

${__샘플러 이름()}

TestPlanName 함수는 현재 테스트 계획의 이름을 반환합니다(계획 포함에서 호출 테스트 계획의 이름을 알기 위해 사용할 수 있음).

ORO Regexp 메타 문자를 이스케이프하는 함수로, Java Regexp 엔진 의 \Q \E 와 동일합니다.

예를 들어,

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

ORO의 Perl5Compiler#quotemeta(String)를 사용합니다.

XML 1.0 엔터티를 사용하여 문자열의 문자를 이스케이프하는 함수입니다.

예를 들어,

${__escapeXml("빵" & '버터')}

Commons Lang의 StringEscapeUtils#escapeXml10(String) 을 사용합니다 .

timeShift 함수는 지정된 초, 분, 시간, 일 또는 월이 추가된 지정된 형식의 날짜를 반환합니다.

다이제스트 함수는 선택적 솔트, 대문자 및 변수 이름을 사용하여 특정 해시 알고리즘에서 암호화된 값을 반환합니다.

__dateTimeConvert 함수는 소스 형식의 날짜를 선택적으로 변수 이름에 결과를 저장하는 대상 형식으로 변환합니다 .

__isPropDefined 함수는 속성이 있으면 true를 반환하고 속성이 없으면 false를 반환합니다 .

__isVarDefined 함수 는 변수가 있으면 true를 반환하고 변수가 없으면 false를 반환합니다.

대소문자 변경 함수는 특정 모드에 따라 대소문자가 변경된 문자열 값을 반환합니다. 결과는 선택적으로 JMeter 변수에 저장할 수 있습니다.

__StringToFile 함수를 사용하여 파일에 문자열을 쓸 수 있습니다 . 호출될 때마다 파일 추가 또는 덮어쓰기에 문자열을 씁니다.

함수의 기본 반환 값은 빈 문자열입니다.