JavaTM Platform
Standard Ed. 6

javax.imageio.metadata
클래스 IIOMetadataNode

java.lang.Object 
  상위를 확장 javax.imageio.metadata.IIOMetadataNode
모든 구현된 인터페이스:
Element , Node , NodeList


public class IIOMetadataNode
extends Object
implements Element , NodeList

메타데이타트리의 노드를 나타내는 클래스에서,org.w3c.dom.Element 인터페이스를 구현해, 한층 더 getUserObjectsetUserObject 메소드를 사용해 텍스트 이외의 객체를 포함할 수 있도록(듯이) 합니다.

이 클래스는, 일반의 XML 처리에 사용하는 것을 상정하고 있습니다. 특히, 이미지 입출력 API 로 작성된 Element 노드는, Sun 의 org.w3.dom API 의 표준 구현으로 작성된 노드와 호환성이 없습니다. 특히, 구현은 단순한 사용법을 하도록(듯이) 조정되고 있어 집중적인 처리로는 충분히 동작하지 않는 경우가 있습니다.

이 구현에서는 이름 공간은 무시됩니다. 용어의 「태그명」과「노드명」은, 항상 동의라고 보여집니다.

관련 항목:
IIOMetadata.getAsTree(java.lang.String) , IIOMetadata.setFromTree(java.lang.String, org.w3c.dom.Node) , IIOMetadata.mergeTree(java.lang.String, org.w3c.dom.Node)

필드의 개요
 
인터페이스 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
 
생성자 의 개요
IIOMetadataNode ()
          빈 상태(empty)의 IIOMetadataNode 를 구축합니다.
IIOMetadataNode (String  nodeName)
          지정된 노드명을 가지는 IIOMetadataNode 를 구축합니다.
 
메소드의 개요
 Node appendChild (Node  newChild)
          노드 newChild 를 이 노드의 아이의 리스트의 말미에 추가합니다.
 Node cloneNode (boolean deep)
          이 노드의 복제를 돌려줍니다.
 short compareDocumentPosition (Node  other)
          이 메소드가 불려 가고 있는 참조 노드를, 파라미터로서 건네받는 노드와 문서내의 위치에 관해서 문서순서와 비교합니다.
 String getAttribute (String  name)
          이름을 지정해 속성을 가져옵니다.
 Attr getAttributeNode (String  name)
          이름을 지정해 속성 노드를 가져옵니다.
 Attr getAttributeNodeNS (String  namespaceURI, String  localName)
          getAttributeNode(localName) 와 같습니다.
 String getAttributeNS (String  namespaceURI, String  localName)
          getAttribute(localName) 와 같습니다.
 NamedNodeMap getAttributes ()
          이 노드가 Element 의 경우, 이 노드의 속성을 포함한 NamedNodeMap 입니다.
 String getBaseURI ()
          이 노드의 절대 베이스 URI, 구현이 절대 URI 를 취득할 수 없었던 경우는 null 가 됩니다.
 NodeList getChildNodes ()
          이 노드의 아이를 모두 포함한 NodeList 입니다.
 NodeList getElementsByTagName (String  name)
          주어진(given) 태그명과 함께, 모든 자손 ElementsNodeList 를 문서순서에 돌려줍니다.
 NodeList getElementsByTagNameNS (String  namespaceURI, String  localName)
          getElementsByTagName(localName) 와 같습니다.
 Object getFeature (String  feature, String  version)
          이 메소드는, 지정한 기능과 버젼을 가지는 특수한 형식의 API 가 지정되었던 대로 구현하는 특수한 형식의 객체를 돌려줍니다.
 Node getFirstChild ()
          이 노드의 최초의 아이를 돌려줍니다.
 Node getLastChild ()
          이 노드의 마지막 아이를 돌려줍니다.
 int getLength ()
          리스트내의 노드수입니다.
 String getLocalName ()
          getNodeName 와 같습니다.
 String getNamespaceURI ()
          이름 공간은 지원되지 않기 때문에,null 를 돌려줍니다.
 Node getNextSibling ()
          이 노드의 다음의 형제 위젯를 돌려줍니다.
 String getNodeName ()
          이 노드에 관련한 노드명을 돌려줍니다.
 short getNodeType ()
          항상 ELEMENT_NODE 인 노드의 형태를 돌려줍니다.
 String getNodeValue ()
          이 노드의 값입니다.
 Document getOwnerDocument ()
          IIOMetadataNode 는 어느 Document 에도 속하지 않기 때문에,null 를 돌려줍니다.
 Node getParentNode ()
          이 노드의 부모를 돌려줍니다.
 String getPrefix ()
          이름 공간은 지원되지 않기 때문에,null 를 돌려줍니다.
 Node getPreviousSibling ()
          이 노드의 전의 형제 위젯를 돌려줍니다.
 TypeInfo getSchemaTypeInfo ()
          이 요소에 관련하는 형태 정보입니다.
 String getTagName ()
          요소의 이름입니다.
 String getTextContent ()
          이 속성은, 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 돌려줍니다.
 Object getUserData (String  key)
          이 노드의 키에 관련지을 수 있었던 객체를 가져옵니다.
 Object getUserObject ()
          이 노드에 관련한 Object 치를 돌려줍니다.
 boolean hasAttribute (String  name)
          이 요소상에 주어진(given) 이름의 속성이 지정되었을 경우, 또는 속성에 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false
 boolean hasAttributeNS (String  namespaceURI, String  localName)
          hasAttribute(localName) 와 같습니다.
 boolean hasAttributes ()
          이 노드가 요소인 경우, 속성을 가지고 있을지 어떨지를 판단합니다.
 boolean hasChildNodes ()
          이 노드에 자식(child) 노드가 있는 경우는 true 를 돌려줍니다.
 Node insertBefore (Node  newChild, Node  refChild)
          기존의 refChild 자 노드의 전에 newChild 노드를 삽입합니다.
 boolean isDefaultNamespace (String  namespaceURI)
          이 메소드는, 지정된 namespaceURI 가 디폴트의 이름 공간일지 어떨지를 체크합니다.
 boolean isEqualNode (Node  node)
          2 개의 노드가 동일한지 어떤지를 테스트합니다.
 boolean isSameNode (Node  node)
          이 노드가 지정된 노드와 같은 노드일지 어떨지를 돌려줍니다.
 boolean isSupported (String  feature, String  version)
          DOM 기능은 지원되어 있지 않기 때문에,false 를 돌려줍니다.
 Node item (int index)
          집합내의 index 번째의 항목을 돌려줍니다.
 String lookupNamespaceURI (String  prefix)
          지정한 노드로부터 개시해, 주어진(given) 접두사에 관련하는 이름 공간 URI 를 검색합니다.
 String lookupPrefix (String  namespaceURI)
          지정된 노드로부터 개시해, 주어진(given) 이름 공간 URI 에 관련하는 접두사를 검색합니다.
 void normalize ()
          IIOMetadataNode 에는 아이 Text 가 포함되지 않기 때문에, 아무것도 실행하지 않습니다.
 void removeAttribute (String  name)
          이름을 지정해 속성을 삭제합니다.
 Attr removeAttributeNode (Attr  oldAttr)
          지정된 속성 노드를 삭제합니다.
 void removeAttributeNS (String  namespaceURI, String  localName)
          removeAttribute(localName) 와 같습니다.
 Node removeChild (Node  oldChild)
          아이 리스트로부터 oldChild 로 나타나는 자식(child) 노드를 삭제해, 이 자식(child) 노드를 돌려줍니다.
 Node replaceChild (Node  newChild, Node  oldChild)
          아이 리스트안의 자식(child) 노드 oldChildnewChild 로 옮겨놓아oldChild 노드를 돌려줍니다.
 void setAttribute (String  name, String  value)
          새로운 속성을 추가합니다.
 Attr setAttributeNode (Attr  newAttr)
          새로운 속성을 추가합니다.
 Attr setAttributeNodeNS (Attr  newAttr)
          setAttributeNode(newAttr) 와 같습니다.
 void setAttributeNS (String  namespaceURI, String  qualifiedName, String  value)
          setAttribute(qualifiedName, value) 와 같습니다.
 void setIdAttribute (String  name, boolean isId)
          isId 파라미터가 true 의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다.
 void setIdAttributeNode (Attr  idAttr, boolean isId)
          isId 파라미터가 true 의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다.
 void setIdAttributeNS (String  namespaceURI, String  localName, boolean isId)
          isId 파라미터가 true 의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다.
 void setNodeValue (String  nodeValue)
          이 노드의 값입니다.
 void setPrefix (String  prefix)
          이름 공간은 지원되지 않기 때문에, 아무것도 실행하지 않습니다.
 void setTextContent (String  textContent)
          이 속성은, 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 돌려줍니다.
 Object setUserData (String  key, Object  data, UserDataHandler  handler)
          이 노드의 키에 객체를 관련짓습니다.
 void setUserObject (Object  userObject)
          이 노드에 관련한 값을 설정합니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

