javax.xml.xpath
인터페이스 XPathExpression

public interface XPathExpression

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

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

도입된 버전 :

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가 발생 됩니다.

item에 null값이 제공되는 경우는 컨텍스트에 는 비어있는 문서가 사용됩니다. returnType가 null인 경우는 NullPointerException가 발생 됩니다.

파라미터:

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값이 제공되는 경우, 컨텍스트에 는 비어있는 문서가 사용됩니다.

파라미터:

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가 발생 됩니다.

source 또는 returnType가 null인 경우, NullPointerException 이 발생 됩니다.

파라미터:

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가 발생 됩니다.

파라미터:

source - 평가하는 문서의 InputSource

반환값:

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

예외:

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

NullPointerException - source가 null인 경우