하위 표현식 빌더

AND, OR, NOT 및 괄호로 묶기를 사용하여 하위 표현식에서 복합 규칙 조건을 빌드하려면 하위 표현식 빌더를 사용하십시오. 규칙 빌더는 변경사항을 적용할 때 규칙을 유효성 검증하며 불일치하는 괄호 및 지원되지 않는 논리 연산자에 대해 경고합니다.

이 관리 콘솔 페이지를 보려면 서버 > On Demand Router > odr_name> On Demand Router 특성 > 일반 서버 클러스터 서비스 정책 > work_class_name > 규칙 추가 > 하위 표현식 빌더를 클릭하십시오.

하위 표현식 빌더를 사용하여 규칙을 수정하려면 관리자 관리 권한을 가지고 있어야 합니다.

피연산자 선택

선택하는 프로토콜에 따라 다른 피연산자가 표시됩니다. 다음 테이블에는 콘솔에 표시되는 피연산자 이름, 표현식에 나타나는 실제 피연산자, 피연산자당 올바른 프로토콜 및 각 피연산자에 대한 설명이 포함됩니다.

표 1. 피연산자 및 해당 설명
표시되는 피연산자 피연산자 유효한 프로토콜 설명
응용프로그램 이름 application IIOP EJB가 포함된 응용프로그램의 이름
클라이언트 호스트 clienthost HTTP, SOAP, IIOP 완전한 클라이언트 호스트 이름. 이는 IP(Internet Protocol) 명령 호스트 이름의 값입니다. 이 피연산자는 숫자 연산자(예: >, >=, <, <=)를 지원하지 않습니다.
클라이언트 포트 clientport IIOP 클라이언트 포트 이름
클라이언트 IPV4 clientipv4 HTTP, SOAP 클라이언트의 인터넷 프로토콜 버전 4 주소로 클라이언트는 점분리 4 주소 유형 n.n.n.n을 사용합니다.
클라이언트 IPV6 clientipv6 HTTP, SOAP 클라이언트 컴퓨터의 인터넷 프로토콜 버전 6 128비트 주소 유형 x:x:x:x:x:x:x:x
쿠키 헤더 이름 cookie$<name> HTTP, SOAP 쿠키 이름. 예를 들어, cookie$My_Cookie_Name='My_Cookie_Value 표현식은 값이 My_Cookie_ValueMy_Cookie_Name 쿠키가 들어 있는지 알기 위해 요청을 테스트합니다. 특정 쿠키의 존재 여부를 테스트하려면 다음 표현식 중 하나를 사용하십시오.
  • cookie$MyCookieName IS NOT NULL
  • cookie$MyCookieName IS NULL
EJB 모듈 이름 ejbmodule IIOP EJB의 모듈 이름
EJB 이름 ejbname IIOP EJB의 이름
EJB 메소드 이름 ejbmethod IIOP EJB 내의 메소드 이름
그룹 ID gids$<name> HTTP, SOAP 요청 전송자의 그룹 ID
HTTP 메소드 HTTPMethod HTTP, SOAP 요청에 대한 HTTP 메소드. 가능한 값은 POST, GET, PUT 및 DELETE입니다.
MIME 유형 MIMEType HTTP, SOAP 요청에 대한 MIME 유형
포트 port HTTP, SOAP, IIOP 호스트에 서비스가 제공되는 대기 중인 포트
프로토콜 protocol HTTP, SOAP 요청을 전송하는 통신 프로토콜. 현재 지원되는 프로토콜은 HTTP, HTTPS, SOAP 및 SOAPS입니다.
요청 헤더 이름 header$<name> HTTP, SOAP

헤더 이름 또는 값. 헤더 이름 및 값. 예를 들어, header$Host='localhost' 표현식은 값이 localhost인 HTTP 호스트 헤더가 들어 있는지 알기 위해 요청을 테스트합니다. 호스트 헤더의 존재 여부를 테스트하려면 다음 표현식 중 하나를 사용하십시오.

