クラス CollectionFactory

メソッドの詳細

• isApproximableCollectionType

  public static boolean isApproximableCollectionType(@Nullable ClassSE<?> collectionType)

  指定されたコレクション型が近似可能な型、つまり createApproximateCollection(java.lang.Object, int) が近似できる型かどうかを判別します。

  パラメーター:

  collectionType - チェックするコレクション型

  戻り値:

  型が近似可能な場合は true 

• createApproximateCollection

  public static <E> CollectionSE<E> createApproximateCollection(@Nullable ObjectSE collection, int capacity)

  指定されたコレクションに最も近いコレクションを作成します。

  警告 : パラメーター化された型 E は、提供された collection に含まれる要素の型にバインドされていないため、提供された collection が EnumSetSE である場合、型安全は保証されません。このようなシナリオでは、呼び出し元は、提供された collection の要素型が型 E に一致する列挙型であることを確認する責任があります。別の方法として、呼び出し元は、戻り値を未加工のコレクションまたは ObjectSE のコレクションとして処理することもできます。

  パラメーター:

  collection - 元のコレクションオブジェクト、場合によっては null

  capacity - 初期容量

  戻り値:

  新しい空のコレクションインスタンス

  関連事項:

  • isApproximableCollectionType(java.lang.Class<?>)
  • LinkedListSE
  • ArrayListSE
  • EnumSetSE
  • TreeSetSE
  • LinkedHashSetSE

• createCollection

  public static <E> CollectionSE<E> createCollection(ClassSE<?> collectionType, int capacity)

  特定のコレクション型に最適なコレクションを作成します。

  null 要素型を持つ createCollection(Class, Class, int) にデリゲートします。

  パラメーター:

  collectionType - ターゲットコレクションの目的の型 (非 null)

  capacity - 初期容量

  戻り値:

  新しいコレクションインスタンス

  例外:

  IllegalArgumentExceptionSE - 提供された collectionType が null または型 EnumSetSE の場合

• createCollection

  public static <E> CollectionSE<E> createCollection(ClassSE<?> collectionType, @Nullable ClassSE<?> elementType, int capacity)

  特定のコレクション型に最適なコレクションを作成します。

  警告 : パラメーター化された型 E は提供された elementType にバインドされていないため、目的の collectionType が EnumSetSE である場合、型の安全性は保証されません。そのようなシナリオでは、呼び出し元は、提供された elementType が、型 E に一致する列挙型であることを確認する責任があります。別の方法として、呼び出し元は、戻り値を未加工のコレクションまたは ObjectSE のコレクションとして処理することもできます。

  パラメーター:

  collectionType - ターゲットコレクションの目的の型 (非 null)

  elementType - コレクションの要素型。不明の場合は null (注意: EnumSetSE の作成にのみ関連)

  capacity - 初期容量

  戻り値:

  新しいコレクションインスタンス

  例外:

  IllegalArgumentExceptionSE - 指定された collectionType が null の場合。または、目的の collectionType が EnumSetSE であり、指定された elementType が EnumSE のサブ型でない場合

  導入:

  4.1.3

  関連事項:

  • LinkedHashSetSE
  • ArrayListSE
  • TreeSetSE
  • EnumSetSE

• isApproximableMapType

  public static boolean isApproximableMapType(@Nullable ClassSE<?> mapType)

  指定されたマップ型が近似可能な型、つまり createApproximateMap(java.lang.Object, int) が近似できる型かどうかを判断します。

  パラメーター:

  mapType - チェックするマップ型

  戻り値:

  型が近似可能な場合は true 

• createApproximateMap

  public static <K, V> MapSE<K,V> createApproximateMap(@Nullable ObjectSE map, int capacity)

  指定されたマップに最も近いマップを作成します。

  警告 : パラメーター化された型 K は、提供された map に含まれるキーの型にバインドされていないため、提供された map が EnumMapSE である場合、型安全は保証されません。このようなシナリオでは、呼び出し元は、提供された map のキー型が型 K と一致する列挙型であることを確認する責任があります。別の方法として、呼び出し元は、戻り値を未加工のマップまたは ObjectSE をキーとするマップとして扱いたい場合があります。

  パラメーター:

  map - 元のマップオブジェクト、場合によっては null

  capacity - 初期容量

  戻り値:

  新しい空のマップインスタンス

  関連事項:

  • isApproximableMapType(java.lang.Class<?>)
  • EnumMapSE
  • TreeMapSE
  • LinkedHashMapSE

