JavaTM 2 Platform
Standard Ed. 5.0

javax.xml.xpath
ÀÎÅÍÆäÀ̽º XPathExpression


public interface XPathExpression

XPathExpression´Â ÄÄÆÄÀÏ µÈ XPath ½Ä¿¡ÀÇ ¾×¼¼½º¸¦ Á¦°øÇÕ´Ï´Ù.

XPath ½ÄÀÇ Æò°¡
ÄÁÅؽºÆ® ÄÁÅؽºÆ® Ç׸ñÀÌ ¾ø´Â ½ÄÀ» Æò°¡ÇÏ´Â ¿ä±¸¸¦ ÇßÀ» °æ¿ì, ÄÁÅؽºÆ®¿¡ ´Â ºñ¾îÀÖ´Â ¹®¼­ ³ëµå°¡ »ç¿ëµÈ´Ù. XPath ½ÄÀ» Æò°¡Çϱâ À§ÇØ, DocumentFragment°¡ ¹®¼­ ³ëµå¿Í °°°Ô ´Ù·ç¾îÁö´Â
º¯¼ö ½Ä¿¡ º¯¼öÀÇ ÂüÁ¶°¡ Æ÷ÇԵǴ °æ¿ì, XPathVariableResolver ¿¡ ÀÇÇØ ±× °ªÀ» ã¾Æ³¾ ¼ö ÀÖ´Ù. º¯¼ö ¸®Àý¹ö°¡ Á¤ÀǵǾî ÀÖÁö ¾ÊÀºÁö, ¸®Àý¹ö·ÎºÎÅÍ º¯¼ö¿¡ ´ëÇؼ­ nullÀÌ µ¹·ÁÁÖ°íÁ³À» °æ¿ì, XPathExpressionExceptionÀÌ »ý¼ºµÈ´Ù. º¯¼öÀÇ °ªÀº 1ȸ ÀÇ Æò°¡ÀÇ °úÁ¤À» ÅëÇؼ­ ºÒº¯ÀÌ ¾Æ´Ï¸é ¾ÈµÇ´Â

ÇÔ¼ö ½Ä¿¡ ÇÔ¼öÀÇ ÂüÁ¶°¡ Æ÷ÇԵǴ °æ¿ì, XPathFunctionResolver ¿¡ ÀÇÇØ ÇÔ¼ö¸¦ ã¾Æ³¾ ¼ö ÀÖ´Ù. ÇÔ¼ö ¸®Àý¹ö°¡ Á¤ÀǵǾî ÀÖÁö ¾ÊÀºÁö, ¸®Àý¹ö·ÎºÎÅÍ ÇÔ¼ö¿¡ ´ëÇؼ­ nullÀÌ µ¹·ÁÁÖ°íÁ³À» °æ¿ì, XPathExpressionExceptionÀÌ »ý¼ºµÇ´Â

QName ½Ä¾ÈÀÇ QName°¡ XPath À̸§ °ø°£ ÄÁÅؽºÆ®¿¡ ºñÃß¾î ÇØ°áµÇ´Â
°á°ú ½ÄÀÇ Æò°¡ÀÇ °á°ú´Â ¸ñÀûÀÇ ¹Ýȯ°ªÀÇ ÇüÅÂÀÇ ÀνºÅϽº¿¡ º¯È¯µÈ´Ù. À¯È¿ÇÑ ¹Ýȯ°ªÀÇ ÇüÅ´ XPathConstants¿¡ Á¤ÀÇÇÑ´Ù. ¹Ýȯ°ªÀÇ ÇüÅ¿¡ÀÇ º¯È¯Àº XPath º¯È¯ ±ÔÄ¢¿¡ µû¸¥´Ù

µµÀÔµÈ ¹öÀü :
1.5
°ü·Ã Ç׸ñ:
XML Path Language (XPath) Version 1.0, Expressions

¸Þ¼­µå °³¿ä
 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 ½ÄÀ» Æò°¡ÇØ, °á°ú°¡ ÁöÁ¤µÈ ÇüÅ·μ­ ¸®ÅÏÇÕ´Ï´Ù.
 

¸Þ¼­µåÀÇ »ó¼¼

evaluate

Object  evaluate(Object  item,
                QName  returnType)
                throws XPathExpressionException 

