クラス CollectionFactory
主にフレームワーク内での内部使用向け。
- 導入:
- 1.1.1
- 作成者:
- Juergen Hoeller, Arjen Poutsma, Oliver Gierke, Sam Brannen
メソッドのサマリー
修飾子と型メソッド説明static <E> CollectionSE<E>
createApproximateCollection
(ObjectSE collection, int capacity) 指定されたコレクションに最も近いコレクションを作成します。static <K,
V> MapSE<K, V> createApproximateMap
(ObjectSE map, int capacity) 指定されたマップに最も近いマップを作成します。static <E> CollectionSE<E>
createCollection
(ClassSE<?> collectionType, int capacity) 特定のコレクション型に最適なコレクションを作成します。static <E> CollectionSE<E>
createCollection
(ClassSE<?> collectionType, ClassSE<?> elementType, int capacity) 特定のコレクション型に最適なコレクションを作成します。static <K,
V> MapSE<K, V> 指定されたマップ型に最適なマップを作成します。static <K,
V> MapSE<K, V> 指定されたマップ型に最適なマップを作成します。static PropertiesSE
createSortedProperties
(boolean omitComments) プロパティをキーに基づいて英数字順にソートするProperties
SE のバリアントを作成します。static PropertiesSE
createSortedProperties
(PropertiesSE properties, boolean omitComments) プロパティをキーに基づいて英数字順にソートするProperties
SE のバリアントを作成します。static PropertiesSE
文字列以外の値をProperties.getProperty(java.lang.String)
SE の文字列表現に自動的に適合させるProperties
SE のバリアントを作成します。static boolean
isApproximableCollectionType
(ClassSE<?> collectionType) 指定されたコレクション型が近似可能型かどうかを決定します。static boolean
isApproximableMapType
(ClassSE<?> mapType) 指定されたマップ型が近似可能な型かどうかを決定します。
メソッドの詳細
isApproximableCollectionType
指定されたコレクション型が近似可能な型、つまりcreateApproximateCollection(java.lang.Object, int)
が近似できる型かどうかを判別します。- パラメーター:
collectionType
- チェックするコレクション型- 戻り値:
- 型が近似可能な場合は
true
createApproximateCollection
public static <E> CollectionSE<E> createApproximateCollection(@Nullable ObjectSE collection, int capacity) 指定されたコレクションに最も近いコレクションを作成します。警告 : パラメーター化された型
E
は、提供されたcollection
に含まれる要素の型にバインドされていないため、提供されたcollection
がEnumSet
SE である場合、型安全は保証されません。このようなシナリオでは、呼び出し元は、提供されたcollection
の要素型が型E
に一致する列挙型であることを確認する責任があります。別の方法として、呼び出し元は、戻り値を未加工のコレクションまたはObject
SE のコレクションとして処理することもできます。- パラメーター:
collection
- 元のコレクションオブジェクト、場合によってはnull
capacity
- 初期容量- 戻り値:
- 新しい空のコレクションインスタンス
- 関連事項:
createCollection
特定のコレクション型に最適なコレクションを作成します。null
要素型を持つcreateCollection(Class, Class, int)
にデリゲートします。- パラメーター:
collectionType
- ターゲットコレクションの目的の型 (非null
)capacity
- 初期容量- 戻り値:
- 新しいコレクションインスタンス
- 例外:
IllegalArgumentExceptionSE
- 提供されたcollectionType
がnull
または型EnumSet
SE の場合
createCollection
public static <E> CollectionSE<E> createCollection(ClassSE<?> collectionType, @Nullable ClassSE<?> elementType, int capacity) 特定のコレクション型に最適なコレクションを作成します。警告 : パラメーター化された型
E
は提供されたelementType
にバインドされていないため、目的のcollectionType
がEnumSet
SE である場合、型の安全性は保証されません。そのようなシナリオでは、呼び出し元は、提供されたelementType
が、型E
に一致する列挙型であることを確認する責任があります。別の方法として、呼び出し元は、戻り値を未加工のコレクションまたはObject
SE のコレクションとして処理することもできます。- パラメーター:
collectionType
- ターゲットコレクションの目的の型 (非null
)elementType
- コレクションの要素型。不明の場合はnull
(注意:EnumSet
SE の作成にのみ関連)capacity
- 初期容量- 戻り値:
- 新しいコレクションインスタンス
- 例外:
IllegalArgumentExceptionSE
- 指定されたcollectionType
がnull
の場合。または、目的のcollectionType
がEnumSet
SE であり、指定されたelementType
がEnum
SE のサブ型でない場合- 導入:
- 4.1.3
- 関連事項:
isApproximableMapType
指定されたマップ型が近似可能な型、つまりcreateApproximateMap(java.lang.Object, int)
が近似できる型かどうかを判断します。- パラメーター:
mapType
- チェックするマップ型- 戻り値:
- 型が近似可能な場合は
true
createApproximateMap
指定されたマップに最も近いマップを作成します。警告 : パラメーター化された型
K
は、提供されたmap
に含まれるキーの型にバインドされていないため、提供されたmap
がEnumMap
SE である場合、型安全は保証されません。このようなシナリオでは、呼び出し元は、提供されたmap
のキー型が型K
と一致する列挙型であることを確認する責任があります。別の方法として、呼び出し元は、戻り値を未加工のマップまたはObject
SE をキーとするマップとして扱いたい場合があります。- パラメーター:
map
- 元のマップオブジェクト、場合によってはnull
capacity
- 初期容量- 戻り値:
- 新しい空のマップインスタンス
- 関連事項:
createMap
指定されたマップ型に最適なマップを作成します。null
キー型のcreateMap(Class, Class, int)
にデリゲートします。- パラメーター:
mapType
- ターゲットマップの目的の型capacity
- 初期容量- 戻り値:
- 新しいマップインスタンス
- 例外:
IllegalArgumentExceptionSE
- 提供されたmapType
がnull
または型EnumMap
SE の場合
createMap
public static <K,V> MapSE<K,V> createMap(ClassSE<?> mapType, @Nullable ClassSE<?> keyType, int capacity) 指定されたマップ型に最適なマップを作成します。警告 : パラメーター化された型
K
は提供されたkeyType
にバインドされていないため、目的のmapType
がEnumMap
SE である場合、型の安全性は保証されません。このようなシナリオでは、呼び出し元は、keyType
が型K
と一致する列挙型であることを確認する責任があります。別の方法として、呼び出し元は、戻り値を未加工のマップまたはObject
SE をキーとするマップとして扱いたい場合があります。同様に、目的のmapType
がMultiValueMap
の場合は、型安全を適用できません。- パラメーター:
mapType
- ターゲットマップの目的の型 (非null
)keyType
- マップのキー型。不明な場合はnull
(注意:EnumMap
SE の作成にのみ関連)capacity
- 初期容量- 戻り値:
- 新しいマップインスタンス
- 例外:
IllegalArgumentExceptionSE
- 指定されたmapType
がnull
の場合。または、目的のmapType
がEnumMap
SE であり、指定されたkeyType
がEnum
SE のサブ型でない場合- 導入:
- 4.1.3
- 関連事項:
createStringAdaptingProperties
文字列以外の値をProperties.getProperty(java.lang.String)
SE の文字列表現に自動的に適合させるProperties
SE のバリアントを作成します。さらに、返された
Properties
インスタンスは、キーに基づいてプロパティを英数字順に並べ替えます。- 戻り値:
- 新しい
Properties
インスタンス - 導入:
- 4.3.4
- 関連事項:
createSortedProperties
プロパティをキーに基づいて英数字順にソートするProperties
SE のバリアントを作成します。これは、
Properties
SE インスタンスをプロパティファイルに格納する場合に役立ちます。これにより、一貫したプロパティの順序でそのようなファイルを繰り返し可能な方法で生成できるようになります。生成されたプロパティファイルのコメントも、オプションで省略できます。- パラメーター:
omitComments
- プロパティをファイルに保存するときにコメントを省略する必要がある場合はtrue
- 戻り値:
- 新しい
Properties
インスタンス - 導入:
- 5.2
- 関連事項:
createSortedProperties
プロパティをキーに基づいて英数字順にソートするProperties
SE のバリアントを作成します。これは、
Properties
インスタンスをプロパティファイルに格納する場合に役立ちます。これにより、そのようなファイルを、プロパティの一貫した順序で繰り返し可能な方法で生成できるようになります。生成されたプロパティファイルのコメントも、オプションで省略できます。返された
Properties
インスタンスには、指定されたproperties
オブジェクトのプロパティが設定されますが、指定されたproperties
オブジェクトのデフォルトプロパティはコピーされません。- パラメーター:
properties
- 初期プロパティのコピー元のProperties
オブジェクトomitComments
- プロパティをファイルに保存するときにコメントを省略する必要がある場合はtrue
- 戻り値:
- 新しい
Properties
インスタンス - 導入:
- 5.2
- 関連事項: