Aprenda a usar o mecanismo XML XQEngine

Autor：Eve Cole Data da Última Atualização：2009-07-07 16:09:39

Recentemente, tenho procurado ferramentas de pesquisa XML. O aplicativo que escrevi precisa pesquisar regularmente alguns arquivos XML relacionados. Minha intenção original era ver se há dados que correspondam aos dados que desejo no arquivo, mas às vezes também quero. para gerar os dados que encontrei. No início, tentei XSLT e XPath, na esperança de transformar o problema de pesquisa em um problema que pudesse ser resolvido usando XSLT. No entanto, após um período de experimentação, descobri que usar XSLT não resolveu realmente o problema de pesquisa que eu queria resolver. Porque os dados que desejo gerar são números separados por vírgula, o XSLT não pode atender a esse requisito e o XLST não pode fornecer funcionalidade de pesquisa de texto completo. Então eu queria tentar usar XML Query Language (XQL) para ver se conseguia resolver, então observei cuidadosamente a implementação de várias versões do XQL. Coincidentemente, encontrei uma pequena ferramenta chamada XQEngine que poderia resolver esse problema. , portanto, neste artigo gostaria de apresentar como usar o XQEngine para pesquisar os dados de string que você deseja encontrar em seu arquivo XML.

O XQEngine pode ser encontrado em www.fatdog.com. É um JavaBean que usa um analisador SAX para indexar um ou mais documentos XML, e então você pode realizar pesquisas complexas nesses documentos. A linguagem de pesquisa usada é um superconjunto do XQL e possui uma sintaxe semelhante ao XPath.

A classe Java que usa XQEngine deve implementar um método result(). Após concluir a pesquisa, o mecanismo chamará esse método para passar os resultados da pesquisa para o método result(). Use parâmetros de linha de comando para especificar os parâmetros de pesquisa necessários. Por exemplo, você pode especificar que um arquivo não será indexado se contiver a palavra stop ou pode instruir o mecanismo nos parâmetros para ignorar palavras menores que as especificadas. número.

Abaixo forneci uma rotina usando o XQEngine, vamos analisá-la agora. Primeiro, o método main() instancia um mecanismo de pesquisa: e, em seguida, chama o método setSaxParserName() para definir o nome completo do analisador SAX. Como estamos usando o analisador Xerces, precisamos usar "org.apache.xerces. analisadores.SAXParser". Então precisamos definir os parâmetros de pesquisa, neste caso não indexaremos números ou quaisquer palavras com menos de 3 caracteres. Haverá descrições detalhadas dos parâmetros de configuração no documento da API XQEngine que você baixou, portanto, não entrarei em detalhes sobre como configurar os parâmetros aqui. Consulte os documentos relevantes. Finalmente, o método setDocument() especifica o arquivo XML que o XQEngine irá indexar ou pesquisar. Claro, se você deseja indexar vários arquivos, você só precisa definir vários métodos setDocument() correspondentes.

Também podemos ver no código abaixo que o mecanismo XQEngine retornará resultados de pesquisa em três formatos diferentes: STANDARD, SUMMARY e CSV (usando valores separados por vírgula, para simplificar, defini um para cada tipo de resultado de retorno em vez de (). 1, 2, 3) e, em seguida, chame o método setListenerType() com os parâmetros correspondentes. Descreverei cada tipo de resultado de retorno em detalhes posteriormente. Há também um método printSessionState() usado para gerar informações de índice e mecanismo, mas eu não o escrevi na rotina, então o programa acima irá apenas gerar os resultados da pesquisa na próxima etapa, chamar o método addXQLResultListener() e passar; a instância Search An é usada para implementar a interface XQLResultListener, então o método setQuery é chamado com a string de consulta como parâmetro e o mecanismo começará a executar a tarefa de consulta. Depois que a consulta é concluída, o mecanismo chama o método result() da classe Search e retorna os resultados da consulta. Na rotina que forneci, o método result() simplesmente exibe os resultados.
Código:

importar java.io.*;
importar com.fatdog.textEngine.XmlEngine;
importar com.fatdog.textEngine.exceptions.*;
importar com.fatdog.textEngine.query.XQLResultListener;
Pesquisa de classe pública implementa XQLResultListener
{
public static void main(String[] args)
{
Mecanismo XmlEngine = novo XmlEngine();
String searchArquivo = args[0];
String tipopesquisa = args[1];
Consulta de string = args[2];
tente { arquivo://mecanismo de configuração
engine.setSaxParserName("org.apache.xerces.parsers.SAXParser");
motor.setMinIndexableWordLength(3);
motor.setDoIndexNumbers(falso);
motor.setDocument(searchFile);

if (searchType.equals("1")) {
motor.setListenerType(
XmlEngine.STANDARD_LISTENER);
}
senão if (searchType.equals("2")) {
motor.setListenerType(
XmlEngine.SUMMARY_LISTENER);
}
outro {
motor.setListenerType(
XmlEngine.CSV_LISTENER);
}
}
catch( MissingOrInvalidSaxParserException e ){
Sistema.out.println(
"Analisador SAX ausente ou indisponível");
retornar;
}
catch(FileNotFoundException e) {
Sistema.out.println(
"Não foi possível encontrar o arquivo XML: ");
retornar;
}
catch(CantParseDocumentException e) {
Sistema.out.println(
"Não é possível analisar o arquivo XML: ");
retornar;
}
//motor.printSessionStats();
engine.addXQLResultListener(nova Pesquisa());
tentar {
motor.setQuery(consulta);
}
catch(InvalidQueryException e) {
Sistema.out.println(
"Solicitação de consulta indisponível: " + e.getMessage() );
retornar;
}
}
resultados públicos vazios (String xqlResults)
{
System.out.println(xqlResults);
}
}

Ok, escrevemos um programa usando o XQEngine, então vamos executar este código. Antes de compilar este código, precisamos baixar o XQEngine e o analisador SAX. Baixei o analisador Xerces de xml.apache.org. O sistema operacional que uso é o Windows 2000 Professional e o JDK é a versão 1.3. OK, depois de fazer isso, siga-me para configurar o CLASSPATH em "Variáveis de ambiente" e adicione "c:xqlXQEngine.jar. ;c:xqlantlr.jar;c:xercesxerces.jar". Agora o código pode ser compilado, mas para executar o programa também precisamos de um arquivo XML. Usei o arquivo web.xml no Apache Tomcat como demonstração. Como apresentei antes, usamos 1, 2 e 3 para substituir os três formatos de resultado da consulta de retorno:

1. Use STANDARD_LISTENER (número 1) e o item de consulta "//welcome-file-list/welcome-file", C:xqlxql1>java Search web.xml 1 "//welcome-file-list/welcome- arquivo "

Analisador.installSaxParser:

instalado com sucesso
1: indexação web.xml
Consulta: ( // ( / lista de arquivos de boas-vindas arquivo de boas-vindas ) )
3 ocorrências para file://welcome-file-list/welcome-file
＜?xml versão="1.0"?＞
query="//lista de arquivos de boas-vindas/arquivo de boas-vindas"
hitCount="3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/Standard_Listener.html">
＜arquivo de boas-vindas＞
index.jsp
＜/arquivo de boas-vindas＞
＜arquivo de boas-vindas＞
index.html
＜/arquivo de boas-vindas＞
＜arquivo de boas-vindas＞
índice.htm
＜/arquivo de boas-vindas＞
＜/xql:resultado＞

No exemplo acima, o item de consulta requer a localização de todos os subelementos "arquivo de boas-vindas" de qualquer elemento "lista de arquivos de boas-vindas". Observe que os resultados da pesquisa são basicamente extraídos do documento XML original e a relação entre os resultados da pesquisa e o documento original não pode ser estabelecida. O tipo de retorno de SUMMARY_LISTENER(2) é um pouco diferente. Inclui um número "docID" e um número "elemlx", para que o resultado possa ser associado ao documento original.

Veja a seguir um exemplo de resultados retornados:

C:xqlxql1>java Pesquisa web.xml 2
"//lista de arquivos de boas-vindas/arquivo de boas-vindas"
Parser.installSaxParser:
instalado com sucesso

1: indexação web.xml

Consulta: ( // ( / lista de arquivos de boas-vindas arquivo de boas-vindas ) )

3 ocorrências para file://welcome-file-list/welcome-file

＜?xml versão="1.0"?＞
query="//lista de arquivos de boas-vindas/arquivo de boas-vindas"
hitCount="3"
elemCount="3"
docCount="1"
xmlns:xql="http://www.fatdog.com/
Resumo_Listener.html">
＜arquivo de boas-vindas xql:docID="0" xql:elemIx="270"/＞
＜arquivo de boas-vindas xql:docID="0" xql:elemIx="271"/＞
＜arquivo de boas-vindas xql:docID="0" xql:elemIx="272"/＞
＜/xql:resultado＞

Também já disse antes que para minha aplicação o mais importante é retornar resultados separados por vírgula, então CSV_LISTENER(3) é muito útil. Ele pode retornar um resultado separado por vírgula, como segue:

C:xqlxql1>java Pesquisa web.xml 3
"//lista de arquivos de boas-vindas/arquivo de boas-vindas"
Analisador.installSaxParser:

instalado com sucesso

1: indexação web.xml

Consulta: ( // ( / lista de arquivos de boas-vindas arquivo de boas-vindas ) )

3 ocorrências para file://welcome-file-list/welcome-file

3,3,1,0
0.270, arquivo de boas-vindas
0.271, arquivo de boas-vindas
0,272, arquivo de boas-vindas

É claro que o XQEngine também possui muitas funções poderosas. Não posso apresentá-las uma por uma aqui. A documentação que vem com ele contém uma grande variedade de programas de origem e métodos de uso. estiver disposto, você pode até desenvolver um programa GUI. O documento vem com um programa de pesquisa baseado em GUI: SwingQueryDemo. Você pode dar uma olhada e estudá-lo.