Element (Java 2 플랫폼 SE v1. 4.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2
Platform
Std. Ed. v1. 4.0

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | constructor | 메소드

상세: 필드 | constructor | 메소드

org.w3c.dom
인터페이스 Element

모든 슈퍼 인터페이스:: Node

기존의 구현 클래스의 일람:: IIOMetadataNode

public interface Element
extends Node

Element 인터페이스는 HTML 문서 또는 XML 문서내의 요소를 나타냅니다. 이러한 요소는 자신이 관련지을 수 있었던 속성을 가질 수가 있습니다. Element 인터페이스는 Node 를 계승하므로, 범용의 Node 인터페이스 속성인 attributes 를 사용해, 어느 요소의 속성 전부를 취득할 수가 있습니다. Element 인터페이스상에는 이름을 지정해 Attr 오브젝트를 취득하는 메소드나, 이름을 지정해 속성치를 취득하는 메소드가 있습니다. XML 에서는 속성치에 엔티티 참조를 포함할 수가 있습니다. 따라서,Attr 오브젝트를 취득하는 것으로써, 속성치를 나타내는 서브 트리 ( 꽤 복잡한 것을 포함한다)를 검사할 필요가 있습니다. 한편, HTML 에서는 속성은 모두 단순한 캐릭터 라인치를 가지게 됩니다. 따라서, 속성치에 직접 액세스 하는 메소드를 안전하고 편리하게 사용할 수가 있습니다. DOM 레벨 2 에서는 메소드 normalize 는 그 이동처 Node 인터페이스로부터 계승됩니다.

「Document Object Model (DOM) Level 2 Core Specification 」를 참조해 주세요.

필드의 개요

인터페이스 org.w3c.dom. Node 에서 상속받은 필드

ATTRIBUTE_NODE , CDATA_SECTION_NODE , COMMENT_NODE , DOCUMENT_FRAGMENT_NODE , DOCUMENT_NODE , DOCUMENT_TYPE_NODE , ELEMENT_NODE , ENTITY_NODE , ENTITY_REFERENCE_NODE , NOTATION_NODE , PROCESSING_INSTRUCTION_NODE , TEXT_NODE

메소드의 개요

String getAttribute (String name)
          이름을 지정해 속성을 취득합니다.

Attr getAttributeNode (String name)
          이름을 지정해 속성 노드를 취득합니다.

Attr getAttributeNodeNS (String namespaceURI, String localName)
          로컬명과 네임 스페이스 URI 를 지정해 Attr 노드를 취득합니다.

String getAttributeNS (String namespaceURI, String localName)
          로컬명과 네임 스페이스 URI 를 지정해 속성치를 취득합니다.

NodeList getElementsByTagName (String name)
          소정의 태그명과 함께, 모든 자손 Elements 의 NodeList 를 돌려줍니다.

NodeList getElementsByTagNameNS (String namespaceURI, String localName)
          소정의 로컬명 및 네임 스페이스 URI 와 함께, 모든 Elements 의 NodeList 를 돌려줍니다.

String getTagName ()
          요소의 이름입니다.

boolean hasAttribute (String name)
          이 요소상에 소정의 이름의 속성이 지정되었을 경우, 또는 속성에 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false

boolean hasAttributeNS (String namespaceURI, String localName)
          이 요소상에 소정의 로컬명과 네임 스페이스 URI 를 가지는 속성이 지정되었을 경우, 또는 그 속성에 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false
"XML" 기능을 서포트하지 않는 문서에서는 요소나 속성을 작성 또는 설정하는 DOM 레벨 1 호출만이 허가됩니다.

void removeAttribute (String name)
          이름을 지정해 속성을 삭제합니다.

Attr removeAttributeNode (Attr oldAttr)
          지정된 속성 노드를 삭제합니다.

void removeAttributeNS (String namespaceURI, String localName)
          로컬명과 네임 스페이스 URI 를 지정해 속성을 삭제합니다.

void setAttribute (String name, String value)
          새로운 속성을 추가합니다.

Attr setAttributeNode (Attr newAttr)
          새로운 속성 노드를 추가합니다.

Attr setAttributeNodeNS (Attr newAttr)
          새로운 속성을 추가합니다.

void setAttributeNS (String namespaceURI, String qualifiedName, String value)
          새로운 속성을 추가합니다.

인터페이스 org.w3c.dom. Node 에서 상속받은 메소드

appendChild , cloneNode , getAttributes , getChildNodes , getFirstChild , getLastChild , getLocalName , getNamespaceURI , getNextSibling , getNodeName , getNodeType , getNodeValue , getOwnerDocument , getParentNode , getPrefix , getPreviousSibling , hasAttributes , hasChildNodes , insertBefore , isSupported , normalize , removeChild , replaceChild , setNodeValue , setPrefix

메소드의 상세

getTagName

public String  getTagName()

요소의 이름입니다. 이하의 예를 참조해 주세요.

 <elementExample 
 id="demo"> ... </elementExample> ,

tagName 의 값은 "elementExample" 입니다. XML 에서는 DOM 의 조작과 같게 알파벳의 대문자와 소문자의 구별이 보존됩니다. HTML DOM 는 소스가 되는 HTML 문서로 대문자와 소문자의 어느 쪽이 사용되고 있어도, HTML 요소의 tagName 를 표준의 대문자로 돌려줍니다.

getAttribute

public String  getAttribute(String  name)

이름을 지정해 속성을 취득합니다.

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

setAttribute

public void setAttribute(String  name,
                         String  value)
                  throws DOMException

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

파라미터:: name - 작성 또는 변경하는 속성의 이름; value - 설정하는 값을 나타내는 캐릭터 라인
예외:: DOMException - INVALID_CHARACTER_ERR: 지정된 이름에 부정한 캐릭터가 포함되어 있는 경우
NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우

removeAttribute

public void removeAttribute(String  name)
                     throws DOMException

이름을 지정해 속성을 삭제합니다. 삭제되는 속성이 디폴트 값를 가지는 속성인 경우, 대응하는 네임 스페이스 URI, 로컬명, 전치수식자 (적절한 경우)와 디폴트 값를 가지는 속성이 즉석에서 작성됩니다.
로컬명과 네임 스페이스 URI 를 지정해 속성을 삭제하려면 ,removeAttributeNS 메소드를 사용합니다.

파라미터:: name - 삭제하는 속성의 이름
예외:: DOMException - NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우

getAttributeNode

public Attr  getAttributeNode(String  name)

이름을 지정해 속성 노드를 취득합니다.
수식명과 네임 스페이스 URI 를 지정해 속성 노드를 취득하려면 ,getAttributeNS 메소드를 사용합니다.

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

setAttributeNode

public Attr  setAttributeNode(Attr  newAttr)
                      throws DOMException

새로운 속성 노드를 추가합니다. 지정한 이름 ( nodeName)의 속성이 벌써 요소내에 존재하는 경우, 새로운 속성으로 옮겨놓을 수 있습니다.
수식명과 네임 스페이스 URI 를 지정해 속성 노드를 추가하려면 ,

setAttributeNodeNS 메소드를 사용합니다.



파라미터: 
newAttr - 속성 리스트에 추가하는 Attr 노드
반환값: 
기존의 속성이 newAttr 속성으로 옮겨놓을 수 있는 경우는 치환의 대상이 되는 Attr 노드. 그 이외의 경우는 null
예외: 
DOMException  - WRONG_DOCUMENT_ERR: newAttr 가 요소의 작성 모토후미서 이외의 문서로 작성된 속성인 경우

NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우

INUSE_ATTRIBUTE_ERR: newAttr 가 벌써 다른 Element 오브젝트의 속성으로서 사용되고 있는 경우. Attr 노드를 다른 요소로 재이용하려면 , 이 노드를 DOM 유저의 손으로 명시적으로 복제할 필요가 있다




 
removeAttributeNode
public Attr  removeAttributeNode(Attr  oldAttr)
                         throws DOMException 

지정된 속성 노드를 삭제합니다. 삭제 대상의 Attr 에 디폴트 값가 있는 경우, 즉시 다른 속성으로 옮겨놓을 수 있습니다. 치환 후의 속성도, 원의 것과 같은 네임 스페이스 URI, 로컬명, 전치수식자 (적절한 경우)를 갖추고 있습니다.





파라미터: 
oldAttr - 속성 리스트로부터 삭제하는 Attr 노드
반환값: 
삭제된 Attr 노드
예외: 
DOMException  - NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우

NOT_FOUND_ERR: oldAttr 가 이 요소의 속성이 아닌 경우




 
getElementsByTagName
public NodeList  getElementsByTagName(String  name)

소정의 태그명과 함께, 모든 자손 Elements 의 NodeList 를 돌려줍니다. 돌려주어지는 차례는  이 Element 트리의 선행순서 (preorder traversal)로 검출된 차례로 됩니다.





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




 
getAttributeNS
public String  getAttributeNS(String  namespaceURI,
                             String  localName)

로컬명과 네임 스페이스 URI 를 지정해 속성치를 취득합니다.

"XML" 기능을 서포트하지 않는 문서에서는  요소나 속성을 작성 또는 설정하는 DOM 레벨 1 호출만이 허가됩니다. 따라서, null 이외의 네임 스페이스 URI 를 지정하면(자), 일치하는 노드는 검출되지 않습니다.





파라미터: 
namespaceURI - 취득하는 속성의 네임 스페이스 URI
localName - 취득하는 속성의 로컬명
반환값: 
캐릭터 라인으로 표현된 Attr 의 값. 그 속성이 지정된 값 또는 디폴트 값를 가지지 않는 경우는 공문자열
도입된 버젼:
  DOM Level 2





 
setAttributeNS
public void setAttributeNS(String  namespaceURI,
                           String  qualifiedName,
                           String  value)
                    throws DOMException 

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





파라미터: 
namespaceURI - 작성 또는 변경하는 속성의 네임 스페이스 URI
qualifiedName - 작성 또는 변경하는 속성의 수식명
value - 설정하는 값을 나타내는 캐릭터 라인
예외: 
DOMException  - INVALID_CHARACTER_ERR: 지정된 수식명에 XML 1.0 사양에 정해져 있는 부정한 캐릭터가 포함되어 있는 경우

NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우

NAMESPACE_ERR: qualifiedName 가 XML 사양의 네임 스페이스의 정의에 따른 것 나오지 않는 경우. qualifiedName 가 전치수식자를 가져,namespaceURI 가 null 의 경우. qualifiedName 가 전치수식자 "xml" 를 가져,namespaceURI 가 http://www.w3.org/XML/1998/namespace 이외인 경우. qualifiedName 또는 그 전치수식자가 "xmlns" 이며,namespaceURI 가 "http://www.w3.org/2000/xmlns/" 이외인 경우

NOT_SUPPORTED_ERR: 현재의 문서가 "XML" 를 서포트하지 않는 경우 (네임 스페이스는 XML 에 의해 정의되고 있다)
도입된 버젼:
  DOM Level 2





 
removeAttributeNS
public void removeAttributeNS(String  namespaceURI,
                              String  localName)
                       throws DOMException 

로컬명과 네임 스페이스 URI 를 지정해 속성을 삭제합니다. 삭제 대상의 속성에 디폴트 값가 있는 경우, 즉시 다른 속성으로 옮겨놓을 수 있습니다. 치환 후의 속성도, 원의 것과 같은 네임 스페이스 URI, 로컬명, 전치수식자를 갖추고 있습니다.

"XML" 기능을 서포트하지 않는 문서에서는  요소나 속성을 작성 또는 설정하는 DOM 레벨 1 호출만이 허가됩니다. 따라서, null 이외의 네임 스페이스 URI 를 지정하면(자), 일치하는 노드는 검출되지 않습니다.





파라미터: 
namespaceURI - 삭제하는 속성의 네임 스페이스 URI
localName - 삭제하는 속성의 로컬명
예외: 
DOMException  - NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우
도입된 버젼:
  DOM Level 2





 
getAttributeNodeNS
public Attr  getAttributeNodeNS(String  namespaceURI,
                               String  localName)

로컬명과 네임 스페이스 URI 를 지정해 Attr 노드를 취득합니다.

"XML" 기능을 서포트하지 않는 문서에서는  요소나 속성을 작성 또는 설정하는 DOM 레벨 1 호출만이 허가됩니다. 따라서, null 이외의 네임 스페이스 URI 를 지정하면(자), 일치하는 노드는 검출되지 않습니다.





파라미터: 
namespaceURI - 취득하는 속성의 네임 스페이스 URI
localName - 취득하는 속성의 로컬명
반환값: 
지정된 속성 로컬명과 네임 스페이스 URI 를 가지는 Attr 노드. 해당하는 속성이 존재하지 않는 경우는 null
도입된 버젼:
  DOM Level 2





 
setAttributeNodeNS
public Attr  setAttributeNodeNS(Attr  newAttr)
                        throws DOMException 

새로운 속성을 추가합니다. 지정한 로컬명 및 네임 스페이스 URI 의 속성이 벌써 요소내에 존재하는 경우, 새로운 속성으로 옮겨놓을 수 있습니다.





파라미터: 
newAttr - 속성 리스트에 추가하는 Attr 노드
반환값: 
지정과 같은 로컬명 및 네임 스페이스 URI 를 가지는 기존의 속성이 newAttr 속성으로 옮겨놓을 수 있는 경우는 치환의 대상이 되는 Attr 노드. 그 이외의 경우는 null
예외: 
DOMException  - WRONG_DOCUMENT_ERR: newAttr 가 요소의 작성 모토후미서 이외의 문서로 작성된 속성인 경우

NO_MODIFICATION_ALLOWED_ERR: 이 노드가 읽어내 전용의 경우

INUSE_ATTRIBUTE_ERR: newAttr 가 벌써 다른 Element 오브젝트의 속성으로서 사용되고 있는 경우. Attr 노드를 다른 요소로 재이용하려면 , 이 노드를 DOM 유저의 손으로 명시적으로 복제할 필요가 있다

NOT_SUPPORTED_ERR: 현재의 문서가 "XML" 를 서포트하지 않는 경우 (네임 스페이스는 XML 에 의해 정의되고 있다)
도입된 버젼:
  DOM Level 2





 
getElementsByTagNameNS
public NodeList  getElementsByTagNameNS(String  namespaceURI,
                                       String  localName)

소정의 로컬명 및 네임 스페이스 URI 와 함께, 모든 Elements 의 NodeList 를 돌려줍니다. 돌려주어지는 차례는  이 Element 트리의 선행순서 (preorder traversal)로 검출된 차례로 됩니다.

"XML" 기능을 서포트하지 않는 문서에서는  요소나 속성을 작성 또는 설정하는 DOM 레벨 1 호출만이 허가됩니다. 따라서, null 이외의 네임 스페이스 URI 를 지정하면(자), 일치하는 노드는 검출되지 않습니다.





파라미터: 
namespaceURI - 일치하는 요소의 네임 스페이스 URI. 특수한 값 "*" 은 모든 네임 스페이스에 일치하는
localName - 일치하는 요소의 로컬명. 특수한 값 "*" 은 모든 로컬명에 일치한다
반환값: 
일치하는 모든 Elements 를 포함한 새로운 NodeList 오브젝트
도입된 버젼:
  DOM Level 2





 
hasAttribute
public boolean hasAttribute(String  name)

이 요소상에 소정의 이름의 속성이 지정되었을 경우, 또는 속성에 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false





파라미터: 
name - 검색하는 속성의 이름
반환값: 
이 요소상에 소정의 이름의 속성이 지정되었을 경우, 또는 속성에 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false
도입된 버젼:
  DOM Level 2





 
hasAttributeNS
public boolean hasAttributeNS(String  namespaceURI,
                              String  localName)

이 요소상에 소정의 로컬명과 네임 스페이스 URI 를 가지는 속성이 지정되었을 경우, 또는 그 속성에 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false

"XML" 기능을 서포트하지 않는 문서에서는  요소나 속성을 작성 또는 설정하는 DOM 레벨 1 호출만이 허가됩니다. 따라서, null 이외의 네임 스페이스 URI 를 지정하면(자), 일치하는 노드는 검출되지 않습니다.





파라미터: 
namespaceURI - 검색하는 속성의 네임 스페이스 URI
localName - 검색하는 속성의 로컬명
반환값: 
이 요소상에 소정의 로컬명과 네임 스페이스 URI 를 가지는 속성이 지정되었을 경우, 또는 속성에 디폴트 값가 있는 경우는 true, 그 이외의 경우는 false
도입된 버젼:
  DOM Level 2







 



 

  
      개요  
      패키지  
    클래스 
      사용  
      계층 트리  
      비추천 API  
      색인  
      헬프  
  



Java^TM 2
 Platform
Std.  Ed.  v1. 4.0





 전의 클래스  
 다음의 클래스 

  프레임 있어    
 프레임 없음    
 






  개요:  상자 | 필드 | constructor    | 메소드 

상세:  필드 | constructor    | 메소드 





  버그의 보고와 기능의 리퀘스트 
 이외의 API 레퍼런스 및 개발자용 문서에 대해서는   Java 2 SDK SE 개발자용 문서를 참조해 주세요.  개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.  Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc.  의 상표 혹은 등록상표입니다. 
 Copyright 1993-2002 Sun Microsystems, Inc.  901 San Antonio Road
Palo Alto, California, 94303, U.S.A.   All Rights Reserved.

메소드의 개요
`String`	`getAttribute (String name)` 이름을 지정해 속성을 취득합니다.
`Attr`	`getAttributeNode (String name)` 이름을 지정해 속성 노드를 취득합니다.
`Attr`	`getAttributeNodeNS (String namespaceURI, String localName)` 로컬명과 네임 스페이스 URI 를 지정해 `Attr` 노드를 취득합니다.
`String`	`getAttributeNS (String namespaceURI, String localName)` 로컬명과 네임 스페이스 URI 를 지정해 속성치를 취득합니다.
`NodeList`	`getElementsByTagName (String name)` 소정의 태그명과 함께, 모든 자손 `Elements` 의 `NodeList` 를 돌려줍니다.
`NodeList`	`getElementsByTagNameNS (String namespaceURI, String localName)` 소정의 로컬명 및 네임 스페이스 URI 와 함께, 모든 `Elements` 의 `NodeList` 를 돌려줍니다.
`String`	`getTagName ()` 요소의 이름입니다.
`boolean`	`hasAttribute (String name)` 이 요소상에 소정의 이름의 속성이 지정되었을 경우, 또는 속성에 디폴트 값가 있는 경우는 `true`, 그 이외의 경우는 `false`
`boolean`	`hasAttributeNS (String namespaceURI, String localName)` 이 요소상에 소정의 로컬명과 네임 스페이스 URI 를 가지는 속성이 지정되었을 경우, 또는 그 속성에 디폴트 값가 있는 경우는 `true`, 그 이외의 경우는 `false` "XML" 기능을 서포트하지 않는 문서에서는 요소나 속성을 작성 또는 설정하는 DOM 레벨 1 호출만이 허가됩니다.
`void`	`removeAttribute (String name)` 이름을 지정해 속성을 삭제합니다.
`Attr`	`removeAttributeNode (Attr oldAttr)` 지정된 속성 노드를 삭제합니다.
`void`	`removeAttributeNS (String namespaceURI, String localName)` 로컬명과 네임 스페이스 URI 를 지정해 속성을 삭제합니다.
`void`	`setAttribute (String name, String value)` 새로운 속성을 추가합니다.
`Attr`	`setAttributeNode (Attr newAttr)` 새로운 속성 노드를 추가합니다.
`Attr`	`setAttributeNodeNS (Attr newAttr)` 새로운 속성을 추가합니다.
`void`	`setAttributeNS (String namespaceURI, String qualifiedName, String value)` 새로운 속성을 추가합니다.

org.w3c.dom 인터페이스 Element

getTagName

getAttribute

setAttribute

removeAttribute

getAttributeNode

setAttributeNode

removeAttributeNode

getElementsByTagName

getAttributeNS

setAttributeNS

removeAttributeNS

getAttributeNodeNS

setAttributeNodeNS

getElementsByTagNameNS

hasAttribute

hasAttributeNS

org.w3c.dom
인터페이스 Element