org.jboss.as.controller

Class RestartParentWriteAttributeHandler

java.lang.Object

org.jboss.as.controller.AbstractWriteAttributeHandler<org.jboss.dmr.ModelNode>

org.jboss.as.controller.RestartParentWriteAttributeHandler

All Implemented Interfaces:

OperationStepHandler

public abstract class RestartParentWriteAttributeHandler
extends AbstractWriteAttributeHandler<org.jboss.dmr.ModelNode>

Simple AbstractWriteAttributeHandler that, if allowed, restarts a parent resource when a change is made. Otherwise the server is put into a forced reload.

Author:

Jason T. Greene.

Nested Class Summary

Nested classes/interfaces inherited from class org.jboss.as.controller.AbstractWriteAttributeHandler

AbstractWriteAttributeHandler.HandbackHolder<T>

Constructor Summary

Constructors

Constructor and Description
RestartParentWriteAttributeHandler(String parentKeyName, AttributeDefinition... definitions)
RestartParentWriteAttributeHandler(String parentKeyName, Collection<AttributeDefinition> definitions)

Method Summary

Modifier and Type	Method and Description
protected boolean	applyUpdateToRuntime(OperationContext context, org.jboss.dmr.ModelNode operation, String attributeName, org.jboss.dmr.ModelNode resolvedValue, org.jboss.dmr.ModelNode currentValue, AbstractWriteAttributeHandler.HandbackHolder<org.jboss.dmr.ModelNode> handbackHolder) Hook to allow subclasses to make runtime changes to effect the attribute value change.
protected PathAddress	getParentAddress(PathAddress address)
protected abstract org.jboss.msc.service.ServiceName	getParentServiceName(PathAddress parentAddress)
protected boolean	isResourceServiceRestartAllowed(OperationContext context, org.jboss.msc.service.ServiceController<?> service) Gets whether a restart of the parent resource's services is allowed.
protected void	recreateParentService(OperationContext context, PathAddress parentAddress, org.jboss.dmr.ModelNode parentModel) Recreate the parent service(s) using the given model.
protected void	recreateParentService(OperationContext context, PathAddress parentAddress, org.jboss.dmr.ModelNode parentModel, ServiceVerificationHandler verificationHandler) Deprecated. override recreateParentService(OperationContext, PathAddress, org.jboss.dmr.ModelNode)
protected void	removeServices(OperationContext context, org.jboss.msc.service.ServiceName parentService, org.jboss.dmr.ModelNode parentModel) Removes services.
protected void	revertUpdateToRuntime(OperationContext context, org.jboss.dmr.ModelNode operation, String attributeName, org.jboss.dmr.ModelNode valueToRestore, org.jboss.dmr.ModelNode resolvedValue, org.jboss.dmr.ModelNode invalidatedParentModel) Hook to allow subclasses to revert runtime changes made in AbstractWriteAttributeHandler.applyUpdateToRuntime(OperationContext, ModelNode, String, ModelNode, ModelNode, HandbackHolder).

Methods inherited from class org.jboss.as.controller.AbstractWriteAttributeHandler

execute, finishModelStage, getAttributeDefinition, recordCapabilitiesAndRequirements, requiresRuntime, validateUpdatedModel

Methods inherited from class java.lang.Object

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

Constructor Detail

RestartParentWriteAttributeHandler

public RestartParentWriteAttributeHandler(String parentKeyName,
                                          AttributeDefinition... definitions)

RestartParentWriteAttributeHandler

public RestartParentWriteAttributeHandler(String parentKeyName,
                                          Collection<AttributeDefinition> definitions)

Method Detail

applyUpdateToRuntime

protected boolean applyUpdateToRuntime(OperationContext context,
                                       org.jboss.dmr.ModelNode operation,
                                       String attributeName,
                                       org.jboss.dmr.ModelNode resolvedValue,
                                       org.jboss.dmr.ModelNode currentValue,
                                       AbstractWriteAttributeHandler.HandbackHolder<org.jboss.dmr.ModelNode> handbackHolder)
                                throws OperationFailedException

Description copied from class: AbstractWriteAttributeHandler

Hook to allow subclasses to make runtime changes to effect the attribute value change.

Specified by:

applyUpdateToRuntime in class AbstractWriteAttributeHandler<org.jboss.dmr.ModelNode>

Parameters:

