중개 기본요소 특성 설정

중개 기본요소는 메시지를 허용하고 처리하여 해당 메시지의 형식, 컨텐츠 또는 대상 서비스 제공자를 바꿀 수 있도록 해줍니다. 중개 기본요소에는 메시지 처리 방법을 결정하는 특성이 있습니다. 중개 플로우 편집기에서 플로우 연결 시, 노드의 특성 및 중개 기본요소를 수정할 수 있습니다.

팁: 중개 기본요소의 입력 및 출력 터미널을 연결한 다음 특성을 설정하십시오. 이로써 편집기에 입력 및 출력 메시지 유형을 알리고 특성 설정 시 시간을 덜 수 있습니다.

이 주제에서는 중개 기본요소의 특성에 대해 설명합니다. 입력 노드는 특성 보기에서 설정할 수 있는 특성을 가진 유일한 노드이므로 이 문서에서 다루어 집니다.

입력 노드

입력 노드는 연결되어 있는 노드 또는 기본요소에 메시지를 전달합니다. 메시지 컨텍스트에 저장될 특성은 입력 노드의 특성 보기 세부사항 페이지에 지정됩니다. 중개 기본요소는 나중에 플로우에서 해당 특성에 액세스할 수 있습니다.


입력 노드

다음은 입력 노드의 세부사항 페이지 특성에 대한 이미지입니다.


입력 세부사항

  • 상관 컨텍스트는 요청 및 응답 플로우와 함께 지속된 비즈니스 오브젝트를 지정합니다. 상관 컨텍스트는 요청 플로우의 입력 노드에 지정되고 요청 플로우에서 응답 플로우로 값을 전달하는 데 사용합니다. 비즈니스 오브젝트를 선택하려면 찾아보기를, 필드를 지우려면 재설정을 클릭하십시오.
  • 임시 컨텍스트는 현재 플로우(요청 플로우 또는 응답 플로우) 지속 기간에 사용할 수 있는 비즈니스 오브젝트를 지정합니다. 임시 컨텍스트는 요청 플로우의 입력 노드에 지정되며, 동일한 플로우에 있는 중개 기본요소 간에 값을 전달하는 데 사용합니다. 비즈니스 오브젝트를 선택하려면 찾아보기를, 필드를 지우려면 재설정을 클릭하십시오.

XSL 변환

XSL 변환 기본요소는 소스 및 대상 메시지 유형 간을 맵핑하는 XSL 스타일시트에 따라 메시지를 변환합니다.


XSL 변환 노드

다음은 XSL 변환 기본요소의 세부사항 페이지 특성에 대한 이미지입니다.

XSL 변환 세부사항

루트 필드에서 XPath 1.0 식을 선택하여 변환에 사용할 수 있는 메시지 파트를 식별합니다.

맵핑 파일 필드에서:

연관된 XSL 필드에서:

입력 유효성 검증 선택란을 선택하면 입력 메시지 유효성 검증을 사용하여 런타임에 해당 메시지 유형 정의와 일치하는지 확인할 수 있습니다. 성능이 우려되면 이 선택란을 선택 취소하여 유효성 검증을 사용하지 마십시오.

메시지 로거

메시지 로거 기본요소는 앞으로 할 검색 또는 감사용 데이터베이스에 메시지 사본을 로그합니다.


메시지 로거 노드

메시지 로거 기본요소의 세부사항 페이지 특성에 대한 이미지가 있습니다.


