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°¡ ¹ß»ý µË´Ï´Ù.

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

ÇÁ·ÎÆÛƼ ÆÄÀÏÀÌ ¾î¶»°Ô ±¸¹® ºÐ¼® µÉ±î¿¡ ´ëÇؼ­´Â 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 »õ·Î¿î ÀνºÅϽº

JavaTM 2 Platform
Standard Ed. 5.0

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