javax.xml.xpath
인터페이스 XPath

public interface XPath

XPath는 XPath 평가 환경 및 식에의 액세스를 제공합니다.

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

도입된 버전 :

1.5

관련 항목:

XML Path Language (XPath) Version 1.0

메서드 개요

XPathExpression	compile (String expression) 나중에 평가하기 위해, Xpath 식을 컴파일 합니다.
String	evaluate (String expression, InputSource source) 지정된 InputSource 컨텍스트 으로 XPath 식을 평가해, 결과를 String로 서 리턴합니다.
Object	evaluate (String expression, InputSource source, QName returnType) 지정된 InputSource 컨텍스트 으로 XPath 식을 평가해, 결과가 지정된 형태로서 리턴합니다.
String	evaluate (String expression, Object item) 지정된 컨텍스트 으로 XPath 식을 평가해, 결과를 String로 서 리턴합니다.
Object	evaluate (String expression, Object item, QName returnType) 지정된 컨텍스트 으로 XPath 식을 평가해, 결과가 지정된 형태로서 리턴합니다.
NamespaceContext	getNamespaceContext () 현재의 이름 공간 컨텍스트를 리턴합니다.
XPathFunctionResolver	getXPathFunctionResolver () 현재의 함수 리절버를 리턴합니다.
XPathVariableResolver	getXPathVariableResolver () 현재의 변수 리절버를 리턴합니다.
void	reset () 이 XPath를 원의 설정에 리셋 합니다.
void	setNamespaceContext (NamespaceContext nsContext) 이름 공간 컨텍스트를 설정합니다.
void	setXPathFunctionResolver (XPathFunctionResolver resolver) 함수 리절버를 설정합니다.
void	setXPathVariableResolver (XPathVariableResolver resolver) 변수 리절버를 설정합니다.

메서드의 상세

reset

void reset()

이 XPath를 원의 설정에 리셋 합니다.

XPath는 XPathFactory.newXPath() 로 작성된 시점 상태에 리셋 됩니다. reset()는 기존의 XPath 재사용을 허가하도록 설정되어 있기 때문에 새로운 XPath 작성에 관련된 자원을 절약할 수 있습니다.

XPath를 리셋 했을 경우, 같은 XPathFunctionResolver, XPathVariableResolver, 또는 NamespaceContext Object를 가지는 것은 보증되지 않습니다. 예를 들어, Object.equals(Object obj) 등입니다. 기능적으로 같은 XPathFunctionResolver, XPathVariableResolver 및 NamespaceContext를 가지는 것은 보증됩니다.

setXPathVariableResolver

void setXPathVariableResolver(XPathVariableResolver  resolver)

변수 리절버를 설정합니다.

resolver가 null인 경우, NullPointerException가 발생 됩니다.

파라미터:

resolver - 변수 리절버.

예외:

NullPointerException - resolver가 null인 경우

getXPathVariableResolver

XPathVariableResolver  getXPathVariableResolver()

현재의 변수 리절버를 리턴합니다.

유효한 변수 리절버가 없는 경우, null이 리턴됩니다 .

반환값:

현재의 변수 리절버

setXPathFunctionResolver

void setXPathFunctionResolver(XPathFunctionResolver  resolver)

함수 리절버를 설정합니다.

resolver가 null인 경우, NullPointerException가 발생 됩니다.

파라미터:

resolver - XPath 함수 리절버

예외:

NullPointerException - resolver가 null인 경우

getXPathFunctionResolver

XPathFunctionResolver  getXPathFunctionResolver()

현재의 함수 리절버를 리턴합니다.

유효한 함수 리절버가 없는 경우, null이 리턴됩니다 .

반환값:

현재의 함수 리절버

setNamespaceContext

void setNamespaceContext(NamespaceContext  nsContext)

이름 공간 컨텍스트를 설정합니다.

nsContext이 null인 경우, NullPointerException가 발생 됩니다.

