XPath

XPath (XML Path Language) là một ngôn ngữ truy vấn dùng để chọn các nút và giá trị từ tài liệu XML. Trong Apidog, XPath được sử dụng để trích xuất dữ liệu từ các phản hồi API XML, xác thực cấu trúc XML và tạo các khẳng định cho API dựa trên XML.

Bạn có thể sử dụng XPath để chọn các nút hoặc tập hợp nút trong một tài liệu XML bằng cách đi theo một đường dẫn hoặc chuỗi các bước qua hệ thống phân cấp của tài liệu.

Ví dụ XML

Chúng ta sẽ sử dụng tài liệu XML này trong các ví dụ sau:

<?xml version="1.0" encoding="UTF-8"?>
<bookstore>
  <book>
    <title lang="eng">Harry Potter</title>
    <price>29.99</price>
  </book>
  <book>
    <title lang="eng">Learning XML</title>
    <price>39.95</price>
  </book>
</bookstore>

Chọn nút

XPath cho phép bạn chọn các nút hoặc tập hợp nút trong một tài liệu XML bằng cách đi theo một đường dẫn hoặc các bước. Dưới đây là một số biểu thức đường dẫn phổ biến nhất:

Biểu thức	Mô tả
`nodename`	Chọn tất cả các phần tử con của nút này
`/`	Chọn từ nút gốc
`//`	Chọn các nút trong tài liệu từ nút hiện tại khớp với lựa chọn, bất kể vị trí của chúng
`.`	Chọn nút hiện tại
`..`	Chọn nút cha của nút hiện tại
`@`	Chọn một thuộc tính

Ví dụ về biểu thức đường dẫn

Bảng sau hiển thị các biểu thức đường dẫn và kết quả của chúng dựa trên XML ví dụ:

Biểu thức đường dẫn	Kết quả
`bookstore`	Chọn tất cả phần tử con của phần tử bookstore
`/bookstore`	Chọn phần tử gốc bookstore. Nếu đường dẫn bắt đầu bằng dấu gạch chéo tiến ( / ), thì đường dẫn này luôn đại diện cho một đường dẫn tuyệt đối đến một phần tử
`bookstore/book`	Chọn tất cả các phần tử book là phần tử con của bookstore
`//book`	Chọn tất cả các phần tử book bất kể vị trí của chúng trong tài liệu
`bookstore//book`	Chọn tất cả các phần tử book là phần tử con của các phần tử bookstore, bất kể chúng nằm ở đâu bên dưới bookstore
`//@lang`	Chọn tất cả các thuộc tính có tên lang

Đường dẫn tuyệt đối so với đường dẫn tương đối

Các đường dẫn bắt đầu bằng / là tuyệt đối (từ gốc), trong khi các đường dẫn không có / là tương đối với nút hiện tại.

Vị từ

Bạn có thể sử dụng vị từ để tìm một nút cụ thể hoặc một nút chứa giá trị được chỉ định. Vị từ được đặt trong dấu ngoặc vuông và cho phép lọc mạnh mẽ.

Ví dụ về vị từ

Biểu thức đường dẫn	Kết quả
`/bookstore/book[1]`	Chọn phần tử book đầu tiên trong các phần tử con của bookstore
`/bookstore/book[last()]`	Chọn phần tử book cuối cùng trong các phần tử con của bookstore
`/bookstore/book[last()-1]`	Chọn phần tử book áp chót trong các phần tử con của bookstore
`/bookstore/book[position()<3]`	Chọn hai phần tử book đầu tiên trong các phần tử con của bookstore
`//title[@lang]`	Chọn tất cả các phần tử title có thuộc tính tên là lang
`//title[@lang='eng']`	Chọn tất cả các phần tử title có thuộc tính lang với giá trị eng
`/bookstore/book[price>35.00]`	Chọn tất cả các phần tử book của bookstore có giá trị của phần tử price lớn hơn 35.00
`/bookstore/book[price>35.00]//title`	Chọn tất cả các phần tử title của phần tử book trong bookstore có phần tử price lớn hơn 35.00

