Class RegistryImpl
java.lang.Object
org.apache.tapestry5.ioc.internal.RegistryImpl
- All Implemented Interfaces:
ObjectLocator,InternalRegistry,ServiceProxyProvider,OperationTracker,Registry,RegistryShutdownHub
public class RegistryImpl
extends Object
implements Registry, InternalRegistry, ServiceProxyProvider
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.apache.tapestry5.ioc.OperationTracker
OperationTracker.NonLoggableException -
Constructor Summary
ConstructorsConstructorDescriptionRegistryImpl(Collection<ModuleDef2> moduleDefs, PlasticProxyFactory proxyFactory, LoggerSource loggerSource, OperationTracker operationTracker) Constructs the registry from a set of module definitions and other resources. -
Method Summary
Modifier and TypeMethodDescriptionvoidaddRegistryShutdownListener(Runnable listener) Adds a listener for eventual notification when the registry shuts down.voidAdds a listener for eventual notification.voidaddRegistryWillShutdownListener(Runnable listener) Adds a listener for eventual notification.<T> TAutobuilds a class by finding the public constructor with the most parameters.<T> TPreferred version ofObjectLocator.autobuild(Class)that tracks the operation usingOperationTracker.invoke(String, org.apache.tapestry5.ioc.Invokable).voidInvoked at the end of a request to discard any thread-specific information accumulated during the current request.expandSymbols(String input) Given an input string that may contain symbols, returns the string with any and all symbols fully expanded.findAdvisorsForService(ServiceDef3 serviceDef) Searches for advisors for a particular service, returning them in order of application.findDecoratorsForService(ServiceDef3 serviceDef) Searches for decorators for a particular service.<K,V> Map<K, V> getMappedConfiguration(ServiceDef3 serviceDef, Class<K> keyType, Class<V> objectType) 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).Returns a Set of Annotation classes that are used as service markers.<T> TgetObject(Class<T> objectType, AnnotationProvider annotationProvider) Obtains an object indirectly, using theMasterObjectProviderservice.<T> TgetObject(Class<T> objectType, AnnotationProvider annotationProvider, ObjectLocator locator, Module localModule) As withObjectLocator.getObject(Class, org.apache.tapestry5.commons.AnnotationProvider), but handles theLocalannotation.<T> List<T>getOrderedConfiguration(ServiceDef3 serviceDef, Class<T> objectType) Builds up an ordered collection by invoking service contributor methods that target the service (from any module, unless the service is private).<T> TgetService(Class<T> serviceInterface) Locates a service given a service interface and (optionally) some marker annotation types.<T> TgetService(Class<T> serviceInterface, Class<? extends Annotation>... markerTypes) Locates a service given a service interface and (optionally) some marker annotation types.<T> TgetService(String serviceId, Class<T> serviceInterface) Obtains a service via its unique service id.getServiceLifecycle(String scope) Returns a service lifecycle by service scope name.org.slf4j.LoggergetServiceLogger(String serviceId) Returns a logger for the service, which consists of the Module'slog namesuffixed with a period and the service id.<T> Collection<T>getUnorderedConfiguration(ServiceDef3 serviceDef, Class<T> objectType) Builds up an unordered collection by invoking service contributor methods that target the service (from any module, unless the service is private).<T> TAs withOperationTracker.run(String, Runnable), but the operation may return a value.<T> Tperform(String description, IOOperation<T> operation) As withOperationTracker.invoke(String, Invokable), but the operation may throw anIOException.voidIt's not unreasonable for an eagerly-loaded service to decide to start a thread, at which point we raise issues about improper publishing of the Registry instance from the RegistryImpl constructor.provideServiceProxy(String serviceId) Look up the service and return its proxy.<T> TCreates a proxy.<T> Tproxy(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).voidExecutes the operation.voidshutdown()Shuts down a Registry instance.
-
Constructor Details
-
RegistryImpl
public RegistryImpl(Collection<ModuleDef2> moduleDefs, PlasticProxyFactory proxyFactory, LoggerSource loggerSource, OperationTracker operationTracker) Constructs the registry from a set of module definitions and other resources.- Parameters:
moduleDefs- defines the modules (and builders, decorators, etc., within)proxyFactory- used to create new proxy objectsloggerSource- used to obtain Logger instancesoperationTracker-
-
-
Method Details
-
performRegistryStartup
It's not unreasonable for an eagerly-loaded service to decide to start a thread, at which point we raise issues about improper publishing of the Registry instance from the RegistryImpl constructor. Moving eager loading of services out to its own method should ensure thread safety.- Specified by:
performRegistryStartupin interfaceRegistry
-
getServiceLogger
Description copied from interface:InternalRegistryReturns a logger for the service, which consists of the Module'slog namesuffixed with a period and the service id.- Specified by:
getServiceLoggerin interfaceInternalRegistry- Returns:
- the logger for the service
-
shutdown
Description copied from interface:RegistryShuts down a Registry instance. Notifies all listeners that the registry has shutdown. Further method invocations on the Registry are no longer allowed, and the Registry instance should be discarded. -
getService
Description copied from interface:ObjectLocatorObtains a service via its unique service id. Returns the service's proxy. The service proxy implements the same interface as the actual service, and is used to instantiate the actual service only as needed (this is transparent to the application).- Specified by:
getServicein interfaceObjectLocator- Parameters:
serviceId- unique Service id used to locate the service object (may contain symbols, which will be expanded), case is ignoredserviceInterface- the interface implemented by the service (or an interface extended by the service interface)- Returns:
- the service instance
-
cleanupThread
Description copied from interface:RegistryInvoked at the end of a request to discard any thread-specific information accumulated during the current request.- Specified by:
cleanupThreadin interfaceRegistry- See Also:
-
getUnorderedConfiguration
Description copied from interface:InternalRegistryBuilds up an unordered collection by invoking service contributor methods that target the service (from any module, unless the service is private).- Specified by:
getUnorderedConfigurationin interfaceInternalRegistry- Parameters:
serviceDef- defines the service for which configuration data is being assembledobjectType- identifies the type of object allowed into the collection- Returns:
- the final collection
-
getOrderedConfiguration
Description copied from interface:InternalRegistryBuilds 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.- Specified by:
getOrderedConfigurationin interfaceInternalRegistry- Parameters:
serviceDef- defines the service for which configuration data is being assembledobjectType- identifies the type of object allowed into the collection- Returns:
- the final ordered list
-
getMappedConfiguration
public <K,V> Map<K,V> getMappedConfiguration(ServiceDef3 serviceDef, Class<K> keyType, Class<V> objectType) Description copied from interface:InternalRegistryBuilds 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.- Specified by:
getMappedConfigurationin interfaceInternalRegistry- Parameters:
serviceDef- defines the service for which configuration data is being assembledkeyType- identifies the type of key object allowed into the mapobjectType- identifies the type of value object allowed into the map- Returns:
- the final ordered list
-
getService
Description copied from interface:ObjectLocatorLocates a service given a service interface and (optionally) some marker annotation types. A single service must implement the service interface (which * can be hard to guarantee) and by marked by all the marker types. The search takes into account inheritance of the service interface (not the service implementation), which may result in a failure due to extra matches.- Specified by:
getServicein interfaceObjectLocator- Parameters:
serviceInterface- the interface the service implements- Returns:
- the service's proxy
- See Also:
-
getService
Description copied from interface:ObjectLocatorLocates a service given a service interface and (optionally) some marker annotation types. A single service must implement the service interface (which * can be hard to guarantee) and by marked by all the marker types. The search takes into account inheritance of the service interface (not the service implementation), which may result in a failure due to extra matches. The ability to specify marker annotation types was added in 5.3- Specified by:
getServicein interfaceObjectLocator- Parameters:
serviceInterface- the interface the service implementsmarkerTypes- Markers used to select a specific service that implements the interface- Returns:
- the service's proxy
- See Also:
-
getServiceLifecycle
Description copied from interface:InternalRegistryReturns a service lifecycle by service scope name.- Specified by:
getServiceLifecyclein interfaceInternalRegistry- Parameters:
scope- the name of the service scope (case insensitive)- Returns:
- the lifecycle corresponding to the scope
-
findDecoratorsForService
Description copied from interface:InternalRegistrySearches for decorators for a particular service. The resultingDecoratorDefs are ordered, then converted intoServiceDecorators.- Specified by:
findDecoratorsForServicein interfaceInternalRegistry
-
findAdvisorsForService
Description copied from interface:InternalRegistrySearches for advisors for a particular service, returning them in order of application.- Specified by:
findAdvisorsForServicein interfaceInternalRegistry
-
getObject
public <T> T getObject(Class<T> objectType, AnnotationProvider annotationProvider, ObjectLocator locator, Module localModule) Description copied from interface:InternalRegistryAs withObjectLocator.getObject(Class, org.apache.tapestry5.commons.AnnotationProvider), but handles theLocalannotation.- Specified by:
getObjectin interfaceInternalRegistry- Parameters:
objectType- type of object o be injectedannotationProvider- access to annotations at point of injectionlocator- used to resolve any subsequent injectionslocalModule- module to limit services to, if Local annotaton present- Returns:
- the service or object
-
getObject
Description copied from interface:ObjectLocatorObtains an object indirectly, using theMasterObjectProviderservice.- Specified by:
getObjectin interfaceObjectLocator- Parameters:
objectType- the type of object to be returnedannotationProvider- provides access to annotations on the field or parameter for which a value is to be obtained, which may be utilized in selecting an appropriate object, use null when annotations are not available (in which case, selection will be based only on the object type)- Returns:
- the requested object
- See Also:
-
addRegistryShutdownListener
Description copied from interface:RegistryShutdownHubAdds a listener for eventual notification.- Specified by:
addRegistryShutdownListenerin interfaceRegistryShutdownHub
-
addRegistryShutdownListener
Description copied from interface:RegistryShutdownHubAdds a listener for eventual notification when the registry shuts down. Runtime exceptions thrown by the listener will be logged and ignored.- Specified by:
addRegistryShutdownListenerin interfaceRegistryShutdownHub
-
addRegistryWillShutdownListener
Description copied from interface:RegistryShutdownHubAdds a listener for eventual notification. RegistryWillShutdownListeners are notified before any standard listeners, and before service proxies and other parts of the Registry are disabled. Runtime exceptions thrown by the listener will be logged and ignored.- Specified by:
addRegistryWillShutdownListenerin interfaceRegistryShutdownHub
-
expandSymbols
Description copied from interface:InternalRegistryGiven an input string that may contain symbols, returns the string with any and all symbols fully expanded.- Specified by:
expandSymbolsin interfaceInternalRegistry- Returns:
- expanded input
-
autobuild
Description copied from interface:ObjectLocatorPreferred version ofObjectLocator.autobuild(Class)that tracks the operation usingOperationTracker.invoke(String, org.apache.tapestry5.ioc.Invokable).- Specified by:
autobuildin interfaceObjectLocator- Parameters:
description- description used withOperationTrackerclazz- the type of object to instantiate- Returns:
- the instantiated instance
-
autobuild
Description copied from interface:ObjectLocatorAutobuilds a class by finding the public constructor with the most parameters. Services and other resources or dependencies will be injected into the parameters of the constructor and into private fields marked with theInjectannotation. There are two cases: constructing a service implementation, and constructing an arbitrary object. In the former case, many service resources are also available for injection, not just dependencies or objects provided via the MasterObjectProvider service.- Specified by:
autobuildin interfaceObjectLocator- Parameters:
clazz- the type of object to instantiate- Returns:
- the instantiated instance
-
proxy
Description copied from interface:ObjectLocatorCreates a proxy. The proxy will defer invocation ofObjectLocator.autobuild(Class)until just-in-time (that is, first method invocation). In a limited number of cases, it is necessary to use such a proxy to prevent service construction cycles, particularly when contributing (directly or indirectly) to theMasterObjectProvider(which is itself at the heart of autobuilding). If the class file for the class is a file on the file system (not a file packaged in a JAR), then the proxy will autoreload: changing the class file will result in the new class being reloaded and re-instantiated (with dependencies).- Specified by:
proxyin interfaceObjectLocator- Parameters:
interfaceClass- the interface implemented by the proxyimplementationClass- a concrete class that implements the interface- Returns:
- a proxy
- See Also:
-
proxy
public <T> T proxy(Class<T> interfaceClass, Class<? extends T> implementationClass, ObjectLocator locator) Description copied from interface:InternalRegistryCreates 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).- Specified by:
proxyin interfaceInternalRegistry
-
provideServiceProxy
Description copied from interface:ServiceProxyProviderLook up the service and return its proxy.- Specified by:
provideServiceProxyin interfaceServiceProxyProvider- Parameters:
serviceId- the id of the service to obtain- Returns:
- the service proxy
-
run
Description copied from interface:OperationTrackerExecutes the operation. If the operation throws aRuntimeExceptionit will be logged and rethrown wrapped as aOperationException.- Specified by:
runin interfaceOperationTracker- Parameters:
description- used if there is an exceptionoperation- to execute
-
invoke
Description copied from interface:OperationTrackerAs withOperationTracker.run(String, Runnable), but the operation may return a value.- Specified by:
invokein interfaceOperationTracker- Parameters:
description- used if there is an exceptionoperation- to invoke- Returns:
- result of operation
-
perform
Description copied from interface:OperationTrackerAs withOperationTracker.invoke(String, Invokable), but the operation may throw anIOException.- Specified by:
performin interfaceOperationTracker- Parameters:
description- used if there is an exception (outside of IOException)operation- to perform- Returns:
- result of operation
- Throws:
IOException
-
getMarkerAnnotations
Description copied from interface:InternalRegistryReturns a Set of Annotation classes that are used as service markers.- Specified by:
getMarkerAnnotationsin interfaceInternalRegistry
-