org.jboss.as.controller

Class CapabilityRegistry

java.lang.Object

org.jboss.as.controller.CapabilityRegistry

All Implemented Interfaces:

ImmutableCapabilityRegistry, PossibleCapabilityRegistry, RuntimeCapabilityRegistry

public final class CapabilityRegistry
extends Object
implements ImmutableCapabilityRegistry, PossibleCapabilityRegistry, RuntimeCapabilityRegistry

Registry of capabilities available in the system.

Author:

Brian Stansberry (c) 2014 Red Hat Inc., Tomaz Cerar (c) 2015 Red Hat Inc.

Constructor Summary

Constructors

Constructor and Description
CapabilityRegistry(boolean forServer)

Method Summary

Modifier and Type	Method and Description
Set<CapabilityRegistration>	getCapabilities() Returns set of runtime capabilities registered in the registry
<T> T	getCapabilityRuntimeAPI(String capabilityName, CapabilityScope scope, Class<T> apiType) Gets the runtime API associated with a given capability, if there is one.
org.jboss.msc.service.ServiceName	getCapabilityServiceName(String capabilityName, CapabilityScope scope, Class<?> serviceType) Gets the name of the service provided by the capability, if there is one.
Set<CapabilityRegistration>	getPossibleCapabilities() Returns set of possible capabilities with there registration points registered in the registry
boolean	hasCapability(String capabilityName, CapabilityScope scope) Gets whether a runtime capability with the given name is registered.
void	registerAdditionalCapabilityRequirement(RuntimeRequirementRegistration requirement) Registers an additional requirement a capability has beyond what it was aware of when capability was passed to registerCapability(RuntimeCapabilityRegistration).
void	registerCapability(RuntimeCapabilityRegistration capabilityRegistration) Registers a capability with the system.
void	registerPossibleCapability(Capability capability, PathAddress registrationPoint) Registers a capability with the system.
RuntimeCapabilityRegistration	removeCapability(String capabilityName, CapabilityScope scope, PathAddress registrationPoint) Remove a previously registered capability if all registration points for it have been removed.
void	removeCapabilityRequirement(RuntimeRequirementRegistration requirementRegistration) Remove a previously registered requirement for a capability.
CapabilityRegistration	removePossibleCapability(Capability capability, PathAddress registrationPoint) Remove a previously registered capability if all registration points for it have been removed.

Methods inherited from class java.lang.Object

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

Constructor Detail

CapabilityRegistry

public CapabilityRegistry(boolean forServer)

Method Detail

registerCapability

public void registerCapability(RuntimeCapabilityRegistration capabilityRegistration)

Registers a capability with the system. Any requirements associated with the capability will be recorded as requirements.

Specified by:

registerCapability in interface RuntimeCapabilityRegistry

Parameters:

capabilityRegistration - the capability. Cannot be null

registerAdditionalCapabilityRequirement

public void registerAdditionalCapabilityRequirement(RuntimeRequirementRegistration requirement)

Registers an additional requirement a capability has beyond what it was aware of when capability was passed to registerCapability(RuntimeCapabilityRegistration). Used for cases where a capability optionally depends on another capability, and whether or not that requirement is needed is not known when the capability is first registered.

Specified by:

registerAdditionalCapabilityRequirement in interface RuntimeCapabilityRegistry

Parameters:

requirement - the requirement

Throws:

IllegalArgumentException - if no matching capability is currently registered for either required or dependent

removeCapabilityRequirement

public void removeCapabilityRequirement(RuntimeRequirementRegistration requirementRegistration)

Remove a previously registered requirement for a capability.

Specified by:

removeCapabilityRequirement in interface RuntimeCapabilityRegistry

Parameters:

requirementRegistration - the requirement. Cannot be null

See Also:

registerAdditionalCapabilityRequirement(org.jboss.as.controller.capability.registry.RuntimeRequirementRegistration)

removeCapability

public RuntimeCapabilityRegistration removeCapability(String capabilityName,
                                                      CapabilityScope scope,
                                                      PathAddress registrationPoint)

Remove a previously registered capability if all registration points for it have been removed.

Specified by:

removeCapability in interface RuntimeCapabilityRegistry

Parameters:

capabilityName - the name of the capability. Cannot be null

scope - the context in which the capability is registered. Cannot be null

registrationPoint - the specific registration point that is being removed

Returns:

the capability that was removed, or null if no matching capability was registered or other registration points for the capability still exist

registerPossibleCapability

public void registerPossibleCapability(Capability capability,
                                       PathAddress registrationPoint)

Registers a capability with the system. Any requirements associated with the capability will be recorded as requirements.

Specified by:

registerPossibleCapability in interface PossibleCapabilityRegistry

Parameters:

capability - the capability. Cannot be null

removePossibleCapability

public CapabilityRegistration removePossibleCapability(Capability capability,
                                                       PathAddress registrationPoint)

Remove a previously registered capability if all registration points for it have been removed.

Specified by:

removePossibleCapability in interface PossibleCapabilityRegistry

Parameters:

capability - the capability. Cannot be null

registrationPoint - the specific registration point that is being removed

Returns:

the capability that was removed, or null if no matching capability was registered or other registration points for the capability still exist

hasCapability

public boolean hasCapability(String capabilityName,
                             CapabilityScope scope)

Description copied from interface: ImmutableCapabilityRegistry

Gets whether a runtime capability with the given name is registered.

Specified by:

hasCapability in interface ImmutableCapabilityRegistry

Parameters:

capabilityName - the name of the capability. Cannot be null

scope - the scope in which to check for the capability

Returns:

true if there is a capability with the given name registered

getCapabilityRuntimeAPI

public <T> T getCapabilityRuntimeAPI(String capabilityName,
                                     CapabilityScope scope,
                                     Class<T> apiType)

Description copied from interface: ImmutableCapabilityRegistry

Gets the runtime API associated with a given capability, if there is one.

Specified by:

getCapabilityRuntimeAPI in interface ImmutableCapabilityRegistry

Type Parameters:

T - the java type that exposes the API

Parameters:

capabilityName - the name of the capability. Cannot be null

scope - the scope in which to resolve the capability. Cannot be null

apiType - class of the java type that exposes the API. Cannot be null

Returns:

the runtime API. Will not return null

getCapabilities

public Set<CapabilityRegistration> getCapabilities()

Description copied from interface: ImmutableCapabilityRegistry

Returns set of runtime capabilities registered in the registry

Specified by:

getCapabilities in interface ImmutableCapabilityRegistry

Returns:

read only Set with all runtime capabilities and where ware they registered

getPossibleCapabilities

public Set<CapabilityRegistration> getPossibleCapabilities()

Description copied from interface: ImmutableCapabilityRegistry

Returns set of possible capabilities with there registration points registered in the registry

Specified by:

getPossibleCapabilities in interface ImmutableCapabilityRegistry

Returns:

read only Set with all possible capabilities and where ware they registered

getCapabilityServiceName

public org.jboss.msc.service.ServiceName getCapabilityServiceName(String capabilityName,
                                                                  CapabilityScope scope,
                                                                  Class<?> serviceType)

Description copied from interface: ImmutableCapabilityRegistry

Gets the name of the service provided by the capability, if there is one.

Specified by:

getCapabilityServiceName in interface ImmutableCapabilityRegistry

Parameters:

capabilityName - the name of the capability. Cannot be null

scope - the scope in which to resolve the capability. Cannot be null

serviceType - the type of the value provided by the service. May be null if the caller is unconcerned about checking that its understanding of the service type provided by the capability is correct

Returns:

the service name. Will not return null