javax.xml.soap
클래스 SOAPPart

java.lang.Object 
  javax.xml.soap.SOAPPart

모든 구현된 인터페이스:

Document , Node

public abstract class SOAPPart
extends Object 
implements Document , Node 

SOAPMessage 객체의 SOAP 고유의 부분용의 컨테이너입니다. 모든 메세지는 SOAP 부를 가지도록(듯이) 요구되고 있기 (위해)때문에,SOAPMessage 객체가 작성되면(자) 자동적으로 SOAPPart 객체를 가집니다.

SOAPPart 객체는 MIME 부이며, Content-Id, Content-Location, 및 Content-Type 의 MIME 헤더를 가집니다. Content-Type 의 값은 "text/xml" 일 필요가 있기 (위해)때문에,SOAPPart 객체는 자동적으로 Content-Type 의 값이 "text/xml" 로 설정된 MIME 헤더를 가집니다. 메세지의 SOAP 부의 컨텐츠는 XML 형식일 필요가 있기 (위해)때문에, 값은 "text/xml" 일 필요가 있습니다. 형태 "text/xml" 가 아닌 컨텐츠는,SOAPPart 객체 중(안)에서는 없고 AttachmentPart 객체안에 넣을 필요가 있습니다.

메세지가 송신될 때, 메세지의 SOAP 부에는 MIME 헤더의 Content-Type 를 "text/xml" 로 설정할 필요가 있습니다. 또는, 다른 시점에서는, 수신하는 임의의 메세지의 SOAP 부는, MIME 헤더의 Content-Type 를 "text/xml" 의 값으로 가질 필요가 있습니다.

클라이언트는,SOAPMessage.getSOAPPart 메소드를 호출해 SOAPMessage 객체의 SOAPPart 객체에 액세스 할 수 있습니다. 다음의 코드에서는,message 가SOAPMessage 객체로, 메세지의 SOAP 부를 가져옵니다.

   SOAPPart soapPart = message.getSOAPPart();
 

SOAPPart 객체는 SOAPEnvelope 객체를 포함해, 순서에 SOAPBody 객체 및 SOAPHeader 객체를 포함합니다. SOAPPart 메소드 getEnvelope 을 사용해,SOAPEnvelope 객체를 취득할 수 있습니다.

필드의 개요

인터페이스 org.w3c.dom. Node 로부터 상속된 필드

ATTRIBUTE_NODE , CDATA_SECTION_NODE , COMMENT_NODE , DOCUMENT_FRAGMENT_NODE , DOCUMENT_NODE , DOCUMENT_POSITION_CONTAINED_BY , DOCUMENT_POSITION_CONTAINS , DOCUMENT_POSITION_DISCONNECTED , DOCUMENT_POSITION_FOLLOWING , DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC , DOCUMENT_POSITION_PRECEDING , DOCUMENT_TYPE_NODE , ELEMENT_NODE , ENTITY_NODE , ENTITY_REFERENCE_NODE , NOTATION_NODE , PROCESSING_INSTRUCTION_NODE , TEXT_NODE

생성자 의 개요

SOAPPart ()

메소드의 개요

abstract void	addMimeHeader (String name, String value) 지정된 이름 및 값을 포함한 MimeHeader 객체를 작성해, 그것을 이 SOAPPart 객체에 추가합니다.
abstract Iterator	getAllMimeHeaders () 이 SOAPPart 객체의 모든 헤더를,MimeHeader 에 대한 반복자로서 가져옵니다.
abstract Source	getContent () SOAPEnvelope 의 컨텐츠를 JAXP Source 객체로서 돌려줍니다.
String	getContentId () 이름이 "Content-Id" 인 MIME 헤더의 값을 가져옵니다.
String	getContentLocation () 이름이 "Content-Location" 인 MIME 헤더의 값을 가져옵니다.
abstract SOAPEnvelope	getEnvelope () 이 SOAPPart 객체에 관련한 SOAPEnvelope 를 돌려줍니다.
abstract Iterator	getMatchingMimeHeaders (String [] names) 지정한 배열내의 이름에 일치하는 모든 MimeHeader 객체를 가져옵니다.
abstract String []	getMimeHeader (String name) 지정한 String 에 의해 식별된 SOAPPart 객체내의,MimeHeader 객체의 모든 값을 가져옵니다.
abstract Iterator	getNonMatchingMimeHeaders (String [] names) 지정한 배열내의 이름에 일치하지 않는 모든 MimeHeader 객체를 가져옵니다.
abstract void	removeAllMimeHeaders () 이 SOAPEnvelope 객체의 MimeHeader 객체를 모두 삭제합니다.
abstract void	removeMimeHeader (String header) 지정한 이름에 일치하는 MIME 헤더를 모두 삭제합니다.
abstract void	setContent (Source source) SOAPEnvelope 객체의 컨텐츠를, 지정한 Source 객체로부터의 데이터로 설정합니다.
void	setContentId (String contentId) 이름이 "Content-Id" 인 MIME 헤더의 값을, 지정된 String 로 설정합니다.
void	setContentLocation (String contentLocation) MIME 헤더 "Content-Location" 의 값을, 지정된 String 로 설정합니다.
abstract void	setMimeHeader (String name, String value) 지정한 헤더명에 일치하는 최초의 헤더 엔트리를 변경해 그 값이 지정한 값이 되도록(듯이) 해, 기존의 헤더로 일치하는 것이 없는 경우는 지정한 이름의 새로운 헤더를 추가합니다.

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

인터페이스 org.w3c.dom. Document 로부터 상속된 메소드

adoptNode , createAttribute , createAttributeNS , createCDATASection , createComment , createDocumentFragment , createElement , createElementNS , createEntityReference , createProcessingInstruction , createTextNode , getDoctype , getDocumentElement , getDocumentURI , getDomConfig , getElementById , getElementsByTagName , getElementsByTagNameNS , getImplementation , getInputEncoding , getStrictErrorChecking , getXmlEncoding , getXmlStandalone , getXmlVersion , importNode , normalizeDocument , renameNode , setDocumentURI , setStrictErrorChecking , setXmlStandalone , setXmlVersion

인터페이스 javax.xml.soap. Node 로부터 상속된 메소드

detachNode , getParentElement , getValue , recycleNode , setParentElement , setValue

인터페이스 org.w3c.dom. Node 로부터 상속된 메소드

appendChild , cloneNode , compareDocumentPosition , getAttributes , getBaseURI , getChildNodes , getFeature , getFirstChild , getLastChild , getLocalName , getNamespaceURI , getNextSibling , getNodeName , getNodeType , getNodeValue , getOwnerDocument , getParentNode , getPrefix , getPreviousSibling , getTextContent , getUserData , hasAttributes , hasChildNodes , insertBefore , isDefaultNamespace , isEqualNode , isSameNode , isSupported , lookupNamespaceURI , lookupPrefix , normalize , removeChild , replaceChild , setNodeValue , setPrefix , setTextContent , setUserData

생성자 의 상세

SOAPPart

public SOAPPart()

메소드의 상세

getEnvelope

public abstract SOAPEnvelope  getEnvelope()
                                  throws SOAPException 

이 SOAPPart 객체에 관련한 SOAPEnvelope 를 돌려줍니다. SOAP 포락선을 취득하고 싶은들 , 그것을 사용해 컨텐츠를 취득할 수 있습니다.

반환값:

이 SOAPPart 객체의 SOAPEnvelope 객체

예외:

SOAPException - SOAP 에러가 존재하는 경우

getContentId

public String  getContentId()

이름이 "Content-Id" 인 MIME 헤더의 값을 가져옵니다.

반환값:

"Content-Id" 라는 이름의 MIME 헤더의 값을 나타낸다 String

관련 항목:

setContentId(java.lang.String)

getContentLocation

public String  getContentLocation()

이름이 "Content-Location" 인 MIME 헤더의 값을 가져옵니다.

반환값:

"Content-Location" 라는 이름의 MIME 헤더의 값을 나타낸다 String

관련 항목:

setContentLocation(java.lang.String)

setContentId

public void setContentId(String  contentId)

이름이 "Content-Id" 인 MIME 헤더의 값을, 지정된 String 로 설정합니다.

파라미터:

contentId - MIME 헤더 "Content-Id" 의 값을 나타낸다 String

예외:

IllegalArgumentException - 컨텐츠 ID 의 설정시에 문제가 있는 경우

관련 항목:

getContentId()

setContentLocation

public void setContentLocation(String  contentLocation)

MIME 헤더 "Content-Location" 의 값을, 지정된 String 로 설정합니다.

파라미터:

contentLocation - MIME 헤더 "Content-Location" 의 값을 나타낸다 String

예외:

IllegalArgumentException - 컨텐츠 로케이션의 설정시에 문제가 있는 경우

관련 항목:

getContentLocation()

removeMimeHeader

public abstract void removeMimeHeader(String  header)

지정한 이름에 일치하는 MIME 헤더를 모두 삭제합니다.

파라미터:

header - 삭제하는 MIME 헤더의 이름을 나타낸다 String

removeAllMimeHeaders

public abstract void removeAllMimeHeaders()

이 SOAPEnvelope 객체의 MimeHeader 객체를 모두 삭제합니다.

getMimeHeader

public abstract String [] getMimeHeader(String  name)

