|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
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
메소드를 호출할 수가 없습니다.
메소드의 개요 | |
---|---|
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 식을 평가해, 결과가 지정된 형태로서 돌려줍니다. |
메소드의 상세 |
---|
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
의 경우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
- 식을 평가할 수 없는 경우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
의 경우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
의 경우
|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.