Obxecto incorporado

Object XmlDocument

O obxecto XmlDocument representa todo o documento XML

O obxecto XmlDocument é a raíz dunha árbore de documentos, que nos proporciona o acceso inicial (ou superior) aos datos do documento. Para nodos de elementos, nodos de texto, comentarios, instrucións de procesamento, etc., non todos poden existir fóra de XmlDocument e o obxecto XmlDocument tamén proporciona métodos para crear estes obxectos.XmlNode Os obxectos proporcionan unha propiedade ownerDocument que os asocia co XmlDocument no que foron creados.

Herdanza

#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()

Construtor

XmlDocument

Construír un obxecto XmlDocument

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

Parámetros de chamada:

  • type: Cadea, especifique o tipo de obxecto do documento, o predeterminado é "text /xml", se precisa procesar html, ten que especificar" text / html "

Atributos dos membros

inputEncoding

Cadea, devolve a codificación usada para o documento (ao analizar)

1
readonly String XmlDocument.inputEncoding;

xmlStandalone

Booleano, define ou devolve se o documento é autónomo

1
Boolean XmlDocument.xmlStandalone;

xmlVersion

Encadea, configura ou devolve a versión XML do documento

1
String XmlDocument.xmlVersion;

doctype

XmlDocumentType, Devolve a declaración de tipo de documento relacionada co documento (Declaración de tipo de documento)

1
readonly XmlDocumentType XmlDocument.doctype;

Para documentos XML sen DTD, devólvese nulo. Este atributo pode fornecerXmlDocumentType Acceso directo ao obxecto (un nodo fillo de XmlDocument).


documentElement

XmlElement, Devolve o nodo raíz do documento

1
readonly XmlElement XmlDocument.documentElement;

XmlElement, Devolve o nodo principal do documento HTML, só válido no modo html

1
readonly XmlElement XmlDocument.head;

title

Cadea, devolve o contido do nodo de título do documento HTML, só válido no modo html

1
readonly String XmlDocument.title;

body

XmlElement, Devolve o nodo corpo do documento HTML, só válido no modo html

1
readonly XmlElement XmlDocument.body;

nodeType

Entero, devolve o tipo de nodo do nodo

1
readonly Integer XmlDocument.nodeType;

O nodeType de diferentes obxectos devolverá diferentes valores:


nodeName

Cadea, devolve o nome do nodo segundo o seu tipo

1
readonly String XmlDocument.nodeName;

O nodoName de diferentes obxectos devolverá diferentes valores:


nodeValue

Cadea, devolve o nome do nodo segundo o seu tipo

1
String XmlDocument.nodeValue;

O nodoName de diferentes obxectos devolverá diferentes valores:


ownerDocument

XmlDocument, devolve o elemento raíz do nodo (obxecto XmlDocument)

1
readonly XmlDocument XmlDocument.ownerDocument;

parentNode

XmlNode, Pode devolver o nodo pai dun nodo

1
readonly XmlNode XmlDocument.parentNode;

childNodes

XmlNodeList, Devolve a lista de nodos dos nodos fillos do nodo especificado

1
readonly XmlNodeList XmlDocument.childNodes;

firstChild

XmlNode, Devolve o primeiro nodo fillo do nodo

1
readonly XmlNode XmlDocument.firstChild;

lastChild

XmlNode, Devolve o último nodo fillo do nodo

1
readonly XmlNode XmlDocument.lastChild;

previousSibling

XmlNode, Devolve o nodo inmediatamente antes dun determinado nodo (ao mesmo nivel de árbore), se non existe ese nodo, entón o atributo devolve nulo

1
readonly XmlNode XmlDocument.previousSibling;

nextSibling

XmlNode, Devolve o nodo inmediatamente despois dun elemento (no mesmo nivel de árbore), se non existe ese nodo, a propiedade devolve nulo

1
readonly XmlNode XmlDocument.nextSibling;

Función de membro

load

Compoñer o documento analizando unha cadea XML / HTML, non admite o multilingüe

1
XmlDocument.load(String source);

Parámetros de chamada:

  • source: Cadea, o texto XML / HTML que se vai analizar, dependendo do tipo de documento cando se creou

O documento componse analizando unha cadea binaria XML / HTML e convértese automaticamente segundo o idioma

1
XmlDocument.load(Buffer source);

Parámetros de chamada:

  • source: Buffer, O texto XML / HTML que se vai analizar depende do tipo de documento cando se creou

getElementsByTagName

Devolve unha lista de nodos de todos os elementos co nome especificado

1
XmlNodeList XmlDocument.getElementsByTagName(String tagName);

Parámetros de chamada:

  • tagName: Cadea, nome da etiqueta que se vai recuperar. O valor "*" coincide con todas as etiquetas

Resultado de volta:

  • XmlNodeList, Coa marca especificada na árbore do documento XmlElement Nodal XmlNodeListxuntar. A orde dos nodos de elementos devoltos é a orde na que aparecen no documento de orixe.

