Filtr SAX wykonujący przekształcenie

Klasa SAXTransformerFactory, będąca podklasą TransformerFactory, umożliwia tworzenie, poza normalnymi Transformer-ami, filtrów SAX realizujących przekształcenie.

SAXTransformerFactory tf = (SAXTransformerFactory)SAXTransformerFactory.newInstance();
XMLFilter f = tf.newXMLFilter(new StreamSource("arkusz.xsl"));

Bierny transformer dla SAX – TransfomerHandler

W przypadku strumienia zdarzeń SAX może zaistnieć potrzeba „biernej” obsługi zdarzeń i przetwarzania ich zgodnie z arkuszem XSLT lub zamiany ich na inny rodzaj reprezentacji dokumentu XML. Zwykły Transformer inicjuje przetwarzanie, a co za tym idzie (w przypadku SAX) także parsowanie.

Obiekt typu TransfomerHandler może być używany w roli ContentHandlera, który pozostaje podłączony do parsera (lub filtra) SAX i po prostu obsługuje zdarzenia wtedy, gdy ktoś inny uruchomi parsowanie. Za pomocą setResult ustala się cel przekształcenia.

Do tworzenia obiektów typu TransfomerHandler oraz innych użytecznych w przypadku SAX służy klasa SAXTransformerFactory.

Streaming API for XML (StAX)

Standard Streaming API for XML jest realizacją idei „parsowania strumieniowego” w Javie, został opracowany w ramach JSR 173, a implementacja parsera była znana także jako Sun Java Streaming XML Parser (SJSXP).

Niedawno StAX został dołączony do wersji 1.4 standardu JAXP i włączony do platformy Java Standard Edition (do wersji 6).

StAX pozwala na czytanie oraz zapisywanie dokumentów XML. Ze standardu można korzystać zasadniczo na dwa sposoby:

• za pomocą kursora – interfejsy ze Stream w nazwie. Niejawnym kursorem przechodzimy do kolejnych węzłów dokumentu, o tym w jakim węźle jesteśmy możemy się dowiedzieć metodą getEventType, a inne metody get... zwracają wartości (np. nazwę węzła, wartość węzła tekstowego / atrybutu). Ten sposób jest najbardziej efektywny, nie zużywa niepotrzebnych zasobów, nadaje się więc do takich zastosowań jak aplikacje J2ME.
• za pomocą zdarzeń – interfejsy z Event w nazwie. Tutaj metodą nextEvent pobieramy kolejne zdarzenie – obiekt typu XMLEvent. Różne zdarzenia będą miały różne konkretne typy (zobacz pakiet javax.xml.stream.events). Ten sposób umożliwia bardziej „eleganckie” programowanie obiektowe w zastosowaniach gdzie oszczędność zasobów nie jest aż tak istotna.

Tworzenie wyniku w StAX

StAX pozwala także tworzyć dokumenty, służą do tego interfejsy XMLStreamWriter i XMLEventWriter.

XMLOutputFactory output = XMLOutputFactory.newInstance();
XMLStreamWriter writer = output.createXMLStreamWriter( ... );
writer.writeStartDocument();
writer.setPrefix("c","http://c");
writer.setDefaultNamespace("http://c");
writer.writeStartElement("http://c","a");
writer.writeAttribute("b","blah");
writer.writeNamespace("c","http://c");
writer.writeDefaultNamespace("http://c");
writer.setPrefix("d","http://c");
writer.writeEmptyElement("http://c","d");
writer.writeAttribute("http://c","chris","fry");
writer.writeNamespace("d","http://c");
writer.writeCharacters("Jean Arp");
writer.writeEndElement();
writer.flush();

Program jest odpowiedzialny za przekazywanie zdarzeń w odpowiedniej kolejności, m.in. zamykanie otwartych elementów. Writer po otrzymaniu zdarzenia startElement czeka z wypisaniem znacznika otwierającego dopóki otrzymuje zdarzenia związane z atrybutami lub przestrzeniami nazw.

Interfejsu XMLEventWriter używa sie podobnie, z tym że konsumuje obiekty–zdarzenia (XMLEvent).

Filtry StAX

Interfejsy StreamFilter i EventFilter służą do implementacji filtrów, które w prosty sposób pozwalają przepuszczać tylko niektóre zdarzenia. XMLInputFactory pozwala tworzyć parsery od razu filtrujące zdarzenia.

public class MyStreamFilter
     implements javax.xml.stream.StreamFilter {
  public boolean accept(XMLStreamReader reader) {
    if (!reader.isStartElement() && !reader.isEndElement())
      return false;
    else
      return true;
  }
}
...
  FileInputStream fis = new FileInputStream(filename);
                
  XMLStreamReader xmlr = xmlif.createFilteredReader(
    xmlif.createXMLStreamReader(fis), new MyStreamFilter());
...