org.bridje.ioc

Interface IocContext

public interface IocContext

Represents a context in witch components are managed. This interface is mean to be use (not for implementation), it brings all the method necessaries for find components and services in the scope that it manages.

An implementation of this interface can be obtained via the Ioc interface or by injecting Inject it in any component you want.

Method Summary

Modifier and Type	Method and Description
IocContext	createChild(String scope) Create a child IocContext of this context.
IocContext	createChild(String scope, Collection instances) Create a child IocContext of this context.
boolean	exists(Type service) This method finds if a service is provided by a least one component in the context.
boolean	existsComponent(Class component) This method finds if the given class is a component of the context.
<T> T	find(Class<T> service) This method finds the highest priority component that provides the given service.
<T> T[]	findAll(Class<T> service) This method finds all the components that provides the given service.
Object	findGeneric(Type service) This method finds the highest priority component that provides the given generic service.
<T> T	findNext(Class<T> service, int priority) This method finds the component that provides the given service with less priority than the priority parameter.
Object	findNextGeneric(Type service, int priority) This method finds the component that provides the given generic service with less priority than the priority parameter.
ClassRepository	getClassRepository() Obtains the class repository associated with this context. that allows to find classes, fields and methods of the components in this context.
IocContext	getParent() The parent of this context.
String	getScope() Gets the scope of the current context.

Method Detail

getScope

String getScope()

Gets the scope of the current context.

Returns:

An string object representing the scope name used for this context.

find

<T> T find(Class<T> service)

This method finds the highest priority component that provides the given service.

Type Parameters:

T - The generic type of the class of the service that this method should find.

Parameters:

service - The class that represents the service that this method must find.

Returns:

An object that extends or implement the class of the service provided, or null if no component provides this services in the context.

findNext

<T> T findNext(Class<T> service,
               int priority)

This method finds the component that provides the given service with less priority than the priority parameter.

Type Parameters:

T - The generic type of the class of the service that this method should find.

Parameters:

service - The class that represents the service that this method must find.

priority - The given component must have a priority value greater than this parameter.

Returns:

An object that extends or implement the class of the service provided, or null if no component provides this services in the context.

findAll

<T> T[] findAll(Class<T> service)

This method finds all the components that provides the given service.

Type Parameters:

T - The generic type of the class of the service that this method should find.

Parameters:

service - The class that represents the service that this method must find.

Returns:

An array of objects who extends or implement the class of the service provided, or an empty array if no component provides this services in the context.

findGeneric

Object findGeneric(Type service)

This method finds the highest priority component that provides the given generic service.

Parameters:

service - The Type that represents the service that this method must find.

Returns:

An object that extends or implement the service provided, or null if no component provides this services in the context.

findNextGeneric

Object findNextGeneric(Type service,
                       int priority)

This method finds the component that provides the given generic service with less priority than the priority parameter.

Parameters:

service - The Type that represents the service that this method must find.

priority - The given component must have a priority value greater than this parameter.

Returns:

An object that extends or implement the service provided, or null if no component provides this services in the context.

exists

boolean exists(Type service)

This method finds if a service is provided by a least one component in the context.

Parameters:

service - The type of the service to look for.

Returns:

true If at least one component provides this service, false otherwise.

existsComponent

boolean existsComponent(Class component)

This method finds if the given class is a component of the context.

Parameters:

component - The class of the component to look for.

Returns:

true If this class represents a component of the context, false otherwise.

getParent

IocContext getParent()

The parent of this context.

Returns:

The IocContext instance representing the parent of this context, or null if this context has no parent.

createChild

IocContext createChild(String scope)

Create a child IocContext of this context.

Parameters:

scope - The scope of the new context.

Returns:

The new IocContext instance created as child of this context.

createChild

IocContext createChild(String scope,
                       Collection instances)

Create a child IocContext of this context.

Parameters:

scope - The scope of the new context.

instances - A collection of objects that will be components of the new context.

Returns:

The new IocContext instance created as child of this context.

getClassRepository

ClassRepository getClassRepository()

Obtains the class repository associated with this context. that allows to find classes, fields and methods of the components in this context.

Returns:

A ClassRepository instance