lum_xpath é um objeto com a finalidade de disponibilizar vários métodos que facilitam na hora de obter dados provenientes do contexto (XML) da interface cujo estilo está sendo gerado, através do uso de XPath.
Tipo retornado |
Método |
Descrição |
String |
valueOf(String xpath, Node context) |
Retorna uma string representando o valor do nó no xpath do contexto passado. |
Node |
selectSingleNode(String xpath) |
Retorna um único elemento com o XPath no contexto passado. Caso o contexto não seja passado, o documento (lum_document) será usado. Quando mais de um elemento for encontrado, somente o primeiro será retornado. Se nenhum elemento for encontrado retorna nulo. |
Node |
selectSingleNode(String xpath, Node context) |
|
List<Node> |
selectNodes(String xpath) |
Retorna uma lista dos os elementos com o XPath no contexto passado. Caso o contexto não seja passado, o documento (lum_document) será usado. Se nenhum elemento for encontrado, uma lista vazia será retornada. |
List<Node> |
selectNodes(String xpath, Node context) |
|
Map<String, Object> |
toMap(Node node) |
Retorna um mapa representando o nó passado. Para maiores informações na estrutura do mapa e suas regras de conversão, veja a página IXPath.toMap. |
Map<String, Object> |
getMap(String xpath) |
Busca um nó com o contexto passado e o converte em um mapa através do método toMap. Caso o contexto não seja passado, o documento (lum_document) será usado. Se nenhum nó for encontrado com o contexto passado, retorna nulo. |
Map<String, Object> |
getMap(String xpath, Node context) |
|
List<Map<String, Object>> |
getMaps(String xpath) |
Busca nós com o contexto passado e os converte em uma lista de mapas utilizando o método toMap em cada nó encontrado. Caso o contexto não seja passado, o documento (lum_document) será usado. Se nenhum nó foi encontrado com o contexto passado, uma lista vazia será retornada. |
List<Map<String, Object>> |
getMaps(String xpath, Node context) |
A seguir uma série de exemplos de uso para cada método:
Exemplos de uso do método lum_xpath.valueOf:
XML |
JavaScript |
Exemplo 1: Valor de nó simples |
|
Código
|
|
Retorno O código acima retornaria a string "Notícias". |
|
Exemplo 2: Valor de nó com filhos |
|
Código
|
|
Retorno O código acima retornaria a string "Notícias Lista Rápida". Note que o valor dos filhos foi concatenado no retorno. |
Exemplos de uso do método lum_xpath.selectSingleNode
XML |
JavaScript |
Exemplo 1: Pegando um nó sem passar contexto |
|
Código
|
|
Retorno O código acima retornaria o nó data, que poderia ser usado no exemplo do valueOf: |
|
Exemplo 2:Pegando um nó especificando um contexto |
|
Código |
|
Retorno O código acima retornaria o nó patterns, que pode ser usado no exemplo do valueOf: |
Exemplos de uso do método lum_xpath.selectNodes
XML |
JavaScript |
Exemplo 1: Pegando uma lista de nós |
|
Código |
|
Retorno O código acima pega uma lista com todos os nós "row" com o XPath passado e cria uma lista de links usando o valor do titulo e href dos mesmos |
Exemplos de uso do método lum_xpath.toMap
XML |
JavaScript |
Exemplo 1: Usando o mapa de um nó |
|
Código |
|
Retorno O código acima pega uma lista com todos os nós "row" com o XPath passado e para cada nó cria um mapa para gerar uma lista de links usando o titulo e href. |