Đánh chỉ mục vị từ

XPath sử dụng đánh chỉ mục bắt đầu từ 1 cho vị từ, không giống JSONPath sử dụng đánh chỉ mục bắt đầu từ 0. Phần tử đầu tiên là [1], không phải [0].

Chọn nút không xác định

Ký tự đại diện của XPath có thể được sử dụng để chọn các phần tử XML không xác định mà không cần biết tên chính xác của chúng.

Cú pháp ký tự đại diện

Ký tự đại diện	Mô tả
`*`	Khớp với bất kỳ nút phần tử nào
`@*`	Khớp với bất kỳ nút thuộc tính nào
`node()`	Khớp với bất kỳ loại nút nào

Ví dụ về ký tự đại diện

Biểu thức đường dẫn	Kết quả
`/bookstore/*`	Chọn tất cả các phần tử con của phần tử bookstore
`//*`	Chọn tất cả các phần tử trong tài liệu
`//title[@*]`	Chọn tất cả các phần tử title có thuộc tính

Sử dụng ký tự đại diện

Ký tự đại diện hữu ích khi làm việc với các cấu trúc XML động hoặc khi bạn muốn chọn tất cả các phần tử bất kể tên của chúng.

Chọn nhiều đường dẫn

Bạn có thể chọn nhiều đường dẫn bằng cách sử dụng toán tử | trong một biểu thức đường dẫn, cho phép bạn kết hợp nhiều lựa chọn.

Ví dụ về nhiều đường dẫn

Biểu thức đường dẫn	Kết quả
`//book/title \| //book/price`	Chọn tất cả các phần tử title và price của phần tử book
`//title \| //price`	Chọn tất cả các phần tử title và price trong tài liệu
`/bookstore/book/title \| //price`	Chọn tất cả các phần tử title của phần tử book thuộc phần tử bookstore và tất cả các phần tử price trong tài liệu

Trường hợp sử dụng trong Apidog

XPath đặc biệt hữu ích trong Apidog cho:

Xác thực phản hồi XML: Trích xuất các giá trị cụ thể từ phản hồi API XML để xác minh tính chính xác

Kiểm thử API SOAP: Phân tích cú pháp và xác thực phản hồi SOAP

Biến động: Lưu trữ các giá trị XML đã trích xuất để sử dụng trong các yêu cầu tiếp theo

Khẳng định kiểm thử: Tạo khẳng định dựa trên dữ liệu phản hồi XML

Trích xuất dữ liệu: Lấy các trường cụ thể từ các cấu trúc XML lồng nhau phức tạp

XML so với JSON

Mặc dù JSON phổ biến hơn trong các API hiện đại, nhiều hệ thống cũ và dịch vụ dựa trên SOAP vẫn sử dụng XML. XPath là thiết yếu để kiểm thử các API này.

Tài liệu tham khảo

Đặc tả XPath của W3C

Hướng dẫn XPath - W3Schools

Trình kiểm thử XPath

Ví dụ XML#

Chọn nút#

Ví dụ về biểu thức đường dẫn#

Vị từ#

Ví dụ về vị từ#

Chọn nút không xác định#

Cú pháp ký tự đại diện#

Ví dụ về ký tự đại diện#

Chọn nhiều đường dẫn#

Ví dụ về nhiều đường dẫn#

Trường hợp sử dụng trong Apidog#

Tài liệu tham khảo#

Ví dụ XML

Chọn nút

Ví dụ về biểu thức đường dẫn

Vị từ

Ví dụ về vị từ

Chọn nút không xác định

Cú pháp ký tự đại diện

Ví dụ về ký tự đại diện

Chọn nhiều đường dẫn

Ví dụ về nhiều đường dẫn

Trường hợp sử dụng trong Apidog

Tài liệu tham khảo