객체 내장 객체

개체 XmlDocument

XmlDocument 개체는 전체 XML 문서를 나타냅니다.

XmlDocument 개체는 문서 데이터에 대한 초기(또는 최상위) 액세스를 제공하는 문서 트리의 루트입니다. 요소 노드, 텍스트 노드, 주석, 처리 지침 등의 경우 모두 XmlDocument 외부에 존재할 수 없으며 XmlDocument 개체는 이러한 개체를 만드는 메서드도 제공합니다.XmlNode 개체는 개체를 만든 XmlDocument와 연결하는 ownerDocument 속성을 제공합니다.

계승

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<class>XmlNode|nodeType;nodeName;nodeValue;ownerDocument;parentNode;childNodes;firstChild;lastChild;previousSibling;nextSibling|hasChildNodes();normalize();cloneNode();lookupPrefix();lookupNamespaceURI();insertBefore();insertAfter();appendChild();replaceChild();removeChild()] [<this>XmlDocument|new XmlDocument()|inputEncoding;xmlStandalone;xmlVersion;doctype;documentElement;head;title;body|load();getElementsByTagName();getElementsByTagNameNS();getElementById();getElementsByClassName();createElement();createElementNS();createTextNode();createComment();createCDATASection();createProcessingInstruction()] [object] <:- [XmlNode] [XmlNode] <:- [XmlDocument] XmlDocument new XmlDocument() inputEncoding xmlStandalone xmlVersion doctype documentElement head title body load() getElementsByTagName() getElementsByTagNameNS() getElementById() getElementsByClassName() createElement() createElementNS() createTextNode() createComment() createCDATASection() createProcessingInstruction() XmlNode nodeType nodeName nodeValue ownerDocument parentNode childNodes firstChild lastChild previousSibling nextSibling hasChildNodes() normalize() cloneNode() lookupPrefix() lookupNamespaceURI() insertBefore() insertAfter() appendChild() replaceChild() removeChild() object toString() toJSON()

건설자

XmlDocument

XmlDocument 개체 생성

1
new XmlDocument(String type = "text/xml");

호출 매개변수:

  • type: 문자열, 문서 객체의 유형을 지정합니다. 기본값은 "텍스트/xml", html을 처리해야 하는 경우 "text/html"을 지정해야 합니다.

회원 속성

inputEncoding

문자열, 문서에 사용된 인코딩을 반환합니다(파싱할 때).

1
readonly String XmlDocument.inputEncoding;

xmlStandalone

부울, 문서가 독립형인지 여부를 설정하거나 반환합니다.

1
Boolean XmlDocument.xmlStandalone;

xmlVersion

문자열, 문서의 XML 버전 설정 또는 반환

1
String XmlDocument.xmlVersion;

doctype

XmlDocumentType, 문서와 관련된 문서 유형 선언을 반환합니다(Document Type Declaration).

1
readonly XmlDocumentType XmlDocument.doctype;

DTD가 없는 XML 문서의 경우 null이 반환됩니다. 이 속성은 다음을 제공할 수 있습니다.XmlDocumentType 개체(XmlDocument의 자식 노드)에 대한 직접 액세스.


documentElement

XmlElement, 문서의 루트 노드를 반환

1
readonly XmlElement XmlDocument.documentElement;

XmlElement, HTML 문서의 헤드 노드를 반환합니다. html 모드에서만 유효합니다.

1
readonly XmlElement XmlDocument.head;

title

문자열, HTML 문서의 제목 노드 내용을 반환하며, html 모드에서만 유효합니다.

1
readonly String XmlDocument.title;

body

XmlElement, HTML 문서의 본문 노드를 반환합니다. html 모드에서만 유효합니다.

1
readonly XmlElement XmlDocument.body;

nodeType

정수, 노드의 노드 유형을 반환합니다.

1
readonly Integer XmlDocument.nodeType;

다른 개체의 nodeType은 다른 값을 반환합니다.


nodeName

문자열, 유형에 따라 노드의 이름을 반환합니다.

1
readonly String XmlDocument.nodeName;

다른 개체의 nodeName은 다른 값을 반환합니다.


nodeValue

문자열, 유형에 따라 노드의 이름을 반환합니다.

1
String XmlDocument.nodeValue;

다른 개체의 nodeName은 다른 값을 반환합니다.


ownerDocument

XmlDocument는 노드의 루트 요소(XmlDocument 개체)를 반환합니다.

1
readonly XmlDocument XmlDocument.ownerDocument;

