JavaCompute 노드

이 주제는 다음 절을 포함합니다.

목적

다음 작업 중 하나를 수행하려면 JavaCompute 노드를 사용합니다.

  • 들어오는 메시지를 조사하고 컨텐츠에 따라 변경되지 않은 상태로 노드의 두 출력 터미널 중 하나로 전달합니다. 노드는 Filter 노드와 유사한 방법으로 작동하지만 사용할 출력 터미널을 결정하기 위해 ESQL 대신 Java를 사용합니다.
  • 들어오는 메시지의 부분을 변경하고 변경된 메시지를 출력 터미널 중 하나로 전달합니다.
  • 전체적으로 입력 메시지와 전혀 관계가 없는 새 출력 메시지를 작성 및 빌드합니다.

노드에 사용되는 Java 코드는 Eclipse Java 프로젝트에 저장됩니다.

JavaCompute 노드는 Workbench에서 다음 아이콘으로 표시됩니다.

Compute 노드 아이콘

메시지 플로우에서 노드 사용

JavaCompute 노드는 다음의 세 가지 방법으로 사용할 수 있습니다.

  • JavaCompute 노드를 사용하여 메시지를 살펴보고 메시지 컨텐츠를 기준으로 메시지를 출력 터미널로 전달하십시오. 메시지 컨텐츠는 변경되지 않으며 메시지에 대해 읽기 전용 액세스를 갖습니다.
  • JavaCompute 노드를 사용하여 메시지를 수정하고 수정된 메시지를 출력 터미널로 전달하십시오.
  • JavaCompute 노드를 사용하여 새 메시지를 작성하고 새 메시지를 출력 터미널로 전달하십시오.

Message Brokers Toolkit샘플 갤러리에 있는 샘플을 보십시오.

JavaCompute 노드 구성

메시지 플로우에서 발생하는 JavaCompute 노드의 각 인스턴스를 구성할 수 있습니다.

노드를 구성하려면 편집기 보기에서 노드를 마우스 오른쪽 단추로 누르십시오. Java 열기 옵션이 표시됩니다. 이 등록 정보를 누르십시오.

처음 수행할 경우에는 새 Java 프로젝트와 일부 스켈레톤 코드가 있는 Java 클래스를 작성하는 과정을 안내하는 마법사가 시작됩니다. 이 스켈레톤 코드는 Java 편집기에 표시됩니다.

제공되는 스켈레톤 코드 또는 템플리트 예는 JavaCompute 노드용 Java 코드 작성을 참조하십시오.

처음 수행하는 경우가 아니면 Java 처리 Perspective에 Java 코드가 표시됩니다.

JavaCompute 노드의 인스턴스를 Java 클래스와 연관시키려면 메시지 플로우의 편집기 보기에서 노드를 마우스 오른쪽 단추로 누른 후 등록 정보기본을 차례로 선택하십시오. 노드의 기본 등록 정보가 표시됩니다.

JavaCompute 노드는 단 하나의 기본 등록 정보를 가지고 있습니다. 이 등록 정보는 Java 클래스입니다. 이 노드에서 사용되는 Java 클래스의 이름을 입력하십시오. 이 이름은 메시지 플로우 프로젝트의 프로젝트 참조에서 사용 가능한 JavaCompute 노드 클래스 목록에 있어야 합니다.

값을 입력해야 하는 모든 필수 등록 정보(정의된 디폴트 값이 없는 등록 정보)는 등록 정보 대화 상자에서 별표(*)로 표시됩니다.

구성을 완료했으면 적용을 누르십시오. 그러면 등록 정보 대화 상자를 닫지 않고도 JavaCompute 노드를 변경할 수 있습니다.

또는 확인을 누르십시오. 그러면 JavaCompute 노드에 대한 변경이 수행되고 등록 정보 대화 상자가 닫힙니다.

취소를 눌러 대화 상자를 닫고 노드에 대해 수행한 모든 변경을 제거할 수도 있습니다.

Java 지정

JavaCompute 노드의 작동을 사용자 정의하려면 Java 문을 코딩하십시오.

입력 메시지나 데이터베이스 컨텐츠(변경되지 않았거나 수정됨) 또는 새 데이터를 사용하여 새 출력 메시지 또는 메시지를 작성하기 위해 사용자 정의할 수 있습니다. 예를 들어, 데이터베이스의 값을 추가하여 입력 메시지의 값을 수정한 다음 결과를 출력 메시지의 필드에 저장하고자 할 수 있습니다.

JavaCompute 노드와 연관된 Java 파일에 원하는 Java 문을 코딩하십시오.

Java 파일이 아직 이 노드에 존재하지 않으면, JavaCompute 노드를 마우스 오른쪽 단추로 누른 다음 Java 열기를 누르십시오. 그러면 새 Java 파일이 작성되어 편집기 보기에서 열립니다.

파일이 이미 존재하면 Java 클래스 등록 정보 옆에 있는 찾아보기 단추를 누르십시오. 그러면 이 메시지 플로우에서 액세스 가능한 Java 클래스를 나열하는 JavaCompute 노드 유형 선택 대화 상자가 표시됩니다. 적절한 Java 클래스를 선택한 후 확인을 누르십시오. 일치 유형 목록은 선택 필드에 최소한 한 문자를 입력할 경우에 적합한 Java 클래스를 표시합니다.
주: 선택 필드에 '*'를 입력할 경우 모든 Java 클래스가 표시됩니다.

메시지 유효성 검증

JavaCompute 노드에서 생성되는 메시지의 유효성을 검증할 방법을 정의하려면 유효성 검증 등록 정보를 설정하십시오. 이 등록 정보는 입력 메시지의 유효성 검증은 수행하지 않습니다. 입력 메시지의 유효성 검증이 필요할 경우 입력 노드나 이전의 Validation 노드에 의해 이미 유효성 검증이 수행되었을 것입니다.

