javax.xml.xpath
클래스 XPathFactory

java.lang.Object 
  javax.xml.xpath.XPathFactory

public abstract class XPathFactory
extends Object 

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

검색 도구에 대해서는 newInstance(String uri)를 참조하십시오.

도입된 버전 :

1.5

필드 개요

static String	DEFAULT_OBJECT_MODEL_URI 디폴트의 객체 모델 URI 입니다.
static String	DEFAULT_PROPERTY_NAME JAXP 사양에 따른 디폴트의 프로퍼티명입니다.

생성자 개요

protected

XPathFactory () newInstance() 또는 newInstance(String uri) 로서 protected 생성자를 사용해, XPathFactory 새로운 인스턴스를 작성할 필요가 있습니다.

메서드 개요

abstract boolean	getFeature (String name) 이름을 붙일 수 있었던 기능 상태를 취득합니다.
abstract boolean	isObjectModelSupported (String objectModel) 지정된 객체 모델이 이 XPathFactory에 지원 되고 있을까를 리턴합니다.
static XPathFactory	newInstance () 디폴트의 객체 모델, DEFAULT_OBJECT_MODEL_URI를 사용해, 새로운 XPathFactory인스턴스를 취득합니다.
static XPathFactory	newInstance (String uri) 지정된 객체 모델을 사용해, 새로운 XPathFactory인스턴스를 취득합니다.
abstract XPath	newXPath () XPathFactory가 인스턴스화 되었을 때에 특정된 기본이 되는 객체 모델을 사용해, 새로운 XPath를 리턴합니다.
abstract void	setFeature (String name, boolean value) 이 팩토리에 의해 생성된 XPathFactory 및 XPath 기능을 설정합니다.
abstract void	setXPathFunctionResolver (XPathFunctionResolver resolver) 디폴트의 함수 리절버를 설정합니다.
abstract void	setXPathVariableResolver (XPathVariableResolver resolver) 디폴트의 변수 리절버를 설정합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

필드의 상세

DEFAULT_PROPERTY_NAME

public static final String  DEFAULT_PROPERTY_NAME

JAXP 사양에 따른 디폴트의 프로퍼티명입니다.

관련 항목:

정수 필드값

DEFAULT_OBJECT_MODEL_URI

public static final String  DEFAULT_OBJECT_MODEL_URI

디폴트의 객체 모델 URI 입니다.

관련 항목:

정수 필드값

생성자 상세

XPathFactory

protected XPathFactory()

newInstance() 또는 newInstance(String uri) 로서 protected 생성자를 사용해, XPathFactory 새로운 인스턴스를 작성할 필요가 있습니다.

메서드의 상세

newInstance

public static final XPathFactory  newInstance()

디폴트의 객체 모델, DEFAULT_OBJECT_MODEL_URI를 사용해, 새로운 XPathFactory인스턴스를 취득합니다.

이 메서드는 기능적으로는 다음과 동등합니다.

   newInstance(DEFAULT_OBJECT_MODEL_URI)
 

W3C DOM 구현을 항상 사용할 수 있기 때문에 이 메서드가 실패할 것은 없습니다.

반환값:

XPathFactory 인스턴스

newInstance

public static final XPathFactory  newInstance(String  uri)
                                      throws XPathFactoryConfigurationException 

지정된 객체 모델을 사용해, 새로운 XPathFactory인스턴스를 취득합니다.

XPathFactory 객체를 검색하는 경우, 이 메서드는 「클래스 로더」가 컨텍스트 클래스 로더를 참조하는 아래의 차례로 다음의 장소를 조사합니다.

1. 시스템 프로퍼티 DEFAULT_PROPERTY_NAME + :uri가 존재해, uri가 이 메서드의 파라미터인 경우, 그 값은 클래스명으로서 읽어내진다. 이 메서드는 클래스 로더를 사용해 이 클래스의 새로운 인스턴스를 작성을 시도해 성공했을 경우는 그것을 돌려준다
2. ${java.home}/lib/jaxp.properties가 읽어내져 상기의 시스템 프로퍼티인 키에 관련된 값이 검색된다. 값이 존재하면, 상기와 같이 값이 처리된다
3. 클래스 로더는 자원 디렉토리 META-INF/services 내의 jjavax.xml.xpath.XPathFactory에 일치하는 서비스 프로바이더의 프로바이더 구성 파일이 요구됩니다. 파일 형식과 구문 분석 규칙에 대해서는 JAR 파일의 사양을 참조하십시오. 각 서비스 프로바이더는 다음의 메서드를 구현하고 있을 필요가 있습니다.

    isObjectModelSupported(String objectModel)  

   지정된 객체 모델을 지원하는 클래스 로더내에서 최초로 검출된 서비스 프로바이더가 리턴됩니다 .
4. 플랫폼의 디폴트 XPathFactory는 구현 고유의 방법으로 배치된다. W3C DOM용의 플랫폼의 디폴트 XPathFactory, 즉 DEFAULT_OBJECT_MODEL_URI 　(이)가 있을 필요가 있습니다.

