Wszystkie przykładowe programy:
API Javy (pakiety javax.xml.*):
javax.xml.transform, javax.xml.stream.Standard JAXP opisuje podstawowe wsparcie dla przetwarzania XML w Javie, jest częścią platformy Java Standard Edition.
Standard określa klasy i interfejsy, z których bezpośrednio powinni korzystać programiści. Standard pozwala na używanie różnych implementacji poszczególnych składników bez jawnego używania klas implementacyjnych (odpowiada za to tzw. plugability layer). To, jaka implementacja zostanie wybrana, zależy od konfiguracji środowiska (klasy dostępne w ścieżce CLASSPATH oraz własności systemowe).
JAXP zawiera następujące składniki:
Transformer),
W pakiecie javax.xml.transform oraz podpakietach
zawarte są klasy i interfejsy stanowiące wsparcie dla przekształceń dokumentów.
Obiekt typu Transformer odpowiada definicji przekształcenia, na przykład arkuszowi XSLT.
Wywołanie metody transform
tego obiektu powoduje przekształcenie dokumentu odczytanego z podanego źródła
i zapisanie wyniku przekształcenia do podanego wyjścia.
Zarówno wejściem jak i wyjściem przekształcenia może być jedna z poniższych reprezentacji dokumentu:
Obecnie można używać przekształceń identycznościowych lub stworzyć obiekt typu Transformer na podstawie arkusza XSLT.
Standard JAXP 1.4 odnosi się do XSLT w wersji 1.0, ale, jak dowodzą doświadczenia,
implementacja Saxon pozwala na wykonywanie transformacji XSLT 2.0
w sposób zgodny z JAXP (wystarczy do CLASSPATH dodać plik saxon9.jar).
Przekształcenia identycznościowe mogą być wykorzystane do zmiany sposobu reprezentacji dokumentu,
np. zbudowania drzewa DOM ze strumienia zdarzeń SAX, serializacji strumienia zdarzeń SAX lub drzewa DOM (bez użycia Load and Save).
Jest to istotna funkcjonalność transformerów, a abstrakcyjne spojrzenie na dokument XML
poprzez interfejs Source jest także wykorzystywane w innych miejscach w Javie,
m.in. w bibliotece JAX-WS (implementacja usług sieciowych / WebServices).
Możliwość serializacji strumienia zdarzeń SAX pozwala na wykorzystanie filtrów SAX do zmiany dokumentów XML bez ich wczytywania do pamięci (co byłoby konieczne przy wykorzystaniu DOM lub JAXB).
Plik: Transformer1.java.
To przykład podstawowego wykorzystania transformera do wykonania przekształcenia XSLT.
Plik: Transformer2.java.
W tym przykładzie źródłem jest strumień zdarzeń SAX, bezpośrednio z parsera.
Plik: Transformer3.java.
W tym przykładzie zdarzenia SAX płyną z parsera, poprzez filtr, do transformera serializującego zdarzenia do pliku. W ten sposób dokument jest modyfikowany bez wczytywania go w całości do pamięci.
id-kategorii
dla dokumentów "sklep", takich jak
przykładowy dokument.
Klasa SAXTransformerFactory, będąca podklasą TransformerFactory,
umożliwia tworzenie, poza normalnymi Transformer-ami, filtrów SAX realizujących
przekształcenie XSLT.
SAXTransformerFactory tf = (SAXTransformerFactory)SAXTransformerFactory.newInstance();
XMLFilter f = tf.newXMLFilter(new StreamSource("arkusz.xsl"));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.
Napisz program używający filtra kategorii inaczej, korzystając z TransfomerHandler.
Klasy i interfejsy związane z walidacją są umieszczone w pakiecie javax.xml.validation.
Aby walidacja zgodnie z tym „nowym” interfejsem działała zwykle trzeba
włączyć obsługę przestrzenia nazw w parserze.
Obiekty typu Schema to schematy, które definiują strukturę dokumentów XML.
Do tworzenia obiektów typu Schema służą obiekty klasy SchemaFactory.
Obiekty typu Schema mogą być utworzone na podstawie schematów XML Schema,
ale także schematów Relax NG czy Schematron, o ile dana implementacja komponentu służącego do walidacji je obsługuje.
Obiekty typu Schema mogą być wykorzystane do sprawdzania poprawności dokumentów podczas parsowania:
fabryce parserów (zarówno SAX jak i DOM) metodą setSchema można wskazać schemat,
względem którego ma być walidowany dokument.
Przykłady walidacji dokumentu podczas wczytywania przez parsery DOM i SAX.
Validator
Z obiektu typu Schema metodą newValidator można uzyskać obiekt typu Validator,
za pomocą którego można zwalidować dokument, nawet jeśli dokument nie jest dostępny jako plik,
a na przykład drzewo DOM czy strumień zdarzeń SAX. Do obsługi błędów walidacji należy użyć
obiektu typu ErrorHandler, jak dla parsera SAX.
Walidacja może mieć wpływ na zawartość dokumentu, poprzez wstawienie domyślnych wartości atrybutów i normalizację białych znaków.
Dlatego do walidacji możemy użyć najbardziej ogólnej metody
Validator.validate(Source, Result),
która waliduje dokument podany w pierwszym argumencie a (potencjalnie zmieniony) wynik zwraca poprzez drugi argument.
Jak widać dozwolone są te same rodzaje źródeł i wyników, co dla transformerów, jednak tutaj wynik musi być tego samego rodzaju co źródło.
ValidatorHandler
W przypadku walidacji strumienia zdarzeń SAX czasami wygodniej jest użyć „biernego”
obiektu typu ValidatorHandler (podobnie jak TransformerHandler).
Metoda setContentHandler pozwala do obiektu typu ValidatorHandler dołączyć
ContentHandler, który będzie odbierał zdarzenia reprezentujące zwalidowany dokument.
JAXP 1.4 obejmuje wsparcie dla XPath 1.0.
Klasy i interfejsy stanowiące wsparcie dla XPath zostały umieszczone w pakiecie javax.xml.xpath.
Do obliczania wyrażeń służą obiekty implementujące interfejs XPath, można je uzyskać z obiektu klasy XPathFactory.
Wartość wyrażenia XPath może być obliczona dla dokumentu dostępnego jako plik (lub ogólnie ciąg znaków) lub jako drzewo DOM. W pierwszym przypadku w celu obliczenia jednego wyrażenia parsowany jest cały dokument, co zwykle nie jest efektywnym rozwiązaniem, drugi przypadek jest możliwy do osiągnięcia tylko dla dokumentów mieszczących się w pamięci. Wyrażenie może być także obliczone w kontekście konkretnego węzła – należy go podać jako węzeł DOM.
Wynik wyrażenia można odebrać jako obiekt Javy typu najbardziej odpowiedniego dla wskazanego typu XPath (metoda typu Object).
Węzły zwracane są jako węzły DOM. Typy atomowe w XPath 1.0 to jedynie liczby, napisy i boolean – zwracane są odpowiednie obiekty Javy.
Wynik można też odebrać zrzutowany od razu na String (metoda typu String).
Plik: XPathExample.java.