생성자 의 상세

IIOMetadataNode

public IIOMetadataNode()
빈 상태(empty)의 IIOMetadataNode 를 구축합니다.


IIOMetadataNode

public IIOMetadataNode(String  nodeName)
지정된 노드명을 가지는 IIOMetadataNode 를 구축합니다.

파라미터:
nodeName - String 로서의, 노드의 이름
메소드의 상세

getNodeName

public String  getNodeName()
이 노드에 관련한 노드명을 돌려줍니다.

정의:
인터페이스 Node 내의 getNodeName
반환값:
String 로서의 노드명

getNodeValue

public String  getNodeValue()
                    throws DOMException 
인터페이스 Node 의 기술:
이 노드의 값입니다. 이 값은 형태에 따라서 다릅니다. 전술의 겉(표)를 참조해 주세요. null 라고 정의되고 있는 경우, 노드가 읽어내 전용인 경우를 포함해, 설정은 아무것도 영향을 주지 않습니다.

정의:
인터페이스 Node 내의 getNodeValue
예외:
DOMException - DOMSTRING_SIZE_ERR:반환되는 문자수가 너무 많아서 구현 플랫폼상의 DOMString 변수에 들어가지 않는 경우

setNodeValue

public void setNodeValue(String  nodeValue)
                  throws DOMException 
인터페이스 Node 의 기술:
이 노드의 값입니다. 이 값은 형태에 따라서 다릅니다. 전술의 겉(표)를 참조해 주세요. null 라고 정의되고 있는 경우, 노드가 읽어내 전용인 경우를 포함해, 설정은 아무것도 영향을 주지 않습니다.

정의:
인터페이스 Node 내의 setNodeValue
예외:
DOMException - NO_MODIFICATION_ALLOWED_ERR:노드가 읽어내 전용의 경우, 및 null 이다고 정의되어 있지 않은 경우

getNodeType

public short getNodeType()
항상 ELEMENT_NODE 인 노드의 형태를 돌려줍니다.

정의:
인터페이스 Node 내의 getNodeType
반환값:
short 치의 ELEMENT_NODE

getParentNode

public Node  getParentNode()
이 노드의 부모를 돌려줍니다. null 치는, 노드가 독자적인 트리의 루트인 것을 나타냅니다. 노드를 기존의 트리에 추가하려면 ,insertBefore,replaceChild, 또는 appendChild 메소드의 1 개를 사용합니다.

정의:
인터페이스 Node 내의 getParentNode
반환값:
Node 로서의 친
관련 항목:
insertBefore(org.w3c.dom.Node, org.w3c.dom.Node) , replaceChild(org.w3c.dom.Node, org.w3c.dom.Node) , appendChild(org.w3c.dom.Node)

getChildNodes