메시지 로거 세부사항
  • 데이터 소스 이름 데이터가 로그될 위치를 정의하는 데이터 소스의 JNDI 이름. 기본 데이터 소스는 jdbc/mediation/messageLog입니다.
  • 루트는 로그될 메시지 파트를 지정합니다. 로그될 메시지는 루트 필드에 지정된 위치에서 XML로 전환됩니다. 다음 옵션 중 하나를 선택하십시오.
    • /는 전체 메시지를 로그합니다.
    • /body는 메시지의 본문 섹션을 로그합니다.
    • /headers는 메시지 헤더를 로그합니다.
    • /context는 메시지 컨텍스트를 로그합니다.
    • 사용자 정의 XPathXPath 식 빌더를 실행합니다. 이 위치에서 XPath 식을 지정할 수 있습니다.
  • 트랜잭션 모드는 데이터베이스의 변경사항이 확약될 트랜잭션을 정의합니다. 이 특성만이 글로벌 트랜잭션에 적용됩니다. 기본적으로 중개 플로우 컴포넌트의 트랜잭션은 글로벌이 아닙니다. 중개 플로우 컴포넌트의 트랜잭션을 글로벌로 설정하려면 어셈블리 편집기의 컴포넌트 구현 페이지에서 규정자 특성을 설정하십시오. 다음 옵션 중 하나를 선택하십시오.

    • Same은 해당 플로우 인스턴스의 트랜잭션에서 메시지를 로그합니다. 나중에 플로우에서 실패가 발생하면 로그는 데이터베이스에 확약되지 않습니다. 요청 및 응답 플로우 마다 트랜잭션이 있습니다.
    • 새로 작성은 새 트랜잭션에서 메시지를 로그합니다. 플로우의 트랜잭션은 일시중단되고 새 트랜잭션이 작성되어 메시지를 저장합니다. 그런 다음 새 트랜잭션이 확약되고 플로우의 트랜잭션이 다시 시작됩니다. 나중에 플로우에 실패가 발생하면 메시지 로깅은 롤백되지 않습니다.

메시지 필터

메시지 필터 기본요소는 메시지 컨텐츠를 구성한 XPath 1.0 식과 비교하여 그 결과에 기초해 다음 중개 기본요소로 메시지의 경로를 정합니다. 출력 터미널을 추가하고, 구성한 XPath 식과 해당 터미널을 연관시킵니다.


메시지 필터 노드

터미널

다음 방법 중 하나로 출력 터미널을 메시지 필터에 추가할 수 있습니다.
  • 중개 플로우 캔버스에서 기본요소를 선택하고 마우스 오른쪽 단추를 클릭하여 아래와 같이 출력 터미널 추가를 선택하십시오.
    메시지 필터: 기본요소의 컨텍스트 메뉴에서 출력 터미널
추가
  • 특성 보기의 터미널 페이지로 전환하십시오. 터미널 목록에서 출력 터미널을 선택하고 오른쪽 마우스 단추를 클릭하여 아래 그림과 같이 출력 터미널 추가를 선택하십시오.
    메시지 필터: 특성 보기에서 출력 터미널 추가
:

세부사항

예제를 사용하여 메시지 필터 기본요소에 해당하는 특성 보기 세부사항 페이지에서 특성 사용을 표시할 수 있습니다. 예제에서 메시지 본문의 subscriptionLevel 필드값이 고급이면 입력 메시지는 실시간이라는 터미널에 전달됩니다. 다음 이미지는 예제를 위해 설정된 특성을 표시합니다.


메시지 필터 세부사항

필터 테이블에서 중개 기본요소에 의해 실행되는 필터링을 정의하십시오. 표의 각 행에서는 패턴과 터미널 이름을 연관시키는 필터 오브젝트를 표시합니다.

참고: 필터 순서는 위로 단추 및 아래로 단추를 사용하여 변경할 수 있습니다. 분배 모드 특성을 사용하여 동작과 일치하는 패턴을 제어할 수 있습니다.

분배 모드 필드에서 둘 이상의 패턴이 올바른 것으로 평가되면 필요한 동작을 지정하십시오.

터미널이 메시지와 일치하지 않으면 메시지는 기본 터미널로 전달됩니다.

데이터베이스 참조

데이터베이스 참조 기본요소는 데이터베이스에서 값을 검색하여 해당 값을 메시지에 저장합니다.


데이터베이스 참조
노드
예제를 사용하여 데이터베이스 참조 기본요소에 해당하는 특성 보기 세부사항 페이지에서 특성 사용을 표시할 수 있습니다. 예제에서 다음을 가정하십시오.
  • 직원의 serialNumber 049728 값은 클라이언트 응용프로그램에서 메시지 본문으로 전달됩니다.
  • serialNumber = '049728' 및 salary = '$50,000'을 포함한 EmployeeDatabase에 직원 레코드가 있습니다.
  • 데이터베이스의 레코드를 찾으려면 메시지의 일련 번호 필드를 사용하여 데이터베이스에서 직원 급여를 검색하려 합니다.
  • 그런 다음 데이터베이스에서 급여 값을 검색하고 해당 값을 메시지 본문에 추가하려 합니다.
다음은 해당 SQL 문입니다.

