|
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
- 신규 요소의 로컬명을 제공한다
String
prefix
- 신규 요소의 이름 공간의 접두사를 제공한다
String
SOAPElement
객체
SOAPException
- prefix
가 이 SOAPElement
객체의 문맥으로
유효하지 않은 경우, 또는 SOAPElement
객체의 작성시에
에러가 발생했을 경우
SOAPElement addChildElement(String localName, String prefix, String uri) throws SOAPException
SOAPElement
객체를 새롭게 작성해, 그 신규 요소를 이 SOAPElement
객체에 추가합니다.
localName
- 신규 요소의 로컬명을 제공한다
String
prefix
- 신규 요소의 이름 공간의 접두사를 제공한다
String
uri
- 신규 요소가 속하는 이름 공간의 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
- 이름 공간의 접두사를 제공하는 String
uri
- 이름 공간의 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
String
Iterator 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
,
정상적으로 삭제되지 않았던 경우는 false
removeAttribute(javax.xml.namespace.QName)
boolean removeAttribute(QName qname)
qname
- 삭제하는 속성의 qname 를 가지는 QName
객체
true
,
정상적으로 삭제되지 않았던 경우는 false
removeAttribute(Name)
boolean removeNamespaceDeclaration(String prefix)
prefix
- 검색하는 접두사를 제공한다
String
true
,
정상적으로 삭제되지 않았던 경우는 false
Iterator 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
객체의 인코딩 스타일을 돌려줍니다.
String
setEncodingStyle(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 도 참조해 주세요.