패키지 javax.xml.xpath

이 패키지는 XPath 식을 평가하기 위한 「객체 모델에 존하지 않는다」API를 제공해, 평가 환경에 액세스 합니다.

참조처:
설명

인터페이스 개요

XPath	XPath는 XPath 평가 환경 및 식에의 액세스를 제공합니다.
XPathExpression	XPathExpression는 컴파일 된 XPath 식에의 액세스를 제공합니다.
XPathFunction	XPathFunction는 XPath 함수에의 액세스를 제공합니다.
XPathFunctionResolver	XPathFunctionResolver는 일련의 사용자 정의의 XPathFunction에 의 액세스를 제공합니다.
XPathVariableResolver	XPathVariableResolver는 일련의 사용자 정의의 XPath 변수에의 액세스를 제공합니다.

클래스 개요

XPathConstants	XPath 정수입니다.
XPathFactory	XPathFactory인스턴스를 사용해, XPath 객체를 작성할 수 있습니다.

예외 개요

XPathException	XPathException는 범용 XPath 예외를 나타냅니다.
XPathExpressionException	XPathExpressionException는 XPath 식의 에러를 나타냅니다.
XPathFactoryConfigurationException	XPathFactoryConfigurationException는 XPathFactory 환경의 구성 에러를 나타냅니다.
XPathFunctionException	XPathFunctionException는 XPath 함수의 에러를 나타냅니다.

패키지 javax.xml.xpath 설명

이 패키지는 XPath 식을 평가하기 위한 「객체 모델에 존하지 않는다」API를 제공해, 평가 환경에 액세스 합니다.

다음의 XML 표준이 적용됩니다.

• 「XML Path Language (XPath) Version 1.0」

XPath 개요

XPath 언어는 XML 문서로부터 노드를 선택하기 위한 단순하고 간결한 구문을 제공합니다. 또, XML 문서 객체 모델 (DOM) 트리의 노드를 boolean, double, 또는 string 치로 변환하기 위한 규칙도 제공합니다. XPath는 W3C에 의해 정의된 언어이며, 공식의 W3C 권고입니다. W3C는 XML Path Language (XPath) Version 1.0 사양을 호스트 하고 있습니다.

XPath는 1999 년에 XSLT 및 XPointer 언어의 보충으로서 탄생했습니다만, 최근에는 독립한 언어로서 또 많은 DOM API 코드 대신에 사용할 수 있는 단일의 XPath 식으로서 보급해 왔습니다.

XPath 식

XPath 식은 1개의 「로케이션 패스」 및 1개 또는 복수의 「프레디케이트」로 구성됩니다. 식에는 XPath 변수가 포함되는 경우도 있습니다.

간단한 XPath 식의 예를 다음에 나타냅니다.

/foo/bar

이 예는 다음과 같은 XML 문서의 <bar> 요소를 선택합니다.

<foo><bar/></foo>

식 /foo/bar는 로케이션 패스의 예입니다. XPath 로케이션 패스는 Unix 스타일의 파일 시스템 패스를 닮아 있습니다만, XPath 식에서는 식에 성냥 하는 「모든」노드를 돌려준다고 하는 점이 중요한 상위입니다. 따라서, /foo/bar 식에 의해 다음의 문서의 3 개 모든 <bar> 요소가 선택됩니다.

<foo><bar/><bar/><bar/></foo>

특별한 로케이션 패스 연산자, //는 깊이에 관계없이 XML 문서의 노드를 선택합니다. 문서내의 위치에 관계없이, 모든 <bar> 요소를 선택하는 경우의 예를 다음에 나타냅니다.

//bar

와일드 카드 연산자 *를 사용하면, 모든 요소 노드가 선택됩니다. <foo> 요소의 모든자식 요소를 선택하는 예를 다음에 나타냅니다.

