|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 | |||||||||
public interface SOAPElement
SOAP 메세지의 요소를 나타내는 객체입니다. SOAP 의 스펙으로 허가되고 있습니다만, 명확하게 규정되고 있는 것은 아닙니다. 이 인터페이스는, SOAP 스펙으로 명확하게 규정된 객체의 기본 인터페이스로서 서비스를 실행합니다.
SAAJ 고유의 객체를 돌려줄 필요가 있는 이 인터페이스의 메소드는, 올바른 형태의 객체를 정상적으로 돌려줄 필요가 있기 (위해)때문에, 트리내의 노드를 통지하는 일 없이 옮겨놓습니다. 상세한 것에 대하여는,
getChildElements() 및 javax.xml.soap 를 참조해 주세요.
| 필드의 개요 |
|---|
| 메소드의 개요 | |
|---|---|
SOAPElement |
addAttribute (Name name,
String value)
지정의 이름과 값을 보관 유지하는 속성을, 이 SOAPElement 객체에 추가합니다. |
SOAPElement |
addAttribute (QName qname,
String value)
지정의 이름과 값을 보관 유지하는 속성을, 이 SOAPElement 객체에 추가합니다. |
SOAPElement |
addChildElement (Name name)
지정의 Name 객체로 초기화한 SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다. |
SOAPElement |
addChildElement (QName qname)
지정의 QName 객체로 초기화한 SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다. |
SOAPElement |
addChildElement (SOAPElement element)
이 SOAPElement 인스턴스의 아이로서 SOAPElement 를 추가합니다. |
SOAPElement |
addChildElement (String localName)
지정의 로컬명으로 초기화한 SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다. |
SOAPElement |
addChildElement (String localName,
String prefix)
지정의 로컬명과 접두사로 초기화한 SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다. |
SOAPElement |
addChildElement (String localName,
String prefix,
String uri)
지정의 로컬명, 접두사, 및 URI 로 초기화한 SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다. |
SOAPElement |
addNamespaceDeclaration (String prefix,
String uri)
지정의 접두사와 URI 를 보관 유지하는 이름 공간 선언을, 이 SOAPElement 객체에 추가합니다. |
SOAPElement |
addTextNode (String text)
지정의 String 로 초기화한 Text 객체를 새롭게 작성해, 이 SOAPElement 객체에 추가합니다. |
QName |
createQName (String localName,
String prefix)
이름 공간 URI 가, 이 SOAPElement 의 문맥의 파라미터,prefix, 에 관련하고 있는 QName 를 작성합니다. |
Iterator |
getAllAttributes ()
이 SOAPElement 객체의 속성 Name 객체의 모두에 걸치는 Iterator 를 돌려줍니다. |
Iterator |
getAllAttributesAsQNames ()
이 SOAPElement 의 속성 모두에 걸치는 Iterator 를 QName 객체로서 돌려줍니다. |
String |
getAttributeValue (Name name)
지정된 이름을 보관 유지하는 속성의 값을 돌려줍니다. |
String |
getAttributeValue (QName qname)
지정된 qname 를 보관 유지하는 속성의 값을 돌려줍니다. |
Iterator |
getChildElements ()
이 요소의 직접적인 자 Node 모두에 걸치는 Iterator 를 돌려줍니다. |
Iterator |
getChildElements (Name name)
지정의 이름을 가지는 이 요소의 직접적인 자 Node 모두에 걸치는 Iterator 를 돌려줍니다. |
Iterator |
getChildElements (QName qname)
지정의 qname 를 가지는 이 요소의 직접적인 자 Node 모두에 걸치는 Iterator 를 돌려줍니다. |
Name |
getElementName ()
이 SOAPElement 객체의 이름을 돌려줍니다. |
QName |
getElementQName ()
이 SOAPElement 객체의 qname 를 돌려줍니다. |
String |
getEncodingStyle ()
이 SOAPElement 객체의 인코딩 스타일을 돌려줍니다. |
Iterator |
getNamespacePrefixes ()
이 요소로 선언되고 있는 이름 공간 접두사의 String 의 Iterator 를 돌려줍니다. |
String |
getNamespaceURI (String prefix)
지정의 접두사를 가지는 이름 공간의 URI 를 돌려줍니다. |
Iterator |
getVisibleNamespacePrefixes ()
이 요소에 표시되고 있는 이름 공간 접두사의 String 의 Iterator 를 돌려줍니다. |
boolean |
removeAttribute (Name name)
지정된 이름의 속성을 삭제합니다. |
boolean |
removeAttribute (QName qname)
지정된 qname 의 속성을 삭제합니다. |
void |
removeContents ()
이 SOAPElement 의 모든 아이를 떼어냅니다. |
boolean |
removeNamespaceDeclaration (String prefix)
지정의 접두사에 대응한 이름 공간 선언을 삭제합니다. |
SOAPElement |
setElementQName (QName newName)
가능하면, 이 Element 의 이름을 newName 로 변경합니다. |
void |
setEncodingStyle (String encodingStyle)
이 SOAPElement 객체의 인코딩 스타일을 지정의 것으로 설정합니다. |
| 인터페이스 javax.xml.soap. Node 로부터 상속된 메소드 |
|---|
detachNode , getParentElement , getValue , recycleNode , setParentElement , setValue |
| 인터페이스 org.w3c.dom. Element 로부터 상속된 메소드 |
|---|
getAttribute , getAttributeNode , getAttributeNodeNS , getAttributeNS , getElementsByTagName , getElementsByTagNameNS , getSchemaTypeInfo , getTagName , hasAttribute , hasAttributeNS , removeAttribute , removeAttributeNode , removeAttributeNS , setAttribute , setAttributeNode , setAttributeNodeNS , setAttributeNS , setIdAttribute , setIdAttributeNode , setIdAttributeNS |
| 인터페이스 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 |
| 메소드의 상세 |
|---|
SOAPElement addChildElement(Name name)
throws SOAPException
Name 객체로 초기화한 SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다. 이 메소드는, addChildElement(javax.xml.namespace.QName)와의 관계로, SAAJ 의 장래의 릴리스로 추천 되지 않게 될 가능성이 있습니다.
name - 신규 요소의 XML 명을 가지는 Name
객체
SOAPElement 객체
SOAPException - SOAPElement 객체의 작성시에
에러가 발생했을 경우addChildElement(javax.xml.namespace.QName)
SOAPElement addChildElement(QName qname)
throws SOAPException
QName 객체로 초기화한 SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다. 새로운 SOAPElement 의namespace,localname, 및prefix는, 모두 qname 인수로부터 가져옵니다.
qname - 신규 요소의 XML 명을 가지는 QName
객체
SOAPElement 객체
SOAPException - SOAPElement 객체의 작성시에
에러가 발생했을 경우addChildElement(Name)
SOAPElement addChildElement(String localName)
throws SOAPException
SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다. 새로운 SOAPElement 는, 디폴트의 이름 공간의 범위를 모두 상속하고 있습니다.
localName - 요소의 로컬명을 제공한다
String
SOAPElement 객체
SOAPException - SOAPElement 객체의 작성시에
에러가 발생했을 경우
SOAPElement addChildElement(String localName,
String prefix)
throws SOAPException
SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다.
localName - 신규 요소의 로컬명을 제공한다
Stringprefix - 신규 요소의 이름 공간의 접두사를 제공한다
String
SOAPElement 객체
SOAPException - prefix 가 이 SOAPElement 객체의 문맥으로
유효하지 않은 경우, 또는 SOAPElement 객체의 작성시에
에러가 발생했을 경우
SOAPElement addChildElement(String localName,
String prefix,
String uri)
throws SOAPException
SOAPElement 객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement 객체에 추가합니다.
localName - 신규 요소의 로컬명을 제공한다
Stringprefix - 신규 요소의 이름 공간의 접두사를 제공한다
Stringuri - 신규 요소가 속하는 이름 공간의 URI 를 제공한다
String
SOAPElement 객체
SOAPException - SOAPElement 객체의 작성시에
에러가 발생했을 경우
SOAPElement addChildElement(SOAPElement element)
throws SOAPException
SOAPElement 인스턴스의 아이로서 SOAPElement 를 추가합니다. SOAPElement 는,SOAPFactory 로 작성하는 것이 전제입니다. 호출측은, XML 트리에 그대로 추가되는 요소 인스턴스를 신용 해서는 안됩니다. 다른 SOAPElement 구현의 인스턴스에게 건네진 SOAPElement 의 컨텐츠를 카피해, 구현이 끝날 가능성이 있습니다. 예를 들어,addChildElement() 이 SOAPHeader 로 불려 가는 경우,element 는 SOAPHeaderElement 의 인스턴스에 카피됩니다.
element 에 루트 된 fragment에는 전체가 추가됩니다. 다만, 에러가 발생했을 경우는 1 개나 추가되지 않습니다.
element 에 루트 된 fragment에는, SOAP 이름 공간에 "Envelope","Header","Body" 라는 이름의 요소를 보유할 수 없습니다. fragment에 존재하는 이름 공간의 접두사는, 그 fragment 내부에서 적절한 이름 공간 선언을 사용해 완전하게 해결될 필요가 있습니다.
element - 새로운 아이로서 추가된다
SOAPElement
SOAPException - 이 요소를 아이로서 추가할 경우에
에러가 발생했을 경우void removeContents()
SOAPElement 의 모든 아이를 떼어냅니다.
이 메소드는, 에러 상태의 검출시에 에러를 송신할 준비로서SOAPHeaders 나 SOAPBodys 를 구축이 완성하고 있는 부분까지 롤백(rollback) 하는데 도움이 됩니다. 또, SOAP 메세지내의 문서의 일부의 재사용에도 도움이 됩니다.
SOAPElement addTextNode(String text)
throws SOAPException
String 로 초기화한 Text 객체를 새롭게 작성해, 이 SOAPElement 객체에 추가합니다.
text - 추가하는 텍스트 컨텐츠를 가지는 String 객체
Text 객체가 삽입되었다
SOAPElement 객체
SOAPException - 새로운 Text 객체의 작성시에
에러가 발생했을 경우, 또는 이 SOAPElement 에
아이로서 첨부하는 것이
허가되어 있지 않은 경우
SOAPElement addAttribute(Name name,
String value)
throws SOAPException
SOAPElement 객체에 추가합니다.
name - 속성명을 가지는 Name 객체value - 속성치를 제공하는 String
SOAPElement
객체
SOAPException - Attribute 의 작성시에 에러가 발생했을 경우,
또는 이 SOAPElement 에
Name name 의 속성을
설정하는 것이 무효인 경우addAttribute(javax.xml.namespace.QName, String)
SOAPElement addAttribute(QName qname,
String value)
throws SOAPException
SOAPElement 객체에 추가합니다.
qname - 속성명을 가지는 QName 객체value - 속성치를 제공하는 String
SOAPElement
객체
SOAPException - Attribute 의 작성시에 에러가 발생했을 경우,
또는 이 SOAPElement 에
QName qname 의 속성을
설정하는 것이 무효인 경우addAttribute(Name, String)
SOAPElement addNamespaceDeclaration(String prefix,
String uri)
throws SOAPException
SOAPElement 객체에 추가합니다.
prefix - 이름 공간의 접두사를 제공하는 Stringuri - 이름 공간의 URI 를 제공하는 String
SOAPElement
객체
SOAPException - 이름 공간의 작성시에
에러가 발생했을 경우String getAttributeValue(Name name)
name - 속성명을 가지는 Name 객체
String,
또는 그러한 속성이 없는 경우는 NullgetAttributeValue(javax.xml.namespace.QName) String getAttributeValue(QName qname)
qname - 속성의 qname 를 보유하는 QName 객체
String,
또는 그러한 속성이 없는 경우는 NullgetAttributeValue(Name) Iterator getAllAttributes()
SOAPElement 객체의 속성 Name 객체의 모두에 걸치는 Iterator 를 돌려줍니다. 반복자는 속성명의 취득에 사용해,getAttributeValue 메소드에 건네주어 각 속성의 값을 취득할 수 있습니다.
getAllAttributesAsQNames() Iterator getAllAttributesAsQNames()
SOAPElement 의 속성 모두에 걸치는 Iterator 를 QName 객체로서 돌려줍니다. 반복자는 속성 QName 의 취득에 사용해,getAttributeValue 메소드에 건네주어 각 속성의 값을 취득할 수 있습니다.
getAllAttributes() String getNamespaceURI(String prefix)
prefix - 검색하는 이름 공간의 접두사를 제공한다
String
StringIterator getNamespacePrefixes()
String 의 Iterator 를 돌려줍니다. 이 반복자로 반환된 접두사를 getNamespaceURI 메소드에 건네주어, 각 이름 공간의 URI 를 취득할 수 있습니다.
SOAPElement 객체의 이름 공간 접두사의
반복자Iterator getVisibleNamespacePrefixes()
String 의 Iterator 를 돌려줍니다. 이 반복자로 반환된 접두사를 getNamespaceURI 메소드에 건네주어, 각 이름 공간의 URI 를 취득할 수 있습니다.
QName createQName(String localName,
String prefix)
throws SOAPException
SOAPElement 의 문맥의 파라미터,prefix, 에 관련하고 있는 QName 를 작성합니다. 새로운 QName 의 나머지의 요소는, 파라미터,localName, 및 prefix 로부터 직접 가져옵니다.
localName - 이름의 로컬 부분을 포함한 String. prefix - 이름의 접두사를 포함한 String
localName 와
prefix, 및, 이 SOAPElement 의 문맥의
prefix 에 관련한 이름 공간을 가진다
QName. 파라미터로서 prefix 가 지정되고 있는 경우,
이 이름 공간은,
getNamespaceURI(String) 에 반환된다
물건과 동일하다
SOAPException - QName 를 작성할 수 없는 경우Name getElementName()
SOAPElement 객체의 이름을 돌려줍니다.
SOAPElement 객체의 이름을 가지는 Name
객체QName getElementQName()
SOAPElement 객체의 qname 를 돌려줍니다.
SOAPElement 객체의 qname 를 가지는 QName
객체getElementName()
SOAPElement setElementQName(QName newName)
throws SOAPException
Element 의 이름을 newName 로 변경합니다. SOAPEnvelope, SOAPHeader, SOAPBody 등이 같은 SOAP Defined 요소는, 이 메소드를 사용해 이름을 변경할 수 없습니다. 변경하려고 하면(자), SOAPException 가 throw 됩니다.
호출측은, 그대로 이름 변경되는 요소 인스턴스를 신용 해서는 안됩니다. SOAPElement 의 컨텐츠를, 이름 변경한 인스턴스에 카피해 구현이 끝날 가능성이 있습니다.
newName - Element 의 새로운 이름
SOAPException - 이 Element 의 이름 변경이
허가되어 있지 않은 경우boolean removeAttribute(Name name)
name - 삭제하는 속성의 이름을 가지는 Name
객체
true,
정상적으로 삭제되지 않았던 경우는 falseremoveAttribute(javax.xml.namespace.QName) boolean removeAttribute(QName qname)
qname - 삭제하는 속성의 qname 를 가지는 QName
객체
true,
정상적으로 삭제되지 않았던 경우는 falseremoveAttribute(Name) boolean removeNamespaceDeclaration(String prefix)
prefix - 검색하는 접두사를 제공한다
String
true,
정상적으로 삭제되지 않았던 경우는 falseIterator getChildElements()
Node 모두에 걸치는 Iterator 를 돌려줍니다. 이것에는 SOAPElement 객체 뿐만이 아니라 javax.xml.soap.Text 도 포함됩니다.
이 메소드를 호출하면(자), 아이의
Element,SOAPElement,SOAPElement 에 치환되는 org.w3c.dom.Text 노드,SOAPHeaderElement,SOAPBodyElement, 이 친노드의 타입에 적절한 javax.xml.soap.Text 노드가 발생합니다. 결과적으로, 어플리케이션을 호출하는 경우, DOM API 로 취득된 이러한 아이의 노드에 대한 기존의 참조는, 모두 무효로서 취급할 필요가 있기 (위해)때문에, 그것들을 파기하는지, 이 Iterator 로 반환된 값으로 리프레쉬 할 필요가 있습니다. 이 동작은, 동등의 DOM API 를 호출하는 것으로 회피할 수 있습니다. 상세한 것에 대하여는,javax.xml.soap 를 참조해 주세요.
SOAPElement 객체의 컨텐츠를 가진다
반복자
Iterator getChildElements(Name name)
Node 모두에 걸치는 Iterator 를 돌려줍니다. 이러한 아이는 모두 SOAPElement 노드가 됩니다.
이 메소드를 호출하면(자), 아이의
Element,SOAPElement,SOAPElement 에 치환되는 org.w3c.dom.Text 노드,SOAPHeaderElement,SOAPBodyElement, 이 친노드의 타입에 적절한 javax.xml.soap.Text 노드가 발생합니다. 결과적으로, 어플리케이션을 호출하는 경우, DOM API 로 취득된 이러한 아이의 노드에 대한 기존의 참조는, 모두 무효로서 취급할 필요가 있기 (위해)때문에, 그것들을 파기하는지, 이 Iterator 로 반환된 값으로 리프레쉬 할 필요가 있습니다. 이 동작은, 동등의 DOM API 를 호출하는 것으로 회피할 수 있습니다. 상세한 것에 대하여는,javax.xml.soap 를 참조해 주세요.
name - 반환되는 아이 요소의 이름을 가지는 Name
객체
SOAPElement 객체의
요소 모두에 걸친다
Iterator 객체getChildElements(javax.xml.namespace.QName)
Iterator getChildElements(QName qname)
Node 모두에 걸치는 Iterator 를 돌려줍니다. 이러한 아이는 모두 SOAPElement 노드가 됩니다.
이 메소드를 호출하면(자), 아이의
Element,SOAPElement,SOAPElement 에 치환되는 org.w3c.dom.Text 노드,SOAPHeaderElement,SOAPBodyElement, 이 친노드의 타입에 적절한 javax.xml.soap.Text 노드가 발생합니다. 결과적으로, 어플리케이션을 호출하는 경우, DOM API 로 취득된 이러한 아이의 노드에 대한 기존의 참조는, 모두 무효로서 취급할 필요가 있기 (위해)때문에, 그것들을 파기하는지, 이 Iterator 로 반환된 값으로 리프레쉬 할 필요가 있습니다. 이 동작은, 동등의 DOM API 를 호출하는 것으로 회피할 수 있습니다. 상세한 것에 대하여는,javax.xml.soap 를 참조해 주세요.
qname - 반환되는 아이 요소의 qname 를 보유하는 QName
객체
SOAPElement 객체의
요소 모두에 걸친다
Iterator 객체getChildElements(Name)
void setEncodingStyle(String encodingStyle)
throws SOAPException
SOAPElement 객체의 인코딩 스타일을 지정의 것으로 설정합니다.
encodingStyle - 인코딩 스타일을 제공하는 String
IllegalArgumentException - 설정되어 있는 인코딩 스타일에
문제가 발생했을 경우
SOAPException - 이 SOAPElement 에 대한 encodingStyle 의 설정이 무효의 경우getEncodingStyle() String getEncodingStyle()
SOAPElement 객체의 인코딩 스타일을 돌려줍니다.
StringsetEncodingStyle(java.lang.String)
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.