지정한 String 에 의해 식별된 SOAPPart 객체내의,MimeHeader 객체의 모든 값을 가져옵니다.

파라미터:

name - 헤더의 이름. 예: "Content-Type"

반환값:

지정한 헤더의 모든 값을 나타낸다 String 배열

관련 항목:

setMimeHeader(java.lang.String, java.lang.String)

setMimeHeader

public abstract void setMimeHeader(String  name,
                                   String  value)

지정한 헤더명에 일치하는 최초의 헤더 엔트리를 변경해 그 값이 지정한 값이 되도록(듯이) 해, 기존의 헤더로 일치하는 것이 없는 경우는 지정한 이름의 새로운 헤더를 추가합니다. 일치하는 헤더가 존재하는 경우, 이 메소드가, 일치하는 최초의 헤더의 기존의 값 모든 것을 클리어로 해, 대신에 지정된 값으로 설정합니다. 복수의 헤더가 지정한 이름을 가지는 경우, 이 메소드는, 최초로 일치한 헤더의 후에 일치하는 헤더를 모두 삭제합니다.

RFC822 헤더는 US-ASCII 문자만을 포함하는 것이 가능한 점에 주의해 주세요.

파라미터:

name - 검색하는 헤더명을 지정했다 String

value - 설정되는 값을 나타내는 String. 이 값은, 일치하는 헤더가 있는 경우에는 최초의 헤더의 현재의 값과 옮겨놓을 수 있습니다. 일치하는 헤더가 없는 경우, 이 값은 새롭다 MimeHeader 객체의 값이 됩니다

예외:

IllegalArgumentException - 지정한 MIME 헤더명 또는 값에 문제가 있었을 경우

관련 항목:

getMimeHeader(java.lang.String)

addMimeHeader

public abstract void addMimeHeader(String  name,
                                   String  value)

지정된 이름 및 값을 포함한 MimeHeader 객체를 작성해, 그것을 이 SOAPPart 객체에 추가합니다. 지정된 이름을 가지는 MimeHeader 가 벌써 존재하는 경우, 이 메소드는 지정한 값을 기존의 값에 추가합니다.

RFC822 헤더는 US-ASCII 문자만을 포함하는 것이 가능한 점에 주의해 주세요.

파라미터:

name - 헤더명을 나타내는 String

value - 설정 또는 추가되는 값을 나타낸다 String

예외:

IllegalArgumentException - 지정한 MIME 헤더명 또는 값에 문제가 있었을 경우

getAllMimeHeaders

public abstract Iterator  getAllMimeHeaders()

이 SOAPPart 객체의 모든 헤더를,MimeHeader 에 대한 반복자로서 가져옵니다.

반환값:

이 SOAPPart 객체의 MIME 헤더 모든 것을 포함한다 Iterator 객체

getMatchingMimeHeaders

public abstract Iterator  getMatchingMimeHeaders(String [] names)

지정한 배열내의 이름에 일치하는 모든 MimeHeader 객체를 가져옵니다.

파라미터:

names - 반환되는 MIME 헤더의 이름을 포함한다 String 배열

반환값:

지정한 배열내의 이름의 1 개로 일치하는 MIME 헤더 모두, Iterator 객체로서 반환된다

getNonMatchingMimeHeaders

public abstract Iterator  getNonMatchingMimeHeaders(String [] names)

지정한 배열내의 이름에 일치하지 않는 모든 MimeHeader 객체를 가져옵니다.

파라미터:

names - 돌려주어지지 않은 MIME 헤더의 이름을 포함한다 String 배열

반환값:

지정한 배열내의 이름의 1 개에 일치한다 물건을 제외한, 이 SOAPPart 객체내의 모든 MIME 헤더. 일치하지 않는 MIME 헤더는, Iterator 객체로서 돌려주어집니다.

setContent

public abstract void setContent(Source  source)
                         throws SOAPException 

SOAPEnvelope 객체의 컨텐츠를, 지정한 Source 객체로부터의 데이터로 설정합니다. 이 Source 에는, 유효한 SOAP 문서가 포함되어 있을 필요가 있습니다.

파라미터:

source - 설정되는 데이터를 포함한다 javax.xml.transform.Source 객체

예외:

SOAPException - source 의 설정시에 문제가 있는 경우

관련 항목:

getContent()

getContent

public abstract Source  getContent()
                           throws SOAPException 

SOAPEnvelope 의 컨텐츠를 JAXP Source 객체로서 돌려줍니다.

반환값:

javax.xml.transform.Source 객체로서의 컨텐츠

예외:

SOAPException - 구현이, 지정했다 Source 객체를 변환할 수 없는 경우

관련 항목:

setContent(javax.xml.transform.Source)