parentNode

XmlNode, 노드의 부모 노드를 반환할 수 있습니다.

1
readonly XmlNode XmlDocument.parentNode;

childNodes

XmlNodeList, 지정된 노드의 자식 노드의 노드 목록을 반환합니다.

1
readonly XmlNodeList XmlDocument.childNodes;

firstChild

XmlNode, 노드의 첫 번째 자식 노드를 반환합니다.

1
readonly XmlNode XmlDocument.firstChild;

lastChild

XmlNode, 노드의 마지막 자식 노드를 반환

1
readonly XmlNode XmlDocument.lastChild;

previousSibling

XmlNode, 동일한 트리 수준에서 특정 노드 바로 앞의 노드를 반환합니다. 해당 노드가 없으면 속성이 null을 반환합니다.

1
readonly XmlNode XmlDocument.previousSibling;

nextSibling

XmlNode, 동일한 트리 수준에서 요소 바로 다음에 오는 노드를 반환합니다. 해당 노드가 없으면 속성이 null을 반환합니다.

1
readonly XmlNode XmlDocument.nextSibling;

멤버 함수

load

XML/HTML 문자열을 구문 분석하여 문서 작성, 다국어 지원하지 않음

1
XmlDocument.load(String source);

호출 매개변수:

  • source: 문자열, 문서가 생성될 때 문서 유형에 따라 구문 분석할 XML/HTML 텍스트

이진 XML/HTML 문자열을 파싱하여 문서를 구성하고 언어에 따라 자동 변환

1
XmlDocument.load(Buffer source);

호출 매개변수:

  • source: Buffer, 구문 분석할 XML/HTML 텍스트는 문서가 생성될 때 문서 유형에 따라 다릅니다.

getElementsByTagName

지정된 이름을 가진 모든 요소의 노드 목록을 반환합니다.

1
XmlNodeList XmlDocument.getElementsByTagName(String tagName);

호출 매개변수:

  • tagName: 문자열, 검색할 태그 이름. 값 "*"는 모든 태그와 일치합니다.

반환 결과:

  • XmlNodeList, 문서 트리에서 지정된 표시로 XmlElement 노달 XmlNodeList모으다. 반환된 요소 노드의 순서는 소스 문서에 나타나는 순서입니다.

이 메서드는 XmlNodeList 객체(읽기 전용 배열로 처리 가능), 객체는 지정된 태그 이름을 가진 모든 문서를 저장합니다. XmlElement 노드, 저장되는 순서는 소스 문서에 나타나는 순서입니다. XmlNodeList 개체는 "라이브"입니다. 즉, 지정된 태그 이름을 가진 요소가 문서에 추가되거나 삭제되면 해당 내용이 필요에 따라 자동으로 업데이트됩니다.


getElementsByTagNameNS

지정된 네임스페이스 및 이름의 모든 요소가 있는 노드 목록을 반환합니다.

1 2
XmlNodeList XmlDocument.getElementsByTagNameNS(String namespaceURI, String localName);

호출 매개변수:

  • namespaceURI: 문자열, 검색할 네임스페이스 URI를 지정합니다. "*" 값은 모든 태그와 일치할 수 있습니다.
  • localName: 문자열, 검색할 태그 이름. 값 "*"는 모든 태그와 일치합니다.

반환 결과:

  • XmlNodeList, 문서 트리에서 지정된 표시로 XmlElement 노달 XmlNodeList모으다. 반환된 요소 노드의 순서는 소스 문서에 나타나는 순서입니다.

이 메서드는 네임스페이스와 이름을 기반으로 요소를 검색한다는 점을 제외하면 getElementsByTagName() 메서드와 유사합니다.


getElementById

지정된 id 속성을 가진 요소를 반환합니다.

1
XmlElement XmlDocument.getElementById(String id);

호출 매개변수:

  • id: 문자열, 검색할 id

반환 결과:

이 메서드는 문서의 하위 노드를 탐색하고 다음을 반환합니다. XmlElement노드 객체는 지정된 id 속성을 가진 첫 번째 문서 요소를 나타냅니다. .


getElementsByClassName

지정된 클래스 이름을 가진 모든 요소의 노드 목록을 반환합니다.

1
XmlNodeList XmlDocument.getElementsByClassName(String className);

호출 매개변수:

  • className: String, 검색할 클래스의 이름

반환 결과:

  • XmlNodeList, 문서 트리에서 지정된 클래스 이름 사용 XmlElement 노달 XmlNodeList모으다. 반환된 요소 노드의 순서는 소스 문서에 나타나는 순서입니다.