context - the context of the operation

operation - the operation

attributeName - the name of the attribute being modified

resolvedValue - the new value for the attribute, after ModelNode.resolve() has been called on it

currentValue - the existing value for the attribute

handbackHolder - holder for an arbitrary object to pass to AbstractWriteAttributeHandler.revertUpdateToRuntime(OperationContext, ModelNode, String, ModelNode, ModelNode, Object) if the operation needs to be rolled back

Returns:

true if the server requires reload to effect the attribute value change; false if not

Throws:

OperationFailedException

isResourceServiceRestartAllowed

protected boolean isResourceServiceRestartAllowed(OperationContext context,
                                                  org.jboss.msc.service.ServiceController<?> service)

Gets whether a restart of the parent resource's services is allowed. This default implementation checks whether the context allows resource service restarts; subclasses could also check the state of the service.

Parameters:

context - the operation context

service - the parent service

Returns:

true if a restart is allowed; false

removeServices

protected void removeServices(OperationContext context,
                              org.jboss.msc.service.ServiceName parentService,
                              org.jboss.dmr.ModelNode parentModel)
                       throws OperationFailedException

Removes services. This default implementation simply instructs the context to remove the parentService. Subclasses could use the provided parentModel to identify and remove other services.

Parameters:

context - the operation context

parentService - the name of the parent service

parentModel - the model associated with the parent resource, including nodes for any child resources

Throws:

OperationFailedException - if there is a problem removing the services

recreateParentService

protected void recreateParentService(OperationContext context,
                                     PathAddress parentAddress,
                                     org.jboss.dmr.ModelNode parentModel)
                              throws OperationFailedException

Recreate the parent service(s) using the given model.

To provide compatible behavior with previous releases, this default implementation calls the deprecated recreateParentService(OperationContext, PathAddress, org.jboss.dmr.ModelNode, ServiceVerificationHandler) method. It then does nothing with the objects referenced by the verificationHandler parameter passed to that method. Subclasses that overrode that method are encouraged to instead override this one. Subclasses that override this method should not callsuper.recreateParentService(...).

Parameters:

context - the operation context

parentAddress - the address of the parent resource

parentModel - the current configuration model for the parent resource and its children

Throws:

OperationFailedException - if there is a problem installing the services

recreateParentService

@Deprecated
protected void recreateParentService(OperationContext context,
                                                 PathAddress parentAddress,
                                                 org.jboss.dmr.ModelNode parentModel,
                                                 ServiceVerificationHandler verificationHandler)
                                          throws OperationFailedException

Deprecated. override recreateParentService(OperationContext, PathAddress, org.jboss.dmr.ModelNode)

Deprecated. Override recreateParentService(OperationContext, PathAddress, org.jboss.dmr.ModelNode) instead.

Parameters:

context - the operation context

parentAddress - the address of the parent resource

parentModel - the current configuration model for the parent resource and its children

verificationHandler - does nothing; ignored

Throws:

OperationFailedException - if there is a problem installing the services

getParentServiceName

protected abstract org.jboss.msc.service.ServiceName getParentServiceName(PathAddress parentAddress)

getParentAddress

protected PathAddress getParentAddress(PathAddress address)

revertUpdateToRuntime

protected void revertUpdateToRuntime(OperationContext context,
                                     org.jboss.dmr.ModelNode operation,
                                     String attributeName,
                                     org.jboss.dmr.ModelNode valueToRestore,
                                     org.jboss.dmr.ModelNode resolvedValue,
                                     org.jboss.dmr.ModelNode invalidatedParentModel)
                              throws OperationFailedException

Description copied from class: AbstractWriteAttributeHandler

Hook to allow subclasses to revert runtime changes made in AbstractWriteAttributeHandler.applyUpdateToRuntime(OperationContext, ModelNode, String, ModelNode, ModelNode, HandbackHolder).

Specified by:

revertUpdateToRuntime in class AbstractWriteAttributeHandler<org.jboss.dmr.ModelNode>

Parameters:

context - the context of the operation

operation - the operation

attributeName - the name of the attribute being modified

valueToRestore - the previous value for the attribute, before this operation was executed

resolvedValue - the new value for the attribute that should be reverted

invalidatedParentModel - an object, if any, passed in to the handbackHolder by the applyUpdateToRuntime implementation

Throws:

OperationFailedException