javax.xml.ws
인터페이스 LogicalMessage

public interface LogicalMessage

LogicalMessage 인터페이스는, 프로토콜에 사로 잡히지 않는 XML 메세지를 표현해, 메세지의 유료 하중에의 액세스를 제공하는 메소드를 포함합니다.

도입된 버젼:

JAX-WS 2.0

메소드의 개요

Source	getPayload () XML 소스로서 메세지의 유료 하중을 가져옵니다.
Object	getPayload (JAXBContext context) JAXB 객체로서 메세지 유료 하중을 가져옵니다.
void	setPayload (Object payload, JAXBContext context) 메세지의 유료 하중을 설정합니다.
void	setPayload (Source payload) 메세지의 유료 하중을 설정합니다.

메소드의 상세

getPayload

Source  getPayload()

XML 소스로서 메세지의 유료 하중을 가져옵니다. 같은 LogicalMessage 인스턴스에 대해서 여러 차례 불려 가는 일도 있어, 메세지 유료 하중 전체를 취득하기 위해서 사용할 수 있는 새로운 Source 를 항상 돌려줍니다.

반환값의 Source 가 DOMSource 인스턴스의 경우, 캡슐화된 DOM 트리를 변경한다고 메세지 유료 하중이 인프레이스로 변경되어 다음에 setPayload 를 호출할 필요가 없습니다. 다른 형태의 Source 는, 메세지 유료 하중에의 읽어내 액세스만을 제공합니다.

반환값:

포함 하는 메세지 유료 하중, 이 메세지에 유료 하중이 없는 경우, null 를 돌려준다

setPayload

void setPayload(Source  payload)

메세지의 유료 하중을 설정합니다.

파라미터:

payload - 메세지의 유료 하중

예외:

WebServiceException - 이 메세지의 유료 하중의 설정중에 에러가 발생했을 경우

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

getPayload

Object  getPayload(JAXBContext  context)

JAXB 객체로서 메세지 유료 하중을 가져옵니다. 반환값의 객체와 메세지 유료 하중의 사이에 아무 관계도 없는 경우, 유료 하중을 변경하기 위해서 setPayload 를 호출할 필요가 있습니다.

파라미터:

context - 메세지 유료 하중을 비정렬화하기 위해서(때문에) 사용하는 JAXBContext

반환값:

포함 하는 메세지 유료 하중. 이 메세지에 유료 하중이 없는 경우는 null 를 돌려준다

예외:

WebServiceException - 유료 하중을 비정렬화하기 위해서(때문에) 제공된 JAXBContext 의 사용시에 에러가 발생했을 경우. WebServiceException 의 원인은, 원의 JAXBException

setPayload

void setPayload(Object  payload,
                JAXBContext  context)

메세지의 유료 하중을 설정합니다.

파라미터:

payload - 메세지 유료 하중

context - 유료 하중을 정렬화하기 위해서(때문에) 사용해야 할 JAXBContext

예외:

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

WebServiceException - 유료 하중을 정렬화하기 위해서(때문에) 제공된 JAXBContext 의 사용시에 에러가 발생했을 경우. WebServiceException 의 원인은, 원의 JAXBException