이 메서드는 XmlNodeList 문서에서 지정된 클래스 이름을 가진 모든 파일을 저장하는 객체(읽기 전용 배열로 처리될 수 있음) XmlElement 노드, 저장되는 순서는 소스 문서에 나타나는 순서입니다. XmlNodeList 개체는 "라이브"입니다. 즉, 지정된 태그 이름을 가진 요소가 문서에 추가되거나 삭제되면 해당 내용이 필요에 따라 자동으로 업데이트됩니다.


createElement

요소 노드 생성

1
XmlElement XmlDocument.createElement(String tagName);

호출 매개변수:

  • tagName: 문자열, 요소 노드의 지정된 이름을 지정합니다.

반환 결과:


createElementNS

지정된 네임스페이스로 요소 노드 생성

1 2
XmlElement XmlDocument.createElementNS(String namespaceURI, String qualifiedName);

호출 매개변수:

  • namespaceURI: 문자열, 요소 노드 네임스페이스의 URI를 지정합니다.
  • qualifiedName: 문자열, 요소 노드의 지정된 이름을 지정합니다.

반환 결과:


createTextNode

텍스트 노드 생성

1
XmlText XmlDocument.createTextNode(String data);

호출 매개변수:

  • data: 문자열, 이 노드의 텍스트를 지정합니다.

반환 결과:

  • XmlText, 새로 만든 반환 XmlText 지정된 데이터 문자열을 나타내는 노드

createComment

댓글 노드 생성

1
XmlComment XmlDocument.createComment(String data);

호출 매개변수:

  • data: 문자열, 이 노드의 주석 텍스트를 지정합니다.

반환 결과:

  • XmlComment, 새로 만든 반환 XmlComment 노드, 주석 텍스트는 지정된 데이터입니다.

createCDATASection

창조하다 XmlCDATASection 마디

1
XmlCDATASection XmlDocument.createCDATASection(String data);

호출 매개변수:

  • data: 문자열, CDATA 데이터를 지정하려면 이 노드를 지정하십시오.

반환 결과:


createProcessingInstruction

창조하다 XmlProcessingInstruction 마디

1 2
XmlProcessingInstruction XmlDocument.createProcessingInstruction(String target, String data);

호출 매개변수:

  • target: 문자열, 처리 명령의 대상을 지정합니다.
  • data: 문자열, 처리 명령의 내용 텍스트를 지정합니다.

반환 결과:


hasChildNodes

자식 노드가 있는지 쿼리

1
Boolean XmlDocument.hasChildNodes();

반환 결과:

  • Boolean, 자식 노드가 있으면 true 반환, 그렇지 않으면 false 반환

normalize

인접한 텍스트 노드를 병합하고 빈 텍스트 노드를 삭제합니다.

1
XmlDocument.normalize();

이 방법은 현재 노드의 모든 자손 노드를 순회하고 빈 텍스트 노드를 삭제하고 인접한 모든 텍스트 노드를 병합하여 문서를 정규화합니다. 이 방법은 노드를 삽입하거나 삭제한 후 문서 트리의 구조를 단순화하는 데 유용합니다.


cloneNode

지정된 노드의 정확한 복사본 만들기

1
XmlNode XmlDocument.cloneNode(Boolean deep = true);

호출 매개변수:

  • deep: Boolean, deep copy 여부, true인 경우 복제된 노드는 원래 노드의 모든 자식 노드를 복제합니다.

반환 결과:

이 메서드는 그것을 호출한 노드의 복사본을 복사하고 반환합니다. 전달된 매개변수가 true이면 현재 노드의 모든 하위 항목도 재귀적으로 복사합니다. 그렇지 않으면 현재 노드만 복사합니다. 반환된 노드는 문서 트리에 속하지 않으며 parentNode 속성은 null입니다. 요소 노드가 복사되면 모든 속성이 복사됩니다.


lookupPrefix

현재 노드에서 지정된 네임스페이스 URI와 일치하는 접두사를 반환합니다.

1
String XmlDocument.lookupPrefix(String namespaceURI);

호출 매개변수:

  • namespaceURI: 문자열, 일치하는 네임스페이스 URI 지정

반환 결과:

  • String, 일치하는 접두사를 반환하고 일치하지 않으면 null을 반환합니다.

lookupNamespaceURI

현재 노드의 지정된 접두사와 일치하는 네임스페이스 URI를 반환합니다.

