org.jboss.as.naming

Class ServiceReferenceObjectFactory

java.lang.Object

org.jboss.as.naming.ServiceReferenceObjectFactory

All Implemented Interfaces:

ObjectFactory, ServiceAwareObjectFactory

Direct Known Subclasses:

ManagedReferenceObjectFactory

public abstract class ServiceReferenceObjectFactory
extends Object
implements ServiceAwareObjectFactory

Abstract object factory that allows for the creation of service references. Object factories that subclass ServiceReferenceObjectFactory can get access to the value of the service described by the reference.

If the factory state is no ServiceController.State.UP then the factory will block. If the state is ServiceController.State.START_FAILED or ServiceController.State.REMOVED (or the state transactions to one of these states while blocking) an exception is thrown.

Author:

Stuart Douglas

Constructor Summary

Constructors

Constructor and Description
ServiceReferenceObjectFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static Reference	createReference(org.jboss.msc.service.ServiceName service, Class<? extends ServiceReferenceObjectFactory> factory) Create a reference to a sub class of ServiceReferenceObjectFactory that injects the value of the given service.
Object	getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment)
abstract Object	getObjectInstance(Object serviceValue, Object obj, Name name, Context nameCtx, Hashtable<?,?> environment) Handles the service reference.
void	injectServiceRegistry(org.jboss.msc.service.ServiceRegistry registry)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServiceReferenceObjectFactory

public ServiceReferenceObjectFactory()

Method Detail

createReference

public static Reference createReference(org.jboss.msc.service.ServiceName service,
                        Class<? extends ServiceReferenceObjectFactory> factory)

Create a reference to a sub class of ServiceReferenceObjectFactory that injects the value of the given service.

injectServiceRegistry

public void injectServiceRegistry(org.jboss.msc.service.ServiceRegistry registry)

Specified by:

injectServiceRegistry in interface ServiceAwareObjectFactory

getObjectInstance

public final Object getObjectInstance(Object obj,
                       Name name,
                       Context nameCtx,
                       Hashtable<?,?> environment)
                               throws Exception

Specified by:

getObjectInstance in interface ObjectFactory

Throws:

Exception

getObjectInstance

public abstract Object getObjectInstance(Object serviceValue,
                       Object obj,
                       Name name,
                       Context nameCtx,
                       Hashtable<?,?> environment)
                                  throws Exception

Handles the service reference. The parameters are the same as ObjectFactory.getObjectInstance(Object, Name, Context, Hashtable), but with the addition of the service value as the first parameter.

Throws:

Exception