org.jboss.as.controller

Class SimpleResourceDefinition

java.lang.Object

org.jboss.as.controller.SimpleResourceDefinition

All Implemented Interfaces:

ResourceDefinition

Direct Known Subclasses:

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

public class SimpleResourceDefinition
extends Object
implements ResourceDefinition

Basic implementation of ResourceDefinition.

Author:

Brian Stansberry (c) 2011 Red Hat Inc.

Nested Class Summary

Nested Classes

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

Constructor Summary

Constructors

Constructor and Description
SimpleResourceDefinition(PathElement pathElement, DescriptionProvider descriptionProvider) Deprecated. Use SimpleResourceDefinition(Parameters)
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, boolean isRuntime) Deprecated. Use SimpleResourceDefinition(Parameters)
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(PathElement pathElement, ResourceDescriptionResolver descriptionResolver, OperationStepHandler addHandler, OperationStepHandler removeHandler, boolean isRuntime) Deprecated. Use SimpleResourceDefinition(Parameters)
SimpleResourceDefinition(PathElement pathElement, ResourceDescriptionResolver descriptionResolver, OperationStepHandler addHandler, OperationStepHandler removeHandler, DeprecationData deprecationData) Deprecated. Use SimpleResourceDefinition(Parameters)
SimpleResourceDefinition(PathElement pathElement, ResourceDescriptionResolver descriptionResolver, OperationStepHandler addHandler, OperationStepHandler removeHandler, OperationEntry.Flag addRestartLevel, OperationEntry.Flag removeRestartLevel) Deprecated. Use SimpleResourceDefinition(Parameters)
SimpleResourceDefinition(PathElement pathElement, ResourceDescriptionResolver descriptionResolver, OperationStepHandler addHandler, OperationStepHandler removeHandler, OperationEntry.Flag addRestartLevel, OperationEntry.Flag removeRestartLevel, DeprecationData deprecationData) Deprecated. Use SimpleResourceDefinition(Parameters)
SimpleResourceDefinition(PathElement pathElement, ResourceDescriptionResolver descriptionResolver, OperationStepHandler addHandler, OperationStepHandler removeHandler, OperationEntry.Flag addRestartLevel, OperationEntry.Flag removeRestartLevel, DeprecationData deprecationData, boolean runtime) Deprecated. Use SimpleResourceDefinition(Parameters)
SimpleResourceDefinition(SimpleResourceDefinition.Parameters parameters) Constructs a ResourceDefinition using the passed in parameters object.

Method Summary

Modifier and Type	Method and Description
List<AccessConstraintDefinition>	getAccessConstraints() Get the definition of any access constraints associated with the resource.
protected DeprecationData	getDeprecationData()
DescriptionProvider	getDescriptionProvider(ImmutableManagementResourceRegistration resourceRegistration) Gets a DescriptionProvider for the given resource.
protected static EnumSet<OperationEntry.Flag>	getFlagsSet(OperationEntry.Flag... vararg)
PathElement	getPathElement() Gets the path element that describes how to navigate to this resource from its parent resource, or null if this is a definition of a root resource.
ResourceDescriptionResolver	getResourceDescriptionResolver() Gets the ResourceDescriptionResolver used by this resource definition, or null if a ResourceDescriptionResolver is not used.
boolean	isOrderedChild() Whether this resource registration is ordered in the parent.
boolean	isRuntime()
protected void	registerAddOperation(ManagementResourceRegistration registration, AbstractAddStepHandler handler, OperationEntry.Flag... flags) Registers add operation Registers add operation
protected void	registerAddOperation(ManagementResourceRegistration registration, OperationStepHandler handler, OperationEntry.Flag... flags) Deprecated. use registerAddOperation(org.jboss.as.controller.registry.ManagementResourceRegistration, AbstractAddStepHandler, org.jboss.as.controller.registry.OperationEntry.Flag...)
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)
protected void	registerRemoveOperation(ManagementResourceRegistration registration, OperationStepHandler handler, OperationEntry.Flag... flags) Deprecated.
protected void	setDeprecated(ModelVersion since)

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleResourceDefinition

@Deprecated
public SimpleResourceDefinition(PathElement pathElement,
                                            DescriptionProvider descriptionProvider)

Deprecated. Use SimpleResourceDefinition(Parameters)

ResourceDefinition that uses the given {code descriptionProvider} to describe the resource.

Parameters:

pathElement - the path. Can be null.

descriptionProvider - the description provider. Cannot be null

Throws:

IllegalArgumentException - if descriptionProvider is null.

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

@Deprecated
public SimpleResourceDefinition(PathElement pathElement,
                                            ResourceDescriptionResolver descriptionResolver,
                                            boolean isRuntime)

Deprecated. Use SimpleResourceDefinition(Parameters)

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

isRuntime - tells if resource is runtime

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

@Deprecated
public SimpleResourceDefinition(PathElement pathElement,
                                            ResourceDescriptionResolver descriptionResolver,
                                            OperationStepHandler addHandler,
                                            OperationStepHandler removeHandler,
                                            boolean isRuntime)

