Especificar Namespace ao consultar o DOM com o XPath
Este artigo descreve que você deve usar nomes qualificados ao usar a consulta XPath com o selectSingleNode e selectNodes
os métodos do IXMLDOMNode
objeto.
Versão original do produto: Analisador do Microsoft XML
Número de KB original: 294797
Resumo
Com a versão do XML Parser (MSXML) 3.0, XPath
fornece uma maneira conveniente de consultar documentos XML e retornar um nó ou um conjunto de nós. Ao usar XPath
a consulta com os selectSingleNode
métodos e selectNodes
do IXMLDOMNode
objeto, você deve usar nomes qualificados. Por exemplo, para selecionar o nó Book com os seguintes dados XML:
<?xml version ="1.0"?>
<a:Books xmlns:a="x-schema:bookschema.xml" >
<a:Book>
<title>Presenting XML</title>
<author>Richard Light</author>
</a:Book>
</a:Books>
se usarmos um como alias do x-schema:bookschema.xml
URI (Uniform Resource Identifier), a consulta XPath correspondente será a seguinte:
pXMLDoc->setProperty("SelectionNamespaces","xmlns:a='x-schema:bookschema.xml'");
pXMLDoc->documentElement->selectNodes("/a:Books/a:Book");
Nesse caso, usar o nome qualificado é simples. No entanto, quando o namespace padrão é usado, o uso do nome qualificado pode ser mais difícil, como no exemplo a seguir:
<?xml version ="1.0"?>
<Books xmlns="x-schema:bookschema.xml" >
<Book>
<title>Presenting XML</title>
<author>Richard Light</author>
</Book>
</Books>
Observação
Nenhum prefixo é usado nas marcas de nó. O nome qualificado ainda deve ser usado dentro da consulta XPath, caso contrário, a consulta (por exemplo, /Books/Book) não retorna nenhum resultado porque não há nós correspondentes.
Mais informações
O exemplo do Visual C++ a seguir é fornecido para demonstrar a técnica.
Para especificar o namespace ao consultar o DOM com XPath, siga estas etapas:
Crie um projeto de console do Win32 e adicione um novo arquivo .cpp ao projeto. Cole o seguinte código no arquivo .cpp e nomeie o arquivo Test.cpp:
#include <stdio.h> #import "msxml3.dll" using namespace MSXML2; void dump_com_error(_com_error &e); int main(int argc, char* argv[]) { CoInitialize(NULL); try{ IXMLDOMDocument2Ptr pXMLDoc; HRESULT hr = pXMLDoc.CreateInstance(__uuidof(DOMDocument)); pXMLDoc->async = false; // default - true, pXMLDoc->validateOnParse = true; hr = pXMLDoc->load("books.xml"); if(hr!=VARIANT_TRUE) { IXMLDOMParseErrorPtr pError; pError = pXMLDoc->parseError; _bstr_t parseError =_bstr_t("At line ")+ _bstr_t(pError->Getline()) + _bstr_t("\n")+ _bstr_t(pError->Getreason()); MessageBox(NULL,parseError, "Parse Error",MB_OK); return -1; } hr = pXMLDoc->setProperty("SelectionLanguage", "XPath"); hr = pXMLDoc->setProperty("SelectionNamespaces", "xmlns:a='x-schema:bookschema.xml'"); IXMLDOMNodeListPtr pNodeList; pNodeList = pXMLDoc->documentElement->selectNodes("/a:Books/a:Book"); int count = pNodeList->Getlength(); char pLength[64]; sprintf(pLength, "Total number of nodes selected is %d", count); MessageBox(NULL,pLength,"Test", MB_OK); } catch(_com_error &e) { dump_com_error(e); return -1; } return 0; } void dump_com_error(_com_error &e) { printf("Error\n"); printf("\a\tCode = %08lx\n", e.Error()); printf("\a\tCode meaning = %s", e.ErrorMessage()); _bstr_t bstrSource(e.Source()); _bstr_t bstrDescription(e.Description()); printf("\a\tSource = %s\n", (LPCSTR) bstrSource); printf("\a\tDescription = %s\n", (LPCSTR) bstrDescription); }
Salve o XML a seguir como Books.xml na mesma pasta de projeto que Test.cpp.
<?xml version ="1.0"?> <Books xmlns="x-schema:bookschema.xml" > <Book> <title>Presenting XML</title> <author>Richard Light</author> <pages>334</pages> </Book> <Book> <title>Mastering XML</title> <author>John Smith</author> <pages>209</pages> </Book> </Books>
Salve o XML a seguir como Bookschema.xml na mesma pasta de projeto que Test.cpp.
<?xml version="1.0"?> <Schema xmlns="urn:schemas-microsoft-com:xml-data"> <ElementType name="title" /> <ElementType name="author" /> <ElementType name="pages" /> <ElementType name="Book" model="closed"> <element type="title" /> <element type="author" /> <element type="pages" /> </ElementType> <ElementType name="Books" model="closed"> <element type="Book" /> </ElementType> </Schema>
Compile e execute o aplicativo. Uma caixa de mensagem mostra o número de nós que são retornados pela
XPath
consulta. Veja o seguinte:O mesmo código de exemplo pode ser usado com um URI explícito como um namespace.
Nas linhas a seguir
IXMLDOMDocument2Ptr pXMLDoc; ... hr = pXMLDoc->setProperty("SelectionLanguage", "XPath"); hr = pXMLDoc->setProperty("SelectionNamespaces", "xmlns:a='x-schema:bookschema.xml'"); ... pNodeList = pXMLDoc->documentElement->selectNodes("/a:Books/a:Book");
o
setProperty
método não está disponível com aIXMLDOMDocument
interface.
Um nome qualificado (QName) é composto por um prefixo e uma parte local. O prefixo fornece o prefixo namespace do nome qualificado e deve ser associado a um URI de namespace.
Referências
Como usar o XPath para consultar um namespace padrão definido pelo usuário