org.jboss.as.controller

Class AbstractRuntimeOnlyHandler

java.lang.Object

org.jboss.as.controller.AbstractRuntimeOnlyHandler

All Implemented Interfaces:

OperationStepHandler

Direct Known Subclasses:

PathInfoHandler

public abstract class AbstractRuntimeOnlyHandler
extends Object
implements OperationStepHandler

Base class for operations that do nothing in OperationContext.Stage.MODEL except register a OperationContext.Stage.RUNTIME step.

Author:

Brian Stansberry (c) 2011 Red Hat Inc., Richard Opalka

Constructor Summary

Constructors

Constructor and Description
AbstractRuntimeOnlyHandler()

Method Summary

Modifier and Type	Method and Description
void	execute(OperationContext context, org.jboss.dmr.ModelNode operation) Simply adds a OperationContext.Stage.RUNTIME step that calls executeRuntimeStep(OperationContext, ModelNode).
protected abstract void	executeRuntimeStep(OperationContext context, org.jboss.dmr.ModelNode operation) Execute this step in OperationContext.Stage.RUNTIME.
protected boolean	resourceMustExist(OperationContext context, org.jboss.dmr.ModelNode operation) By default the handler will check whether the resource exist before calling @{link #executeRuntimeStep(OperationContext, ModelNode)}.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractRuntimeOnlyHandler

public AbstractRuntimeOnlyHandler()

Method Detail

execute

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

Simply adds a OperationContext.Stage.RUNTIME step that calls executeRuntimeStep(OperationContext, ModelNode). 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()

resourceMustExist

protected boolean resourceMustExist(OperationContext context,
                                    org.jboss.dmr.ModelNode operation)

By default the handler will check whether the resource exist before calling @{link #executeRuntimeStep(OperationContext, ModelNode)}. This method can be overridden in the special case where a runtime operation must be executed without a corresponding resource.

Parameters:

context - the operation context

operation - the operation being executed

Returns:

true if the resource must exist for this runtime handler to be executed.

executeRuntimeStep

protected abstract void executeRuntimeStep(OperationContext context,
                                           org.jboss.dmr.ModelNode operation)
                                    throws OperationFailedException

Execute this step in OperationContext.Stage.RUNTIME. If the operation fails, context.getFailureDescroption() must be called, or OperationFailedException must be thrown, before calling one of the context.completeStep variants. If the operation succeeded, context.getResult() should be called and the result populated with the outcome, after which one of the context.completeStep variants must be called.

Parameters:

context - the operation context

operation - the operation being executed

Throws:

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