CollectionFactory (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

The Spring Framework

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.core
Class CollectionFactory

java.lang.Object
  org.springframework.core.CollectionFactory

public abstract class CollectionFactory
extends Object
extends Object

Factory for collections, being aware of Commons Collection 3.x's extended collections as well as of JDK 1.5+ concurrent collections and backport-concurrent collections. Mainly for internal use within the framework.

The goal of this class is to avoid runtime dependencies on JDK 1.5+ and Commons Collections 3.x, simply using the best collection implementation that is available at runtime.

Since:: 1.1.1
Author:: Juergen Hoeller

Constructor Summary

CollectionFactory()


Method Summary

static Collection createApproximateCollection(Object collection, int initialCapacity)
          Create the most approximate collection for the given collection.

static Map createApproximateMap(Object map, int initialCapacity)
          Create the most approximate map for the given map.

static Map createConcurrentMapIfPossible(int initialCapacity)
          Create a concurrent map if possible: that is, if running on JDK >= 1.5 or if the backport-concurrent library is available.

static Map createIdentityMapIfPossible(int initialCapacity)
          Create a identity Map if possible: This implementation always creates a IdentityHashMap.

static Map createLinkedCaseInsensitiveMapIfPossible(int initialCapacity)
          Create a linked case-insensitive map if possible: if Commons Collections 3.x is available, a CaseInsensitiveMap with ListOrderedMap decorator will be created.

static Map createLinkedMapIfPossible(int initialCapacity)
          Create a linked Map if possible: This implementation always creates a LinkedHashMap.

static Set createLinkedSetIfPossible(int initialCapacity)
          Create a linked Set if possible: This implementation always creates a LinkedHashSet.

Methods inherited from class java.lang.Object

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

Constructor Summary
`CollectionFactory()`

Method Summary
`static Collection`	`createApproximateCollection(Object collection, int initialCapacity)` Create the most approximate collection for the given collection.
`static Map`	`createApproximateMap(Object map, int initialCapacity)` Create the most approximate map for the given map.
`static Map`	`createConcurrentMapIfPossible(int initialCapacity)` Create a concurrent map if possible: that is, if running on JDK >= 1.5 or if the backport-concurrent library is available.
`static Map`	`createIdentityMapIfPossible(int initialCapacity)` Create a identity Map if possible: This implementation always creates a `IdentityHashMap`.
`static Map`	`createLinkedCaseInsensitiveMapIfPossible(int initialCapacity)` Create a linked case-insensitive map if possible: if Commons Collections 3.x is available, a CaseInsensitiveMap with ListOrderedMap decorator will be created.
`static Map`	`createLinkedMapIfPossible(int initialCapacity)` Create a linked Map if possible: This implementation always creates a `LinkedHashMap`.
`static Set`	`createLinkedSetIfPossible(int initialCapacity)` Create a linked Set if possible: This implementation always creates a `LinkedHashSet`.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

CollectionFactory

public CollectionFactory()

Method Detail

createLinkedSetIfPossible

public static Set createLinkedSetIfPossible(int initialCapacity)

Create a linked Set if possible: This implementation always creates a LinkedHashSet.

Parameters:: initialCapacity - the initial capacity of the Set
Returns:: the new Set instance

createLinkedMapIfPossible

public static Map createLinkedMapIfPossible(int initialCapacity)

Create a linked Map if possible: This implementation always creates a LinkedHashMap.

Parameters:: initialCapacity - the initial capacity of the Map
Returns:: the new Map instance

createLinkedCaseInsensitiveMapIfPossible

public static Map createLinkedCaseInsensitiveMapIfPossible(int initialCapacity)

Create a linked case-insensitive map if possible: if Commons Collections 3.x is available, a CaseInsensitiveMap with ListOrderedMap decorator will be created. Else, a JDK LinkedHashMap will be used.

Parameters:: initialCapacity - the initial capacity of the map
Returns:: the new map instance
See Also:: CaseInsensitiveMap, ListOrderedMap

createIdentityMapIfPossible

public static Map createIdentityMapIfPossible(int initialCapacity)

Create a identity Map if possible: This implementation always creates a IdentityHashMap.

Parameters:: initialCapacity - the initial capacity of the Map
Returns:: the new Map instance

createConcurrentMapIfPossible

public static Map createConcurrentMapIfPossible(int initialCapacity)

Create a concurrent map if possible: that is, if running on JDK >= 1.5 or if the backport-concurrent library is available. Prefers a JDK 1.5+ ConcurrentHashMap to its backport-concurrent equivalent.

Parameters:: initialCapacity - the initial capacity of the map
Returns:: the new map instance
See Also:: ConcurrentHashMap, ConcurrentHashMap

createApproximateCollection

public static Collection createApproximateCollection(Object collection,
                                                     int initialCapacity)

Create the most approximate collection for the given collection.

Creates an ArrayList, TreeSet or linked Set for a List, SortedSet or Set, respectively.

Parameters:: collection - the original collection object; initialCapacity - the initial capacity
Returns:: the new collection instance
See Also:: ArrayList, TreeSet, createLinkedSetIfPossible(int)

createApproximateMap

public static Map createApproximateMap(Object map,
                                       int initialCapacity)

Create the most approximate map for the given map.

Creates a TreeMap or linked Map for a SortedMap or Map, respectively.

Parameters:: map - the original map object; initialCapacity - the initial capacity
Returns:: the new collection instance
See Also:: TreeMap, createLinkedMapIfPossible(int)