HTTP 요청 수신 활동

HTTP 요청 수신 활동을 사용하여 통합 어플라이언스가 HTTP 리스너 역할을 하도록 구성합니다.

다음 그림은 HTTP 리스너로 작동하는 통합 어플라이언스를 보여줍니다.
그림 1.
HTTP 요청 수신 활동은 시작 활동입니다. HTTP 요청 수신 활동으로 시작하는 오케스트레이션이 통합 어플라이언스에 배치되면 통합 어플라이언스는 HTTP 요청을 기다리는 HTTP 리스너로 작동합니다. HTTP 요청이 수신되면 다음 조치가 발생합니다.
  1. 오케스트레이션 작업이 시작됩니다.
  2. HTTP 요청 수신 활동은 수신 HTTP 요청을 처리하고 HTTP 요청을 활동의 출력 매개변수로 맵핑합니다.
  3. 출력 매개변수는 지정된 오케스트레이션 변수에 맵핑합니다. 점검 목록출력 맵핑 태스크에서 디자인하는 시간 동안, 출력 매개변수와 오케스트레이션 변수 사이의 맵핑이 정의됩니다.
  4. 오케스트레이션에서 나머지 활동이 처리됩니다. (오케스트레이션의 그래픽 표시에서, 나머지 활동은 HTTP 요청 수신 활동의 오른쪽에 있는 활동입니다.)
기본적으로 압축 해제는 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을 호출하는 경우에는 어느 활동에서도 요청이 허용되지 않습니다.

참고: 첫 번째가 /customer/department이고 두 번째가 /customer/{path parameter}인 두 개의 활동을 배치하고 /customer/department가 호출되면 첫 번째로 배치된 활동(/customer/department)에서 요청이 허용됩니다. /customer/{path parameter}가 처음으로 배치되었으면 /customer/{path parameter}에서 요청이 허용됩니다.
참고: 웹 서비스와 HTTP에 동일한 URL을 배치하지 않는 것이 좋습니다.
기본 URL - 경로 매개변수 이전의 URL 파트. 예를 들어, 구성된 URL이 /employee/manager/{id}이면 기본 URL은 /employee/manager입니다.

오케스트레이션에 HTTP에 요청 수신 활동 추가

  1. 오케스트레이션을 작성하거나 여십시오. 오케스트레이션의 그래픽 표시가 나타납니다.
  2. 활동 탭을 선택하고 HTTP 폴더를 펼치십시오.
  3. 요청 수신 활동을 오케스트레이션으로 끌어오십시오.
  4. 활동을 선택하십시오. 특성 분할창에 활성 상태의 요약 태스크와 함께 점검 목록이 표시됩니다. 작업공간에서 오케스트레이션의 그래픽 표시 아래에 특성 분할창이 위치됩니다.

HTTP 엔드포인트 작성, 선택 또는 편집

  1. 점검 목록에서 엔드포인트 선택 태스크를 클릭하고 다음 조치 중 하나를 선택하십시오.
    • 기존 엔드포인트를 선택하십시오.
      1. 찾아보기를 선택하십시오. 프로젝트 탐색기가 표시됩니다.
      2. 기존 엔드포인트를 선택하고 확인을 클릭하십시오. "활동 구성" 프로시저로 건너뛰십시오.
    • 기존 엔드포인트를 선택하고 편집하십시오.
      1. 찾아보기를 선택하십시오. 프로젝트 탐색기가 표시됩니다.
      2. 기존 엔드포인트를 선택하고 확인을 클릭하십시오.
      3. 편집을 클릭하십시오. 엔드포인트 편집 분할창이 표시됩니다.
    • 새로 작성을 선택하여 새 엔드포인트를 작성하십시오. 엔드포인트 작성 분할창이 표시됩니다.
  2. HTTP 엔드포인트 작성 또는 편집에 대해 HTTP 엔드포인트 작성 또는 편집을 참조하십시오.

