javax.xml.ws.handler.soap
인터페이스 SOAPMessageContext

모든 슈퍼 인터페이스:

Map <String ,Object >, MessageContext

public interface SOAPMessageContext
extends MessageContext 

인터페이스 SOAPMessageContext 는, RPC 요구 또는 응답의 SOAP 메세지에의 액세스를 제공합니다. javax.xml.soap.SOAPMessage 는, 첨부를 사용한 SOAP 1.1 메세지의 표현으로서 표준 Java API 를 지정합니다.

도입된 버젼:

JAX-WS 2.0

관련 항목:

SOAPMessage

상자의 클래스의 개요

인터페이스 javax.xml.ws.handler. MessageContext 로부터 상속된 상자의 클래스/인터페이스

MessageContext.Scope

인터페이스 java.util. Map 로부터 상속된 상자의 클래스/인터페이스

Map.Entry <K ,V >

필드의 개요

인터페이스 javax.xml.ws.handler. MessageContext 로부터 상속된 필드

HTTP_REQUEST_HEADERS , HTTP_REQUEST_METHOD , HTTP_RESPONSE_CODE , HTTP_RESPONSE_HEADERS , INBOUND_MESSAGE_ATTACHMENTS , MESSAGE_OUTBOUND_PROPERTY , OUTBOUND_MESSAGE_ATTACHMENTS , PATH_INFO , QUERY_STRING , SERVLET_CONTEXT , SERVLET_REQUEST , SERVLET_RESPONSE , WSDL_DESCRIPTION , WSDL_INTERFACE , WSDL_OPERATION , WSDL_PORT , WSDL_SERVICE

메소드의 개요

Object []	getHeaders (QName header, JAXBContext context, boolean allRoles) 메세지 문맥의 메세지로부터 특정의 수식명을 가지는 헤더를 가져옵니다.
SOAPMessage	getMessage () 이 메세지 문맥으로부터 SOAPMessage 를 가져옵니다.
Set <String >	getRoles () 핸들러 체인의 실행에 관련지을 수 있고 있는 SOAP actor 롤을 가져옵니다.
void	setMessage (SOAPMessage message) 이 메세지 문맥에 SOAPMessage 를 설정합니다.

인터페이스 javax.xml.ws.handler. MessageContext 로부터 상속된 메소드

getScope , setScope

인터페이스 java.util. Map 로부터 상속된 메소드

clear , containsKey , containsValue , entrySet , equals , get , hashCode , isEmpty , keySet , put , putAll , remove , size , values

메소드의 상세

getMessage

SOAPMessage  getMessage()

이 메세지 문맥으로부터 SOAPMessage 를 가져옵니다. 반환값의 SOAPMessage 를 변경하면(자), 메세지가 인프레이스로 변경되므로, 다음에 setMessage 를 호출할 필요가 없습니다.

반환값:

SOAPMessage 를 돌려준다. 이 메세지 문맥에 SOAPMessage 가 없는 경우, null 를 돌려준다

setMessage

void setMessage(SOAPMessage  message)

이 메세지 문맥에 SOAPMessage 를 설정합니다.

파라미터:

message - SOAP 메세지

예외:

WebServiceException - 이 메세지 문맥에 SOAPMessage 를 설정해 있는 도중에 에러가 발생했을 경우

UnsupportedOperationException - 이 조작이 지원되어 있지 않은 경우

getHeaders

Object [] getHeaders(QName  header,
                    JAXBContext  context,
                    boolean allRoles)

메세지 문맥의 메세지로부터 특정의 수식명을 가지는 헤더를 가져옵니다. SOAP 메세지에 같은 수식명을 가지는 복수의 헤더가 포함되는 경우가 있는 것에 주의해 주세요.

파라미터:

header - SOAP 헤더의 XML 수식명

context - 헤더를 비정렬화하기 위해서(때문에) 사용해야 할 JAXBContext

allRoles - true 의 경우, 모든 SOAP 롤의 헤더를 돌려주어,false 의 경우, SOAP 노드가 현재 실행하고 있는 롤을 타겟으로 한 헤더만을 돌려준다. getRoles 를 참조

반환값:

비정렬화 되는 헤더의 배열. 메세지 문맥에 메세지가 없는 경우, 또는, 지정된 수식명에 일치하는 헤더가 없는 경우, 빈 상태(empty)의 배열을 돌려준다

예외:

WebServiceException - 지정된 JAXBContext 를 사용해 비정렬화할 때 에러가 발생했을 경우. WebServiceException 의 원인은, 원의 JAXBException

getRoles

Set <String > getRoles()

핸들러 체인의 실행에 관련지을 수 있고 있는 SOAP actor 롤을 가져옵니다. SOAP actor 롤은 SOAP 노드에 적용되어SOAPBinding.setRoles 및 SOAPBinding.getRoles 를 사용해 관리되는 것에 주의해 주세요. 핸들러 체인내의 핸들러 인스턴스는, SOAP actor 롤에 대한 이 정보를 사용해 SOAP 헤더 블록을 처리합니다. 핸들러 체인을 통해 SOAP 메세지를 처리하고 있는 동안, SOAP actor 롤은 불변입니다.

반환값:

SOAP actor 롤의 캐릭터 라인 배열