Package org.jboss.as.naming.service

Class BinderService

java.lang.Object

org.jboss.as.naming.service.BinderService

All Implemented Interfaces:

Service, Service<ManagedReferenceFactory>, Value<ManagedReferenceFactory>

Direct Known Subclasses:

ExternalContextBinderService

public class BinderService
extends Object
implements Service<ManagedReferenceFactory>

Service responsible for binding and unbinding an entry into a naming context. This service can be used as a dependency for any service that needs to retrieve this entry from the context.

Author:

John E. Bailey, Eduardo Martins

Field Summary

Fields inherited from interface org.jboss.msc.service.Service

NULL

Constructor Summary

Constructors

Constructor	Description
BinderService(String name)
BinderService(String name, Object source)	Construct new instance.
BinderService(String name, Object source, boolean shared)	Construct new instance.

Method Summary

Modifier and Type	Method	Description
void	acquire()
InjectedValue<ManagedReferenceFactory>	getManagedObjectInjector()	Get the injector for the item to be bound.
String	getName()
InjectedValue<ServiceBasedNamingStore>	getNamingStoreInjector()	Get the naming store injector.
ServiceName	getServiceName()
Object	getSource()
ManagedReferenceFactory	getValue()	Get the value from the injected context.
boolean	release()	Releases the service, returns true if the service is removed as a result, or false otherwise
void	setSource(Object source)
void	start(StartContext context)	Bind the entry into the injected context.
void	stop(StopContext context)	Unbind the entry from the injected context.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

BinderService

public BinderService(String name,
                     Object source,
                     boolean shared)

Construct new instance.

Parameters:

name - The JNDI name to use for binding. May be either an absolute or relative name

source -

shared - indicates if the bind may be shared among multiple deployments, if true the service tracks references indicated through acquire(), and automatically stops once all deployments unreference it through release()

BinderService

public BinderService(String name,
                     Object source)

Construct new instance.

Parameters:

name - The JNDI name to use for binding. May be either an absolute or relative name

BinderService

public BinderService(String name)

Method Detail

getSource

public Object getSource()

setSource

public void setSource(Object source)

acquire

public void acquire()

release

public boolean release()

Releases the service, returns true if the service is removed as a result, or false otherwise

Returns:

getServiceName

public ServiceName getServiceName()

start

public void start(StartContext context)
           throws StartException

Bind the entry into the injected context.

Specified by:

start in interface Service

Parameters:

context - The start context

Throws:

StartException - If the entity can not be bound

stop

public void stop(StopContext context)

Unbind the entry from the injected context.

Specified by:

stop in interface Service

Parameters:

context - The stop context

getValue

public ManagedReferenceFactory getValue()
                                 throws IllegalStateException

Get the value from the injected context.

Specified by:

getValue in interface Value<ManagedReferenceFactory>

Returns:

The value of the named entry

Throws:

IllegalStateException

getManagedObjectInjector

public InjectedValue<ManagedReferenceFactory> getManagedObjectInjector()

Get the injector for the item to be bound.

Returns:

the injector

getNamingStoreInjector

public InjectedValue<ServiceBasedNamingStore> getNamingStoreInjector()

Get the naming store injector.

Returns:

the injector

toString

public String toString()

Overrides:

toString in class Object

getName

public String getName()