43.3. 논리 처리기에서 메시지 처리

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

handleMessage() 메서드는 메시지 본문에 대한 액세스 및 메시지 컨텍스트에 저장된 모든 속성에 대한 액세스를 제공하는 LogicalMessageContext 개체를 수신합니다.

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

논리 메시지 처리기로 전달된 LogicalMessageContext 개체를 사용하면 컨텍스트의 getMessage() 메서드를 사용하여 메시지 본문에 액세스할 수 있습니다. 예 43.2. “논리 처리기에서 메시지 페이로드를 가져오는 방법” 에 표시된 getMessage() 메서드는 메시지 페이로드를 LogicalMessage 오브젝트로 반환합니다.

LogicalMessage 개체가 있으면 이를 사용하여 메시지 본문을 조작할 수 있습니다. 예 43.3. “논리 메시지 홀더” 에 표시된 논리 메시지 인터페이스에는 실제 메시지 본문으로 작업하기 위한 getECDSA 및 set zone이 있습니다.

논리 메시지의 한 쌍과 setexports는 javax.xml.transform.dom.DOMSource 개체로 메시지 페이로드와 함께 작동합니다.

매개 변수가 없는 getPayload() 메서드는 message payload를 192.0.2. Source 개체로 반환합니다. 반환된 오브젝트는 실제 메시지 페이로드입니다. 반환된 오브젝트의 변경 사항은 메시지 본문을 즉시 변경합니다.

단일 Source 개체를 사용하는 setPayload() 메서드를 사용하여 message의 본문을 192.0.2.Source 개체로 교체할 수 있습니다.

다른 한 쌍의 getter 및 setter를 사용하면 메시지 페이로드를 a CryostatB 오브젝트로 사용할 수 있습니다. 메시지 페이로드를 CryostatB 오브젝트로 변환하는 데 CryostatBContext 오브젝트를 사용합니다.

CryostatB 오브젝트를 사용하려면 다음을 수행합니다.

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

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

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

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

메시지가 처리기 체인을 통과하는 방향을 아는 것이 종종 중요합니다. 예를 들어 들어오는 요청에서 보안 토큰을 검색하고 발신 응답에 보안 토큰을 연결해야 합니다.

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

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

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

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

예 43.7. “논리 메시지 처리기 메시지 처리” 서비스 소비자가 사용하는 논리 메시지 처리기에 대한 handleMessage() 메시지의 구현을 보여줍니다. 요청을 서비스 공급자로 보내기 전에 처리합니다.

public class SmallNumberHandler implements LogicalHandler<LogicalMessageContext>
{
    public final boolean handleMessage(LogicalMessageContext messageContext)
    {
        try
        {
            boolean outbound = (Boolean)messageContext.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);

            if (outbound)
            {
                LogicalMessage msg = messageContext.getMessage();

                JAXBContext jaxbContext = JAXBContext.newInstance(ObjectFactory.class);
                Object payload = msg.getPayload(jaxbContext);
                if (payload instanceof JAXBElement)
                {
                    payload = ((JAXBElement)payload).getValue();
                }

                if (payload instanceof AddNumbers)
                {
                    AddNumbers req = (AddNumbers)payload;

                    int a = req.getArg0();
                    int b = req.getArg1();
                    int answer = a + b;

                    if (answer < 20)
                    {
                      AddNumbersResponse resp = new AddNumbersResponse();
                      resp.setReturn(answer);
                      msg.setPayload(new ObjectFactory().createAddNumbersResponse(resp),
                                                      jaxbContext);

                      return false;
                    }
                }
                else
                {
                   throw new WebServiceException("Bad Request");
                }
            }
            return true;
        }
        catch (JAXBException ex)
        {
            throw new ProtocolException(ex);
        }
    }
...
}

예 43.7. “논리 메시지 처리기 메시지 처리” 의 코드는 다음을 수행합니다.

메시지가 아웃바운드 요청인지 확인합니다.

메시지가 아웃바운드 요청인 경우 처리기는 추가 메시지 처리를 수행합니다.

메시지 컨텍스트에서 메시지 페이로드의 LogicalMessage 표현을 가져옵니다.

실제 메시지 페이로드를 가져옵니다.

요청이 올바른 유형인지 확인합니다.

이 경우 처리기는 메시지를 계속 처리합니다.

합계 값을 확인합니다.

임계값이 20 미만이면 응답을 작성하고 클라이언트에 반환합니다.

응답을 빌드합니다.

false를 반환하여 메시지 처리를 중지하고 클라이언트에 대한 응답을 반환합니다.

메시지가 올바른 유형이 아닌 경우 런타임 예외를 throw합니다.

이 예외는 클라이언트에 반환됩니다.

메시지가 인바운드 응답이거나 합계가 임계값을 충족하지 않는 경우 true를 반환합니다.

메시지 처리가 정상적으로 계속됩니다.

CryostatB marshalling 오류가 발생하는 경우 ProtocolException이 발생합니다.

예외는 현재 처리기와 클라이언트 간의 처리기에서 처리한 후 클라이언트에 다시 전달됩니다.