Package org.jboss.as.controller

Class SimpleResourceDefinition

java.lang.Object

org.jboss.as.controller.ResourceDefinition.MinimalResourceDefinition

org.jboss.as.controller.SimpleResourceDefinition

All Implemented Interfaces:

Feature, ResourceDefinition, ResourceRegistration

Direct Known Subclasses:

AbstractSocketBindingGroupResourceDefinition, AbstractSocketBindingResourceDefinition, BaseHttpInterfaceResourceDefinition, BaseNativeInterfaceResourceDefinition, ExtensionResourceDefinition, ExtensionSubsystemResourceDefinition, InterfaceDefinition, ModelOnlyResourceDefinition, PathResourceDefinition, PersistentResourceDefinition

public class SimpleResourceDefinition
extends ResourceDefinition.MinimalResourceDefinition

Basic implementation of ResourceDefinition.

Author:

Brian Stansberry (c) 2011 Red Hat Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SimpleResourceDefinition.Parameters	Parameters object for the SimpleResourceDefinition constructor

Nested classes/interfaces inherited from interface org.jboss.as.controller.ResourceDefinition

ResourceDefinition.AbstractConfigurator<C extends ResourceDefinition.Configurator<C>>, ResourceDefinition.Builder, ResourceDefinition.Configurator<C extends ResourceDefinition.Configurator<C>>, ResourceDefinition.MinimalBuilder, ResourceDefinition.MinimalResourceDefinition

Constructor Summary

Constructors

Constructor	Description
SimpleResourceDefinition(PathElement pathElement, ResourceDescriptionResolver descriptionResolver)	ResourceDefinition that uses the given {code descriptionResolver} to configure a DefaultResourceDescriptionProvider to describe the resource.
SimpleResourceDefinition(PathElement pathElement, ResourceDescriptionResolver descriptionResolver, OperationStepHandler addHandler, OperationStepHandler removeHandler)	ResourceDefinition that uses the given {code descriptionResolver} to configure a DefaultResourceDescriptionProvider to describe the resource.
SimpleResourceDefinition(SimpleResourceDefinition.Parameters parameters)	Constructs a ResourceDefinition using the passed in parameters object.

Method Summary

Modifier and Type	Method	Description
protected AttributeDefinition[]	getAddOperationParameters(ManagementResourceRegistration registration)	Returns the parameters of the "add" resource operation.
protected DeprecationData	getDeprecationData()
protected static EnumSet<OperationEntry.Flag>	getFlagsSet(OperationEntry.Flag... vararg)
ResourceDescriptionResolver	getResourceDescriptionResolver()	Gets the ResourceDescriptionResolver used by this resource definition, or null if a ResourceDescriptionResolver is not used.
void	registerAdditionalRuntimePackages(ManagementResourceRegistration resourceRegistration)	Register "additional" Galleon packages that must be installed in order for this Resource to function.
protected void	registerAddOperation(ManagementResourceRegistration registration, AbstractAddStepHandler handler, OperationEntry.Flag... flags)	Deprecated, for removal: This API element is subject to removal in a future version. Redundant with registerAddOperation(ManagementResourceRegistration, OperationStepHandler, org.jboss.as.controller.registry.OperationEntry.Flag...)
protected void	registerAddOperation(ManagementResourceRegistration registration, OperationStepHandler handler, OperationEntry.Flag... flags)	Registers the "add" resource operation.
void	registerAttributes(ManagementResourceRegistration resourceRegistration)	Register operations associated with this resource.
void	registerCapabilities(ManagementResourceRegistration resourceRegistration)	Register capabilities associated with this resource.
void	registerChildren(ManagementResourceRegistration resourceRegistration)	Register child resources associated with this resource.
void	registerNotifications(ManagementResourceRegistration resourceRegistration)	Register notifications associated with this resource.
void	registerOperations(ManagementResourceRegistration resourceRegistration)	Register operations associated with this resource.
protected void	registerRemoveOperation(ManagementResourceRegistration registration, AbstractRemoveStepHandler handler, OperationEntry.Flag... flags)	Deprecated, for removal: This API element is subject to removal in a future version. Redundant with registerRemoveOperation(ManagementResourceRegistration, OperationStepHandler, org.jboss.as.controller.registry.OperationEntry.Flag...)
protected void	registerRemoveOperation(ManagementResourceRegistration registration, OperationStepHandler handler, OperationEntry.Flag... flags)	Registers the "remove" resource operation.
protected void	setDeprecated(ModelVersion since)