• createMap

  public static <K, V> MapSE<K,V> createMap(ClassSE<?> mapType, int capacity)

  指定されたマップ型に最適なマップを作成します。

  null キー型の createMap(Class, Class, int) にデリゲートします。

  パラメーター:

  mapType - ターゲットマップの目的の型

  capacity - 初期容量

  戻り値:

  新しいマップインスタンス

  例外:

  IllegalArgumentExceptionSE - 提供された mapType が null または型 EnumMapSE の場合

• createMap

  public static <K, V> MapSE<K,V> createMap(ClassSE<?> mapType, @Nullable ClassSE<?> keyType, int capacity)

  指定されたマップ型に最適なマップを作成します。

  警告 : パラメーター化された型 K は提供された keyType にバインドされていないため、目的の mapType が EnumMapSE である場合、型の安全性は保証されません。このようなシナリオでは、呼び出し元は、keyType が型 K と一致する列挙型であることを確認する責任があります。別の方法として、呼び出し元は、戻り値を未加工のマップまたは ObjectSE をキーとするマップとして扱いたい場合があります。同様に、目的の mapType が MultiValueMap の場合は、型安全を適用できません。

  パラメーター:

  mapType - ターゲットマップの目的の型 (非 null)

  keyType - マップのキー型。不明な場合は null (注意: EnumMapSE の作成にのみ関連)

  capacity - 初期容量

  戻り値:

  新しいマップインスタンス

  例外:

  IllegalArgumentExceptionSE - 指定された mapType が null の場合。または、目的の mapType が EnumMapSE であり、指定された keyType が EnumSE のサブ型でない場合

  導入:

  4.1.3

  関連事項:

  • LinkedHashMapSE
  • TreeMapSE
  • LinkedMultiValueMap
  • EnumMapSE

• createStringAdaptingProperties

  public static PropertiesSE createStringAdaptingProperties()

  文字列以外の値を Properties.getProperty(java.lang.String)SE の文字列表現に自動的に適合させる PropertiesSE のバリアントを作成します。

  さらに、返された Properties インスタンスは、キーに基づいてプロパティを英数字順に並べ替えます。

  戻り値:

  新しい Properties インスタンス

  導入:

  4.3.4

  関連事項:

  • createSortedProperties(boolean)
  • createSortedProperties(Properties, boolean)

• createSortedProperties

  public static PropertiesSE createSortedProperties(boolean omitComments)

  プロパティをキーに基づいて英数字順にソートする PropertiesSE のバリアントを作成します。

  これは、PropertiesSE インスタンスをプロパティファイルに格納する場合に役立ちます。これにより、一貫したプロパティの順序でそのようなファイルを繰り返し可能な方法で生成できるようになります。生成されたプロパティファイルのコメントも、オプションで省略できます。

  パラメーター:

  omitComments - プロパティをファイルに保存するときにコメントを省略する必要がある場合は true 

  戻り値:

  新しい Properties インスタンス

  導入:

  5.2

  関連事項:

  • createStringAdaptingProperties()
  • createSortedProperties(Properties, boolean)

• createSortedProperties

  public static PropertiesSE createSortedProperties(PropertiesSE properties, boolean omitComments)

  プロパティをキーに基づいて英数字順にソートする PropertiesSE のバリアントを作成します。

  これは、Properties インスタンスをプロパティファイルに格納する場合に役立ちます。これにより、そのようなファイルを、プロパティの一貫した順序で繰り返し可能な方法で生成できるようになります。生成されたプロパティファイルのコメントも、オプションで省略できます。

  返された Properties インスタンスには、指定された properties オブジェクトのプロパティが設定されますが、指定された properties オブジェクトのデフォルトプロパティはコピーされません。

  パラメーター:

  properties - 初期プロパティのコピー元の Properties オブジェクト

  omitComments - プロパティをファイルに保存するときにコメントを省略する必要がある場合は true 

  戻り値:

  新しい Properties インスタンス

  導入:

  5.2

  関連事項:

  • createStringAdaptingProperties()
  • createSortedProperties(boolean)