패키지 javax.xml.soap

SOAP 메세지의 작성과 구축을 실행하는 API 를 제공합니다.

참조처:
설명

인터페이스의 개요

Detail	DetailEntry 객체의 컨테이너입니다.
DetailEntry	SOAPFault 객체의 상세를 제공하는 Detail 객체의 컨텐츠입니다.
Name	XML 명의 표현입니다.
Node	XML 문서내의 노드 (요소)의 표현입니다.
SOAPBody	SOAP 메세지내의 SOAP 본체 요소의 컨텐츠를 나타내는 객체입니다.
SOAPBodyElement	SOAPBodyElement 객체는,SOAPBody 객체의 컨텐츠를 나타냅니다.
SOAPConstants	SOAP 프로토콜에 관련한 정수의 정의입니다.
SOAPElement	SOAP 메세지의 요소를 나타내는 객체입니다.
SOAPEnvelope	SOAPPart 객체의 SOAPHeader 와 SOAPBody 부분의 컨테이너입니다.
SOAPFault	에러 정보 또는 상태 정보, 혹은 그 양쪽 모두를 포함하는 SOAPBody 객체내의 요소입니다.
SOAPFaultElement	SOAPFault 객체내의 컨텐츠의 표현입니다.
SOAPHeader	SOAP 헤더 요소의 표현입니다.
SOAPHeaderElement	SOAP 포락선의 SOAP 헤더부의 컨텐츠를 표현하는 객체입니다.
Text	값이 텍스트인 노드의 표현입니다.

클래스의 개요

AttachmentPart	SOAPMessage 객체에의 개개의 첨부입니다.
MessageFactory	SOAPMessage 객체를 작성하는 팩토리입니다.
MimeHeader	MIME 헤더명과 그 값을 보존하는 객체입니다.
MimeHeaders	MimeHeader 객체의 컨테이너로, 메세지의 MIME 부분에 있는 MIME 헤더를 나타냅니다.
SAAJMetaFactory	SAAJ API 로 정의된 팩토리의 구현 클래스의 액세스 포인트입니다.
SAAJResult	SAAJ 트리 형식에서, JAXP 변환, 또는 JAXB 정렬화의 결과의 홀더로서 동작합니다.
SOAPConnection	클라이언트가 원격 측에 직접 메세지를 송신하는데 사용하는 point-to-point 접속입니다 (URL 등으로 표시).
SOAPConnectionFactory	SOAPConnection 객체를 작성하는 팩토리입니다.
SOAPElementFactory	추천 되고 있지 않습니다. - SOAPElement 의 작성에 javax.xml.soap.SOAPFactory 를 사용합니다.
SOAPFactory	SOAPFactory 는, SOAP XML 트리에 존재하는 다양한 객체를 작성하기 위한 팩토리입니다.
SOAPMessage	모든 SOAP 메세지의 루트 클래스입니다.
SOAPPart	SOAPMessage 객체의 SOAP 고유의 부분용의 컨테이너입니다.

예외의 개요

SOAPException

SOAP 예외가 발생한 것을 통지하는 예외입니다.

패키지 javax.xml.soap 의 설명

SOAP 메세지의 작성과 구축을 실행하는 API 를 제공합니다. 이 패키지는,SOAP with Attachments API for Java^TM (SAAJ) 1.3 의 스펙으로 정의되고 있습니다.

javax.xml.soap 패키지의 API 를 사용하면(자), 다음의 내용을 실행할 수 있습니다.

• 지정의 단 점에의 point-to-point 접속의 작성
• SOAP 메세지의 작성
• XML fragment의 작성
• SOAP 메세지의 헤더에 컨텐츠를 추가
• SOAP 메세지의 본문에 컨텐츠를 추가
• 첨부 부분의 작성과 그 첨부에의 컨텐츠의 추가
• SOAP 메세지 부분의 액세스, 추가, 수정
• SOAP 에러 정보의 작성, 추가, 수정
• SOAP 메세지로부터의 컨텐츠 추출
• SOAP 요구 응답 메세지의 송신

javax.xml.soap 패키지의 API 에 가세해org.w3c.dom 패키지의 내용도 확장됩니다. 이것은,SOAPMessage 의 SOAPPart 도 DOM Level 2 Document 로, DOM (자세한 것은 http://www.w3.org/DOM/ 를 참조)를 사용하는 어플리케이션이나 툴, 라이브러리등에서 조작할 수 있는 것을 의미합니다. DOM API 를 사용해 일반적으로의 DOM 노드를 SAAJ 트리에 추가할 수 있습니다만, SAAJ API 는 트리의 검사시 또는 조작시에, SAAJ 타입을 돌려줄 필요가 있습니다. 이 처리를 실행할 수 있도록(듯이), SAAJ API (SOAPElement.getChildElements() )에서는, 통지하는 일 없이 SAAJ 요건에 관련하는 부정한 형태의 객체를 필요한 형태의 객체에 옮겨놓을 수가 있습니다. 이 치환 처리에 의해, 트리의 논리 구조가 바뀔 것은 없습니다. 그 때문에, DOM API 의 트리도 변경될 것은 없습니다. 다만, 물리적인 트리 구조는 변경되기 (위해)때문에, 옮겨놓을 수 있었던 노드를 참조하는 경우, 벌써 트리 부분은 아니게 된 노드를 참조하게 됩니다. 이후, 필요가 없으면, SAAJP API 는 SAAJ API 에의 호출에 대해서 옮겨놓을 수 있었던 객체를 통지 없게 옮겨놓을 것은 없습니다.

즉, 실질적으로, DOM API 로부터의 조작뒤트리상의 SAAJ API 를 사용해 개시하는 어플리케이션은, 트리가 벌써 SAAJ 트리에 변환되고 있어 DOM API 를 사용해 취득한 트리내의 객체에의 참조는 무효이다고 봅니다. 참조가 무효가 될 뿐만 아니라, 어느쪽이나 SAAJ API 를 배타적으로 사용할 수 없기 때문에, SAAJ API 로부터 DOM API 에의 변환은 실행할 수 없습니다. 특정의 SAAJ 트리로 DOM API 로부터 SAAJ API 의 사용으로 전환하는 것만으로, 참조가 무효가 되는 위험이 수반합니다.