XPath

XPath(XML Path Language)는 XML 문서에서 노드와 값을 선택하기 위한 쿼리 언어입니다. Apidog에서는 XPath를 사용하여 XML API 응답에서 데이터를 추출하고, XML 구조를 검증하며, XML 기반 API에 대한 어서션을 생성합니다.

문서 계층 구조를 따라 경로 또는 일련의 단계를 지정하여 XML 문서의 노드 또는 노드 집합을 선택할 수 있습니다.

XML 예시

다음 예시에서는 이 XML 문서를 사용하겠습니다.

<?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>

노드 선택

XPath를 사용하면 경로 또는 단계를 따라 XML 문서의 노드 또는 노드 집합을 선택할 수 있습니다. 아래는 가장 일반적인 경로 표현식 중 일부입니다.

표현식	설명
`nodename`	이 노드의 모든 자식을 선택합니다
`/`	루트 노드에서 선택합니다
`//`	현재 노드에서 선택 조건과 일치하는 문서 내 노드를 위치와 관계없이 선택합니다
`.`	현재 노드를 선택합니다
`..`	현재 노드의 부모 노드를 선택합니다
`@`	속성을 선택합니다

경로 표현식 예시

다음 표는 예시 XML을 기준으로 경로 표현식과 그 결과를 보여 줍니다.

경로 표현식	결과
`bookstore`	bookstore 요소의 모든 자식을 선택합니다
`/bookstore`	루트 요소 bookstore를 선택합니다. 경로가 슬래시( / )로 시작하는 경우, 이 경로는 항상 요소에 대한 절대 경로를 나타냅니다
`bookstore/book`	bookstore의 자식인 모든 book 요소를 선택합니다
`//book`	문서 내 위치와 관계없이 모든 book 요소를 선택합니다
`bookstore//book`	bookstore 아래 어디에 위치하든 bookstore 요소의 자식인 모든 book 요소를 선택합니다
`//@lang`	lang이라는 이름의 모든 속성을 선택합니다

절대 경로와 상대 경로

/로 시작하는 경로는 절대 경로(루트에서 시작)이며, /가 없는 경로는 현재 노드를 기준으로 하는 상대 경로입니다.

조건자

조건자를 사용하여 특정 노드 또는 지정된 값을 포함하는 노드를 찾을 수 있습니다. 조건자는 대괄호로 묶으며 강력한 필터링을 가능하게 합니다.

조건자 예시

경로 표현식	결과
`/bookstore/book[1]`	bookstore 자식 요소 중 첫 번째 book 요소를 선택합니다
`/bookstore/book[last()]`	bookstore 자식 요소 중 마지막 book 요소를 선택합니다
`/bookstore/book[last()-1]`	bookstore 자식 요소 중 끝에서 두 번째 book 요소를 선택합니다
`/bookstore/book[position()<3]`	bookstore 자식 요소 중 처음 두 개의 book 요소를 선택합니다
`//title[@lang]`	lang이라는 이름의 속성을 가진 모든 title 요소를 선택합니다
`//title[@lang='eng']`	값이 eng인 lang 속성을 가진 모든 title 요소를 선택합니다
`/bookstore/book[price>35.00]`	price 요소의 값이 35.00보다 큰 bookstore의 모든 book 요소를 선택합니다
`/bookstore/book[price>35.00]//title`	price 요소가 35.00보다 큰 bookstore 내 book 요소의 모든 title 요소를 선택합니다

조건자 인덱싱

XPath는 조건자에 1부터 시작하는 인덱싱을 사용하며, 이는 0부터 시작하는 인덱싱을 사용하는 JSONPath와 다릅니다. 첫 번째 요소는 [0]이 아니라 [1]입니다.

알 수 없는 노드 선택

XPath 와일드카드를 사용하면 정확한 이름을 알지 못해도 알 수 없는 XML 요소를 선택할 수 있습니다.

와일드카드 구문

와일드카드	설명
`*`	모든 요소 노드와 일치합니다
`@*`	모든 속성 노드와 일치합니다
`node()`	모든 유형의 노드와 일치합니다

와일드카드 예시

경로 표현식	결과
`/bookstore/*`	bookstore 요소의 모든 자식 요소를 선택합니다
`//*`	문서의 모든 요소를 선택합니다
`//title[@*]`	속성이 있는 모든 title 요소를 선택합니다

와일드카드 사용

와일드카드는 동적 XML 구조를 다루거나 이름과 관계없이 모든 요소를 선택하려는 경우에 유용합니다.

여러 경로 선택

경로 표현식에서 | 연산자를 사용하여 여러 경로를 선택할 수 있으며, 이를 통해 여러 선택 항목을 결합할 수 있습니다.

여러 경로 예시

경로 표현식	결과
`//book/title \| //book/price`	book 요소의 모든 title 및 price 요소를 선택합니다
`//title \| //price`	문서의 모든 title 및 price 요소를 선택합니다
`/bookstore/book/title \| //price`	bookstore 요소의 book 요소에 있는 모든 title 요소와 문서의 모든 price 요소를 선택합니다

Apidog에서의 사용 사례

XPath는 Apidog에서 특히 다음과 같은 용도로 유용합니다.

XML 응답 검증: XML API 응답에서 특정 값을 추출하여 정확성을 확인합니다

SOAP API 테스트: SOAP 응답을 구문 분석하고 검증합니다

동적 변수: 추출한 XML 값을 후속 요청에서 사용할 수 있도록 저장합니다

테스트 어서션: XML 응답 데이터를 기반으로 어서션을 생성합니다

데이터 추출: 복잡한 중첩 XML 구조에서 특정 필드를 가져옵니다

XML과 JSON

최신 API에서는 JSON이 더 일반적이지만, 많은 레거시 시스템과 SOAP 기반 서비스는 여전히 XML을 사용합니다. XPath는 이러한 API를 테스트하는 데 필수적입니다.

참고 자료

W3C XPath 사양

XPath 튜토리얼 - W3Schools

XPath 테스터

XML 예시#

노드 선택#

경로 표현식 예시#

조건자#

조건자 예시#

알 수 없는 노드 선택#

와일드카드 구문#

와일드카드 예시#

여러 경로 선택#

여러 경로 예시#

Apidog에서의 사용 사례#

참고 자료#

XML 예시

노드 선택

경로 표현식 예시

조건자

조건자 예시

알 수 없는 노드 선택

와일드카드 구문

와일드카드 예시

여러 경로 선택

여러 경로 예시

Apidog에서의 사용 사례

참고 자료