public NodeList  getChildNodes()
인터페이스 Node 의 기술:
이 노드의 아이를 모두 포함한 NodeList 입니다. 아이가 존재하지 않는 경우, 노드를 가지지 않는 NodeList 가 돌려주어집니다.

정의:
인터페이스 Node 내의 getChildNodes

getFirstChild

public Node  getFirstChild()
이 노드의 최초의 아이를 돌려줍니다. 노드에 아이가 없는 경우는 null 를 돌려줍니다.

정의:
인터페이스 Node 내의 getFirstChild
반환값:
Node 로서의 최초의 아이, 또는 null

getLastChild

public Node  getLastChild()
이 노드의 마지막 아이를 돌려줍니다. 노드에 아이가 없는 경우는 null 를 돌려줍니다.

정의:
인터페이스 Node 내의 getLastChild
반환값:
Node 로서의 마지막 아이, 또는 null

getPreviousSibling

public Node  getPreviousSibling()
이 노드의 전의 형제 위젯를 돌려줍니다. 이 노드에 전의 형제 위젯가 없는 경우는 null 를 돌려줍니다.

정의:
인터페이스 Node 내의 getPreviousSibling
반환값:
Node 로서의 전의 형제 위젯, 또는 null

getNextSibling

public Node  getNextSibling()
이 노드의 다음의 형제 위젯를 돌려줍니다. 이 노드에 다음의 형제 위젯가 없는 경우는 null 를 돌려줍니다.

정의:
인터페이스 Node 내의 getNextSibling
반환값:
Node 로서의 다음의 형제 위젯, 또는 null

getAttributes

public NamedNodeMap  getAttributes()
인터페이스 Node 의 기술:
이 노드가 Element 의 경우, 이 노드의 속성을 포함한 NamedNodeMap 입니다. 그 이외의 경우는 null 입니다.

정의:
인터페이스 Node 내의 getAttributes

getOwnerDocument

public Document  getOwnerDocument()
IIOMetadataNode 는 어느 Document 에도 속하지 않기 때문에,null 를 돌려줍니다.

정의:
인터페이스 Node 내의 getOwnerDocument
반환값:
null

insertBefore

public Node  insertBefore(Node  newChild,
                         Node  refChild)
기존의 refChild 자 노드의 전에 newChild 노드를 삽입합니다. refChildnull 의 경우, 아이 리스트의 마지막에 newChild 를 삽입합니다.

정의:
인터페이스 Node 내의 insertBefore
파라미터:
newChild - 삽입하는 Node
refChild - 참조 Node
반환값:
삽입되는 노드
예외:
IllegalArgumentException - newChildnull 의 경우

replaceChild

public Node  replaceChild(Node  newChild,
                         Node  oldChild)
아이 리스트안의 자식(child) 노드 oldChildnewChild 로 옮겨놓아oldChild 노드를 돌려줍니다.

정의:
인터페이스 Node 내의 replaceChild
파라미터:
newChild - 삽입하는 Node
oldChild - 치환되는 Node
반환값:
치환된 노드
예외:
IllegalArgumentException - newChildnull 의 경우

removeChild

public Node  removeChild(Node  oldChild)
아이 리스트로부터 oldChild 로 나타나는 자식(child) 노드를 삭제해, 이 자식(child) 노드를 돌려줍니다.

정의:
인터페이스 Node 내의 removeChild
파라미터:
oldChild - 삭제되는 Node
반환값:
삭제된 노드
예외:
IllegalArgumentException - oldChildnull 의 경우

appendChild

public Node  appendChild(Node  newChild)
노드 newChild 를 이 노드의 아이의 리스트의 말미에 추가합니다.

정의:
인터페이스 Node 내의 appendChild
파라미터:
newChild - 삽입하는 Node
반환값:
추가된 노드
예외:
IllegalArgumentException - newChildnull 의 경우

hasChildNodes

public boolean hasChildNodes()
이 노드에 자식(child) 노드가 있는 경우는 true 를 돌려줍니다.

정의:
인터페이스 Node 내의 hasChildNodes
반환값:
이 노드에 아이가 있는 경우는 true

cloneNode

public Node  cloneNode(boolean deep)
이 노드의 복제를 돌려줍니다. 복제 노드에는 부모가 없습니다 (getParentNodenull 를 돌려줍니다). 샤로 복제를 실행하면(자) (deepfalse), 새로운 노드에는 아이나 형제 위젯가 없습니다. 딥 복제를 실행하면(자), 새로운 노드는 완전하게 복제된 서브 트리의 루트를 형성합니다.

정의:
인터페이스 Node 내의 cloneNode
파라미터:
deep - true 의 경우는, 지정된 노드아래에 서브 트리를 재귀적으로 복제해,false 의 경우는, 노드 자체만을 복제합니다.
반환값:
복제된 노드

normalize

public void normalize()
IIOMetadataNode 에는 아이 Text 가 포함되지 않기 때문에, 아무것도 실행하지 않습니다.

정의:
인터페이스 Node 내의 normalize

isSupported

public boolean isSupported(String  feature,
                           String  version)
DOM 기능은 지원되어 있지 않기 때문에,false 를 돌려줍니다.

정의:
인터페이스 Node 내의 isSupported
파라미터:
feature - String. 무시되는
version - String. 무시된다
반환값:
false

getNamespaceURI

public String  getNamespaceURI()
                       throws DOMException 
이름 공간은 지원되지 않기 때문에,null 를 돌려줍니다.

정의:
인터페이스 Node 내의 getNamespaceURI
예외:
DOMException

getPrefix

public String  getPrefix()
이름 공간은 지원되지 않기 때문에,null 를 돌려줍니다.

정의:
인터페이스 Node 내의 getPrefix
반환값:
null
관련 항목:
setPrefix(java.lang.String)

setPrefix

public void setPrefix(String  prefix)
이름 공간은 지원되지 않기 때문에, 아무것도 실행하지 않습니다.

정의:
인터페이스 Node 내의 setPrefix
파라미터:
prefix - String. 무시되는
관련 항목:
getPrefix()

getLocalName

public String  getLocalName()
getNodeName 와 같습니다.

정의:
인터페이스 Node 내의 getLocalName
반환값:
String 로서의 노드명

getTagName

public String  getTagName()
인터페이스 Element 의 기술:
요소의 이름입니다. Node.localNamenull 이외의 경우, 이 속성은 수식명입니다. 다음에 예를 나타냅니다.
<elementExample id="demo"> ... 
 </elementExample> , 
tagName 의 값은 「elementExample」입니다. XML 에서는, DOM 의 조작과 같게 알파벳의 대문자와 소문자의 구별이 보존됩니다. HTML DOM 는, 소스가 되는 HTML 문서로 대문자와 소문자의 어느 쪽이 사용되고 있어도, HTML 요소의 tagName 를 표준의 대문자로 돌려줍니다.

정의:
인터페이스 Element 내의 getTagName

getAttribute

public String  getAttribute(String  name)
인터페이스 Element 의 기술:
이름을 지정해 속성을 가져옵니다.

정의:
인터페이스 Element 내의 getAttribute
파라미터:
name - 취득하는 속성의 이름
반환값:
캐릭터 라인으로 표현된 Attr 의 값. 그 속성이 지정된 값 또는 디폴트 값를 가지지 않는 경우는 공문자열

getAttributeNS

public String  getAttributeNS(String  namespaceURI,
                             String  localName)
getAttribute(localName) 와 같습니다.

정의:
인터페이스 Element 내의 getAttributeNS
파라미터:
namespaceURI - 취득하는 속성의 이름 공간 URI
localName - 취득하는 속성의 로컬명
반환값:
캐릭터 라인으로 표현된 Attr 의 값. 그 속성이 지정된 값 또는 디폴트 값를 가지지 않는 경우는 공문자열
관련 항목:
setAttributeNS(java.lang.String, java.lang.String, java.lang.String)

setAttribute

public void setAttribute(String  name,
                         String  value)
인터페이스 Element 의 기술:
새로운 속성을 추가합니다. 요소내에 그 이름의 속성이 벌써 존재하는 경우, 그 값은 value 파라미터의 값으로 변경됩니다. 이 값은 단순한 캐릭터 라인이며, 설정시에 해석은 행해지지 않습니다. 그 결과, 모든 마크 업 (엔티티 참조로서 인식되는 구문을 포함한다)이 문자 텍스트라고 보여집니다. 구현은, 서두를 실시할 때, 이것을 적절한 방법으로 이스케이프 할 필요가 있습니다. 엔티티 참조를 포함한 속성치를 할당하려면 ,Attr 노드 외에 Text 노드와 EntityReference 노드를 작성할 필요가 있습니다. 다음에, 적절한 서브 트리를 구축해,setAttributeNode 를 사용해, 이것을 속성치로서 할당합니다.
수식명과 이름 공간 URI 를 지정해 속성을 설정하려면 ,setAttributeNS 메소드를 사용합니다.

정의:
인터페이스 Element 내의 setAttribute
파라미터:
name - 작성 또는 변경하는 속성의 이름
value - 설정하는 값을 나타내는 캐릭터 라인

setAttributeNS

public void setAttributeNS(String  namespaceURI,
                           String  qualifiedName,
                           String  value)
setAttribute(qualifiedName, value) 와 같습니다.

정의:
인터페이스 Element 내의 setAttributeNS
파라미터:
namespaceURI - 작성 또는 변경하는 속성의 이름 공간 URI
qualifiedName - 작성 또는 변경하는 속성의 수식명
value - 설정하는 값을 나타내는 캐릭터 라인
관련 항목:
getAttributeNS(java.lang.String, java.lang.String)

removeAttribute

public void removeAttribute(String  name)
인터페이스 Element 의 기술:
이름을 지정해 속성을 삭제합니다. 삭제되는 속성의 디폴트 값가 DTD 로 정의되고 있으면(자), 디폴트 값 뿐만이 아니라, 해당하는 경우는 대응하는 이름 공간 URI, 로컬명, 접두사와 함께 새로운 속성이 곧바로 표시됩니다. 구현에서는, 똑같이 다른 schema의 디폴트 값를 처리할 수 있습니다만, 어플리케이션에서는 Document.normalizeDocument() 를 사용해, 정보가 최신의 정보인 것을 보증할 필요가 있습니다.
이 이름을 가지는 속성이 발견되지 않는 경우에는, 이 메소드는 효과가 없습니다.
로컬명과 이름 공간 URI 를 지정해 속성을 삭제하려면 ,removeAttributeNS 메소드를 사용합니다.

정의:
인터페이스 Element 내의 removeAttribute
파라미터:
name - 삭제하는 속성의 이름

removeAttributeNS

public void removeAttributeNS(String  namespaceURI,
                              String  localName)
removeAttribute(localName) 와 같습니다.

정의:
인터페이스 Element 내의 removeAttributeNS
파라미터:
namespaceURI - 삭제하는 속성의 이름 공간 URI
localName - 삭제하는 속성의 로컬명

getAttributeNode

public Attr  getAttributeNode(String  name)
인터페이스 Element 의 기술:
이름을 지정해 속성 노드를 가져옵니다.
수식명과 이름 공간 URI 를 지정해 속성 노드를 가져오려면 ,getAttributeNodeNS 메소드를 사용합니다.

정의:
인터페이스 Element 내의 getAttributeNode
파라미터:
name - 취득하는 속성의 이름 (nodeName)
반환값:
지정된 이름 (nodeName)의 Attr 노드. 해당하는 속성이 존재하지 않는 경우는 null

getAttributeNodeNS

public Attr  getAttributeNodeNS(String  namespaceURI,
                               String  localName)
getAttributeNode(localName) 와 같습니다.