활동 구성

  1. 점검 목록에서 구성 태스크를 선택하십시오. 구성 분할창이 표시됩니다.
  2. 다음 표에 설명된 대로 이 분할창의 모든 필드와 선택란을 구성하십시오.
    표 1.
    필드 설명
    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}" 매개변수로 맵핑하고 조회 매개변수 이름(이 예제에서는 name1name2)을 지정할 수 있습니다. 다수의 "{path}" 매개변수를 선언하도록 선택한 경우에는 각 매개변수의 고유 이름이 있어야 합니다. 동일한 이름의 매개변수는 맵에 하나의 노드로만 표시됩니다. 경로 매개변수는 출력 맵핑의 /httpheaders/pathParameters 아래에 표시됩니다. 조회 매개변수는 출력 맵핑의 /httpheaders/queryParameters 아래에 표시됩니다.

    참고: URL에서 조회 매개변수에 지정하는 값은 맵퍼에 전달되지 않습니다. 값은 실제 수신 요청을 기반으로 서버에서 발생합니다.
    참고: 통합 어플라이언스가 인바운드 HTTP 요청을 청취하는 경로는 사용자가 지정하는 자원 경로 문자열이며 통합 어플라이언스의 실제 디렉토리 경로가 아닙니다.
    메소드 HTTP 메소드가 청취하는 서버에서 승인됨을 지정합니다.
    유형 HTTP 요청의 예상 메시지 유형을 지정합니다(Text 또는 Binary).
    회신 필요 요청의 송신자에게 회신을 전송해야 하는지 여부를 지정합니다.
    참고: 이 선택란을 선택하면 오케스트레이션에서 HTTP 응답 전송 활동을 추가하고 구성해야 합니다.
    압축/압축 해제 사용 활동 레벨에서 압축/압축 해제가 켜지거나 꺼지는지 여부를 지정합니다. 기본적으로 압축/압축 해제 사용 선택란은 지워져 있으므로 이 활동에 압축/압축 해제를 사용하지 않습니다. 이 활동에 압축/압축 해제를 사용하려면 압축/압축 해제 사용 선택란을 선택하십시오. 자세한 정보는 HTTP 요청 호출/가져오기/게시/헤드/넣기/삭제 활동의 압축/압축 해제을 참조하십시오.

요청 헤더 지정

  1. 점검 목록에서 요청 헤더 태스크를 선택하십시오. 요청 헤더 분할창이 표시됩니다. 사용자 정의 헤더 테이블이 맨 위에 표시되고, 사전 정의 표준 헤더 포함 선택란이 중간에 표시되며, 표준 헤더 테이블은 맨 아래에 표시됩니다.
  2. 추가 단추를 클릭하여 사용자 정의 헤더 테이블에 헤더를 추가하십시오. 새 항목을 클릭하여 헤더 이름을 입력하거나 드롭 다운 목록에서 헤더 이름을 선택하십시오. 헤더 이름이 사전 정의 헤더 이름이면 설명 열에 설명이 표시되고 그렇지 않은 경우에는 헤더에 대한 설명을 직접 입력하십시오.
  3. 사전 정의된 표준 헤더를 사용하려면 사전 정의 표준 헤더 포함 선택란을 선택하십시오. 중복 헤더 이름은 허용되지 않으며(대소문자 차이는 무시하고) 사용자 정의 헤더 테이블에서 중복 헤더를 제거하도록 프롬프트가 표시될 수 있습니다. 선택된 HTTP 헤더는 출력 맵핑의 /httpheaders 아래에 표시됩니다.

활동의 출력 맵핑

  1. 점검 목록에서 출력 맵핑 태스크를 선택하십시오. 다음 표에 설명된 대로 활동의 출력 매개변수가 출력 맵핑 태스크의 활동에서 분할창에 표시됩니다.
    표 2.
    출력 매개변수 설명
    httpheaders HTTP 요청의 헤더를 지정합니다.
    body HTTP 요청 메시지의 본문을 지정합니다.
    다음 표는 선택적 httpheaders 출력 매개변수의 노드를 정의합니다.  
    표 3.
    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 헤더 매개변수의 값을 지정합니다.
  2. 활동의 출력 매개변수와 오케스트레이션 변수 사이의 맵을 작성합니다. 맵핑에 대한 지시사항은 맵핑 작성을 참조하십시오.
    참고: HTTP 요청 수신 활동으로 시작하는 오케스트레이션을 테스트하려면 Studio 설치에서 포함된 HTTP 게시 유틸리티를 사용하여 런타임 중에 청취하는 통합 어플라이언스로 HTTP 요청을 보낼 수 있습니다. 시작 메뉴에서 HTTP 게시 유틸리티에 액세스할 수 있습니다. 프로그램 > IBM > Cast Iron Studio > HTTP 게시 유틸리티 옵션을 선택하십시오. 인바운드 커넥터 필드의 URL에 지정하는 URL에는 전체 URL이 포함되어야 합니다(예: http://myAR:myPort/myPath).



피드백 | 주의사항


시간소인 아이콘 마지막 업데이트 날짜: 2013년 11월 6일 수요일