com.iijgio.dag.util

Class XpathUtils

java.lang.Object

com.iijgio.dag.util.XpathUtils

public class XpathUtils
extends Object

Xpath式を用いてXMLドキュメントからデータを展開するためのメソッドを含む ユーティリティクラスです

Constructor Summary

Constructors

Constructor and Description
XpathUtils()

Method Summary

Modifier and Type	Method and Description
static Boolean	asBoolean(String expression, Node node) 指定されたXPath式を評価し、結果をBooleanオブジェクトとして返します。
static Byte	asByte(String expression, Node node) 指定されたXPath式を評価し、結果をByteオブジェクトとして返します。
static ByteBuffer	asByteBuffer(String expression, Node node) 指定されたXPath式を評価し、得られた結果をBase64デコードし、 ByteBufferオブジェクトとして返します。
static Date	asDate(String expression, Node node) 指定されたXPath式を評価し、結果をDateオブジェクトとして返します。 指定されたノードは、xs:dateTimeで指定されるISO 8601形式の日時情報文字列を 想定しています。
static Double	asDouble(String expression, Node node) 指定されたXPath式を評価し、結果をDoubleオブジェクトとして返します。
static Float	asFloat(String expression, Node node) 指定されたXPath式を評価し、結果をFloatオブジェクトとして返します。
static Integer	asInteger(String expression, Node node) 指定されたXPath式を評価し、結果をIntegerオブジェクトとして返します。
static Long	asLong(String expression, Node node) 指定されたXPath式を評価し、結果をLongオブジェクトとして返します。
static Node	asNode(String nodeName, Node node) 指定されたXPath式を評価し、得られた結果をNodeオブジェクトとして返します
static String	asString(String expression, Node node) 指定されたXPath式を評価し、結果を文字列オブジェクトとして返します。
static Document	documentFrom(InputStream is) ストリームからデータを読み込み、パースし、XMLのDocumentオブジェクトを返します。
static Document	documentFrom(String xml) XML文字列をパースし、XMLのDocumentオブジェクトを返します。
static Document	documentFrom(URL url) URLからXMLを取得してパースし、XMLのDocumentオブジェクトを返します。
static boolean	isEmpty(Node node) 指定されたnodeがnullまたは子要素を含まない場合にtrueを返します
static int	nodeLength(NodeList list) ノードリストの件数を返します

Methods inherited from class java.lang.Object

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

Constructor Detail

XpathUtils

public XpathUtils()

Method Detail

documentFrom

public static Document documentFrom(InputStream is)
                             throws SAXException,
                                    IOException,
                                    ParserConfigurationException

ストリームからデータを読み込み、パースし、XMLのDocumentオブジェクトを返します。

Parameters:

is - 読み込むInputStream

Returns:

パースしたDocumentオブジェクト

Throws:

SAXException - XMLのパースに失敗した場合

IOException - ストリームの読み込みに失敗した場合

ParserConfigurationException - XMLドキュメントビルダーの生成に失敗した場合

documentFrom

public static Document documentFrom(String xml)
                             throws SAXException,
                                    IOException,
                                    ParserConfigurationException

XML文字列をパースし、XMLのDocumentオブジェクトを返します。

Parameters:

xml - パースするXML文字列

Returns:

パースしたDocumentオブジェクト

Throws:

SAXException - XMLのパースに失敗した場合

IOException - ストリームの読み込みに失敗した場合

ParserConfigurationException - XMLドキュメントビルダーの生成に失敗した場合

documentFrom

public static Document documentFrom(URL url)
                             throws SAXException,
                                    IOException,
                                    ParserConfigurationException

URLからXMLを取得してパースし、XMLのDocumentオブジェクトを返します。

Parameters:

url - xmlを取得するURL

Returns:

パースしたDocumentオブジェクト

Throws:

SAXException - XMLのパースに失敗した場合

IOException - ストリームの読み込みに失敗した場合

ParserConfigurationException - XMLドキュメントビルダーの生成に失敗した場合

