XPath 是一種用來從文件樹中挑選節點與節點集的語言,也是 XSLT 表達式的核心基礎。
從 XPath 的視角看,一份 XML 文件由七種節點構成:
要留意的是,CDATA 區段、實體參照與文件型別宣告並不算在內——XPath 是在這些項目都被展開合併之後才開始作用。另外,「根節點」與「根元素」是兩個不同概念:根節點包含整份文件(連同根元素本身),根元素只是它的一個子節點。
| 模式 | 說明 |
|---|---|
| match="E" | 匹配元素 E |
| match="*" | 匹配任意元素 |
| match="E|F" | 匹配元素 E 與 F |
| match="E/F" | 匹配以 E 為父元素的 F |
| match="E//F" | 匹配以 E 為根元素的 F |
| match="/" | 匹配根節點 |
| match="text()" | 匹配文字節點 |
| match="comment()" | 匹配註解節點 |
| match="processing-instruction()" | 匹配處理指令 |
| match="node()" | 匹配除屬性節點與根節點外的節點 |
| match="id(test)" | 匹配具唯一 ID 為 test 的元素 |
| match="E[@CLASS='foo']" | 匹配 class 屬性為 foo 的元素 E |
| match="E[F]" | 匹配含有子元素 F 的元素 E |
軸指定「上下文節點」與「要選取的節點」之間的關係。XPath 共有十三種軸,最常用的是 child、attribute、self、parent 這四種。
| 軸 | 說明 |
|---|---|
| child | 當前節點的子節點 |
| descendant | 當前節點的所有後代(不含屬性與命名空間節點) |
| parent | 當前節點的父節點 |
| ancestor | 當前節點的祖先,永遠包含根節點 |
| following-sibling | 當前節點之後的所有兄弟節點(不含屬性與命名空間節點) |
| preceding-sibling | 當前節點之前的所有兄弟節點(不含屬性與命名空間節點) |
| following | 當前節點之後的所有節點,排除其後代與屬性/命名空間節點 |
| preceding | 當前節點之前的所有節點,排除其祖先與屬性/命名空間節點 |
| attribute | 當前節點的所有屬性 |
| namespace | 當前節點的所有命名空間節點 |
| self | 只包含當前節點本身 |
| descendant-or-self | 當前節點及其所有後代 |
| ancestor-or-self | 當前節點及其所有祖先 |
XPath 表達式常會一口氣匹配多個節點,若要進一步篩選,就加上謂詞。
| 表達式 | 說明 |
|---|---|
| E | 選取當前節點的子元素 E |
| * | 選取當前節點的所有子元素 |
| text() | 選取當前節點的文字節點子節點 |
| @name | 選取當前節點的 name 屬性 |
| @* | 選取當前節點的所有屬性 |
| E[1] | 選取第一個子元素 E |
| E[last()] | 選取最後一個子元素 E |
| */E | 選取所有孫輩中的 E 元素 |
| E//F | 選取由子元素 E 衍生而來的所有 F |
| // | 選取根元素 |
| //E | 選取從根節點衍生的所有 E |
| //E/F | 選取所有 E 的子元素 F |
| . | 選取當前節點 |
| .//E | 選取從當前節點衍生的所有 E |
| .. | 選取父節點 |
| ../@name | 選取父節點的 name 屬性 |
| E[@name='foo'] | 選取 name 屬性值為 foo 的子元素 E(除 = 外還可用 <、>、<=、>=、!=) |
| E[@foo and @bar] | 選取同時具備 foo 與 bar 屬性的 E |
home/person/@id 這種寫法叫簡寫定位路徑,簡潔易懂,是 XSLT 匹配模式中最常見的形式。另有一種非簡寫定位路徑,把節點測試與軸明確寫出來:
child::home/child::person/attribute::id
實務上不常用,但它有重要的效能意義,值得理解。
位置路徑是 XPath 最常用的表達式,用來標識文件中的節點集。除此之外,XPath 表達式還能回傳數字、布林值與字串。非節點集的表達式不能用於 xsl:template 的 match 屬性,只能用於 xsl:value-of 的 select 屬性或位置路徑的謂詞中。
每個位置路徑可分為一步或多步,各步以 / 分隔:
room[@name=$root]/date[year=$year and month=$month]/meeting
上下文節點就是當前正在處理的節點,由 XSLT 處理器在表達式求值前建立;每處理完一步,上下文就會改變。
位置路徑中的每一步由三部分組成:
axis::node-test[predicate]
軸與節點測試之間以 :: 分隔,每個謂詞用一對 [] 包住。
要設計出一條好的位置路徑,原則是:每一步都選到最少的節點、用最嚴格的軸、用最嚴格的節點測試,並盡量避免謂詞。原因是軸與節點測試選出的節點集中的每個節點,都會被用作謂詞求值時的上下文節點——節點越多,謂詞被求值的次數就越多。三步之中,最省成本的優化點是節點測試。
XPath 中的所有數字都是 8 位元組的 IEEE 754 浮點雙精度型別,等同 Java 的 double,可表示正負無窮大與 NaN(零除零)。支援五種運算:加 +、減 -、乘 *、除 div、取餘 mod。
字串是 Unicode 字元,以單引號或雙引號定界。可用 = 與 != 比較,也可用 <、>、<=、>= 做關係運算,但比較的兩側必須能轉為數字,否則結果沒有意義。
布林值常用於位置路徑的謂詞中,例如 /person[name="debian"],也常用於 xsl:if 與 xsl:when 的 test 屬性:
<xsl:template match="home">
<xsl:if test=".='debian' or .='redhat'">
<xsl:value-of select="." />
</xsl:if>
</xsl:template>
XPath 提供了大量函數供表達式與謂詞使用,回傳值分四類:
true() 回傳真、false() 回傳假、not() 取反。number() 把任意型別轉為數字、ceiling() 回傳大於或等於參數的最小整數。position() 回傳當前節點在上下文節點列表中的位置、count() 統計節點數。string() 把任意型別轉為字串、string-length() 回傳字串長度。