정의:
인터페이스 Element 내의 getAttributeNodeNS
파라미터:
namespaceURI - 취득하는 속성의 이름 공간 URI
localName - 취득하는 속성의 로컬명
반환값:
지정된 속성 로컬명과 이름 공간 URI 를 가지는 Attr 노드. 해당하는 속성이 존재하지 않는 경우는 null
관련 항목:
setAttributeNodeNS(org.w3c.dom.Attr)

setAttributeNode

public Attr  setAttributeNode(Attr  newAttr)
                      throws DOMException 
인터페이스 Element 의 기술:
새로운 속성을 추가합니다. 지정한 이름 (nodeName)을 가지는 속성이 벌써 요소내에 존재하는 경우는, 새로운 속성으로 옮겨집니다. 속성 노드를 그 속성 노드 자체에 옮겨놓아도 영향은 전혀 없습니다.
수식명과 이름 공간 URI 를 지정해 속성 노드를 추가하려면 ,setAttributeNodeNS 메소드를 사용합니다.

정의:
인터페이스 Element 내의 setAttributeNode
파라미터:
newAttr - 속성 리스트에 추가하는 Attr 노드
반환값:
기존의 속성이 newAttr 속성으로 옮겨놓을 수 있는 경우는 치환의 대상이 되는 Attr 노드. 그 이외의 경우는 null
예외:
DOMException - WRONG_DOCUMENT_ERR:요소를 작성한 문서와는 다른 문서로부터 newAttr 하지만 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
INUSE_ATTRIBUTE_ERR:newAttr 가 벌써 다른 Element 객체의 속성으로서 사용되고 있는 경우. Attr 노드를 다른 요소로 재사용하려면 , 이 노드를 DOM 사용자의 손으로 명시적으로 복제한다 필요가 있다

setAttributeNodeNS

public Attr  setAttributeNodeNS(Attr  newAttr)
setAttributeNode(newAttr) 와 같습니다.

정의:
인터페이스 Element 내의 setAttributeNodeNS
파라미터:
newAttr - 속성 리스트에 추가하는 Attr 노드
반환값:
지정과 같은 로컬명 및 이름 공간 URI (을)를 가지는 기존의 속성이 newAttr 속성으로 옮겨놓을 수 있는 경우는 치환의 대상이 되는 Attr 노드. 그 이외의 경우는 null
관련 항목:
getAttributeNodeNS(java.lang.String, java.lang.String)

removeAttributeNode

public Attr  removeAttributeNode(Attr  oldAttr)
인터페이스 Element 의 기술:
지정된 속성 노드를 삭제합니다. 삭제되는 Attr 노드의 디폴트 값가 DTD 로 정의되고 있으면(자), 디폴트 값 뿐만이 아니라, 해당하는 경우는 대응하는 이름 공간 URI, 로컬명, 접두사와 함께 새로운 노드가 곧바로 표시됩니다. 구현에서는, 똑같이 다른 schema의 디폴트 값를 처리할 수 있습니다만, 어플리케이션에서는 Document.normalizeDocument() 를 사용해, 정보가 최신의 정보인 것을 보증할 필요가 있습니다.

정의:
인터페이스 Element 내의 removeAttributeNode
파라미터:
oldAttr - 속성 리스트로부터 삭제하는 Attr 노드
반환값:
삭제된 Attr 노드

getElementsByTagName

public NodeList  getElementsByTagName(String  name)
인터페이스 Element 의 기술:
주어진(given) 태그명과 함께, 모든 자손 ElementsNodeList 를 문서순서에 돌려줍니다.

정의:
인터페이스 Element 내의 getElementsByTagName
파라미터:
name - 일치하는 태그의 이름. 특수한 값 「*」은 모든 태그에 일치한다.
반환값:
일치하는 Element 노드의 리스트

getElementsByTagNameNS

public NodeList  getElementsByTagNameNS(String  namespaceURI,
                                       String  localName)
getElementsByTagName(localName) 와 같습니다.

정의:
인터페이스 Element 내의 getElementsByTagNameNS
파라미터:
namespaceURI - 일치하는 요소의 이름 공간 URI. 특수한 값 「*」은 모든 이름 공간에 일치하는
localName - 일치하는 요소의 로컬명. 특수한 값 「*」은 모든 로컬명에 일치한다
반환값:
일치하는 모든 Elements 를 포함한 새로운 NodeList 객체

hasAttributes

public boolean hasAttributes()
인터페이스 Node 의 기술:
이 노드가 요소인 경우, 속성을 가지고 있을지 어떨지를 판단합니다.

정의:
인터페이스 Node 내의 hasAttributes
반환값:
이 노드가 속성을 가지고 있는 경우는 true, 그렇지 않은 경우는 false

hasAttribute

public boolean hasAttribute(String  name)
인터페이스 Element 의 기술:
이 요소상에 주어진(given) 이름의 속성이 지정되었을 경우, 또는 속성에 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false

정의:
인터페이스 Element 내의 hasAttribute
파라미터:
name - 검색하는 속성의 이름
반환값:
이 요소상에 주어진(given) 이름의 속성이 지정되었을 경우, 또는 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false

hasAttributeNS

public boolean hasAttributeNS(String  namespaceURI,
                              String  localName)
hasAttribute(localName) 와 같습니다.

정의:
인터페이스 Element 내의 hasAttributeNS
파라미터:
namespaceURI - 검색하는 속성의 이름 공간 URI
localName - 검색하는 속성의 로컬명
반환값:
이 요소상에 주어진(given) 로컬명과 이름 공간 URI 를 가지는 속성이 지정되었을 경우, 또는 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false

getLength

public int getLength()
인터페이스 NodeList 의 기술:
리스트내의 노드수입니다. 유효한 자식(child) 노드 인덱스의 범위는 0 이상 length-1 이하입니다.

정의:
인터페이스 NodeList 내의 getLength

item

