feat2.template
クラス NodeSelector

java.lang.Object
  拡張feat2.template.NodeSelector

public class NodeSelector
extends java.lang.Object

ノードを検索するユーティリティクラス。

作成者:
SUGIMOTO Ken-ichi

コンストラクタの概要
NodeSelector()
           
 
メソッドの概要
static HTMLElement getElement(NodeIterator iterator)
          イテレータが返すノードの中で最初に見つかった要素ノードを返す。
static HTMLElement getElement(NodeIterator iterator, int n)
          イテレータが返すノードの中でn番目に見つかった要素ノードを返す。
static HTMLElement getElementByAttribute(NodeIterator iterator, java.lang.String attrName, java.lang.String attrVal)
          イテレータが返すノードの中で最初に見つかった指定属性値の要素を返す。
static HTMLElement getElementByClass(NodeIterator iterator, java.lang.String className)
          イテレータが返すノードの中で最初に見つかった指定class属性名の要素を返す。
static HTMLElement getLastTag(NodeIterator iterator, java.lang.String tagName)
          イテレータが返すノードの中で最後に見つかった指定の名前の要素を返す。
static HTMLText getLastText(NodeIterator iterator)
          イテレータが返すノードの中で最後に見つかったテキストノードを返す。
static HTMLElement getTag(NodeIterator iterator, java.lang.String tagName)
          イテレータが返すノードの中で最初に見つかった指定の名前の要素を返す。
static HTMLElement getTag(NodeIterator iterator, java.lang.String tagName, int n)
          イテレータが返すノードの中でn番目に見つかった指定の名前の要素を返す。
static HTMLText getText(NodeIterator iterator)
          イテレータが返すノードの中で最初に見つかったテキストノードを返す。
static HTMLText getText(NodeIterator iterator, int n)
          イテレータが返すノードの中でn番目に見つかったテキストノードを返す。
static java.lang.String joinText(HTMLNode node)
          指定ノード以下のテキストノードのテキストを連結した文字列を返す。
static HTMLNodeList selectElementsByAttribute(NodeIterator iterator, java.lang.String attrName, java.lang.String attrVal)
          指定属性値の要素をすべて返す。
static HTMLNodeList selectElementsByClass(NodeIterator iterator, java.lang.String className)
          指定属性値の要素をすべて返す。
static HTMLNodeMap selectIdentifiableElements(NodeIterator iterator)
          id属性を持った要素をすべて選択する。
static HTMLNodeList selectTags(NodeIterator iterator, java.lang.String tagName)
          指定のタグ名の要素をすべて返す。
static HTMLNodeList selectTextNode(NodeIterator iterator)
          イテレータが返すノードの中のテキストノードをすべて返す。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

NodeSelector

public NodeSelector()
メソッドの詳細

getElement

public static HTMLElement getElement(NodeIterator iterator)
イテレータが返すノードの中で最初に見つかった要素ノードを返す。 渡されたイテレータは見つかったノードの位置まで進む (次のnextメソッドでは、ここで見つかったノードの次のノードが返される)。 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

getElement

public static HTMLElement getElement(NodeIterator iterator,
                                     int n)
イテレータが返すノードの中でn番目に見つかった要素ノードを返す。 渡されたイテレータは見つかったノードの位置まで進む (次のnextメソッドでは、ここで見つかったノードの次のノードが返される)。 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
n -
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

getText

public static HTMLText getText(NodeIterator iterator)
イテレータが返すノードの中で最初に見つかったテキストノードを返す。 渡されたイテレータは見つかったノードの位置まで進む (次のnextメソッドでは、ここで見つかったノードの次のノードが返される)。 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

getText

public static HTMLText getText(NodeIterator iterator,
                               int n)
イテレータが返すノードの中でn番目に見つかったテキストノードを返す。 渡されたイテレータは見つかったノードの位置まで進む (次のnextメソッドでは、ここで見つかったノードの次のノードが返される)。 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
n -
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

getLastText

public static HTMLText getLastText(NodeIterator iterator)
イテレータが返すノードの中で最後に見つかったテキストノードを返す。 渡されたイテレータは最後の位置まで進むが、 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

selectTextNode

public static HTMLNodeList selectTextNode(NodeIterator iterator)
イテレータが返すノードの中のテキストノードをすべて返す。 渡されたイテレータは最後まで進む。