1
String XmlDocument.lookupNamespaceURI(String prefix);

호출 매개변수:

  • prefix: 문자열, 일치하는 접두사 지정

반환 결과:

  • String, 일치하는 네임스페이스 URI를 반환하고 일치하지 않으면 null을 반환합니다.

insertBefore

기존 자식 노드 앞에 새 자식 노드 삽입

1 2
XmlNode XmlDocument.insertBefore(XmlNode newChild, XmlNode refChild);

호출 매개변수:

  • newChild: XmlNode, 새 노드 삽입
  • refChild: XmlNode, 이 노드 앞에 새 노드를 삽입합니다.

반환 결과:

  • XmlNode, 새 자식 노드 반환

newChild가 이미 문서 트리에 있는 경우 문서 트리에서 삭제된 다음 새 위치에 다시 삽입됩니다. 한 문서의 노드(또는 한 문서에서 만든 노드)는 다른 문서에 삽입할 수 없습니다. 즉, newChild의 ownerDocument 속성은 현재 노드의 ownerDocument 속성과 동일해야 합니다.


insertAfter

기존 자식 노드 뒤에 새 자식 노드 삽입

1 2
XmlNode XmlDocument.insertAfter(XmlNode newChild, XmlNode refChild);

호출 매개변수:

  • newChild: XmlNode, 새 노드 삽입
  • refChild: XmlNode, 이 노드 뒤에 새 노드를 삽입합니다.

반환 결과:

  • XmlNode, 새 자식 노드 반환

newChild가 이미 문서 트리에 있는 경우 문서 트리에서 삭제된 다음 새 위치에 다시 삽입됩니다. 한 문서의 노드(또는 한 문서에서 만든 노드)는 다른 문서에 삽입할 수 없습니다. 즉, newChild의 ownerDocument 속성은 현재 노드의 ownerDocument 속성과 동일해야 합니다.


appendChild

노드의 자식 노드 목록 끝에 새 자식 노드 추가

1
XmlNode XmlDocument.appendChild(XmlNode newChild);

호출 매개변수:

  • newChild: XmlNode, 추가된 노드 지정

반환 결과:

  • XmlNode, 이 새 자식 노드를 반환합니다.

newChild가 이미 문서 트리에 있는 경우 문서 트리에서 삭제된 다음 새 위치에 다시 삽입됩니다. 한 문서의 노드(또는 한 문서에서 만든 노드)는 다른 문서에 삽입할 수 없습니다. 즉, newChild의 ownerDocument 속성은 현재 노드의 ownerDocument 속성과 동일해야 합니다.


replaceChild

하나의 자식 노드를 다른 노드로 교체

1 2
XmlNode XmlDocument.replaceChild(XmlNode newChild, XmlNode oldChild);

호출 매개변수:

  • newChild: XmlNode, 새 노드 지정
  • oldChild: XmlNode, 교체할 노드 지정

반환 결과:

  • XmlNode, 교체가 성공하면 이 메서드는 교체된 노드를 반환할 수 있고 교체가 실패하면 null을 반환합니다.

newChild가 이미 문서 트리에 있는 경우 문서 트리에서 삭제된 다음 새 위치에 다시 삽입됩니다. 한 문서의 노드(또는 한 문서에서 만든 노드)는 다른 문서에 삽입할 수 없습니다. 즉, newChild의 ownerDocument 속성은 현재 노드의 ownerDocument 속성과 동일해야 합니다.


removeChild

자식 노드 목록에서 노드 제거

1
XmlNode XmlDocument.removeChild(XmlNode oldChild);

호출 매개변수:

  • oldChild: XmlNode, 삭제할 노드 지정

반환 결과:

  • XmlNode, 삭제가 성공하면 이 메소드는 삭제된 노드를 반환할 수 있고, 실패하면 null을 반환합니다.

toString

개체의 문자열 표현을 반환하고 일반적으로 "[네이티브 개체]"를 반환하며 개체는 고유한 특성에 따라 다시 구현할 수 있습니다.

1
String XmlDocument.toString();

반환 결과:

  • String, 객체의 문자열 표현을 반환합니다.

toJSON

객체의 JSON 형식 표현을 반환하고 일반적으로 객체에 의해 정의된 읽을 수 있는 속성 모음을 반환합니다.

1
Value XmlDocument.toJSON(String key = "");

호출 매개변수:

  • key: 문자열, 미사용

반환 결과:

  • Value, 직렬화 가능한 JSON을 포함하는 값을 반환합니다.