public Node  item(int index)
인터페이스 NodeList 의 기술:
집합내의 index 번째의 항목을 돌려줍니다. index 가 리스트내의 노드수와 같은가 그것보다 큰 경우는 null 를 돌려줍니다.

정의:
인터페이스 NodeList 내의 item
파라미터:
index - 집합의 인덱스
반환값:
NodeList 내의 index 번째의 위치에 있는 노드. 인덱스가 유효하지 않은 경우는 null

getUserObject

public Object  getUserObject()
이 노드에 관련한 Object 치를 돌려줍니다.

반환값:
사용자 Object
관련 항목:
setUserObject(java.lang.Object)

setUserObject

public void setUserObject(Object  userObject)
이 노드에 관련한 값을 설정합니다.

파라미터:
userObject - 사용자 Object
관련 항목:
getUserObject()

setIdAttribute

public void setIdAttribute(String  name,
                           boolean isId)
                    throws DOMException 
인터페이스 Element 의 기술:
isId 파라미터가 true 의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다. 이것은,Attr.isId 의 값과 Document.getElementById 의 동작에 영향을 미칩니다만, 사용중의 schema는 변경되지 않습니다. 특히, 지정된 Attr 노드의 Attr.schemaTypeInfo 에는 영향을 주지 않습니다. isId 파라미터의 false 치를 사용하면(자), 속성이 사용자 결정 ID 속성인 것은 선언되지 않습니다.
로컬명과 이름 공간 URI 로 속성을 지정하려면 ,setIdAttributeNS 메소드를 사용합니다.

정의:
인터페이스 Element 내의 setIdAttribute
파라미터:
name - 속성의 이름
isId - 속성이 형태 ID 의 속성일지 어떨지를 판정
예외:
DOMException - NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
NOT_FOUND_ERR:지정된 노드가 이 요소의 속성이 아닌 경우

setIdAttributeNS

public void setIdAttributeNS(String  namespaceURI,
                             String  localName,
                             boolean isId)
                      throws DOMException 
인터페이스 Element 의 기술:
isId 파라미터가 true 의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다. 이것은,Attr.isId 의 값과 Document.getElementById 의 동작에 영향을 미칩니다만, 사용중의 schema는 변경되지 않습니다. 특히, 지정된 Attr 노드의 Attr.schemaTypeInfo 에는 영향을 주지 않습니다. isId 파라미터의 false 치를 사용하면(자), 속성이 사용자 결정 ID 속성인 것은 선언되지 않습니다.

정의:
인터페이스 Element 내의 setIdAttributeNS
파라미터:
namespaceURI - 속성의 이름 공간 URI
localName - 속성의 로컬명
isId - 속성이 형태 ID 의 속성일지 어떨지를 판정
예외:
DOMException - NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
NOT_FOUND_ERR:지정된 노드가 이 요소의 속성이 아닌 경우

setIdAttributeNode

public void setIdAttributeNode(Attr  idAttr,
                               boolean isId)
                        throws DOMException 
인터페이스 Element 의 기술:
isId 파라미터가 true 의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다. 이것은,Attr.isId 의 값과 Document.getElementById 의 동작에 영향을 미칩니다만, 사용중의 schema는 변경되지 않습니다. 특히, 지정된 Attr 노드의 Attr.schemaTypeInfo 에는 영향을 주지 않습니다. isId 파라미터의 false 치를 사용하면(자), 속성이 사용자 결정 ID 속성인 것은 선언되지 않습니다.

정의:
인터페이스 Element 내의 setIdAttributeNode
파라미터:
idAttr - 속성 노드
isId - 속성이 형태 ID 의 속성일지 어떨지를 판정
예외:
DOMException - NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
NOT_FOUND_ERR:지정된 노드가 이 요소의 속성이 아닌 경우

getSchemaTypeInfo

public TypeInfo  getSchemaTypeInfo()
인터페이스 Element 의 기술:
이 요소에 관련하는 형태 정보입니다.

정의:
인터페이스 Element 내의 getSchemaTypeInfo

setUserData

public Object  setUserData(String  key,
                          Object  data,
                          UserDataHandler  handler)
인터페이스 Node 의 기술:
이 노드의 키에 객체를 관련짓습니다. 이 이후, 객체는, 같은 키로 getUserData 를 호출해 취득할 수 있습니다.

정의:
인터페이스 Node 내의 setUserData
파라미터:
key - 객체를 관련짓는 키
data - 주어진(given) 키에 관련짓는 객체. 주어진(given) 키에 대한 기존의 관련을 삭제하는 경우는 null
handler - 주어진(given) 키에 관련짓는 핸들러, 또는 null
반환값:
이 노드의 주어진(given) 키에 이전 관련지을 수 있고 있던 DOMUserData. 관련지을 수 있지 않았던 경우는 null

getUserData

public Object  getUserData(String  key)
인터페이스 Node 의 기술:
이 노드의 키에 관련지을 수 있었던 객체를 가져옵니다. 객체는, 우선 같은 키로 setUserData 를 호출해, 이 노드에 대해서 벌써 설정되어 있을 필요가 있습니다.

정의:
인터페이스 Node 내의 getUserData
파라미터:
key - 객체를 관련지을 수 있고 있는 키
반환값:
이 노드의 주어진(given) 키에 관련지을 수 있었던 DOMUserData. 관련지을 수 있지 않았던 경우는 null

getFeature

public Object  getFeature(String  feature,
                         String  version)
인터페이스 Node 의 기술:
이 메소드는, 지정한 기능과 버젼을 가지는 특수한 형식의 API 가 지정되었던 대로 구현하는 특수한 형식의 객체를 돌려줍니다. 특수한 형식의 객체는, 바인딩 고유의 캐스팅 메소드를 사용해 취득할 수도 있습니다만, 반드시 설명되고 있도록(듯이) 네 오지 않습니다. 이 메소드를 사용하면(자), 구현에서는 Node 인터페이스를 지원하고 있지 않는 특수한 형식의 객체를 이용할 수 있습니다.