Methods inherited from class org.jboss.as.controller.ResourceDefinition.MinimalResourceDefinition

getAccessConstraints, getDescriptionProvider, getMaxOccurs, getMinOccurs, getPathElement, getStability, isFeature, isOrderedChild, isRuntime

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleResourceDefinition

public SimpleResourceDefinition(PathElement pathElement,
                                ResourceDescriptionResolver descriptionResolver)

ResourceDefinition that uses the given {code descriptionResolver} to configure a DefaultResourceDescriptionProvider to describe the resource.

Parameters:

pathElement - the path. Cannot be null.

descriptionResolver - the description resolver to use in the description provider. Cannot be null

Throws:

IllegalArgumentException - if any parameter is null.

SimpleResourceDefinition

public SimpleResourceDefinition(PathElement pathElement,
                                ResourceDescriptionResolver descriptionResolver,
                                OperationStepHandler addHandler,
                                OperationStepHandler removeHandler)

ResourceDefinition that uses the given {code descriptionResolver} to configure a DefaultResourceDescriptionProvider to describe the resource.

Parameters:

pathElement - the path. Cannot be null.

descriptionResolver - the description resolver to use in the description provider. Cannot be null *

addHandler - a handler to register for the resource "add" operation. Can be {null}

removeHandler - a handler to register for the resource "remove" operation. Can be {null}

Throws:

IllegalArgumentException - if any parameter is null

SimpleResourceDefinition

public SimpleResourceDefinition(SimpleResourceDefinition.Parameters parameters)

Constructs a ResourceDefinition using the passed in parameters object.

Parameters:

parameters - SimpleResourceDefinition.Parameters to configure this ResourceDefinition

Throws:

IllegalStateException - if the parameters object is not valid.

Method Detail

registerOperations

public void registerOperations(ManagementResourceRegistration resourceRegistration)

Register operations associated with this resource. Registers an add operation handler or a remove operation handler if one was provided to the constructor.

Specified by:

registerOperations in interface ResourceDefinition

Overrides:

registerOperations in class ResourceDefinition.MinimalResourceDefinition

Parameters:

resourceRegistration - a ManagementResourceRegistration created from this definition

registerAttributes

public void registerAttributes(ManagementResourceRegistration resourceRegistration)

Description copied from interface: ResourceDefinition

Register operations associated with this resource.

Specified by:

registerAttributes in interface ResourceDefinition

Overrides:

registerAttributes in class ResourceDefinition.MinimalResourceDefinition

Parameters:

resourceRegistration - a ManagementResourceRegistration created from this definition

registerNotifications

public void registerNotifications(ManagementResourceRegistration resourceRegistration)

Description copied from interface: ResourceDefinition

Register notifications associated with this resource.

Specified by:

registerNotifications in interface ResourceDefinition

Overrides:

registerNotifications in class ResourceDefinition.MinimalResourceDefinition

Parameters:

resourceRegistration - a ManagementResourceRegistration created from this definition

registerChildren

public void registerChildren(ManagementResourceRegistration resourceRegistration)

Description copied from interface: ResourceDefinition

Register child resources associated with this resource.

Specified by:

registerChildren in interface ResourceDefinition

Overrides:

registerChildren in class ResourceDefinition.MinimalResourceDefinition

Parameters:

resourceRegistration - a ManagementResourceRegistration created from this definition

registerCapabilities

public void registerCapabilities(ManagementResourceRegistration resourceRegistration)

Register capabilities associated with this resource.

Classes that overrides this method MUST call super.registerCapabilities(resourceRegistration).

Parameters:

resourceRegistration - a ManagementResourceRegistration created from this definition

registerAdditionalRuntimePackages