모든 것이 실패했을 경우, XPathFactoryConfigurationException가 발생 됩니다.

트러블 슈팅의 힌트

프로퍼티 파일이 어떻게 구문 분석 될까에 대해서는 Properties.load(java.io.InputStream)를 참조하십시오. 특히, 구두점 「:」은 프로퍼티 파일내에서 이스케이프 될 필요가 있기 때문에 URI가 적절히 이스케이프 되고 있는 것을 확인해 주세요. 다음에 예를 나타냅니다.

   http\://java.sun.com/jaxp/xpath/dom=org.acme.DomXPathFactory
 

파라미터:

uri - 기본이 되는 객체 모델을 식별한다. 사양은 URI DEFAULT_OBJECT_MODEL_URI, W3C DOM, the org.w3c.dom package http://java.sun.com/jaxp/xpath/dom 만을 정의해, 구현은 다른 객체 모델의 URI를 자유롭게 도입 가능

반환값:

XPathFactory 인스턴스

예외:

XPathFactoryConfigurationException - 지정된 객체 모델을 사용할 수 없는 경우

NullPointerException - uri가 null인 경우

IllegalArgumentException - uri.length() == 0인 경우

isObjectModelSupported

public abstract boolean isObjectModelSupported(String  objectModel)

지정된 객체 모델이 이 XPathFactory에 지원 되고 있을까를 리턴합니다.

파라미터:

objectModel - 리턴된 XPathFactory를 인식하는 객체 모델을 지정한다

반환값:

XPathFactory가 objectModel을 지원 하고 있는 경우는 true, 그렇지 않은 경우는 false

예외:

NullPointerException - objectModel가 null인 경우

IllegalArgumentException - objectModel.length() == 0인 경우

setFeature

public abstract void setFeature(String  name,
                                boolean value)
                         throws XPathFactoryConfigurationException 

이 팩토리에 의해 생성된 XPathFactory 및 XPath 기능을 설정합니다.

기능명은 완전 수식 URI 입니다. 구현이 독자적인 기능을 정의할 수도 있습니다. 생성하는 XPathFactory 또는 XPath가 그 기능을 지원 할 수 없는 경우는 XPathFactoryConfigurationException을 발생시킵니다. XPathFactory는 기능의 값을 표시할 수 있습니다만, 그 상태를 변경할 수 없습니다.

구현은 모두, XMLConstants.FEATURE_SECURE_PROCESSING 기능을 지원 하고 있을 필요가 있습니다. 기능이 true인 경우는 외부 함수를 참조하면 에러가 됩니다. 이러한 경우, 구현은 XPathFunctionResolver를 호출할 수 없기 때문에 XPathFunctionException를 Throw 합니다.

파라미터:

name - 기능명

value - 기능 상태가 true인가 false인가

예외:

XPathFactoryConfigurationException - 작성하는 XPathFactory 또는 XPath가 이 기능을 지원 할 수 없는 경우

NullPointerException - name가 null인 경우

getFeature

public abstract boolean getFeature(String  name)
                            throws XPathFactoryConfigurationException 

이름을 붙일 수 있었던 기능 상태를 취득합니다.

기능명은 완전 수식 URI 입니다. 구현이 독자적인 기능을 정의할 수도 있습니다. 생성하는 XPathFactory 또는 XPath가 그 기능을 지원 할 수 없는 경우는 XPathFactoryConfigurationException을 발생시킵니다. XPathFactory는 기능의 값을 표시할 수 있습니다만, 그 상태를 변경할 수 없습니다.

파라미터:

name - 기능명

반환값:

이름을 붙일 수 있었던 기능 상태

예외:

XPathFactoryConfigurationException - 작성하는 XPathFactory 또는 XPath가 이 기능을 지원 할 수 없는 경우

NullPointerException - name가 null인 경우

setXPathVariableResolver

public abstract void setXPathVariableResolver(XPathVariableResolver  resolver)

디폴트의 변수 리절버를 설정합니다.

이 팩토리로 구축된 XPath객체는 디폴트로 지정된 리절버를 사용합니다.

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

파라미터:

resolver - 변수 리절버.

예외:

NullPointerException - resolver가 null인 경우

setXPathFunctionResolver

public abstract void setXPathFunctionResolver(XPathFunctionResolver  resolver)

디폴트의 함수 리절버를 설정합니다.

이 팩토리로 구축된 XPath객체는 디폴트로 지정된 리절버를 사용합니다.

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

파라미터:

resolver - XPath 함수 리절버

예외:

NullPointerException - resolver가 null인 경우

newXPath

public abstract XPath  newXPath()

XPathFactory가 인스턴스화 되었을 때에 특정된 기본이 되는 객체 모델을 사용해, 새로운 XPath를 리턴합니다.

반환값:

XPath 새로운 인스턴스