43.5. Cryostat 처리기에서 메시지 처리

일반적인 메시지 처리는 handleMessage() 메서드에서 처리합니다.

handleMessage() 메서드는 메시지 본문에 대한 액세스를 제공하고 message와 연결된 Cryostat 헤더로 message 본문에 대한 액세스를 제공하는 Cryostat Message Context 오브젝트를 수신합니다. 또한 컨텍스트는 메시지 컨텍스트에 저장된 속성에 대한 액세스를 제공합니다.In addition, the context provides access to any properties stored in the message context.

handleMessage() 메서드는 메시지 처리를 계속 수행하는 방법에 따라 true 또는 false를 반환합니다. 또한 예외를 throw할 수도 있습니다.

Cryostat 메시지 컨텍스트의 getMessage() 메서드를 사용하여 Cryostat 메시지를 가져올 수 있습니다. 메시지를 라이브 Cryostat Message 오브젝트로 반환합니다. 처리기의 메시지에 대한 모든 변경 사항은 컨텍스트에 저장된 메시지에 자동으로 반영됩니다.

기존 메시지를 새 메시지로 교체하려면 컨텍스트의 setMessage() 메서드를 사용할 수 있습니다. setMessage() 메서드는 Cryostat Message 오브젝트 를 사용합니다.

Cryostat Message 개체의 getHeader() 메서드를 사용하여 Cryostat 메시지 의 헤더에 액세스할 수 있습니다. 이렇게 하면 처리하려는 헤더 요소를 찾기 위해 검사해야 하는 Cryostat Header 개체로 header 헤더가 반환됩니다.

Cryostat 메시지 컨텍스트는 예 43.10. “Cryo statMessageContext.getHeaders() 메서드” 에 표시된 getHeaders() 메서드를 제공하여 지정된 Cryostat 헤더에 대해 CryostatB 개체가 포함된 배열을 반환합니다.

해당 요소의 QName을 사용하여 헤더를 지정합니다. allRoles 매개변수를 false로 설정하여 반환된 헤더를 추가로 제한할 수 있습니다. 이는 활성 Cryostat 역할에 적용할 수 있는 Cryostat 헤더만 반환하도록 런타임에 지시합니다.

헤더가 없는 경우 메서드는 빈 배열을 반환합니다.

Cryostat BContext 오브젝트 인스턴스화에 대한 자세한 내용은 39장. A Cryo statBContext 오브젝트 사용 에서 참조하십시오.

논리 처리기에 전달된 Cryostat 메시지 컨텍스트는 애플리케이션 메시지 컨텍스트의 인스턴스이며 이 컨텍스트에 저장된 모든 속성에 액세스할 수 있습니다. 처리기는 APPLICATION 범위와 Handler 범위 모두에서 속성에 액세스할 수 있습니다.

애플리케이션의 메시지 컨텍스트와 마찬가지로 Cryostat 메시지 컨텍스트는 Java 맵의 하위 클래스입니다. 컨텍스트에 저장된 속성에 액세스하려면 Map 인터페이스에서 상속된 get() 메서드 및 put() 메서드를 사용합니다.

기본적으로 논리 처리기 내에서 컨텍스트에서 설정한 모든 속성에는 HANDLER의 범위가 할당됩니다.By default, any properties you set in the context from inside a logical handler will be assigned a scope of HANDLER. 애플리케이션 코드가 속성에 액세스하려면 컨텍스트의 setScope() 메서드를 사용하여 속성 범위를 명시적으로 APPLICATION으로 설정해야 합니다.

메시지 컨텍스트에서 속성 사용에 대한 자세한 내용은 42.1절. “컨텍스트 이해” 을 참조하십시오.

메시지가 처리기 체인을 통과하는 방향을 아는 것이 종종 중요합니다. 예를 들어 발신 메시지에 헤더를 추가하고 들어오는 메시지에서 헤더를 제거하려고 합니다.

메시지의 방향은 메시지 컨텍스트의 아웃바운드 메시지 속성에 저장됩니다. 예 43.11. “ESP 메시지 컨텍스트에서 메시지 방향 가져오기” 에 표시된 대로 MessageContext.MESSAGE_OUTBOUND_PROPERTY 키를 사용하여 메시지 컨텍스트에서 아웃바운드 메시지 속성을 검색합니다.

Boolean outbound;
outbound = (Boolean)smc.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);

속성은 부울 오브젝트로 저장됩니다. 개체의 booleanValue() 메서드를 사용하여 속성의 값을 확인할 수 있습니다. 속성이 true로 설정되면 메시지는 아웃바운드입니다. 속성이 false로 설정된 경우 메시지는 인바운드입니다.

handleMessage() 메서드가 메시지 처리를 완료하는 방법은 메시지 처리가 진행되는 방식에 직접적인 영향을 미칩니다. 다음 작업 중 하나를 수행하여 완료할 수 있습니다.

예 43.12. “Cryostat 처리기에서 메시지 처리” shows a handleMessage() implementation that print the message to the screen.

public boolean handleMessage(SOAPMessageContext smc)
{
  PrintStream out;

  Boolean outbound = (Boolean)smc.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);

  if (outbound.booleanValue())
  {
    out.println("\nOutbound message:");
  }
  else
  {
    out.println("\nInbound message:");
  }

  SOAPMessage message = smc.getMessage();

  message.writeTo(out);
  out.println();

  return true;
}

예 43.12. “Cryostat 처리기에서 메시지 처리” 의 코드는 다음을 수행합니다.

메시지 컨텍스트에서 아웃바운드 속성을 검색합니다.

메시지 방향을 테스트하고 적절한 메시지를 출력합니다.

컨텍스트에서 Cryostat 메시지를 검색합니다.

메시지를 콘솔에 출력합니다.