정의:
인터페이스 Node 내의 getFeature
파라미터:
feature - 요구된 기능의 이름. 기능명의 전에 추가되는 플러스 기호 「+」은, 이 메소드의 문맥에서는 의미가 있지 않기 때문에 무시되는
version - 테스트하는 기능의 버젼 번호
반환값:
지정된 기능과 버젼의 특수한 형식의 API 를 구현하는 객체 (존재하는 경우). 지정된 기능에 관련지을 수 있었다 인터페이스를 구현하는 객체가 존재하지 않는 경우는 null. 이 메소드에 의해 반환되는 DOMObjectNode 인터페이스를 구현하는 경우, 이 인터페이스를 주요 코어 Node 에 위양 해, attributes, childNodes 라고 하는 주요 코어 Node (와)과 정합하지 않는 결과를 돌려주는 것이 없게 할 필요가 있다

isSameNode

public boolean isSameNode(Node  node)
인터페이스 Node 의 기술:
이 노드가 지정된 노드와 같은 노드일지 어떨지를 돌려줍니다.
이 메소드를 사용하면(자), 구현으로 반환된 2 개의 Node 참조가 같은 객체를 참조할지 어떨지를 판정할 수 있습니다. 2 개의 Node 참조가 같은 객체를 참조하는 경우는, 프록시를 통한 참조의 경우에서도, 모든 속성이 같은 값을 가져, 어느 쪽인가의 참조의 같은 DOM 메소드의 호출이 항상 완전히 같은 효과를 발휘하도록(듯이), 참조를 완전하게 교대로 사용할 수 있습니다.

정의:
인터페이스 Node 내의 isSameNode
파라미터:
node - 테스트 대상의 노드
반환값:
노드가 같은 있는 경우는 true, 그렇지 않은 경우는 false

isEqualNode

public boolean isEqualNode(Node  node)
인터페이스 Node 의 기술:
2 개의 노드가 동일한지 어떤지를 테스트합니다.
이 메소드는,Node.isSameNode() 를 사용해 테스트할 수 있는 노드의 동일성 (2 개의 노드가 같은 객체를 참조할지 어떨지)은 아니고 동등성을 테스트합니다. 같다 모든 노드는 동등하기도 합니다만, 그 역은 반드시 들어맞지 않습니다.
2 개의 노드가 동등해요는, 다음의 조건이 채워지는 경우만입니다.
  • 2 개의 노드가 같은 형태의 노드이다
  • 캐릭터 라인 속성의 nodeName,localName,namespaceURI,prefix,nodeValue 가 동일하다. 즉, 2 개의 노드가 null 인지, 같은 길이를 가져, 동일 문자의 문자이다
  • attributes NamedNodeMaps 가 동일하다. 즉, 2 개의 노드가 양쪽 모두 null 인지, 또는 같은 길이를 가져, 1 개의 맵에 존재하는 각 노드에 대해서 다른 맵에 존재하는 노드가 있어, 동일하지만, 반드시 같은 인덱스에는 없다
  • childNodes NodeLists 가 동일하다. 즉, 양쪽 모두 null 인지, 또는 같은 길이를 가져, 같은 인덱스에 동일한 노드를 가진다. 정규화는, 동등성에 영향을 미칠 가능성이 있는 것에 주의가 필요. 이 영향을 피하려면 , 노드를 정규화하고 나서 비교를 실시할 필요가 있다

2 개의 DocumentType 노드가 동일하기 위해(때문에)는, 다음의 조건이 채워질 필요가 있습니다.
  • 캐릭터 라인 속성의 publicId,systemId,internalSubset 가 동일하다
  • entities NamedNodeMaps 가 동일하다
  • notations NamedNodeMaps 가 동일하다

한편, 다음은 동등성에 영향을 주지 않습니다. ownerDocument,baseURI, 및 parentNode 속성,Attr 노드의 specified 속성,Attr 노드와 Element 노드의 schemaTypeInfo 속성,Text 노드의 Text.isElementContentWhitespace 속성, 및 노드에 등록되어 있는 사용자 데이터 또는 이벤트 청취자

주:일반적으로, 위의 설명으로 다루어지지 않은 것은, 동일성 체크의 면에서 의미가 있지는 않습니다. 이 스펙의 장래 버젼에서는, 보다 많은 속성을 고려해, 이 스펙에 준거하는 구현을 적당 갱신할 예정입니다.

정의:
인터페이스 Node 내의 isEqualNode
파라미터:
node - 동일성을 비교하는 대상의 노드
반환값:
노드가 동일한 경우는 true, 그렇지 않은 경우는 false

lookupNamespaceURI

public String  lookupNamespaceURI(String  prefix)
인터페이스 Node 의 기술:
지정한 노드로부터 개시해, 주어진(given) 접두사에 관련하는 이름 공간 URI 를 검색합니다.
자세한 것은, 이 메소드로 사용되는 알고리즘을 참조해 주세요.

정의:
인터페이스 Node 내의 lookupNamespaceURI
파라미터:
prefix - 검색하는 접두사. 이 파라미터가 null 의 경우, 메소드는 디폴트의 이름 공간 URI 를 돌려준다 (존재하는 경우)
반환값:
관련지을 수 있었던 이름 공간 URI, 발견되지 않았던 경우는 null

isDefaultNamespace

public boolean isDefaultNamespace(String  namespaceURI)
인터페이스 Node 의 기술:
이 메소드는, 지정된 namespaceURI 가 디폴트의 이름 공간일지 어떨지를 체크합니다.

정의:
인터페이스 Node 내의 isDefaultNamespace
파라미터:
namespaceURI - 검색하는 이름 공간 URI
반환값:
지정된 namespaceURI 가 디폴트의 이름 공간인 경우는 true, 그렇지 않은 경우는 false