자세한 정보는 메시지 유효성 검증MRM 도메인에서 메시지의 유효성 검증 등록 정보를 참조하십시오.

터미널 및 등록 정보

다음 표에는 JavaCompute 노드 터미널이 설명되어 있습니다.

터미널 설명
In 노드가 처리할 메시지를 승인하는 입력 터미널.
Failure 처리 중에 실패가 감지될 경우 입력 메시지가 라우트될 출력 터미널. (유효성 검증 등록 정보가 설정되었더라도 노드의 failure 터미널로 전달된 메시지는 유효성이 검증되지 않습니다.)
Out 변환된 메시지가 라우트될 출력 터미널.
Alternate Out 터미널 대신 전송된 메시지를 라우트할 수 있는 대체 출력 터미널.

다음 표에는 노드 등록 정보가 설명되어 있습니다. 앞에 M이 표시된 열은 등록 정보가 필수임을 나타내며(디폴트가 정의되지 않았을 때 값을 입력해야 하는 경우 등록 정보 대화 상자에 별표(*)로 표시됨) 앞에 C가 표시된 열은 등록 정보가 구성 가능함을 나타냅니다(메시지 플로우를 Bar 파일에 추가하여 전개할 때 값을 변경할 수 있음).

다음 표에는 JavaCompute 노드의 기본 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
Java 클래스 아니오 없음 이 노드에 사용되는 Java 클래스의 이름. 이 이름은 사용 가능한 Java 클래스 목록에 있어야 합니다.

다음 표에는 JavaCompute 노드의 유효성 검증 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
유효성 검증 없음 유효성 검증의 발생 여부와 유효성을 검증할 메시지의 부분. 올바른 값은 없음, 컨텐츠 및 값, 컨텐츠상속입니다.
실패 조치 아니오 예외 유효성 검증 실패가 발생할 경우에 취할 조치. 유효성 검증컨텐츠 또는 컨텐츠 및 값으로 설정한 경우에만 이 등록 정보를 설정할 수 있습니다. 올바른 값은 사용자 추적, 로컬 오류 로그, 예외예외 목록입니다.
모든 값 제한조건 포함 아니오 선택 이 등록 정보는 편집할 수 없습니다. 선택하는 선택란이 표시하는 디폴트 조치는 유효성 검증에 모든 값 제한조건이 포함되는 것입니다.
수정사항 아니오 없음 이 등록 정보는 편집할 수 없습니다. 최소 수정이 제공됩니다. 올바른 값은 없음전체입니다.

다음 표에는 JavaCompute 노드의 일반 메시지 옵션 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
구문 분석 타이밍 아니오 요청시 이 등록 정보는 입력 메시지를 구문 분석하는 시기를 제어합니다. 올바른 값은 요청시, 즉시완료입니다.

이 등록 정보에 대한 자세한 설명은 요청시 구문 분석을 참조하십시오.

MQRFH2 도메인에 MQRFH2C 압축 구문 분석기 사용 아니오 아니오 False 이 등록 정보는 MQRFH2 헤더에 MQRFH2 구문 분석기 대신 MQRFH2C 압축 구문 분석기를 사용하는지 여부를 제어합니다.

다음 표에는 JavaCompute 노드의 XMLNSC 구문 분석기 옵션 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
XMLNS 도메인에 XMLNSC 압축 구문 분석기 사용 지우기 아니오 변경 시작이 등록 정보를 설정하는 것은 보내는 MQRFH2가 XMLNSC 구문 분석기 대신 XMLNS를 지정하도록 하므로, 나머지 외부 응용프로그램을 변경하지 않을 수 있습니다. 보내는 메시지가 MQRFH2 헤더를 포함하고 있지 않으면 이 등록 정보는 아무런 영향을 미치지 않습니다. 변경 끝
혼합 컨텐츠 보유 모드 아니오 없음 이 등록 정보는 XMLNSC 구문 분석기가 입력 메시지에서 혼합 텍스트를 발견할 경우 메시지 트리에서 요소를 작성하는지 여부를 제어합니다. 올바른 값은 없음모두입니다. 모두를 선택하면 혼합 텍스트에 대해 요소가 작성됨을 의미합니다. 없음을 선택하면 혼합 텍스트가 무시되고 요소가 작성되지 않음을 의미합니다.
주석 보유 모드 아니오 없음 이 등록 정보는 XMLNSC 구문 분석기가 입력 메시지에서 주석을 발견할 경우 메시지 트리에서 요소를 작성하는지 여부를 제어합니다. 올바른 값은 없음모두입니다. 모두를 선택하면 주석에 대해 요소가 작성됨을 의미합니다. 없음을 선택하면 주석이 무시되고 요소가 작성되지 않음을 의미합니다.
처리 지시사항 보유 모드 아니오 없음 이 등록 정보는 XMLNSC 구문 분석기가 입력 메시지에서 처리 지시사항을 발견할 경우 메시지 트리에서 요소를 작성하는지 여부를 제어합니다. 올바른 값은 없음모두입니다. 모두를 선택하면 처리 지시사항에 대해 요소가 작성됨을 의미합니다. 없음을 선택하면 처리 지시사항이 무시되고 요소가 작성되지 않음을 의미합니다.

다음 표에는 JavaCompute 노드의 설명 등록 정보가 설명되어 있습니다.

등록 정보 M C 디폴트 설명
간단한 설명 아니오 아니오   노드에 대한 간략한 설명.
자세한 설명 아니오 아니오   메시지 플로우에서 노드의 목적을 설명하는 텍스트.
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
ac20805_