public void registerAdditionalRuntimePackages(ManagementResourceRegistration resourceRegistration)

Description copied from interface: ResourceDefinition

Register "additional" Galleon packages that must be installed in order for this Resource to function. NB: the packages need to be visible from the feature pack that contains the ResourceDefinition. It can't be any package from any feature pack. The purpose of providing this information is to make it available to the Galleon tooling that produces Galleon feature-specs, in order to allow the tooling to include the package information in the relevant spec.

A package is "additional" if it is not one of the "standard" packages that must be installed. The names of "standard" packages should not be registered. The "standard" packages are:

1. The root package for the process type; i.e. the package that provides the main module whose name is passed to JBoss Modules when the process is launched.
2. The package that installs the module that provides the extension in which the resource is defined.
3. Any package that is non-optionally directly or transitively required by one of the other types of standard packages.

Additional packages fall into in the following categories:

1. Packages that install required modules injected into Deployment Unit can be registered as required RuntimePackageDependency.
2. Packages that install optional modules injected into Deployment Unit can be registered as optional RuntimePackageDependency.
3. Packages that install modules that are only required if the resource associated to this definition is instantiated are to be registered as required RuntimePackageDependency.
4. Packages that install modules that are only required by this feature in order to interact with other features are to be registered as passive RuntimePackageDependency. A passive dependency is provisioned only if its own required dependencies are present.

Specified by:

registerAdditionalRuntimePackages in interface ResourceDefinition

Overrides:

registerAdditionalRuntimePackages in class ResourceDefinition.MinimalResourceDefinition

Parameters:

resourceRegistration - a ManagementResourceRegistration created from this definition

getResourceDescriptionResolver

public ResourceDescriptionResolver getResourceDescriptionResolver()

Gets the ResourceDescriptionResolver used by this resource definition, or null if a ResourceDescriptionResolver is not used.

Returns:

the resource description resolver, or null

getAddOperationParameters

protected AttributeDefinition[] getAddOperationParameters(ManagementResourceRegistration registration)

Returns the parameters of the "add" resource operation. The default implementation returns all registered attributes, excluding runtime-only and resource-only.

Parameters:

registration - the registration of this resource definition

Returns:

an array of attribute definitions

registerAddOperation

protected void registerAddOperation(ManagementResourceRegistration registration,
                                    OperationStepHandler handler,
                                    OperationEntry.Flag... flags)

Registers the "add" resource operation.

Parameters:

registration - resource on which to register

handler - operation handler to register

flags - with flags

registerRemoveOperation

protected void registerRemoveOperation(ManagementResourceRegistration registration,
                                       OperationStepHandler handler,
                                       OperationEntry.Flag... flags)

Registers the "remove" resource operation.

Parameters:

registration - resource on which to register

handler - operation handler to register

flags - with flags

registerAddOperation

@Deprecated(forRemoval=true)
protected void registerAddOperation(ManagementResourceRegistration registration,
                                    AbstractAddStepHandler handler,
                                    OperationEntry.Flag... flags)

Deprecated, for removal: This API element is subject to removal in a future version.

Redundant with registerAddOperation(ManagementResourceRegistration, OperationStepHandler, org.jboss.as.controller.registry.OperationEntry.Flag...)

Registers add operation

Parameters:

registration - resource on which to register

handler - operation handler to register

flags - with flags

registerRemoveOperation

@Deprecated(forRemoval=true)
protected void registerRemoveOperation(ManagementResourceRegistration registration,
                                       AbstractRemoveStepHandler handler,
                                       OperationEntry.Flag... flags)

Deprecated, for removal: This API element is subject to removal in a future version.

Redundant with registerRemoveOperation(ManagementResourceRegistration, OperationStepHandler, org.jboss.as.controller.registry.OperationEntry.Flag...)

Registers remove operation

Parameters:

registration - resource on which to register

handler - operation handler to register

flags - with flags

getFlagsSet

protected static EnumSet<OperationEntry.Flag> getFlagsSet(OperationEntry.Flag... vararg)

setDeprecated

protected void setDeprecated(ModelVersion since)

getDeprecationData

protected DeprecationData getDeprecationData()