header$Host IS NOT NULL ,header$Host IS NULL

요청 조회 매개변수 이름 queryparm$<name> HTTP, SOAP 요청 URL에서 지정된 조회 매개변수 이름. 각 요청에 대해 해당되는 경우에 한해 조회 매개변수의 이름/값 쌍 맵이 있습니다. ODR(On Demand Router)은 요청 조회 매개변수 이름을 매개변수 맵을 검색하기 위한 키로 사용하며 해당되는 경우에 한해 값을 추출하여 규칙 표현식을 평가합니다. 규칙이 일치하면 지정된 조치를 취합니다. 그렇지 않으면 표현식이 정의된 작업 클래스에 대한 기본 조치를 사용합니다.
예를 들어, queryparm$timezone=’EST’ 표현식은 요청에 값이 ESTtimezone HTTP 조회 매개변수가 들어 있는지 알기 위해 요청을 테스트합니다. 조회 매개변수의 존재 여부를 테스트하려면 다음 명령 중 하나를 사용하십시오.
  • queryparm$timezone IS NOT NULL
  • queryparm$timezone IS NULL
역할 roles$<name> HTTP, SOAP 요청 전송자의 역할
서버 호스트 serverhost HTTP, SOAP, IIOP 서버의 완전한 호스트 이름. 이 피연산자는 숫자 연산자(예: >, >=, <, <=)를 지원하지 않습니다.
서버 IPV4 serveripv4 HTTP, SOAP 서버 시스템의 IP 주소로 IPv4 점분리 4 주소 유형 n.n.n.n을 사용합니다.
서버 IPV6 serveripv6 HTTP, SOAP 서버 시스템 RFC 1924 뒤에 IPv6 128비트 주소 유형 x:x:x:x:x:x:x:x
시간 time HTTP, SOAP, IIOP
시간 피연산자의 형식은 다음과 같습니다. [dayOfWeek[/dayOfMonth[/month[/year]]]::][hour[:minute[:second]]]
  • dayofWeek 값에는 일요일, 월요일, 화요일, 수요일, 목요일, 금요일, 토요일이 있습니다.
  • dayOfMonth에는 1에서 31까지의 값이 포함됩니다.
  • month는 월을 나타내는 숫자이며 1월을 나타내는 1부터 시작하여 12월을 나타내는 12까지 있습니다. 예를 들어, 숫자 5 값은 5월을 나타냅니다.
  • year은 4자리 수의 연도입니다(예: 2007).
  • hour는 24시간 단위의 하루 중 시간입니다.
  • minute는 0에서 59까지의 범위인 정수입니다.
  • second는 0에서 59까지의 범위인 정수입니다.

슬래시(/)는 날짜 매개변수를 구분하는 데 사용되고, 더블 콜론(::)은 날짜 및 시간 매개변수를 구분하는 데 사용되며, 콜론(:)은 하루 중 시간 매개변수를 구분하는 데 사용합니다. 라우팅 조치를 취할 것인지 여부를 결정하는 데 time 피연산자를 사용하는 전체 규칙의 부울 결과입니다.

사용자 ID uid$<name> HTTP, SOAP 요청 전송자의 사용자 ID
가상 포털 virtualportal HTTP, SOAP 가상 포털은 WebSphere Portal Server 내에 작성되며 WebSphere Virtual Enterprise는 WebSphere Portal Server와의 통합을 위해 이 피연산자를 지원합니다. 가상 포털은 요청 URL에서 WebSphere Portal 응용프로그램의 웹 모듈에 대한 컨텍스트 루트를 제외한 것입니다. 지정된 요청이 정의된 가상 포털과 일치하면 해당 규칙에 대해 정의된 라우팅 조치를 취합니다.
XPath 표현식 xpathexpr SOAP

