org.jboss.as.controller.operations.common

Class GenericSubsystemDescribeHandler

java.lang.Object

org.jboss.as.controller.operations.common.GenericSubsystemDescribeHandler

All Implemented Interfaces:

DescriptionProvider, OperationStepHandler

public class GenericSubsystemDescribeHandler
extends Object
implements OperationStepHandler, DescriptionProvider

A generic handler recursively creating add operations for a managed resource using it's attributes as the request-parameters.

Author:

Emanuel Muckenhuber

Field Summary

Fields

Modifier and Type	Field and Description
static SimpleOperationDefinition	DEFINITION
static Set<Action.ActionEffect>	DESCRIBE_EFFECTS
static GenericSubsystemDescribeHandler	INSTANCE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GenericSubsystemDescribeHandler()
protected	GenericSubsystemDescribeHandler(Comparator<PathElement> comparator) Creates a new describe handler.

Method Summary

Methods

Modifier and Type	Method and Description
static GenericSubsystemDescribeHandler	create(Comparator<PathElement> comparator) Creates a new describe handler.
protected org.jboss.dmr.ModelNode	createAddOperation(org.jboss.dmr.ModelNode address, org.jboss.dmr.ModelNode subModel, Set<PathElement> children)
protected void	describe(Resource resource, org.jboss.dmr.ModelNode address, org.jboss.dmr.ModelNode result, ImmutableManagementResourceRegistration registration)
void	execute(OperationContext context, org.jboss.dmr.ModelNode operation) Execute this step.
org.jboss.dmr.ModelNode	getModelDescription(Locale locale) Deprecated. use DEFINITION for registration of operation

Methods inherited from class java.lang.Object

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

Field Detail

INSTANCE

public static final GenericSubsystemDescribeHandler INSTANCE

DEFINITION

public static final SimpleOperationDefinition DEFINITION

DESCRIBE_EFFECTS

public static final Set<Action.ActionEffect> DESCRIBE_EFFECTS

Constructor Detail

GenericSubsystemDescribeHandler

protected GenericSubsystemDescribeHandler()

GenericSubsystemDescribeHandler

protected GenericSubsystemDescribeHandler(Comparator<PathElement> comparator)

Creates a new describe handler.

If the comparator is not null the ImmutableManagementResourceRegistration.getChildAddresses(org.jboss.as.controller.PathAddress) child addresses} from the registration are placed in a sorted collection. This allows the result to order the add operations for the subsystem resources.

If the comparator is null the order for the ImmutableManagementResourceRegistration.getChildAddresses(org.jboss.as.controller.PathAddress) child addresses} is not guaranteed.

Parameters:

comparator - the comparator used to sort the child addresses

Method Detail

create

public static GenericSubsystemDescribeHandler create(Comparator<PathElement> comparator)

Creates a new describe handler.

If the comparator is not null the ImmutableManagementResourceRegistration.getChildAddresses(org.jboss.as.controller.PathAddress) child addresses} from the registration are placed in a sorted collection. This allows the result to order the add operations for the subsystem resources.

If the comparator is null the order for the ImmutableManagementResourceRegistration.getChildAddresses(org.jboss.as.controller.PathAddress) child addresses} is not guaranteed.

Parameters:

comparator - the comparator used to sort the child addresses

execute

public void execute(OperationContext context,
           org.jboss.dmr.ModelNode operation)
             throws OperationFailedException

Description copied from interface: OperationStepHandler

Execute this step. If the operation fails, context.getFailureDescription() must be called, or an OperationFailedException must be thrown. If the operation succeeded and the operation provides a return value, context.getResult() should be called and the result populated with the outcome. If the handler wishes to take further action once the result of the overall operation execution is known, one of the context.completeStep variants should be called to register a callback. The callback will not be invoked if this method throws an exception.

When this method is invoked the thread context classloader will be set to be the defining class loader of the class that implements this interface.

Specified by:

execute in interface OperationStepHandler

Parameters:

context - the operation context

operation - the operation being executed

Throws:

OperationFailedException - if the operation failed before calling context.completeStep()

describe

protected void describe(Resource resource,
            org.jboss.dmr.ModelNode address,
            org.jboss.dmr.ModelNode result,
            ImmutableManagementResourceRegistration registration)

createAddOperation

protected org.jboss.dmr.ModelNode createAddOperation(org.jboss.dmr.ModelNode address,
                                         org.jboss.dmr.ModelNode subModel,
                                         Set<PathElement> children)

getModelDescription

public org.jboss.dmr.ModelNode getModelDescription(Locale locale)

Deprecated. use DEFINITION for registration of operation

Description copied from interface: DescriptionProvider

Gets the descriptive information (human-friendly description, list of attributes, list of children) describing a single model node or operation.

The implementation must assume that the caller intends to modify the returned ModelNode so it should not hand out a reference to any internal data structures.

Specified by:

getModelDescription in interface DescriptionProvider

Parameters:

locale - the locale to use to generate any localized text used in the description. May be null, in which case Locale.getDefault() should be used

Returns:

definition of operation