public class ObjectLocatorImpl extends Object implements ObjectLocator
| Constructor and Description |
|---|
ObjectLocatorImpl(InternalRegistry registry,
Module module) |
| Modifier and Type | Method and Description |
|---|---|
<T> T |
autobuild(Class<T> clazz)
Autobuilds a class by finding the public constructor with the most parameters.
|
<T> T |
autobuild(String description,
Class<T> clazz)
Preferred version of
ObjectLocator.autobuild(Class) that tracks the operation using
OperationTracker.invoke(String, org.apache.tapestry5.ioc.Invokable). |
<T> T |
getObject(Class<T> objectType,
AnnotationProvider annotationProvider)
Obtains an object indirectly, using the
MasterObjectProvider service. |
<T> T |
getService(Class<T> serviceInterface)
Locates a service given a service interface and (optionally) some marker annotation types.
|
<T> T |
getService(Class<T> serviceInterface,
Class<? extends Annotation>... markerTypes)
Locates a service given a service interface and (optionally) some marker annotation types.
|
<T> T |
getService(String serviceId,
Class<T> serviceInterface)
Obtains a service via its unique service id.
|
<T> T |
proxy(Class<T> interfaceClass,
Class<? extends T> implementationClass)
Creates a proxy.
|
public ObjectLocatorImpl(InternalRegistry registry, Module module)
public <T> T getService(String serviceId, Class<T> serviceInterface)
ObjectLocatorgetService in interface ObjectLocatorserviceId - 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)public <T> T getService(Class<T> serviceInterface)
ObjectLocatorgetService in interface ObjectLocatorserviceInterface - the interface the service implementsMarkerpublic <T> T getService(Class<T> serviceInterface, Class<? extends Annotation>... markerTypes)
ObjectLocatorgetService in interface ObjectLocatorserviceInterface - the interface the service implementsmarkerTypes - Markers used to select a specific service that implements the interfaceMarkerpublic <T> T getObject(Class<T> objectType, AnnotationProvider annotationProvider)
ObjectLocatorMasterObjectProvider service.getObject in interface ObjectLocatorobjectType - 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)ObjectProviderpublic <T> T autobuild(Class<T> clazz)
ObjectLocatorInject annotation. 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.autobuild in interface ObjectLocatorclazz - the type of object to instantiatepublic <T> T autobuild(String description, Class<T> clazz)
ObjectLocatorObjectLocator.autobuild(Class) that tracks the operation using
OperationTracker.invoke(String, org.apache.tapestry5.ioc.Invokable).autobuild in interface ObjectLocatordescription - description used with OperationTrackerclazz - the type of object to instantiatepublic <T> T proxy(Class<T> interfaceClass, Class<? extends T> implementationClass)
ObjectLocatorObjectLocator.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 the
MasterObjectProvider (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).proxy in interface ObjectLocatorinterfaceClass - the interface implemented by the proxyimplementationClass - a concrete class that implements the interfaceObjectLocator.autobuild(Class)${project.version} - Copyright © 2003-2015 The Apache Software Foundation.