SERIAL_NUMBER = '049728'인 EMPLOYEE_TABLE에서 급여를 선택하십시오.

결과로 유형 길이 '50000'은 메시지 본문의 급여 필드에 저장됩니다.


데이터베이스
참조 세부사항

기본요소의 특성을 특성 보기 세부사항 페이지에 지정하십시오.

데이터 소스 이름 필드에서 데이터 소스의 JNDI 이름을 입력하십시오. 예제에서 jdbc/sample/EmployeeDatabase

표 이름 필드에 스키마 이름뿐 아니라 데이터베이스 표 이름도 입력하십시오. 예제에서 myschema.EMPLOYEE_TABLE

키 열 이름 필드에서 찾아보기에 사용할 데이터베이스 열 이름을 입력하십시오. 예제에서 해당 이름은 SERIAL_NUMBER입니다.

키 경로 필드에서 사용자 정의 XPath를 클릭하여 XPath 식 빌더를 실행한 후 XPath 식을 빌드하십시오. XPath 식에서 리턴된 값은 데이터베이스에서 키로 사용됩니다. 이 경우 해당 값은 메시지 본문에서 일련 번호(049728) 값입니다.

입력 유효성 검증 선택란을 선택하면 입력 메시지 유효성 검증을 사용하여 입력 메시지가 런타임에 해당 유형 정의와 일치하는지 확인할 수 있습니다. 성능이 우려되면 이 선택란을 선택 취소하여 유효성 검증을 사용하지 마십시오.

데이터 요소 표에서 값이 검색될 데이터베이스 열, 현재 정보 유형 및 검색된 값이 저장될 메시지 장소를 정의하십시오. 각 데이터 요소에는 세 가지 특성이 있습니다.

사용자 정의 중개

사용자 정의 중개 기본요소는 Java™ 코드를 사용하여 중개 로직을 구현하고 동일한 중개 모듈에서 가져오기를 호출하도록 해줍니다. .


사용자 정의 중개 노드

다음은 사용자 정의 중개 기본요소의 세부사항 페이지 특성에 대한 이미지입니다.


사용자 정의 중개 세부사항

정의를 클릭하여 기본요소가 호출 중인 컴포넌트에 대한 서비스 참조를 생성하는데 사용될 인터페이스 및 조작을 지정하십시오.

서비스 참조 필드는 Java 컴포넌트 또는 가져오기에 연결되는 중개 플로우 컴포넌트에서 참조 이름을 표시합니다. 작성되면 이 참조는 편집기의 조작 연결 섹션에서 대상 조작으로도 표시됩니다.

구현

아래와 같이 특성 보기의 구현 페이지에서 기본요소 구현을 지정하십시오.


사용자 정의 중개 세부사항

비주얼 단일 선택 단추를 선택하여 비주얼 스니펫 편집기에서 Java 코드를 구현하십시오. 식, 링크, 동작 및 스니펫 작성용 제어 노드를 어셈블하려면 팔레트의 옵션을 사용하십시오.

Java 단일 선택 단추를 선택하여 Java 스니펫 편집기에서 Java 코드를 구현하십시오. 메소드 서명 아래 텍스트 상자에 Java 코드를 입력하십시오.

열린 Java 편집기 단추를 클릭하여 Java 편집기를 실행하십시오. 이 옵션을 선택하면 앞으로 해당 사용자 정의 중개용 Java 스니펫 편집기 사용에 영향을 미칠 수 있음을 참고하십시오.

참고: Java 코드가 단순하거나 Java에 익숙하지 않은 경우, 비주얼 또는 Java 스니펫 편집기를 사용하십시오. 그렇지 않으면 Java 편집기를 사용하십시오.

중지

기본요소 중지를 사용하여 플로우 실행을 중지하십시오. 이는 예상한 종료이며 예외로 인해 발생되지는 않습니다.


중지
노드

해당 기본요소에 대해 지정되는 특성은 없습니다.

실패

실패 기본요소는 예외를 발생하고 중개 기본요소에서 실행 실패 발생 시 플로우 실행을 중지합니다.


실패 노드

특성 보기의 세부사항 페이지에서 기본요소의 특성을 지정하십시오.

오류 메시지 필드에서 예외에 추가된 오류 메시지를 입력하십시오.


실패 세부사항

피드백
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.