|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.glassfish.hk2.api.ServiceLocatorFactory
public abstract class ServiceLocatorFactory
This factory can be used to create new named ServiceLocators
Constructor Summary | |
---|---|
ServiceLocatorFactory()
|
Method Summary | |
---|---|
abstract ServiceLocator |
create(String name)
Creates (or finds) a ServiceLocator. |
abstract ServiceLocator |
create(String name,
ServiceLocator parent)
Creates or finds a ServiceLocator. |
abstract ServiceLocator |
create(String name,
ServiceLocator parent,
ServiceLocatorGenerator generator)
Creates or finds a ServiceLocator. |
abstract void |
destroy(ServiceLocator locator)
Removes the given ServiceLocator |
abstract void |
destroy(String name)
Removes the ServiceLocator with this name |
abstract ServiceLocator |
find(String name)
Finds the ServiceLocator with this name |
static ServiceLocatorFactory |
getInstance()
This will return a factory where the ServiceLocatorGenerator is discovered from the META-INF/services of the process |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ServiceLocatorFactory()
Method Detail |
---|
public static ServiceLocatorFactory getInstance()
public abstract ServiceLocator create(String name)
If there is already a ServiceLocator with the given name then this method will return null.
name
- The name of this service locator. May not be null
public abstract ServiceLocator create(String name, ServiceLocator parent)
If there is already a ServiceLocator with the given name then this method will that ServiceLocator. The parent argument will be ignored in that case
name
- The name of this service locator. May not be nullparent
- The parent of this ServiceLocator. Services can
be found in the parent (and all grand-parents). May be null
if the returned ServiceLocator should not be parented
public abstract ServiceLocator create(String name, ServiceLocator parent, ServiceLocatorGenerator generator)
If there is already a ServiceLocator with the given name then this method will return that ServiceLocator. The parent argument will be ignored in that case. If a null name is given then a new ServiceLocator with a generated name will be returned.
name
- The name of this service locator. Passing a null
name will result in a newly created service locator with a
generated name.parent
- The parent of this ServiceLocator. Services can
be found in the parent (and all grand-parents). May be null
if the returned ServiceLocator should not be parentedgenerator
- An implementation of the generator interface that
can be used to provide an implementation of ServiceLocator. If
null then the generator used will be discovered from the OSGi
service registry or from META-INF/services
public abstract ServiceLocator find(String name)
name
- May not be null, is the name of the ServiceLocator to find
public abstract void destroy(String name)
All services associated with this ServiceLocator will be shutdown
name
- The name of the ServiceLocator to destroypublic abstract void destroy(ServiceLocator locator)
All services associated with this ServiceLocator will be shutdown
name
- The ServiceLocator to destroy. If null this will do nothing.
If the ServiceLocator given was already destroyed this will do nothing
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |