Anotações Básicas de Condição
Na seção anterior foram apresentadas quatro anotações básicas:
| Anotação |
Significado |
| StartDocument |
método anotado deve executar no início do processamento do documento XML |
| EndDocument |
método anotado deve executar no fim do processamento do documento XML |
| StartElement |
método anotado deve executar quando um elemento do XML iniciar |
| EndElement |
método anotado deve executar quando um elemento do XML terminar |
As anotações acima funcionam de maneira similar aos métodos startDocument, endDocument, startElement e endElement, da classe DefaultHandler, a principal classe do SAX, como você pôde ver em Clássico "Hello World" com JColtrane.
Uma ou mais dessas anotações devem estar presentes em um método se você desejar que o JColtrane o execute.
StartDocument é usado, em geral, para inicializar o que é necessário das suas classes, como por exemplo um buffer, antes do processamento.
EndDocument é usado, em geral, para liberar recursos do sistema, como por exemplo um buffer, depois do processamento.
Ambas anotações anteriores podem ser usadas somente em métodos sem parâmetros, uma vez que não faz sentido elas receberem qualquer informação antes do processamento ou depois do término do mesmo.
As outras duas, StartElement e EndElement, são destinadas para métodos que fazem algum tratamento nos dados XML. Por causa disso, JColtrane apresenta algumas opções para permitir ao usuário escolher as circunstâncias nas quais os métodos anotados devem executar. JColtrane faz ser possível, também, receber alguns parâmetros contendo informação sobre o processamento.
Nas próximas duas seções serão apresentadas opções para filtrar elementos e como receber parâmetros.