XPath 문자열 표현식은 XPath 표현식을 포함하는 데 사용되는 필수 필드 및 로컬 네임 스페이스를 위한 선택적 필드를 가집니다. XPath 표현식에 포함된 모든 네임 스페이스가 표준인 경우 두 번째 필드는 선택적일 수 있습니다. 다중 로컬 네임 스페이스가 있는 경우 각각을 쉼표(,)로 분리하십시오. 다음은 하나의 로컬 네임 스페이스 정의를 갖는 xpathexpr의 예제입니다.

xpathexpr$/soap:Envelope/soap:Body/m:getTimeZone/n:clientId$m\\=http://test.classify.ws.ibm.com,n\\=http://test2.classify.ws.ibm.com = \\'1000\\' or operation IS NOT NULL

연산자
  • = 같음 연산자는 대소문자 구분 일치를 표시합니다.
  • <> 같지 않음 연산자는 피연산자 값과 입력한 값이 같지 않음을 표시합니다.
  • > 보다 큼 연산자는 숫자와 함께 사용됩니다.
  • >= 이상 연산자는 숫자와 함께 사용됩니다.
  • < 미만 연산자는 숫자와 함께 사용됩니다.
  • <= 이하 연산자는 숫자와 함께 사용됩니다.
  • AND: xx AND yy의 경우 xx, yy가 모두 포함된 일치를 표시합니다.
  • BETWEEN: 이 연산자는 AND와 함께 사용되어 첫 번째(낮음), 값 및 마지막(높음), 값을 포함하는 값 범위를 선택합니다. 숫자 및 날짜와 함께 연산됩니다.
  • EXISTS: 이 부울 연산자는 특정 HTTP 헤더 요소 속성을 검사하는 경우와 같이 복합 하위 표현식의 결과 또는 피연산자를 검사합니다.
  • IN: 이 연산자는 단일 표현식에서 다중값이 있는 피연산자를 표시합니다. 예를 들어, port라는 피연산자의 경우, 9080, 9090, 9091 같은 값이 될 수 있는 포트 값을 표현하려면 표현식 단편이 port IN (9080,9090,9091)이 됩니다. 대괄호 안의 값이 표현되는 방법은 포트의 데이터 유형에 따라 다릅니다. 포트가 정수인 경우, 정확한 구문은 따옴표 없는 값입니다. 포트가 문자열인 경우 정확한 구문은 port IN (‘9080’, ‘9090’, ‘9091’)입니다.
  • IS NULL: 이 연산자는 조회의 유효성 검증에서 요청된 매개변수가 없음을 표시하도록 나타냅니다.
  • IS NOT NULL: 이 연산자는 조회의 유효성 검증에서 요청된 매개변수가 있음을 표시하도록 합니다.
  • LIKE: 이 연산자는 문자열 피연산자 값에 대한 패턴 일치를 표시합니다. 값에는 패턴 일치가 시작될 위치에 와일드카드 문자인 퍼센트 부호(%)를 포함해야 합니다. 예를 들어, host LIKE %blanca라는 표현식은 blanca라는 단어 또는 blanca로 끝나는 단어와 일치하는 반면, host LIKE blanca%라는 표현식은 blanca라는 단어 또는 blanca로 시작하는 단어와 일치하며 host LIKE %blanca%라는 표현식은 blanca라는 단어 또는 그 안에 blanca가 포함되어 있는 단어와 일치합니다.
  • NOT: NOT xx의 경우, 이 연산자는 xx를 포함하지 않는 일치를 표시합니다.
  • OR: xx OR yy의 경우, 이 연산자는 xx, yy 중 하나가 포함되는 일치를 표시합니다.

선택하는 연산자에 따라 작성할 하위 표현식의 값을 입력하십시오.

하위 표현식 빌드

지정한 피연산자, 연산자 및 값의 결과로서 하위 표현식을 생성하십시오.

생성된 하위 표현식

이 하위 표현식을 규칙에 복사하여 붙여넣으십시오.




WebSphere Extended Deployment Information Center(온라인)

관련 정보
On Demand Router 라우팅 정책
On Demand Router 서비스 정책
작업 클래스 멤버쉽 및 규칙 정의

wc_rulebuilder_detail