be.redlab.tool.context

Interface ApplicationContext

All Known Implementing Classes:

BeanApplicationContext, NoNullBeanApplicationContext, SpringContextAwareApplicationContext

public interface ApplicationContext

The ApplicationContext is a container for storing and retrieving singleton objects.

Author:

redlab

Method Summary

Methods

Modifier and Type	Method and Description
void	add(Object object) Adds an object instance with the fully qualified classname as name to the application context
void	add(String name, Object instance) Adds an object instance with the specified name to the ApplicationContext.
<T> T	find(Class<T> klass) Looks for an object of the specified class.
<T> Collection<T>	findAll(Class<T> klass) Utility method to find all classes that implements or extends from the given class.
<T> T	get(String name) Returns the object of the specified type with the specified name.
BeanFactory	getBeanFactory()
boolean	hasBean(String name) Check if a object with the specified name is available in this ApplicationContext.
<T> T	load(Class<T> klass) Load the specified class with the context ClassLoader into this ApplicationContext.
<T> T	load(Class<T> klass, ClassLoader classLoader) Load the specified class with the given ClassLoader into this ApplicationContext.
void	shutdown() Called to shutdown the application context, letting it perform shutdown like running PreDestroy on beans.

Method Detail

add

void add(String name,
       Object instance)

Adds an object instance with the specified name to the ApplicationContext.

Parameters:

name - the unique name of the object

instance - the object to add.

add

void add(Object object)

Adds an object instance with the fully qualified classname as name to the application context

Parameters:

ms -

get

<T> T get(String name)

Returns the object of the specified type with the specified name.

Parameters:

name - the name of the object to return

Returns:

the object of the specified type or null if the object was not found.

find

<T> T find(Class<T> klass)

Looks for an object of the specified class. If multiple are found implementations decide which one is returned. If the specified class is not found a search is done for subclasses of the specified type.

Parameters:

klass - the class of the object to look for.

Returns:

the object of the specified type or a subclass of the specified type or null if not found.

findAll

<T> Collection<T> findAll(Class<T> klass)

Utility method to find all classes that implements or extends from the given class.

Parameters:

klass - the type to look for

Returns:

a collection of found classes or en empty collection if none.

getBeanFactory

BeanFactory getBeanFactory()

Returns:

the associated BeanFactory of this ApplicationContext

hasBean

boolean hasBean(String name)

Check if a object with the specified name is available in this ApplicationContext.

Parameters:

name - the name to look for.

Returns:

true if the object exists in the ApplicationContext, false otherwise.

load

<T> T load(Class<T> klass,
         ClassLoader classLoader)

Load the specified class with the given ClassLoader into this ApplicationContext.

Parameters:

klass - the class to load.

classLoader - the ClassLoader to use.

load

<T> T load(Class<T> klass)

Load the specified class with the context ClassLoader into this ApplicationContext.

Parameters:

klass - the class to load.

shutdown

void shutdown()

Called to shutdown the application context, letting it perform shutdown like running PreDestroy on beans.