All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface aid.util.assoc.AssocFactory

public interface AssocFactory

This class follows the design pattern Abstract Factory to create objects used as containers for association between classes. Three kind of containers are provided

list associations to mange resisable containers
array associations : to manage fixed size containers
qualified associations : to access to elements with a key

The interfaces to these containers are based on the Collection package of Java which is standard in the JDK 1.2 and that can be also used in the JDK 1.1 with a specific version.

The current version of this package uses the JDK 1.1 version of the Collection package but can be easily updated by changing the import statements

Version:: $Revision$, $Date$
Author:: M. Jaczynski

DEFAULT
FREQUENT: constant used as a modifier for the creation of a container that can handle frequent access to the elements.
HUGE: constant used as a modifier for the creation of a container that can handle a huge amount of elements.
SMALL

newArrayAssoc(int): creates an array association
newArrayAssoc(int, int, Object): creates an array association with modifiers and parameters
newArrayAssoc(int, Object[]): creates an array association with modifiers and parameters
newBoundedListAssoc(List, int): creates a list association with a size limit
newBoundedQualifiedAssoc(Map, int): creates a qualified association with a size limit.
newBoundedSetAssoc(Set, int)
newConstArrayAssoc(List): creates a unmodifiable view of an existing list association
newConstListAssoc(List): creates a unmodifiable view of an existing list association
newConstQualifiedAssoc(Map): creates a unmodifiable view of an existing list association
newConstSetAssoc(Set)
newListAssoc(): create a default list association
newListAssoc(int): creates a new list association with some modifers
newQualifiedAssoc(): creates an default qualified association
newQualifiedAssoc(int): creates a qualified association with modifiers
newSetAssoc()
newSetAssoc(int)

DEFAULT

 public static final int DEFAULT

HUGE

 public static final int HUGE

constant used as a modifier for the creation of a container that can handle a huge amount of elements. The meaning of this modifer is application specific.

SMALL

 public static final int SMALL

FREQUENT

 public static final int FREQUENT

constant used as a modifier for the creation of a container that can handle frequent access to the elements. The use of this modifer is application specific.

newListAssoc

 public abstract List newListAssoc()

create a default list association

Returns:: the created association

newListAssoc

 public abstract List newListAssoc(int modifiers)

creates a new list association with some modifers

Parameters:: modifiers - the modifiers built by adding modifier constants
Returns:: the created association

newBoundedListAssoc

 public abstract List newBoundedListAssoc(List assoc,
                                          int size)

creates a list association with a size limit

Parameters:: assoc - the existing association; size - the size limit
Returns:: the created association

newConstListAssoc

 public abstract List newConstListAssoc(List assoc)

creates a unmodifiable view of an existing list association

Parameters:: assoc - the existing association
Returns:: the unmodifiable association

newArrayAssoc

 public abstract List newArrayAssoc(int size)

creates an array association

Parameters:: size - the size of the array
Returns:: the created association

newArrayAssoc

 public abstract List newArrayAssoc(int modifiers,
                                    Object values[])

creates an array association with modifiers and parameters

Parameters:: modifiers - the modifiers built by adding modifier constants; values - the default array of values
Returns:: the created association

newArrayAssoc

 public abstract List newArrayAssoc(int modifiers,
                                    int size,
                                    Object value)

creates an array association with modifiers and parameters

Parameters:: modifiers - the modifiers built by adding modifier constants; size - the size of containers; value - the default value affected to every index
Returns:: the created association

newConstArrayAssoc

 public abstract List newConstArrayAssoc(List assoc)

creates a unmodifiable view of an existing list association

Parameters:: assoc - the existing association
Returns:: the created association

newQualifiedAssoc

 public abstract Map newQualifiedAssoc()

creates an default qualified association

Returns:: the created association

newQualifiedAssoc

 public abstract Map newQualifiedAssoc(int modifiers)

creates a qualified association with modifiers

Parameters:: modifiers - the modifiers built by adding modifier constants
Returns:: the created association

newBoundedQualifiedAssoc

 public abstract Map newBoundedQualifiedAssoc(Map assoc,
                                              int size)

creates a qualified association with a size limit.

Parameters:: assooc - the existing assciation; size - the size limit
Returns:: the created association

newConstQualifiedAssoc

 public abstract Map newConstQualifiedAssoc(Map assoc)

creates a unmodifiable view of an existing list association

Parameters:: assoc - the existing association
Returns:: the created association

newSetAssoc

 public abstract Set newSetAssoc()

newSetAssoc

 public abstract Set newSetAssoc(int modifiers)

newBoundedSetAssoc

 public abstract Set newBoundedSetAssoc(Set assoc,
                                        int size)

newConstSetAssoc

 public abstract Set newConstSetAssoc(Set assoc)

All Packages  Class Hierarchy  This Package  Previous  Next  Index