파라미터:

nsContext - 사용하는 이름 공간 컨텍스트

예외:

NullPointerException - nsContext이 null인 경우

getNamespaceContext

NamespaceContext  getNamespaceContext()

현재의 이름 공간 컨텍스트를 리턴합니다.

유효한 이름 공간 컨텍스트이 없는 경우, null이 리턴됩니다 .

반환값:

현재의 이름 공간 컨텍스트

compile

XPathExpression  compile(String  expression)
                        throws XPathExpressionException 

나중에 평가하기 위해, Xpath 식을 컴파일 합니다.

expression에 XPathFunction 가 포함되어 있는 경우는 XPathFunctionResolver 로 사용 가능한 필요가 있습니다. XPathFunction가 XPathFunctionResolver로 해결할 수 없는 경우, XPathExpressionException을 발생시킵니다.

expression가 null인 경우는 NullPointerException가 발생 됩니다.

파라미터:

expression - XPath 식

반환값:

컴파일 끝난 XPath 식

예외:

XPathExpressionException - expression을 컴파일 할 수 없는 경우

NullPointerException - expression가 null인 경우

evaluate

Object  evaluate(String  expression,
                Object  item,
                QName  returnType)
                throws XPathExpressionException 

지정된 컨텍스트 으로 XPath 식을 평가해, 결과가 지정된 형태로서 리턴합니다.

컨텍스트 항목의 평가 변수, 함수 및 QName 해결과 반환값의 형태의 변환에 대해서는「XPath 식의 평가」를 참조하십시오.

returnType가 XPathConstants ( NUMBER, STRING, BOOLEAN, NODE, 또는 NODESET )에 정의된 형태가 아닌 경우, IllegalArgumentException가 발생 됩니다.

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

파라미터:

expression - XPath 식

item - 개시 컨텍스트 (노드 또는 노드 리스트 등)

returnType - 목적의 반환값의 형태

반환값:

returnType Object로서의 XPath 식의 평가의 결과

예외:

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

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

NullPointerException - expression 또는 returnType가 null인 경우

evaluate

String  evaluate(String  expression,
                Object  item)
                throws XPathExpressionException 

지정된 컨텍스트 으로 XPath 식을 평가해, 결과를 String로 서 리턴합니다.

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

컨텍스트 항목의 평가 변수, 함수 및 QName 해결과 반환값의 형태의 변환에 대해서는「XPath 식의 평가」를 참조하십시오.

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

파라미터:

expression - XPath 식

item - 개시 컨텍스트 (노드 또는 노드 리스트 등)

반환값:

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

예외:

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

NullPointerException - expression가 null인 경우

evaluate

Object  evaluate(String  expression,
                InputSource  source,
                QName  returnType)
                throws XPathExpressionException 

지정된 InputSource 컨텍스트 으로 XPath 식을 평가해, 결과가 지정된 형태로서 리턴합니다.

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

컨텍스트 항목의 평가 변수, 함수 및 QName 해결과 반환값의 형태의 변환에 대해서는「XPath 식의 평가」를 참조하십시오.

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

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

파라미터:

expression - XPath 식

source - 평가하는 문서의 입력 소스

returnType - 목적의 반환값의 형태

반환값:

식의 평가의 결과를 캡슐화하는 Object

예외:

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

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

NullPointerException - expression, source, 또는 returnType가 null인 경우

evaluate

String  evaluate(String  expression,
                InputSource  source)
                throws XPathExpressionException 

지정된 InputSource 컨텍스트 으로 XPath 식을 평가해, 결과를 String로 서 리턴합니다.

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

컨텍스트 항목의 평가 변수, 함수 및 QName 해결과 반환값의 형태의 변환에 대해서는「XPath 식의 평가」를 참조하십시오.

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

파라미터:

expression - XPath 식

source - 평가하는 문서의 InputSource

반환값:

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

예외:

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

NullPointerException - expression 또는 source가 null인 경우