javax.xml.xpath
인터페이스 XPathExpression

public interface XPathExpression

XPathExpression 는 컴파일 된 XPath 식에의 액세스를 제공합니다.

XPath 식의 평가
문맥	문맥 항목이 없는 식을 평가하는 요구를 했을 경우, 문맥에는 빈 상태(empty)의 문서 노드가 사용된다. XPath 식을 평가하기 위해(때문에), DocumentFragment 가 문서 노드와 같게 다루어진다
변수	식에 변수의 참조가 포함되는 경우,XPathVariableResolver 에 의해 그 값을 찾아낼 수 있다. 변수 리절버가 정의되어 있지 않은지, 리절버로부터 변수에 대해서 null 가 돌려주어졌을 경우,XPathExpressionException 가 생성된다. 변수의 값은, 1 회의 평가의 과정을 통해서 불변이 아니면 안된다
함수	식에 함수의 참조가 포함되는 경우,XPathFunctionResolver 에 의해 함수를 찾아낼 수 있다. 함수 리절버가 정의되어 있지 않은지, 리절버로부터 함수에 대해서 null 가 돌려주어졌을 경우,XPathExpressionException 가 생성된다
QName	식안의 QName 가 XPath 이름 공간 문맥에 비추어 해결된다
result	식의 평가의 결과는 목적의 반환값의 형태의 인스턴스에 변환된다. 유효한 반환값의 형태는,XPathConstants 에 정의한다. 반환값의 형태에의 변환은 XPath 변환 규칙에 따른다

　

XPath 식은 thread에 대해서 안전하지 않고, 재입 불가능합니다. 즉, 어플리케이션측에서, 어떠한 경우에서도 1 개 XPathExpression 객체가 복수의 thread로부터 사용되는 것이 없게 할 필요가 있습니다. 또,evaluate 메소드가 불려 가고 있는 동안, 어플리케이션은 재귀적으로 evaluate 메소드를 호출할 수가 없습니다.

도입된 버젼:

1.5

관련 항목:

XML Path Language (XPath) Version 1.0, Expressions

메소드의 개요

String	evaluate (InputSource source) 지정된 InputSource 의 문맥으로 컴파일 된 XPath 식을 평가해, 결과를 String 로서 돌려줍니다.
Object	evaluate (InputSource source, QName returnType) 지정된 InputSource 의 문맥으로 컴파일 된 XPath 식을 평가해, 결과가 지정된 형태로서 돌려줍니다.
String	evaluate (Object item) 지정된 문맥으로 컴파일 된 XPath 식을 평가해, 결과를 String 로서 돌려줍니다.
Object	evaluate (Object item, QName returnType) 지정된 문맥으로 컴파일 된 XPath 식을 평가해, 결과가 지정된 형태로서 돌려줍니다.

메소드의 상세

evaluate

Object  evaluate(Object  item,
                QName  returnType)
                throws XPathExpressionException 

지정된 문맥으로 컴파일 된 XPath 식을 평가해, 결과가 지정된 형태로서 돌려줍니다.

　

문맥 항목의 평가, 변수, 함수, 및 QName 의 해결과 반환값의 형태의 변환에 대해서는「XPath 식의 평가」를 참조해 주세요.

　

returnType 가 XPathConstants 에 정의된 형태가 아닌 경우,IllegalArgumentException 가 throw 됩니다.

　

item 에 null 치가 제공되는 경우, 문맥에는 빈 상태(empty)의 문서가 사용됩니다. returnType 가 null 의 경우는,NullPointerException 가 throw 됩니다.

파라미터:

item - 초기 문맥 (노드 등)

returnType - 목적의 반환값의 형태

반환값:

식을 평가해, 결과를 returnType 로 변환한 결과이다 Object

예외:

XPathExpressionException - 식을 평가할 수 없는 경우

IllegalArgumentException - returnType 가 XPathConstants 에 정의된 형태가 아닌 경우

NullPointerException - returnType 가 null 의 경우

evaluate

String  evaluate(Object  item)
                throws XPathExpressionException 

지정된 문맥으로 컴파일 된 XPath 식을 평가해, 결과를 String 로서 돌려줍니다.

　

이 메소드는,returnType 가 XPathConstants.STRING 으로 evaluate(Object item, QName returnType) 를 호출합니다.

　

문맥 항목의 평가, 변수, 함수, 및 QName 의 해결과 반환값의 형태의 변환에 대해서는「XPath 식의 평가」를 참조해 주세요.

　

item 에 null 치가 제공되는 경우, 문맥에는 빈 상태(empty)의 문서가 사용됩니다.

파라미터:

item - 초기 문맥 (노드 등)

반환값:

식을 평가해, 결과를 String 로 변환한 결과이다 String

예외:

XPathExpressionException - 식을 평가할 수 없는 경우

evaluate

Object  evaluate(InputSource  source,
                QName  returnType)
                throws XPathExpressionException 

지정된 InputSource 의 문맥으로 컴파일 된 XPath 식을 평가해, 결과가 지정된 형태로서 돌려줍니다.

　

이 메소드는 InputSource 의 데이터 모델을 구축해, 결과의 문서 객체에 대해서 evaluate(Object item, QName returnType) 를 호출합니다.

　

문맥 항목의 평가, 변수, 함수, 및 QName 의 해결과 반환값의 형태의 변환에 대해서는「XPath 식의 평가」를 참조해 주세요.

　

returnType 가 XPathConstants 에 정의된 형태가 아닌 경우,IllegalArgumentException 가 throw 됩니다.

　

source 또는 returnType 가 null 의 경우,NullPointerException 가 throw 됩니다.

파라미터:

source - 평가하는 문서의 InputSource

returnType - 목적의 반환값의 형태

반환값:

식을 평가해, 결과를 returnType 로 변환한 결과이다 Object

예외:

XPathExpressionException - 식을 평가할 수 없는 경우

IllegalArgumentException - returnType 가 XPathConstants 에 정의된 형태가 아닌 경우

NullPointerException - source 또는 returnType 가 null 의 경우

evaluate

String  evaluate(InputSource  source)
                throws XPathExpressionException 

지정된 InputSource 의 문맥으로 컴파일 된 XPath 식을 평가해, 결과를 String 로서 돌려줍니다.

　

이 메소드는,returnType 가 XPathConstants.STRING 으로 evaluate(InputSource source, QName returnType) 를 호출합니다.

　

문맥 항목의 평가, 변수, 함수, 및 QName 의 해결과 반환값의 형태의 변환에 대해서는「XPath 식의 평가」를 참조해 주세요.

　

source 가 null 의 경우는,NullPointerException 가 throw 됩니다.

파라미터:

source - 평가하는 문서의 InputSource

반환값:

식을 평가해, 결과를 String 로 변환한 결과이다 String

예외:

XPathExpressionException - 식을 평가할 수 없는 경우

NullPointerException - source 가 null 의 경우