/foo/*

XPath 로케이션 패스는 요소 노드 뿐만이 아니라, 속성 노드, 텍스트 노드, 코멘트 노드 및 처리의 지시 노드를 주소 지정할 수도 있습니다. 이러한 각 노드형에 대한 로케이션 패스의 예를 다음의 겉(표)에 나타냅니다.

로케이션 패스	설명
/foo/bar/@id	<bar> 요소의 속성 id를 선택
/foo/bar/text()	<bar> 요소의 텍스트 노드를 선택. 이스케이프 된 문자 데이터와 이스케이프되어 있지 않은 문자 데이터에 차이는 없는
/foo/bar/comment()	<bar> 요소에 포함되는 모든 코멘트 노드를 선택
/foo/bar/processing-instruction()	<bar> 요소에 포함되는 모든 처리의 지시 노드를 선택

프레디케이트에서는 XPath 로케이션 패스로 선택된 노드를 세련 하는 것이 가능합니다. 프레디케이트는 [expression] 형식을 취합니다. true값을 가지는 include 속성을 포함한 모든 <foo> 요소를 선택하는 예를 다음에 나타냅니다.

//foo[@include='true']

프레디케이트를 다음과 같이 추가해, 식을 또한 세련 할 수도 있습니다.

//foo[@include='true'][@mode='bar']

XPath API 사용

XPath API를 사용해, XML 문서로부터 1개 또는 복수의 노드를 선택하는 경우의 예를 다음에 나타냅니다.

XPath xpath = XPathFactory.newInstance(). newXPath() ;String expression = "/widgets/widget";InputSource inputSource = new InputSource("widgets.xml") ;NodeSet nodes = (NodeSet) xpath.evaluate(expression, inputSource, XPathConstants.NODESET);

XPath 식 및 형태

XPath 식은 XML 문서의 노드를 선택합니다만, XPath API는 선택된 노드를 다음에 나타내는 다른 데이터형의 어느 쪽인가에 합체 시킬 수가 있습니다.

• Boolean
• 수치
• String

바람직한 반환값의 형태는 식을 평가하기 위해서 사용된 메서드 호출 QName 파라미터로 지정되고 있습니다. 이것은, XPathExpression.evalute(...) 호출인가XPath.evaluate(...) 간이 메서드의 1개가 됩니다. 허가되는 QName 치는 다음과 같이 XPathConstants 클래스의 정수로서 지정되고 있습니다.

• XPathConstants.NODESET
• XPathConstants.NODE
• XPathConstants.STRING
• XPathConstants.BOOLEAN
• XPathConstants.NUMBER

Boolean 형 반환값이 요구되면, 1개 또는 복수의 노드가 선택되고 있는 경우는Boolean.TRUE가 돌려주고져 그렇지 않은 경우는Boolean.FALSE가 리턴됩니다 .

String 반환값형은 텍스트 노드, 속성 노드, 코멘트 노드, 또는 처리의 지시 노드로부터 문자 데이터를 얻는인 경우에 편리합니다. 요소 노드에 사용하면,자식 텍스트 노드의 값이 리턴됩니다 .

Number 반환값형은 노드의 텍스트를 double 데이터형에 합체 시킵니다.

XPath 컨텍스트

XPath 로케이션 패스는 context로 불리는 문서안의 특정의 노드에 관련된 경우가 있습니다. 다음의 XML 문서를 봐 주세요.

<widgets><widget><manufacturer/><dimensions/></widget></widgets>

다음의 XPath API 코드로<widget> 요소를 선택할 수 있습니다 .

// parse the XML as a W3C DocumentDocumentBuilder builder = DocumentBuilderFactory.newInstance(). newDocumentBuilder() ;Document document = builder.parse(new File("/widgets.xml"));
XPath xpath = XPathFactory.newInstance(). newXPath() ;String expression = "/widgets/widget";Node widgetNode = (Node) xpath.evaluate(expression, document, XPathConstants.NODE);

<widget> 요소에의 참조가 있으면, 관련된 XPath 식을 다음과 같이 써, <manufacturer> 자 요소를 선택하도록 할 수 있습니다.

XPath xpath = XPathFactory.newInstance(). newXPath();String expression = "manufacturer";Node manufacturerNode = (Node) xpath.evaluate(expression, widgetNode, XPathConstants.NODE);

• Author Ben Galbraith
• Author Norman Walsh
• Author Jeff Suttor
• See XML Path Language (XPath) Version 1.0
• Since 1.5