43.5. SOAP 핸들러에서 메시지 처리

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

handleMessage() 메서드는 메시지 본문에 대한 액세스를 SOAPMessage 개체 및 메시지와 연결된 SOAP 헤더로 제공하는 SOAPMessageContext 개체를 수신합니다. 또한 컨텍스트는 메시지 컨텍스트에 저장된 모든 속성에 대한 액세스를 제공합니다.

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

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

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

SOAPMessage 개체의 getHeader() 메서드를 사용하여 SOAP 메시지의 헤더에 액세스할 수 있습니다. 그러면 처리하려는 헤더 요소를 찾기 위해 검사해야 하는 SOAPHeader 개체로 SOAP 헤더가 반환됩니다.

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

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

헤더가 없으면 메서드가 빈 배열을 반환합니다.

JAXBContext 오브젝트를 인스턴스화하는 방법에 대한 자세한 내용은 39장. A JAXBContext 오브젝트 사용 을 참조하십시오.

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

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

기본적으로 논리 핸들러 내부에서 컨텍스트에서 설정한 모든 속성에는 HANDLER 의 범위가 할당됩니다. 애플리케이션 코드가 컨텍스트의 setScope() 메서드를 사용하여 속성 범위를 APPLICATION으로 명시적으로 설정하는 데 필요한 속성에 액세스할 수 있도록 하려면.

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

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

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

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

속성은 부울 오브젝트로 저장됩니다. 개체의 부울Value() 메서드를 사용하여 속성 값을 확인할 수 있습니다. 속성이 true로 설정되면 메시지는 아웃바운드입니다.If the property is set to true, the message is outbound. 속성이 false로 설정되면 메시지가 인바운드됩니다.If the property is set to false, the message is inbound.

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

예 43.12. “SOAP 핸들러에서 메시지 처리” shows a handleMessage() implementation that prints the SOAP 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. “SOAP 핸들러에서 메시지 처리” 의 코드는 다음을 수행합니다.

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

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

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

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