CollectionFactory (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

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 class CollectionFactory
extends Object
extends Object

Factory for collections, being aware of JDK 1.4+ extended collections and Commons Collection 3.x's corresponding versions for older JDKs. Mainly for internal use within the framework.

The goal of this class is to avoid runtime dependencies on JDK 1.4+ or Commons Collections 3.x, simply using the best collection implementation that is available. Prefers JDK 1.4+ collection implementations to Commons Collections 3.x versions, falling back to JDK 1.3 collections as worst case.

Since:: 1.1.1
Author:: Juergen Hoeller
See Also:: createLinkedSetIfPossible(int), createLinkedMapIfPossible(int), createLinkedCaseInsensitiveMapIfPossible(int), createIdentityMapIfPossible(int)

Constructor Summary

CollectionFactory()


Method Summary

static Map createIdentityMapIfPossible(int initialCapacity)
          Create an identity map if possible: that is, if running on JDK >= 1.4 or if Commons Collections 3.x is available.

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: that is, if running on JDK >= 1.4 or if Commons Collections 3.x is available.

static Set createLinkedSetIfPossible(int initialCapacity)
          Create a linked set if possible: that is, if running on JDK >= 1.4 or if Commons Collections 3.x is available.

Methods inherited from class java.lang.Object

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

Constructor Summary
`CollectionFactory()`

Method Summary
`static Map`	`createIdentityMapIfPossible(int initialCapacity)` Create an identity map if possible: that is, if running on JDK >= 1.4 or if Commons Collections 3.x is available.
`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: that is, if running on JDK >= 1.4 or if Commons Collections 3.x is available.
`static Set`	`createLinkedSetIfPossible(int initialCapacity)` Create a linked set if possible: that is, if running on JDK >= 1.4 or if Commons Collections 3.x is available.

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: that is, if running on JDK >= 1.4 or if Commons Collections 3.x is available. Prefers a JDK 1.4+ LinkedHashSet to a Commons Collections 3.x ListOrderedSet.

Parameters:: initialCapacity - the initial capacity of the set
Returns:: the new set instance
See Also:: LinkedHashSet, ListOrderedSet

createLinkedMapIfPossible

public static Map createLinkedMapIfPossible(int initialCapacity)

Create a linked map if possible: that is, if running on JDK >= 1.4 or if Commons Collections 3.x is available. Prefers a JDK 1.4+ LinkedHashMap to a Commons Collections 3.x LinkedMap.

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

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 1.4+ LinkedHashMap or plain HashMap 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 an identity map if possible: that is, if running on JDK >= 1.4 or if Commons Collections 3.x is available. Prefers a JDK 1.4+ IdentityHashMap to a Commons Collections 3.x IdentityMap.

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