HTTP 요청 수신 활동을 사용하여 통합 어플라이언스가 HTTP 리스너 역할을 하도록 구성합니다.
엔드포인트 세부사항, URL, 메소드가 동일한 어플라이언스에 두 개의 HTTP 요청 수신 활동을 배치할 수는 없습니다.
단일 HTTP 요청 수신 활동의 경우
URL에 대한 HTTP 요청 수신 활동을 하나만 배치하는 경우 오케스트레이션은 이 기본 URL로 시작하는 이 URL의 모든 요청을 승인합니다. 예를 들어, /customer를 배치하면 /customer, /customer/21, /customer/21/dept 등에 대한 요청을 승인합니다.
URL에 대한 HTTP 요청 수신 활동을 경로 매개변수와 함께 배치하는 경우에는 경로 매개변수의 값이 있는 구성된 URL에 URL이 일치하는 요청만 오케스트레이션이 승인합니다. 예를 들어, /customer/{custid}를 배치하면 /customer/10, /customer/21, /customer/dept와 같은 요청을 승인합니다. /customer, /customer/21/dept 등의 URL은 허용되지 않습니다.
복수 HTTP 요청 수신 활동의 경우
동일한 기본 URL로 구성된 두 개의 HTTP 요청 수신 활동을 배치하는 경우 활동은 URL이 구성된 URL과 정확히 일치하는 요청을 허용합니다. 예를 들어, /customer 및 /customer/{path parameter}를 배치하고 /customer가 호출되면 요청은 /customer로 구성된 활동에서 허용됩니다. /customer/007이 호출되는 경우에는 /customer/{path parameter}로 구성된 활동에서 요청이 허용됩니다. 또한 /customer/dept/1 또는 /customer/12/21 URL을 호출하는 경우에는 어느 활동에서도 요청이 허용되지 않습니다.
필드 | 설명 |
---|---|
URL(호스트 이름 다음 경로) | 통합 어플라이언스가 인바운드 HTTP 요청을 청취하는
자원 경로(예: /mypath)를 지정합니다.
이 필드에 지정하는 문자열에서 http://, the hostname 문자열과
통합 어플라이언스의 포트 번호를 제외해야 합니다. 통합 어플라이언스가 인바운드
HTTP 요청을 청취하기 위해 사용하는 전체 URL은 통합 어플라이언스의
호스트 이름, HTTP 엔드포인트에 지정된 포트 이름, 그리고 이 필드에 지정된
경로를 통해 자동으로 구성됩니다. 예를 들어,
통합 어플라이언스가 HTTP 요청을 청취하는 전체 URL이 http://myAR:myPort/myPath이면
이 필드에서는 /myPath 문자열만 지정하면 됩니다.
지정된 경로는 동일한 포트를 사용하여
같은 통합 어플라이언스에서 동시에 배치되는 HTTP 요청 수신 활동에
고유해야 합니다. 경로 매개변수와 조회 매개변수를 이용하려면 url/{path}?name1=value1&name2=value2 형식으로 URL을 입력하십시오. 그러면 문자열 값을 "{path}" 매개변수로 맵핑하고 조회 매개변수 이름(이 예제에서는 name1 및 name2)을 지정할 수 있습니다. 다수의 "{path}" 매개변수를 선언하도록 선택한 경우에는 각 매개변수의 고유 이름이 있어야 합니다. 동일한 이름의 매개변수는 맵에 하나의 노드로만 표시됩니다. 경로 매개변수는 출력 맵핑의 /httpheaders/pathParameters 아래에 표시됩니다. 조회 매개변수는 출력 맵핑의 /httpheaders/queryParameters 아래에 표시됩니다. 참고: URL에서 조회 매개변수에 지정하는 값은 맵퍼에
전달되지 않습니다. 값은 실제 수신 요청을 기반으로
서버에서 발생합니다.
참고: 통합 어플라이언스가 인바운드 HTTP 요청을 청취하는 경로는 사용자가
지정하는 자원 경로 문자열이며 통합 어플라이언스의 실제 디렉토리 경로가 아닙니다.
|
메소드 | HTTP 메소드가 청취하는 서버에서 승인됨을 지정합니다. |
유형 | HTTP 요청의 예상 메시지 유형을 지정합니다(Text 또는 Binary). |
회신 필요 | 요청의 송신자에게 회신을 전송해야 하는지 여부를
지정합니다. 참고: 이 선택란을 선택하면 오케스트레이션에서 HTTP 응답 전송
활동을 추가하고 구성해야 합니다.
|
압축/압축 해제 사용 | 활동 레벨에서 압축/압축 해제가 켜지거나 꺼지는지 여부를 지정합니다. 기본적으로 압축/압축 해제 사용 선택란은 지워져 있으므로 이 활동에 압축/압축 해제를 사용하지 않습니다. 이 활동에 압축/압축 해제를 사용하려면 압축/압축 해제 사용 선택란을 선택하십시오. 자세한 정보는 HTTP 요청 호출/가져오기/게시/헤드/넣기/삭제 활동의 압축/압축 해제을 참조하십시오. |
출력 매개변수 | 설명 |
---|---|
httpheaders | HTTP 요청의 헤더를 지정합니다. |
body | HTTP 요청 메시지의 본문을 지정합니다. |
httpheaders 출력 매개변수의 노드 | 설명 |
---|---|
httpheaders/uri | 수신 요청의 자원 경로를 지정합니다(예: /myPath). |
httpheaders/method | HTTP 요청의 유형을 지정합니다. |
httpheaders/host | 클라이언트의 IP 주소 또는 호스트 이름을 지정합니다. |
httpheaders/otherHeaders/headerItem | HTTP 헤더 매개변수 세트가 포함된 요소를 이름/값 쌍으로 지정합니다. HTTP 요청에 여러 개의 HTTP 헤더 매개변수를 지정할 수 있으므로 이 노드는 반복 노드입니다. |
httpheaders/<configured_header_name> | 요청 헤더 단계에서 최소 하나의 요청 헤더를 구성한 경우 각 헤더가 여기에 표시됩니다. <configured_header_name>은 선택하거나 입력한 실제 헤더 이름으로 대체됩니다. |
httpheaders/pathParameters | 구성 단계에서 URL의 경로 매개변수를 구성한 경우 각 매개변수가 여기에 표시됩니다. 지정된 경로 매개변수가 없으면 이 노드가 표시되지 않습니다. |
httpheaders/queryParameters | 구성 단계에서 URL의 조회 매개변수를 구성한 경우 각 매개변수가 여기에 표시됩니다. 지정된 조회 매개변수가 없으면 이 노드가 표시되지 않습니다. |
httpheaders/otherHeaders/headerItem/name | HTTP 헤더 매개변수의 이름을 지정합니다. |
httpheaders/otherHeaders/headerItem/value | HTTP 헤더 매개변수의 값을 지정합니다. |