ÁöÁ¤µÈ ÄÁÅؽºÆ® À¸·Î ÄÄÆÄÀÏ ³¡³­ XPath ½ÄÀ» Æò°¡ÇØ, °á°ú°¡ ÁöÁ¤µÈ ÇüÅ·μ­ ¸®ÅÏÇÕ´Ï´Ù.

ÄÁÅؽºÆ® Ç׸ñÀÇ Æò°¡ º¯¼ö, ÇÔ¼ö ¹× QName ÇØ°á°ú ¹Ýȯ°ªÀÇ ÇüÅÂÀÇ º¯È¯¿¡ ´ëÇؼ­´Â¡¸XPath ½ÄÀÇ Æò°¡¡¹¸¦ ÂüÁ¶ÇϽʽÿÀ.

returnType°¡ XPathConstants¿¡ Á¤ÀÇµÈ ÇüÅ°¡ ¾Æ´Ñ °æ¿ì, IllegalArgumentException°¡ ¹ß»ý µË´Ï´Ù.

item¿¡ null°ªÀÌ Á¦°øµÇ´Â °æ¿ì´Â ÄÁÅؽºÆ®¿¡ ´Â ºñ¾îÀÖ´Â ¹®¼­°¡ »ç¿ëµË´Ï´Ù. returnType°¡ nullÀÎ °æ¿ì´Â NullPointerException°¡ ¹ß»ý µË´Ï´Ù.

ÆĶó¹ÌÅÍ:
item - °³½Ã ÄÁÅؽºÆ® (³ëµå ¶Ç´Â ³ëµå ¸®½ºÆ® µî)
returnType - ¸ñÀûÀÇ ¹Ýȯ°ªÀÇ ÇüÅÂ
¹Ýȯ°ª:
½ÄÀ» Æò°¡ÇØ, °á°ú¸¦ returnType·Î º¯È¯ÇÑ °á°úÀÎ Object
¿¹¿Ü:
XPathExpressionException - ½ÄÀ» Æò°¡ÇÒ ¼ö ¾ø´Â °æ¿ì
IllegalArgumentException - returnType°¡ XPathConstants¿¡ Á¤ÀÇµÈ ÇüÅ°¡ ¾Æ´Ñ °æ¿ì
NullPointerException - returnType°¡ nullÀÎ °æ¿ì

evaluate

String  evaluate(Object  item)
                throws XPathExpressionException 

ÁöÁ¤µÈ ÄÁÅؽºÆ® À¸·Î ÄÄÆÄÀÏ ³¡³­ XPath ½ÄÀ» Æò°¡ÇØ, °á°ú¸¦ String·Î ¼­ ¸®ÅÏÇÕ´Ï´Ù.

ÀÌ ¸Þ¼­µå´Â returnType°¡ XPathConstants.STRING À¸·Î evaluate(Object item, QName returnType)¸¦ È£ÃâÇÕ´Ï´Ù.

ÄÁÅؽºÆ® Ç׸ñÀÇ Æò°¡ º¯¼ö, ÇÔ¼ö ¹× QName ÇØ°á°ú ¹Ýȯ°ªÀÇ ÇüÅÂÀÇ º¯È¯¿¡ ´ëÇؼ­´Â¡¸XPath ½ÄÀÇ Æò°¡¡¹¸¦ ÂüÁ¶ÇϽʽÿÀ.

item¿¡ null°ªÀÌ Á¦°øµÇ´Â °æ¿ì, ÄÁÅؽºÆ®¿¡ ´Â ºñ¾îÀÖ´Â ¹®¼­°¡ »ç¿ëµË´Ï´Ù.

ÆĶó¹ÌÅÍ:
item - °³½Ã ÄÁÅؽºÆ® (³ëµå ¶Ç´Â ³ëµå ¸®½ºÆ® µî)
¹Ýȯ°ª:
½ÄÀ» Æò°¡ÇØ, °á°ú¸¦ String·Î º¯È¯ÇÑ °á°úÀÎ String
¿¹¿Ü:
XPathExpressionException - ½ÄÀ» Æò°¡ÇÒ ¼ö ¾ø´Â °æ¿ì

evaluate

Object  evaluate(InputSource  source,
                QName  returnType)
                throws XPathExpressionException 