Deprecated. Use SimpleResourceDefinition(Parameters)

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}

isRuntime - tells is resources is runtime or not

Throws:

IllegalArgumentException - if any parameter is null

SimpleResourceDefinition

@Deprecated
public SimpleResourceDefinition(PathElement pathElement,
                                            ResourceDescriptionResolver descriptionResolver,
                                            OperationStepHandler addHandler,
                                            OperationStepHandler removeHandler,
                                            DeprecationData deprecationData)

Deprecated. Use SimpleResourceDefinition(Parameters)

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}

deprecationData - Information describing deprecation of this resource. Can be null if the resource isn't deprecated.

Throws:

IllegalArgumentException - if any parameter is null

SimpleResourceDefinition

@Deprecated
public SimpleResourceDefinition(PathElement pathElement,
                                            ResourceDescriptionResolver descriptionResolver,
                                            OperationStepHandler addHandler,
                                            OperationStepHandler removeHandler,
                                            OperationEntry.Flag addRestartLevel,
                                            OperationEntry.Flag removeRestartLevel)

Deprecated. Use SimpleResourceDefinition(Parameters)

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

Parameters:

pathElement - the path. Can 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 descriptionResolver is null.

SimpleResourceDefinition

@Deprecated
public SimpleResourceDefinition(PathElement pathElement,
                                            ResourceDescriptionResolver descriptionResolver,
                                            OperationStepHandler addHandler,
                                            OperationStepHandler removeHandler,
                                            OperationEntry.Flag addRestartLevel,
                                            OperationEntry.Flag removeRestartLevel,
                                            DeprecationData deprecationData)

Deprecated. Use SimpleResourceDefinition(Parameters)

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

Parameters:

pathElement - the path. Can 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}

deprecationData - Information describing deprecation of this resource. Can be null if the resource isn't deprecated.

Throws:

IllegalArgumentException - if descriptionResolver is null.

SimpleResourceDefinition

@Deprecated
public SimpleResourceDefinition(PathElement pathElement,
                                            ResourceDescriptionResolver descriptionResolver,
                                            OperationStepHandler addHandler,
                                            OperationStepHandler removeHandler,
                                            OperationEntry.Flag addRestartLevel,
                                            OperationEntry.Flag removeRestartLevel,
                                            DeprecationData deprecationData,
                                            boolean runtime)

Deprecated. Use SimpleResourceDefinition(Parameters)

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

Parameters:

pathElement - the path. Can 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}

deprecationData - Information describing deprecation of this resource. Can be null if the resource isn't deprecated.

runtime - Whether this is a runtime resource

Throws:

IllegalArgumentException - if descriptionResolver 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

getPathElement

public PathElement getPathElement()

Description copied from interface: ResourceDefinition

Gets the path element that describes how to navigate to this resource from its parent resource, or null if this is a definition of a root resource.

Specified by:

getPathElement in interface ResourceDefinition

Returns:

the path element, or null if this is a definition of a root resource.

getDescriptionProvider

public DescriptionProvider getDescriptionProvider(ImmutableManagementResourceRegistration resourceRegistration)

Description copied from interface: ResourceDefinition

Gets a DescriptionProvider for the given resource.

Specified by:

getDescriptionProvider in interface ResourceDefinition

Parameters:

resourceRegistration - the resource. Cannot be null

Returns:

the description provider. Will not be null

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

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

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

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

Parameters:

resourceRegistration - a ManagementResourceRegistration created from this definition

registerCapabilities

public void registerCapabilities(ManagementResourceRegistration resourceRegistration)

Description copied from interface: ResourceDefinition

Register capabilities associated with this resource.

Specified by:

registerCapabilities in interface ResourceDefinition

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

registerAddOperation

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

Deprecated. use registerAddOperation(org.jboss.as.controller.registry.ManagementResourceRegistration, AbstractAddStepHandler, 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

registerAddOperation

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

Registers add operation

Registers add operation

Parameters:

registration - resource on which to register

handler - operation handler to register

flags - with flags

registerRemoveOperation

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

Deprecated.

registerRemoveOperation

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

getFlagsSet

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

getAccessConstraints

public List<AccessConstraintDefinition> getAccessConstraints()

Get the definition of any access constraints associated with the resource.

Specified by:

getAccessConstraints in interface ResourceDefinition

Returns:

this default implementation simply returns an empty list.

setDeprecated

protected void setDeprecated(ModelVersion since)

getDeprecationData

protected DeprecationData getDeprecationData()

isRuntime

public boolean isRuntime()

Specified by:

isRuntime in interface ResourceDefinition

Returns:

true if resource is runtime

isOrderedChild

public boolean isOrderedChild()

Whether this resource registration is ordered in the parent. The automatically generated 'add' operation will get the add-index parameter added. Also, it will get registered as an ordered child in the parent's management resource registration.

Specified by:

isOrderedChild in interface ResourceDefinition

Returns:

whether this is an ordered child resource