JavaTM 2 Platform
Standard Ed. 5.0

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 °¡ Throw µË´Ï´Ù.

Æ®·¯ºí ½´ÆÃÀÇ ÈùÆ®

ÇÁ·ÎÆÛƼ ÆÄÀÏÀÌ ¾î¶»°Ô ±¸¹® ºÐ¼® µÉ±î¿¡ ´ëÇØ¼­´Â 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 °¡ Throw µË´Ï´Ù. 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 °¡ Throw µË´Ï´Ù. XPathFactory´Â ±â´ÉÀÇ °ªÀ» Ç¥½ÃÇÒ ¼ö ÀÖ½À´Ï´Ù¸¸, ±× »óŸ¦ º¯°æÇÒ ¼ö ¾ø½À´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
name - ±â´É¸í
¹Ýȯ°ª:
À̸§À» ºÙÀÏ ¼ö ÀÖ¾ú´ø ±â´É »óÅÂ
¿¹¿Ü:
XPathFactoryConfigurationException - ÀÛ¼ºÇÏ´Â XPathFactory ¶Ç´Â XPath °¡ ÀÌ ±â´ÉÀ» ¼­Æ÷Æ®ÇÒ ¼ö ¾ø´Â °æ¿ì
NullPointerException - name °¡ null °æ¿ì

setXPathVariableResolver

public abstract void setXPathVariableResolver(XPathVariableResolver  resolver)

µðÆúÆ®ÀÇ º¯¼ö ¸®Àý¹ö¸¦ ¼³Á¤ÇÕ´Ï´Ù.

ÀÌ ÆÑÅ丮·Î ±¸ÃàµÈ XPath ¿ÀºêÁ§Æ®´Â µðÆúÆ®·Î ÁöÁ¤µÈ ¸®Àý¹ö¸¦ »ç¿ëÇÕ´Ï´Ù.

resolver °¡ null °æ¿ì,NullPointerException °¡ Throw µË´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
resolver - º¯¼ö ¸®Àý¹ö.
¿¹¿Ü:
NullPointerException - resolver °¡ null °æ¿ì

setXPathFunctionResolver

public abstract void setXPathFunctionResolver(XPathFunctionResolver  resolver)

µðÆúÆ®ÀÇ ÇÔ¼ö ¸®Àý¹ö¸¦ ¼³Á¤ÇÕ´Ï´Ù.

ÀÌ ÆÑÅ丮·Î ±¸ÃàµÈ XPath ¿ÀºêÁ§Æ®´Â µðÆúÆ®·Î ÁöÁ¤µÈ ¸®Àý¹ö¸¦ »ç¿ëÇÕ´Ï´Ù.

resolver °¡ null °æ¿ì,NullPointerException °¡ Throw µË´Ï´Ù.

ÆÄ¶ó¹ÌÅÍ:
resolver - XPath ÇÔ¼ö ¸®Àý¹ö
¿¹¿Ü:
NullPointerException - resolver °¡ null °æ¿ì

newXPath

public abstract XPath  newXPath()

XPathFactory °¡ ÀνºÅϽºÈ­ µÇ¾úÀ» ¶§¿¡ ƯÁ¤µÈ ±âº»ÀÌ µÇ´Â ¿ÀºêÁ§Æ® ¸ðµ¨À» »ç¿ëÇØ, »õ·Î¿î XPath¸¦ µ¹·ÁÁÝ´Ï´Ù.

¹Ýȯ°ª:
XPath »õ·Î¿î ÀνºÅϽº

JavaTM 2 Platform
Standard Ed. 5.0

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy µµ ÂüÁ¶ÇϽʽÿÀ.