ÁöÁ¤µÈ InputSource ÄÁÅؽºÆ® À¸·Î ÄÄÆÄÀÏ ³¡³­ XPath ½ÄÀ» Æò°¡ÇØ, °á°ú°¡ ÁöÁ¤µÈ ÇüÅ·μ­ ¸®ÅÏÇÕ´Ï´Ù.

ÀÌ ¸Þ¼­µå´Â InputSource µ¥ÀÌÅÍ ¸ðµ¨À» ±¸ÃàÇØ, °á°úÀÇ ¹®¼­ °´Ã¼¿¡ ´ëÇؼ­ evaluate(Object item, QName returnType)¸¦ È£ÃâÇÕ´Ï´Ù.

ÄÁÅؽºÆ® Ç׸ñÀÇ Æò°¡ º¯¼ö, ÇÔ¼ö ¹× QName ÇØ°á°ú ¹Ýȯ°ªÀÇ ÇüÅÂÀÇ º¯È¯¿¡ ´ëÇؼ­´Â¡¸XPath ½ÄÀÇ Æò°¡¡¹¸¦ ÂüÁ¶ÇϽʽÿÀ.

returnType°¡ XPathConstants¿¡ Á¤ÀÇµÈ ÇüÅ°¡ ¾Æ´Ñ °æ¿ì, IllegalArgumentException°¡ ¹ß»ý µË´Ï´Ù.

source ¶Ç´Â returnType°¡ nullÀÎ °æ¿ì, NullPointerException ÀÌ ¹ß»ý µË´Ï´Ù.

ÆĶó¹ÌÅÍ:
source - Æò°¡ÇÏ´Â ¹®¼­ÀÇ InputSource
returnType - ¸ñÀûÀÇ ¹Ýȯ°ªÀÇ ÇüÅÂ
¹Ýȯ°ª:
½ÄÀ» Æò°¡ÇØ, °á°ú¸¦ returnType·Î º¯È¯ÇÑ °á°úÀÎ Object
¿¹¿Ü:
XPathExpressionException - ½ÄÀ» Æò°¡ÇÒ ¼ö ¾ø´Â °æ¿ì
IllegalArgumentException - returnType°¡ XPathConstants¿¡ Á¤ÀÇµÈ ÇüÅ°¡ ¾Æ´Ñ °æ¿ì
NullPointerException - source ¶Ç´Â returnType°¡ nullÀÎ °æ¿ì

evaluate

String  evaluate(InputSource  source)
                throws XPathExpressionException 

ÁöÁ¤µÈ InputSource ÄÁÅؽºÆ® À¸·Î ÄÄÆÄÀÏ ³¡³­ XPath ½ÄÀ» Æò°¡ÇØ, °á°ú¸¦ String·Î ¼­ ¸®ÅÏÇÕ´Ï´Ù.

ÀÌ ¸Þ¼­µå´Â returnType°¡ XPathConstants.STRING À¸·Î evaluate(InputSource source, QName returnType)¸¦ È£ÃâÇÕ´Ï´Ù.

ÄÁÅؽºÆ® Ç׸ñÀÇ Æò°¡ º¯¼ö, ÇÔ¼ö ¹× QName ÇØ°á°ú ¹Ýȯ°ªÀÇ ÇüÅÂÀÇ º¯È¯¿¡ ´ëÇؼ­´Â¡¸XPath ½ÄÀÇ Æò°¡¡¹¸¦ ÂüÁ¶ÇϽʽÿÀ.

source°¡ nullÀÎ °æ¿ì´Â NullPointerException°¡ ¹ß»ý µË´Ï´Ù.

ÆĶó¹ÌÅÍ:
source - Æò°¡ÇÏ´Â ¹®¼­ÀÇ InputSource
¹Ýȯ°ª:
½ÄÀ» Æò°¡ÇØ, °á°ú¸¦ String·Î º¯È¯ÇÑ °á°úÀÎ String
¿¹¿Ü:
XPathExpressionException - ½ÄÀ» Æò°¡ÇÒ ¼ö ¾ø´Â °æ¿ì
NullPointerException - source°¡ nullÀÎ °æ¿ì

JavaTM 2 Platform
Standard Ed. 5.0

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