jp.go.nict.langrid.commons.util
クラス CollectionUtil

java.lang.Object
  jp.go.nict.langrid.commons.util.CollectionUtil

public class CollectionUtil
extends Object

コレクションに関するユーティリティを集めたクラス。

バージョン:

$Revision: 9745 $

作成者:

Takao Nakaguchi, $Author: Takao Nakaguchi $

コンストラクタの概要

CollectionUtil()

メソッドの概要

static <T,U> Map<T,U>	asMap(Map.Entry<T,U>... elements) Map.Entryの配列からMapを作成する。
static <T,U> Map<T,U>	asMap(Pair<T,U>... elements) Pairの配列からMapを作成する。
static <T,U> List<U>	collect(Iterable<T> elements, Transformer<T,U> transformer) 各要素についてtransformerを適用した値のリストに変換する。
static <T,U> void	collect(Iterator<T> iterator, Collection<U> target, Transformer<T,U> transformer) オブジェクト配列を各要素についてtransformerを適用した値の配列に変換する。
static <T,U> List<U>	collect(Iterator<T> iterator, Transformer<T,U> transformer) 各要素についてtransformerを適用した値のリストに変換する。
static <T> Collection<T>	emptyCollection() 空のコレクションを返す。
static <T> boolean	equalsAsSet(Collection<T> value1, Collection<T> value2) コレクションをセットとして、順序を無視して比較する。
static <T> boolean	equalsAsSet(Collection<T> value1, Collection<T> value2, Class<T> clazz, String equalsMethodName) コレクションをセットとして、順序を無視して比較する。
static <T> boolean	equalsAsSet(Collection<T> value1, Collection<T> value2, Method equalsMethod) コレクションをセットとして、順序を無視して比較する。
static <T> T[]	toArray(Collection<T> collection, Class<T> elementClass) コレクションを配列に変換する。
static <T> T[]	toArray(Collection<T> collection, Class<T> elementClass, int index, int count) コレクションを配列に変換する。

クラス java.lang.Object から継承されたメソッド

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

コンストラクタの詳細

CollectionUtil

public CollectionUtil()

メソッドの詳細

equalsAsSet

public static <T> boolean equalsAsSet(Collection<T> value1,
                                      Collection<T> value2)

コレクションをセットとして、順序を無視して比較する。

型パラメータ:

T - 要素の型

パラメータ:

value1 - 比較する元のコレクション

value2 - 比較する先のコレクション

戻り値:

等しい場合true

equalsAsSet

public static <T> boolean equalsAsSet(Collection<T> value1,
                                      Collection<T> value2,
                                      Class<T> clazz,
                                      String equalsMethodName)
                           throws IllegalAccessException,
                                  InvocationTargetException,
                                  NoSuchMethodException

コレクションをセットとして、順序を無視して比較する。 比較メソッドは、booleanを返し、clazz型の引数もしくはObject型の引数をとる必要がある。

型パラメータ:

T - 要素の型

パラメータ:

value1 - 比較する元のコレクション

value2 - 比較する先のコレクション

clazz - 比較メソッドを取得するクラス

equalsMethodName - 比較メソッド名

戻り値:

等しい場合true

例外:

IllegalAccessException - 比較メソッドの実行に失敗した

InvocationTargetException - 比較メソッドの実行に失敗した

NoSuchMethodException - 比較メソッドが見つからない

equalsAsSet

public static <T> boolean equalsAsSet(Collection<T> value1,
                                      Collection<T> value2,
                                      Method equalsMethod)
                           throws IllegalAccessException,
                                  InvocationTargetException

コレクションをセットとして、順序を無視して比較する。

型パラメータ:

T - 要素の型

パラメータ:

value1 - 比較する元のコレクション

value2 - 比較する先のコレクション

equalsMethod - 比較に使用するメソッド。要素型引数を一つとり、booleanを返す

戻り値:

等しい場合true

例外:

IllegalAccessException - 比較メソッドの実行に失敗した

InvocationTargetException - 比較メソッドの実行に失敗した

asMap

public static <T,U> Map<T,U> asMap(Pair<T,U>... elements)

Pairの配列からMapを作成する。 ジェネリックタイプの配列を作成するとワーニングが出るため、 このメソッドを使用する場合、@SuppressWarnings("unchecked") の使用を推奨。

型パラメータ:

T - keyの型

U - valueの型

パラメータ:

elements - key-valueペアの配列

戻り値:

マップ

asMap

public static <T,U> Map<T,U> asMap(Map.Entry<T,U>... elements)

Map.Entryの配列からMapを作成する。 ジェネリックタイプの配列を作成するとワーニングが出るため、 このメソッドを使用する場合、@SuppressWarnings("unchecked") の使用を推奨。

型パラメータ:

T - keyの型

U - valueの型

パラメータ:

elements - key-valueペアの配列

戻り値:

マップ

collect

public static <T,U> List<U> collect(Iterator<T> iterator,
                                    Transformer<T,U> transformer)
                       throws TransformationException

各要素についてtransformerを適用した値のリストに変換する。

型パラメータ:

T - 変換元の型

U - 変換先の型

パラメータ:

iterator - 変換する要素群を返すiterator

transformer - 変換に使用するTransformer

戻り値:

作成された配列

例外:

TransformationException - 変換に失敗した

collect

public static <T,U> List<U> collect(Iterable<T> elements,
                                    Transformer<T,U> transformer)
                       throws TransformationException

各要素についてtransformerを適用した値のリストに変換する。

型パラメータ:

T - 変換元の型

U - 変換先の型

パラメータ:

elements - 変換するコレクション

transformer - 変換に使用するTransformer

戻り値:

作成された配列

例外:

TransformationException - 変換に失敗した

collect

public static <T,U> void collect(Iterator<T> iterator,
                                 Collection<U> target,
                                 Transformer<T,U> transformer)
                    throws TransformationException

オブジェクト配列を各要素についてtransformerを適用した値の配列に変換する。

型パラメータ:

T - 変換元の型

U - 変換先の型

パラメータ:

iterator - 変換する要素群を返すiterator

target - 追加するコレクション

transformer - 変換に使用するTransformer

例外:

TransformationException - 変換に失敗した

toArray

public static <T> T[] toArray(Collection<T> collection,
                              Class<T> elementClass)

コレクションを配列に変換する。

型パラメータ:

T - 要素型

パラメータ:

collection - コレクション

elementClass - 要素クラス(配列の作成に使用される)

戻り値:

配列

toArray

public static <T> T[] toArray(Collection<T> collection,
                              Class<T> elementClass,
                              int index,
                              int count)

コレクションを配列に変換する。

型パラメータ:

T - 要素型

パラメータ:

collection - コレクション

elementClass - 要素クラス(配列の作成に使用される)

index - コレクション内の開始インデックス

count - 配列に格納する要素数

戻り値:

配列

emptyCollection

public static <T> Collection<T> emptyCollection()

空のコレクションを返す。

型パラメータ:

T - 要素型

戻り値:

空のコレクション