lookupPrefix

public String  lookupPrefix(String  namespaceURI)
인터페이스 Node 의 기술:
지정된 노드로부터 개시해, 주어진(given) 이름 공간 URI 에 관련하는 접두사를 검색합니다. 이 메소드는, 디폴트의 이름 공간 선언을 무시합니다.
자세한 것은, 이 메소드로 사용되는 알고리즘을 참조해 주세요.

정의:
인터페이스 Node 내의 lookupPrefix
파라미터:
namespaceURI - 검색하는 이름 공간 URI
반환값:
발견되었을 경우는, 관련지을 수 있었던 이름 공간 접두사, 발견되지 않았던 경우는 null. 복수의 접두사가 이름 공간 접두사에 관련지을 수 있고 있는 경우, 반환되는 이름 공간 접두사는 구현에 응해 다르다

getTextContent

public String  getTextContent()
                      throws DOMException 
인터페이스 Node 의 기술:
이 속성은, 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 돌려줍니다. 이 속성을 null 에 정의했을 경우, 설정에 의한 영향은 없습니다. 설정에서는, 이 노드가 가질 수가 있는 생각되는 아이는 모두 삭제되어 새로운 캐릭터 라인이 빈 상태(empty) 또는 null 인 경우, 이 속성이 설정되어 있는 캐릭터 라인을 포함한 단일의 Text 노드로 옮겨집니다.
취득에서는, 직렬화는 행해지지 않고, 반환되는 캐릭터 라인은 마크 업을 포함하지 않습니다. 공백 문자의 정규화는 행해지지 않고, 반환되는 캐릭터 라인은 요소 컨텐츠에 공백 문자를 포함하지 않습니다 (Text.isElementContentWhitespace 속성을 참조). 같이 설정에서는, 해석도 행해지지 않습니다. 입력 캐릭터 라인은 순수한 텍스트 형식의 컨텐츠로서 취득됩니다.
반환되는 캐릭터 라인은, 다음에 나타내도록(듯이) 노드의 형태에 응해, 노드의 텍스트 컨텐츠로 구성되어 있습니다.
노드형 컨텐츠
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE COMMENT_NODE 노드와 PROCESSING_INSTRUCTION_NODE 노드를 제외한, 모든 자식(child) 노드의 textContent 속성치의 연결. 노드가 아이를 가지지 않는 경우는, 빈 상태(empty)의 캐릭터 라인
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE nodeValue
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE null

정의:
인터페이스 Node 내의 getTextContent
예외:
DOMException - DOMSTRING_SIZE_ERR:반환되는 문자수가 너무 많아서 구현 플랫폼상의 DOMString 변수에 들어가지 않는 경우

setTextContent

public void setTextContent(String  textContent)
                    throws DOMException 
인터페이스 Node 의 기술:
이 속성은, 지정된 노드와 노드의 자손의 텍스트 컨텐츠를 돌려줍니다. 이 속성을 null 에 정의했을 경우, 설정에 의한 영향은 없습니다. 설정에서는, 이 노드가 가질 수가 있는 생각되는 아이는 모두 삭제되어 새로운 캐릭터 라인이 빈 상태(empty) 또는 null 인 경우, 이 속성이 설정되어 있는 캐릭터 라인을 포함한 단일의 Text 노드로 옮겨집니다.
취득에서는, 직렬화는 행해지지 않고, 반환되는 캐릭터 라인은 마크 업을 포함하지 않습니다. 공백 문자의 정규화는 행해지지 않고, 반환되는 캐릭터 라인은 요소 컨텐츠에 공백 문자를 포함하지 않습니다 (Text.isElementContentWhitespace 속성을 참조). 같이 설정에서는, 해석도 행해지지 않습니다. 입력 캐릭터 라인은 순수한 텍스트 형식의 컨텐츠로서 취득됩니다.
반환되는 캐릭터 라인은, 다음에 나타내도록(듯이) 노드의 형태에 응해, 노드의 텍스트 컨텐츠로 구성되어 있습니다.
노드형 컨텐츠
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE COMMENT_NODE 노드와 PROCESSING_INSTRUCTION_NODE 노드를 제외한, 모든 자식(child) 노드의 textContent 속성치의 연결. 노드가 아이를 가지지 않는 경우는, 빈 상태(empty)의 캐릭터 라인
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE nodeValue
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE null

정의:
인터페이스 Node 내의 setTextContent
예외:
DOMException - NO_MODIFICATION_ALLOWED_ERR:노드가 읽어내 전용의 경우

compareDocumentPosition

public short compareDocumentPosition(Node  other)
                              throws DOMException 
인터페이스 Node 의 기술:
이 메소드가 불려 가고 있는 참조 노드를, 파라미터로서 건네받는 노드와 문서내의 위치에 관해서 문서순서와 비교합니다.

정의:
인터페이스 Node 내의 compareDocumentPosition
파라미터:
other - 참조 노드와 비교하는 노드
반환값:
참조 노드에 대해서 노드의 상대적인 위치를 결정한다 방법
예외:
DOMException - NOT_SUPPORTED_ERR:비교 대상 노드가, 일관한 구현 고유의 결과를 돌려주도록(듯이) 조정하지 않는다 다른 DOM 구현의 노드인 경우

getBaseURI

public String  getBaseURI()
인터페이스 Node 의 기술:
이 노드의 절대 베이스 URI, 구현이 절대 URI 를 취득할 수 없었던 경우는 null 가 됩니다. 이 값은, 설명에 따라 계산됩니다. 다만,Document 가 「HTML」기능「DOM Level 2 HTML」를 지원하는 경우, 베이스 URI 는, 우선 HTML BASE 요소의 href 속성의 값 (존재하는 경우)을 사용해 계산되어 그렇지 않은 경우는 Document 인터페이스의 documentURI 속성의 값을 사용해 계산됩니다.

정의:
인터페이스 Node 내의 getBaseURI

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.