Este método devolverá un XmlNodeList Obxecto (pódese procesar como unha matriz de só lectura), o obxecto almacena todos os documentos co nome da etiqueta especificado XmlElement Nodos, a orde na que se almacenan é a orde na que aparecen no documento de orixe. XmlNodeList O obxecto é "vivo", é dicir, se se engade ou elimina no documento un elemento co nome da etiqueta especificado, o seu contido actualizarase automaticamente segundo sexa necesario.


getElementsByTagNameNS

Devolve unha lista de nodos con todos os elementos do nome e espazo de nome especificado

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

Parámetros de chamada:

  • namespaceURI: Cadea, especifica o URI do espazo de nomes para recuperar. O valor "*" pode coincidir con todas as etiquetas
  • localName: Cadea, nome da etiqueta que se vai recuperar. O valor "*" coincide con todas as etiquetas

Resultado de volta:

  • XmlNodeList, Coa marca especificada na árbore do documento XmlElement Nodal XmlNodeListxuntar. A orde dos nodos de elementos devoltos é a orde na que aparecen no documento de orixe.

Este método é similar ao método getElementsByTagName (), excepto que recupera elementos baseados no espazo de nome e o nome.


getElementById

Devolve o elemento co atributo id especificado

1
XmlElement XmlDocument.getElementById(String id);

Parámetros de chamada:

  • id: Cadea, id que se recuperará

Resultado de volta:

Este método percorrerá os nodos descendentes do documento e devolverá un XmlElementO obxecto nodo representa o primeiro elemento do documento co atributo id especificado. .


getElementsByClassName

Devolve unha lista de nodos de todos os elementos co nome da clase especificado

1
XmlNodeList XmlDocument.getElementsByClassName(String className);

Parámetros de chamada:

  • className: Cadea, o nome da clase que se recuperará

Resultado de volta:

  • XmlNodeList, Co nome da clase especificado na árbore do documento XmlElement Nodal XmlNodeListxuntar. A orde dos nodos de elementos devoltos é a orde na que aparecen no documento de orixe.

Este método devolverá un XmlNodeList Obxecto (pódese procesar como unha matriz de só lectura), que almacena todos os ficheiros co nome de clase especificado no documento XmlElement Nodos, a orde na que se almacenan é a orde na que aparecen no documento de orixe. XmlNodeList O obxecto é "vivo", é dicir, se se engade ou elimina no documento un elemento co nome da etiqueta especificado, o seu contido actualizarase automaticamente segundo sexa necesario.


createElement

Crear nodo de elemento

1
XmlElement XmlDocument.createElement(String tagName);

Parámetros de chamada:

  • tagName: Cadea, especifique o nome especificado do nodo do elemento

Resultado de volta:


createElementNS

Crear nodo de elemento co espazo de nomes especificado

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

Parámetros de chamada:

  • namespaceURI: Cadea, especifique o URI do espazo de nomes do nodo elemento
  • qualifiedName: Cadea, especifique o nome especificado do nodo do elemento

Resultado de volta:


createTextNode

Crear nodo de texto

1
XmlText XmlDocument.createTextNode(String data);

Parámetros de chamada:

  • data: Cadea, especifica o texto deste nodo

Resultado de volta:

  • XmlText, Devolve o recén creado XmlText Nodo, que representa a cadea de datos especificada

createComment

Crear un nodo de comentarios

1
XmlComment XmlDocument.createComment(String data);

Parámetros de chamada:

  • data: Cadea, especifique o texto de comentario deste nodo

Resultado de volta:


createCDATASection

crear XmlCDATASection nodo

1
XmlCDATASection XmlDocument.createCDATASection(String data);

Parámetros de chamada:

  • data: Cadea, especifique este nodo para especificar datos CDATA

Resultado de volta:


createProcessingInstruction

crear XmlProcessingInstruction nodo

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

Parámetros de chamada:

  • target: Cadea, especifique o destino da instrución de procesamento
  • data: Cadea, especifica o contido do texto da instrución de procesamento

Resultado de volta:


hasChildNodes

Consulta se hai nodos fillos

1
Boolean XmlDocument.hasChildNodes();

Resultado de volta:

  • Boolean, Devolve verdadeiro se hai nodos fillos, en caso contrario devolve falso

normalize

Combina nodos de texto adxacentes e elimina nodos de texto baleiros

1
XmlDocument.normalize();

Este método percorrerá todos os nodos descendentes do nodo actual e normalizará o documento eliminando o nodo de texto baleiro e fusionando todos os nodos de texto adxacentes. Este método é útil para simplificar a estrutura da árbore do documento despois de inserir ou eliminar nodos.


cloneNode

Crea unha copia exacta do nodo especificado

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