パラメータ:
iterator -
戻り値:
見つかったノードのリスト。ノードが見つからないときは空のリストを返す。

joinText

public static java.lang.String joinText(HTMLNode node)
指定ノード以下のテキストノードのテキストを連結した文字列を返す。 結果の文字列は以下のように整形される。
・改行とタブ文字はスペースに変換される
・連続したスペースは1つのスペースに置き換えられる
・文字列の最初と最後のスペースは削除される

パラメータ:
node - 検索を開始するサブツリーの頂点ノード
戻り値:

getTag

public static HTMLElement getTag(NodeIterator iterator,
                                 java.lang.String tagName)
イテレータが返すノードの中で最初に見つかった指定の名前の要素を返す。 渡されたイテレータは見つかったノードの位置まで進む (次のnextメソッドでは、ここで見つかったノードの次のノードが返される)。 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
tagName - 検索する要素の名前。"*"を指定するとすべての要素にヒットする。
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

getTag

public static HTMLElement getTag(NodeIterator iterator,
                                 java.lang.String tagName,
                                 int n)
イテレータが返すノードの中でn番目に見つかった指定の名前の要素を返す。 渡されたイテレータは見つかったノードの位置まで進む (次のnextメソッドでは、ここで見つかったノードの次のノードが返される)。 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
tagName - 検索する要素の名前。"*"を指定するとすべての要素にヒットする。
n -
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

getLastTag

public static HTMLElement getLastTag(NodeIterator iterator,
                                     java.lang.String tagName)
イテレータが返すノードの中で最後に見つかった指定の名前の要素を返す。 渡されたイテレータは最後の位置まで進むが、 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
tagName - 検索する要素の名前。"*"を指定するとすべての要素にヒットする。
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

selectTags

public static HTMLNodeList selectTags(NodeIterator iterator,
                                      java.lang.String tagName)
指定のタグ名の要素をすべて返す。 タグ名は大文字/小文字を区別しない。 渡されたイテレータは最後まで進む。

パラメータ:
iterator -
tagName - 検索するタグの名前。"*"が指定されたときはすべてのタグ名が該当する
戻り値:
結果のリスト。該当するノードが見つからなかったときはサイズ0のリスト

getElementByAttribute

public static HTMLElement getElementByAttribute(NodeIterator iterator,
                                                java.lang.String attrName,
                                                java.lang.String attrVal)
イテレータが返すノードの中で最初に見つかった指定属性値の要素を返す。 渡されたイテレータは見つかったノードの位置まで進む (次のnextメソッドでは、ここで見つかったノードの次のノードが返される)。 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
attrName - 属性名
attrVal - 属性値
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

selectElementsByAttribute

public static HTMLNodeList selectElementsByAttribute(NodeIterator iterator,
                                                     java.lang.String attrName,
                                                     java.lang.String attrVal)
指定属性値の要素をすべて返す。 渡されたイテレータは最後まで進む。

パラメータ:
iterator -
attrName - 属性名
attrVal - 属性値
戻り値:
結果のリスト。該当するノードが見つからなかったときはサイズ0のリスト

getElementByClass

public static HTMLElement getElementByClass(NodeIterator iterator,
                                            java.lang.String className)
イテレータが返すノードの中で最初に見つかった指定class属性名の要素を返す。 渡されたイテレータは見つかったノードの位置まで進む (次のnextメソッドでは、ここで見つかったノードの次のノードが返される)。 ノードが見つからなかったときは、イテレータをこのメソッドを実行する前の位置に戻す。 このメソッドはイテレータのマークを変更するので注意。

パラメータ:
iterator -
className - class属性名
戻り値:
見つかったノード。ノードが見つからないときはnullを返す

selectElementsByClass

public static HTMLNodeList selectElementsByClass(NodeIterator iterator,
                                                 java.lang.String className)
指定属性値の要素をすべて返す。 渡されたイテレータは最後まで進む。

パラメータ:
iterator -
className - class属性名
戻り値:
結果のリスト。該当するノードが見つからなかったときはサイズ0のリスト

selectIdentifiableElements

public static HTMLNodeMap selectIdentifiableElements(NodeIterator iterator)
id属性を持った要素をすべて選択する。 同じid値を持つノードが複数見つかったときは最後に見つかったものが結果に格納される。

戻り値:
id属性値にマッピングされたノードのコレクション