org.apache.tapestry5.ioc.internal
Interface InternalRegistry

All Superinterfaces:
ObjectLocator, OperationTracker, Registry, RegistryShutdownHub
All Known Implementing Classes:
RegistryImpl

public interface InternalRegistry
extends Registry, RegistryShutdownHub, OperationTracker

Internal view of the module registry, adding additional methods needed by modules.


Method Summary
 String expandSymbols(String input)
          Given an input string that may contain symbols, returns the string with any and all symbols fully expanded.
 List<ServiceAdvisor> findAdvisorsForService(ServiceDef3 serviceDef)
          Searches for advisors for a particular service, returning them in order of application.
 List<ServiceDecorator> findDecoratorsForService(ServiceDef3 serviceDef)
          Searches for decorators for a particular service.
<K,V> Map<K,V>
getMappedConfiguration(ServiceDef3 serviceDef, Class<K> keyType, Class<V> valueType)
          Builds up a map of key/value pairs by invoking service contribution methods that target the service (from any module, unless the service is private).
 Set<Class> getMarkerAnnotations()
          Returns a Set of Annotation classes that are used as service markers.
<T> T
getObject(Class<T> objectType, AnnotationProvider annotationProvider, ObjectLocator locator, Module localModule)
          As with ObjectLocator.getObject(Class, org.apache.tapestry5.ioc.AnnotationProvider), but handles the Local annotation.
<T> List<T>
getOrderedConfiguration(ServiceDef3 serviceDef, Class<T> valueType)
          Builds up an ordered collection by invoking service contributor methods that target the service (from any module, unless the service is private).
 ServiceLifecycle2 getServiceLifecycle(String scope)
          Returns a service lifecycle by service scope name.
 org.slf4j.Logger getServiceLogger(String serviceId)
          Returns a logger for the service, which consists of the Module's log name suffixed with a period and the service id.
<T> Collection<T>
getUnorderedConfiguration(ServiceDef3 serviceDef, Class<T> valueType)
          Builds up an unordered collection by invoking service contributor methods that target the service (from any module, unless the service is private).
 ClassFab newClass(Class serviceInterface)
          Convieience for creating a new ClassFab instance using a ClassFactory.
<T> T
proxy(Class<T> interfaceClass, Class<? extends T> implementationClass, ObjectLocator locator)
          Creates a just-in-time (and possibly, live reloading) proxy for the indicated class and interface, using the provided locator to autobuild the implementationClass (when necessary).
 
Methods inherited from interface org.apache.tapestry5.ioc.Registry
cleanupThread, performRegistryStartup, shutdown
 
Methods inherited from interface org.apache.tapestry5.ioc.ObjectLocator
autobuild, autobuild, getObject, getService, getService, getService, proxy
 
Methods inherited from interface org.apache.tapestry5.ioc.services.RegistryShutdownHub
addRegistryShutdownListener, addRegistryShutdownListener, addRegistryWillShutdownListener
 
Methods inherited from interface org.apache.tapestry5.ioc.OperationTracker
invoke, run
 

Method Detail

getObject

<T> T getObject(Class<T> objectType,
                AnnotationProvider annotationProvider,
                ObjectLocator locator,
                Module localModule)
As with ObjectLocator.getObject(Class, org.apache.tapestry5.ioc.AnnotationProvider), but handles the Local annotation.

Parameters:
objectType - type of object o be injected
annotationProvider - access to annotations at point of injection
locator - used to resolve any subsequent injections
localModule - module to limit services to, if Local annotaton present
Returns:
the service or object

getServiceLifecycle

ServiceLifecycle2 getServiceLifecycle(String scope)
Returns a service lifecycle by service scope name.

Parameters:
scope - the name of the service scope (case insensitive)
Returns:
the lifecycle corresponding to the scope
Throws:
RuntimeException - if the lifecycle name does not match a known lifecycle

findDecoratorsForService

List<ServiceDecorator> findDecoratorsForService(ServiceDef3 serviceDef)
Searches for decorators for a particular service. The resulting DecoratorDef s are ordered, then converted into ServiceDecorators.


findAdvisorsForService

List<ServiceAdvisor> findAdvisorsForService(ServiceDef3 serviceDef)
Searches for advisors for a particular service, returning them in order of application.

Since:
5.1.0.0

getUnorderedConfiguration

<T> Collection<T> getUnorderedConfiguration(ServiceDef3 serviceDef,
                                            Class<T> valueType)
Builds up an unordered collection by invoking service contributor methods that target the service (from any module, unless the service is private).

Type Parameters:
T -
Parameters:
serviceDef - defines the service for which configuration data is being assembled
valueType - identifies the type of object allowed into the collection
Returns:
the final collection

getOrderedConfiguration

<T> List<T> getOrderedConfiguration(ServiceDef3 serviceDef,
                                    Class<T> valueType)
Builds up an ordered collection by invoking service contributor methods that target the service (from any module, unless the service is private). Once all values have been added (each with an id, and pre/post constraints), the values are ordered, null values dropped, and the final sorted list is returned.

Type Parameters:
T -
Parameters:
serviceDef - defines the service for which configuration data is being assembled
valueType - identifies the type of object allowed into the collection
Returns:
the final ordered list

getMappedConfiguration

<K,V> Map<K,V> getMappedConfiguration(ServiceDef3 serviceDef,
                                      Class<K> keyType,
                                      Class<V> valueType)
Builds up a map of key/value pairs by invoking service contribution methods that target the service (from any module, unless the service is private). Values and keys may not be null. Invalid values (keys or values that are the wrong type, or duplicate keys) result in warnings and are ignored.

Type Parameters:
K -
V -
Parameters:
serviceDef - defines the service for which configuration data is being assembled
keyType - identifies the type of key object allowed into the map
valueType - identifies the type of value object allowed into the map
Returns:
the final ordered list

newClass

ClassFab newClass(Class serviceInterface)
Convieience for creating a new ClassFab instance using a ClassFactory.

Parameters:
serviceInterface - the interface to be implemented by the provided class

expandSymbols

String expandSymbols(String input)
Given an input string that may contain symbols, returns the string with any and all symbols fully expanded.

Parameters:
input -
Returns:
expanded input

getServiceLogger

org.slf4j.Logger getServiceLogger(String serviceId)
Returns a logger for the service, which consists of the Module's log name suffixed with a period and the service id.

Parameters:
serviceId -
Returns:
the logger for the service

proxy

<T> T proxy(Class<T> interfaceClass,
            Class<? extends T> implementationClass,
            ObjectLocator locator)
Creates a just-in-time (and possibly, live reloading) proxy for the indicated class and interface, using the provided locator to autobuild the implementationClass (when necessary).

Since:
5.2.0

getMarkerAnnotations

Set<Class> getMarkerAnnotations()
Returns a Set of Annotation classes that are used as service markers.

Since:
5.2.0


Copyright © 2003-2012 The Apache Software Foundation.