Parámetros de chamada:

  • deep: Booleano, se se copia en profundidade, cando é verdadeiro, o nodo clonado clonará todos os nodos fillos do nodo orixinal

Resultado de volta:

Este método copiará e devolverá unha copia do nodo que o chamou. Se o parámetro que se lle pasou é certo, tamén copiará recursivamente todos os descendentes do nodo actual. Se non, só copia o nodo actual. O nodo devolto non pertence á árbore do documento e a súa propiedade parentNode é nula. Cando se copia o nodo Element, copiaranse todos os seus atributos.


lookupPrefix

Devolve o prefixo que coincide co URI do espazo de nomes especificado no nodo actual

1
String XmlDocument.lookupPrefix(String namespaceURI);

Parámetros de chamada:

  • namespaceURI: Cadea, especifique o URI do espazo de nomes coincidente

Resultado de volta:

  • String, Devolve o prefixo coincidente, devolve nulo se non se coincide

lookupNamespaceURI

Devolve o URI do espazo de nomes que coincide co prefixo especificado no nodo actual

1
String XmlDocument.lookupNamespaceURI(String prefix);

Parámetros de chamada:

  • prefix: Cadea, especifique o prefixo coincidente

Resultado de volta:

  • String, Devolve o URI do espazo de nome coincidente, devolve nulo se non coincide

insertBefore

Insira un novo nodo fillo antes do nodo fillo existente

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

Parámetros de chamada:

  • newChild: XmlNode, Insira un novo nodo
  • refChild: XmlNode, Insira un novo nodo antes deste nodo

Resultado de volta:

  • XmlNode, Devolve o novo nodo fillo

Se newChild xa existe na árbore do documento, eliminarase da árbore do documento e despois volverá inserilo na súa nova posición. Os nodos dun documento (ou nodos creados por un documento) non se poden inserir noutro documento. Noutras palabras, a propiedade ownerDocument de newChild debe ser a mesma que a propiedade ownerDocument do nodo actual.


insertAfter

Insira un novo nodo fillo despois do nodo fillo existente

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

Parámetros de chamada:

  • newChild: XmlNode, Insira un novo nodo
  • refChild: XmlNode, Insira un novo nodo despois deste nodo

Resultado de volta:

  • XmlNode, Devolve o novo nodo fillo

Se newChild xa existe na árbore do documento, eliminarase da árbore do documento e despois volverá inserilo na súa nova posición. Os nodos dun documento (ou nodos creados por un documento) non se poden inserir noutro documento. Noutras palabras, a propiedade ownerDocument de newChild debe ser a mesma que a propiedade ownerDocument do nodo actual.


appendChild

Engade un novo nodo fillo ao final da lista de nodos fillos do nodo

1
XmlNode XmlDocument.appendChild(XmlNode newChild);

Parámetros de chamada:

  • newChild: XmlNode, Especifique o nodo engadido

Resultado de volta:

  • XmlNode, Devolve este novo nodo fillo

Se newChild xa existe na árbore do documento, eliminarase da árbore do documento e despois volverá inserilo na súa nova posición. Os nodos dun documento (ou nodos creados por un documento) non se poden inserir noutro documento. Noutras palabras, a propiedade ownerDocument de newChild debe ser a mesma que a propiedade ownerDocument do nodo actual.


replaceChild

Substitúe un nodo fillo por outro

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

Parámetros de chamada:

  • newChild: XmlNode, Especifique un novo nodo
  • oldChild: XmlNode, Especifique o nodo a substituír

Resultado de volta:

  • XmlNode, Se a substitución é correcta, este método pode devolver o nodo substituído; se a substitución falla, devolve nulo

Se newChild xa existe na árbore do documento, eliminarase da árbore do documento e despois volverá inserilo na súa nova posición. Os nodos dun documento (ou nodos creados por un documento) non se poden inserir noutro documento. Noutras palabras, a propiedade ownerDocument de newChild debe ser a mesma que a propiedade ownerDocument do nodo actual.


removeChild

Elimina un nodo da lista de nodos fillos

1
XmlNode XmlDocument.removeChild(XmlNode oldChild);

Parámetros de chamada:

  • oldChild: XmlNode, Especifique o nodo que se vai eliminar

Resultado de volta:

  • XmlNode, Se a eliminación é correcta, este método pode devolver o nodo eliminado; se falla, devolve nulo

toString

Devolve a representación de cadea do obxecto, xeralmente devolve "[Obxecto nativo]", o obxecto pode reimplementarse segundo as súas propias características

1
String XmlDocument.toString();

Resultado de volta:

  • String, Devolve a representación de cadea do obxecto

toJSON

Devolve a representación en formato JSON do obxecto, xeralmente devolve unha colección de atributos lexibles definidos polo obxecto

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

Parámetros de chamada:

  • key: Cadea, sen usar

Resultado de volta:

  • Value, Devolve un valor que contén JSON serializable