XPath

XPath – kelio standartas duomenų struktūrai XML dokumente pasiekti. XPath sintaksė kiek primena failų sistemose naudojamą kelią dokumentams aplanke rasti, tačiau yra daug lankstesnė ir numato atvejus kuomet tame pačiame aplanke (pavyzdžiui, narių sąraše) yra vienodus vardus turintys elementai. Galimas elementų indeksavimas bei paieška pagal atributų reikšmes. XPATH gali būti naudojama skyrium arba kaip sudėtingesnės XSLT transformacijų kalbos dalis.

XPath sukūrė World Wide Web Consortium (W3C) 1999 m.

Kelio aprašas

XPath užklausa vykdoma, vieną XML dokumento mazgą laikant užklausos kontekstu.

XPath išraišką sudaro:

• Ašis, nurodanti išrenkamų mazgų santykį su konteksto mazgu.
• Mazgų testas.
• Predikatai, ribojantys išrenkamų mazgų aibę.

Ašys

XPath ašis apibrėžia aibę mazgų, susijusių su konteksto mazgu. Kiekvienos ašies mazgų aibė yra vieno tipo: elementų, atributų arba vardų srities. XPath egzistuoja tokios ašys:

• child – aibė elementų, kurių tėvas yra konteksto mazgas.
• descendant – aibė elementų, kurių tėvas, tėvo tėvas ir t. t. yra konteksto mazgas.
• parent – elementas, kuris yra konteksto mazgo tėvas.
• ancestor – aibė elementų: konteksto mazgo tėvas, tėvo tėvas ir t. t.
• following - sibling – aibė po konteksto mazgo einančių elementų, kurių tėvas tas pats kaip ir konteksto mazgo.
• preceding - sibling – aibė prieš konteksto mazgą einančių elementų, kurių tėvas tas pats kaip ir konteksto mazgo.
• following – aibė elementų, esančių po konteksto mazgo.
• preceding – aibė elementų, esančių prieš konteksto mazgą.
• attribute – aibė konteksto mazgo atributų.
• namespace – aibė vardų sričių mazgų, susietų su konteksto mazgu.
• self – konteksto mazgas.
• descendent - or - self – self ir descendent elementų sąjunga.
• ancestor - or - self – self ir ancestor elementų sąjunga.

Mazgų testas

Mazgų testas gali pagal pavadinimą, vardų sritį, ir tipą apriboti išrenkamus mazgus.

Predikatai

Predikatai gali apriboti išrenkamą mazgų aibę pagal nurodytus požymius (pavyzdžiui, išrinkti tik antrąjį elementą)

Trumpesnė sintaksė

Išraiška	Sinonimas	Pastabos
child::node()	*
child::node	node
descendant::node()	.//*
descendant::node()	//*	Tik kai konteksto mazgas yra šaknis
parent::node()	..
attribute::node()	@*
self::node()	.

Vartojimo pavyzdys

<?xml version="1.0" encoding="utf-8" ?>
<?xml-stylesheet href="test.xsl" type="text/xsl" ?>
<straipsnis xml:id="1" xmlns="http://lt.wikipedia.org/wiki/XPath#Vartojimo_pavyzdys" data="2006-11-06">
  <pavadinimas xml:id="2">XPath</pavadinimas>
  <skyrius xml:id="3" pavadinimas="Kelio aprašas">
    <skyrius xml:id="4" pavadinimas="Ašys" >
      <sąrašas xml:id="5" />
    </skyrius>
    <skyrius xml:id="6" pavadinimas="Mazgų testas" />
    <skyrius xml:id="7" pavadinimas="Predikatai" />
  </skyrius>
  <skyrius xml:id="8" pavadinimas="Pavyzdys" />
  <skyrius xml:id="9" pavadinimas="Sąvokos" />
  <skyrius xml:id="10" pavadinimas="Funkcijos" />
  <literatūra>
  </literatūra>
