WebSphere Enterprise Service Bus, 버전 6.2.0 운영 체제: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


메시지 요소 Setter 중개 기본요소

메시지의 컨텐츠를 설정하려면 메시지 요소 Setter 중개 기본요소를 사용하십시오.

소개

메시지 요소 Setter 중개 기본요소는 메시지 컨텐츠 설정을 위한 단순한 메커니즘을 제공합니다. 중개 기본요소 특성을 설정하여 메시지 요소를 추가, 변경 또는 삭제할 수 있습니다. 메시지 요소 Setter 기본은 메시지 유형을 변경하지 않습니다.

여러가지 메시지 변경이 가능합니다. 변경은 순차적으로 일어나므로 요소는 서로 간에 빌드됩니다.

메시지 요소 Setter 중개 기본은 하나의 입력 터미널(in), 하나의 출력 터미널(out) 및 실패 터미널(fail)을 갖습니다. in 터미널은 메시지를 승인하도록 연결되고 다른 터미널은 메시지를 전달하도록 연결됩니다. 중개가 성공하는 경우 out 터미널이 수정된 메시지를 전달합니다. 변환 중에 예외가 발생하는 경우 fail 터미널은 failinfo 요소에 들어 있는 모든 예외 정보와 함께 원래 메시지를 전달합니다.

세부사항

대상 요소를 상수값이나 입력 서비스 메시지 오브젝트(SMO)에서 복사되는 값으로 설정할 수 있습니다. 지정하는 대상 요소가 존재하지 않는 경우, SMO에서 작성됩니다. 또한 메시지 요소가 선택적 또는 반복 요소인 경우 해당 요소를 삭제할 수 있습니다.

대상 요소는 대상 특성을 사용하여 XPath 표현식으로 지정됩니다. 대상 요소를 상수 값으로 설정하는 경우, 대상 XPath가 SMO 노드의 단일 리프로 해석되어야 합니다. 소스 요소로부터 대상 요소를 설정하는 경우, 소스 및 대상 XPath가 단일 요소(단일 리프 또는 서브트리)로 해석되어야 합니다.

사용법

정의하는 조작이 순서대로 일어나기 때문에 후속 조작은 이전 조작에 따라 다를 수 있습니다. 예를 들어, 새 요소를 SMO로 복사하는 복사 조작과 값을 새 요소로 설정하는 후속 조작을 정의할 수 있습니다.

종종 메시지 요소 Setter 중개 기본을 다른 중개 기본과 결합하는 것이 유용합니다. 예를 들어, 데이터베이스 찾아보기 중개 기본이 호출되기 전이나 후에 데이터를 조작해야 하는 경우 메시지 요소 Setter 중개 기본을 사용할 수 있습니다.

또한 메시지 필터 중개 기본을 사용하여 메시지를 필터링한 후 메시지 요소 Setter 중개 기본을 사용하여 메시지를 변경할 수 있습니다. 필터링 후 특정 메시지 요소를 갱신하거나 삭제하기 원할 수 있습니다.

특성

메시지 요소

추가, 변경, 삭제하려는 메시지의 요소입니다.

메시지 요소 갱신을 지정하려면 WebSphere® Integration Developer에서 추가를 클릭합니다. 갱신을 정의하면 메시지 요소 테이블에 나타납니다. 테이블에서 메시지 요소를 위/아래로 움직여 메시지 요소 갱신이 일어나는 순서를 변경할 수 있습니다.

조치
메시지를 변경하려는 방식을 말합니다. 조치에는 설정, 복사, 추가 또는 삭제가 있습니다. 사용자가 선택한 조치에 따라 WebSphere Integration Developer 분할창에서 다른 특성을 설정할 수 있습니다. 기본 조치는 설정입니다. 설정, 복사추가 조치는 필요에 따라 새 요소를 작성합니다.
  • 설정을 사용하면 대상 요소를 상수 값으로 설정할 수 있습니다 ( 속성에서 지정).
  • 복사를 사용하면 소스 요소에서 대상 요소로 복사할 수 있습니다.
    주: 소스 데이터 유형은 대상 데이터 유형과 호환 가능한지 또는 런타임 예외가 발생하지 않는지 확인해야 합니다.
  • 추가를 사용하면 결과물에서 반복되는 요소에 추가함으로써 복사 원본에서 새 요소 인스턴스로 복사할 수 있습니다. 출력에서 반복되는 요소에만 추가할 수 있습니다.
    주: 소스 데이터 유형은 대상 데이터 유형과 호환 가능한지 또는 런타임 예외가 발생하지 않는지 확인해야 합니다.
  • 삭제를 사용하면 SMO에서 요소 인스턴스를 삭제할 수 있습니다.
    주: 선택적 요소나 반복되는 요소에만 삭제를 시도해야 합니다.
대상
추가, 변경 또는 삭제하려는 요소를 식별하는 XPath 1.0 표현식입니다 (예: /body/GetAddress/Name).

대상 요소를 상수 값으로 설정하려면, 대상 XPath 표현식이 단일 리프 요소로 해석되어야 합니다. 소스 요소에서 대상 요소로 복사하려면 소스 및 대상 모두 단일 메시지 요소(단일 리프 또는 서브트리)로 해석되는 XPath 표현식을 지정해야 합니다.

다중 대상을 설정하는 경우, 갱신은 순서대로 일어납니다. 그러므로, 값 13에서 값 14로 요소 X를 설정하고 요소 Y를 요소 X의 값으로 설정하는 경우, 중개가 요소 X를 값 14로, 요소 Y를 값 14로 설정합니다.

동일한 대상 요소를 두 번 이상 지정하는 경우 대상 요소에 수행된 마지막 조작이 우선권을 갖습니다.

유형
요소 값의 유형입니다.

대상을 상수 값으로 설정하려면 유형은 단순 XML 스키마 유형 또는 단순 XML 스키마 유형을 확장하는 XML 스키마 유형이어야 합니다.

조치 특성이 설정인 경우, 특성을 사용하여 상수값을 지정할 수 있습니다.
주: 유형 특성은 호환 가능해야 합니다. 예를 들어, 유형이 XML 스키마 유형 int인 경우, 14일 수 있지만 GoldAccount일 수는 없습니다.
소스
조치 특성이 복사 또는 추가로 설정되는 경우, 소스 특성은 소스 요소를 식별하는 XPath 1.0 표현식이어야 합니다.
입력 유효성 검증
true인 경우, 중개가 수행되기 전에 입력 메시지가 유효성 검증됩니다.
표 1. 메시지 요소 Setter 중개 기본 특성
특성 유효값 기본값
메시지 요소 조치 설정, 복사, 추가 또는 삭제 세트
대상 XPath 표현식  
유형 데이터 유형  
유형 특성과 호환 가능한 값
주: 설정에만 사용됩니다.
 
소스 XPath 표현식
주: 복사 또는 추가에만 사용됩니다.
 
입력 유효성 검증 부울: true 또는 false false

고려사항

메시지 요소 Setter 중개 기본을 사용할 때 다음을 고려하십시오.


reference 참조 주제

이용약관 | 피드백


시간소인 아이콘 마지막 갱신 날짜: 09 7월 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/ref/rwesb_MessageElementSettermediationprimitive.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
이 Information Center는 Eclipse 기술로 구현됩니다. (http://www.eclipse.org)