asDouble

public static Double asDouble(String expression,
                              Node node)
                       throws XPathExpressionException

指定されたXPath式を評価し、結果をDoubleオブジェクトとして返します。

Parameters:

expression - 評価するXPath式

node - XPath式の評価対象とするNodeオブジェクト

Returns:

得られた Doubleオブジェクト

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

asString

public static String asString(String expression,
                              Node node)
                       throws XPathExpressionException

指定されたXPath式を評価し、結果を文字列オブジェクトとして返します。

Parameters:

expression - 評価するXPath式

node - 評価対象とするNodeオブジェクト.

Returns:

得られた文字列

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

asInteger

public static Integer asInteger(String expression,
                                Node node)
                         throws XPathExpressionException

指定されたXPath式を評価し、結果をIntegerオブジェクトとして返します。

Parameters:

expression - 評価するXPath式

node - 評価対象とするNodeオブジェクト.

Returns:

得られた Integer オブジェクト

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

asBoolean

public static Boolean asBoolean(String expression,
                                Node node)
                         throws XPathExpressionException

指定されたXPath式を評価し、結果をBooleanオブジェクトとして返します。

Parameters:

expression - 評価するXPath式

node - 評価対象とするNodeオブジェクト.

Returns:

得られた Boolean オブジェクト

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

asFloat

public static Float asFloat(String expression,
                            Node node)
                     throws XPathExpressionException

指定されたXPath式を評価し、結果をFloatオブジェクトとして返します。

Parameters:

expression - 評価するXPath式

node - 評価対象とするNodeオブジェクト.

Returns:

得られた Float オブジェクト

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

asLong

public static Long asLong(String expression,
                          Node node)
                   throws XPathExpressionException

指定されたXPath式を評価し、結果をLongオブジェクトとして返します。

Parameters:

expression - 評価するXPath式

node - 評価対象とするNodeオブジェクト.

Returns:

得られた Long オブジェクト

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

asByte

public static Byte asByte(String expression,
                          Node node)
                   throws XPathExpressionException

指定されたXPath式を評価し、結果をByteオブジェクトとして返します。

Parameters:

expression - 評価するXPath式

node - 評価対象とするNodeオブジェクト.

Returns:

得られた Byte オブジェクト

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

asDate

public static Date asDate(String expression,
                          Node node)
                   throws XPathExpressionException

指定されたXPath式を評価し、結果をDateオブジェクトとして返します。 指定されたノードは、xs:dateTimeで指定されるISO 8601形式の日時情報文字列を 想定しています。

Parameters:

expression - 評価するXPath式

node - 評価対象とするNodeオブジェクト.

Returns:

得られた Date オブジェクト

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

asByteBuffer

public static ByteBuffer asByteBuffer(String expression,
                                      Node node)
                               throws XPathExpressionException

指定されたXPath式を評価し、得られた結果をBase64デコードし、 ByteBufferオブジェクトとして返します。

Parameters:

expression - 評価するXPath式

node - 評価対象とするNodeオブジェクト.

Returns:

得られたNodeをBase64デコードした結果を含むByteBuffer オブジェクト

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

isEmpty

public static boolean isEmpty(Node node)

指定されたnodeがnullまたは子要素を含まない場合にtrueを返します

Parameters:

node - テストするNode

Returns:

指定されたnodeがnullまたは子要素を含まない場合はtrue

asNode

public static Node asNode(String nodeName,
                          Node node)
                   throws XPathExpressionException

指定されたXPath式を評価し、得られた結果をNodeオブジェクトとして返します

Parameters:

nodeName - 評価するXPath式

node - 評価対象とするNodeオブジェクト.

Returns:

得られたNodeオブジェクト

Throws:

XPathExpressionException - 指定されたXPath式の処理中に問題が生じた場合

nodeLength

public static int nodeLength(NodeList list)

ノードリストの件数を返します

Parameters:

list - 計るノードリスト

Returns:

指定されたノードリストの件数