</straipsnis>

Konteksto mazgo id yra '3':

• child::*/@xml: id rezultatas yra {'4', '6', '7'}.
• descendant::*/@xml: id rezultatas yra {'4', '5', '6', '7'}.
• descendant - or - self::*/@xml: id rezultatas yra {'3', '4', '5', '6', '7'}.
• parent::*/@xml: id rezultatas yra {'1'}.
• namespace::* rezultatas yra { 'http://lt.wikipedia.org/wiki/XPath#Vartojimo_pavyzdys', 'http://www.w3.org/XML/1998/namespace' }.
• self::* rezultatas yra {3}.

Konteksto mazgo id yra '8':

• following - sibling::*/@xml: id rezultatas yra {'9', '10'}.
• preceding - sibling::*/@xml: id rezultatas yra {'2', '3'}.
• following::*/@xml: id rezultatas yra {'9', '10'}.
• preceding::*/@xml: id rezultatas yra {'2', '3', '4', '5', '6', '7'}.

Konteksto mazgo id yra '4':

• ancestor::*/@xml: id rezultatas yra {'1', '3'}.
• ancestor - or - self::*/@xml: id rezultatas yra {'1', '3', '4'}.

Konteksto mazgo id yra '1':

• attribute::* rezultatas yra {'2006-11-06'}.

„Sveikas pasauli“ pavyzdys

XML dokumentui

<vietos>
  <vieta vardas="dangus" būsena="a"/>
  <vieta vardas="pasaulis" būsena="sveikas"/>
  <vieta vardas="pragaras" būsena="b"/>
</vietos>

XPath takas

/vietos/vieta[@vardas="pasaulis"]/@būsena

turi grąžinti tekstą „sveikas“ (paieška pagal atributo reikšmę)

XPath takas

/vietos/vieta[2]/@būsena

irgi turi grąžinti tekstą „sveikas“ (indeksavimas).

Sąvokos

XPath išraiškos konceptualiai vykdomos XML dokumente kaip medyje. XPath specifikacijoje apibrėžti 7 mazgų tipai:

• Šaknis – dokumento medžio šaknis (žymimas „/“). Ji būtinai turi vieną vaiką – elementą (dokumento elementą) ir gali turėti šiuos vaikus: komentarus, vykdymo instrukcijas (esančias prieš ir po dokumento elemento).
• Elementas – bet kuris iš XML elementų. Jis gali turėti šiuos vaikus: elementus, komentarus, vykdymo instrukcijas, tekstus.
• Tekstas – mazgas, priklausantis elementui; jame įrašytas tekstas.
• Atributas priklauso vienam iš elementų. Šio mazgo tėvinis mazgas yra elementas, tačiau atributas nėra elemento vaikas.
• Vardų sritys yra susietos su elementais. Vardų srities tėvinis mazgas yra elementas, tačiau vardų srities mazgas nėra elemento vaikas.
• Vykdymo instrukcija (pavyzdžiui, <?xml-stylesheet href="style.css" type="text/css"?>).
• Komentaras.

Funkcijos

XPath išraiškose gali būti naudojamos šios funkcijos:

• skaičius last()
  • Grąžina nagrinėjamos mazgų aibės mazgų skaičių.
• skaičius position()
  • Grąžina nagrinėjamo mazgo eilės numerį aibėje.
• skaičius count(mazgų aibė)
  • Grąžina mazgų aibės mazgų skaičių.
• mazgų aibė id(objektas)
  • Grąžina mazgų aibę su nurodyta(-omis) id atributų reikšmėmis.

Literatūra

1. XPath standarto tinklalapis (angl.)
2. XPath vadovėlis Archyvuota kopija 2012-11-26 iš Wayback Machine projekto. (angl.)
3. XPath vadovėlis (vok.)
4. XSLT ir XPath nuoroda Archyvuota kopija 2010-10-30 iš Wayback Machine projekto. (vok.)