org.jboss.as.controller

Class AbstractControllerService

java.lang.Object

org.jboss.as.controller.AbstractControllerService

All Implemented Interfaces:

org.jboss.msc.service.Service<ModelController>, org.jboss.msc.value.Value<ModelController>

public abstract class AbstractControllerService
extends Object
implements org.jboss.msc.service.Service<ModelController>

A base class for controller services.

Author:

David M. Lloyd

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractControllerService.ModelControllerServiceInitializationParams Parameters for initializing ModelControllerServiceInitialization instances

Field Summary

Fields

Modifier and Type	Field and Description
protected DelegatingConfigurableAuthorizer	authorizer
static String	BOOT_STACK_SIZE_PROPERTY Name of the system property to set to control the stack size for the thread used to process boot operations.
static int	DEFAULT_BOOT_STACK_SIZE The default stack size for the thread used to process boot operations.
protected ProcessType	processType

Fields inherited from interface org.jboss.msc.service.Service

NULL, NULL_VALUE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractControllerService(ProcessType processType, RunningModeControl runningModeControl, ConfigurationPersister configurationPersister, ControlledProcessState processState, DescriptionProvider rootDescriptionProvider, OperationStepHandler prepareStep, ExpressionResolver expressionResolver) Deprecated. Here for backwards compatibility for ModelTestModelControllerService
protected	AbstractControllerService(ProcessType processType, RunningModeControl runningModeControl, ConfigurationPersister configurationPersister, ControlledProcessState processState, DescriptionProvider rootDescriptionProvider, OperationStepHandler prepareStep, ExpressionResolver expressionResolver, ManagedAuditLogger auditLogger, DelegatingConfigurableAuthorizer authorizer) Deprecated.
protected	AbstractControllerService(ProcessType processType, RunningModeControl runningModeControl, ConfigurationPersister configurationPersister, ControlledProcessState processState, ResourceDefinition rootResourceDefinition, OperationStepHandler prepareStep, ExpressionResolver expressionResolver) Deprecated. Here for backwards compatibility for ModelTestModelControllerService
protected	AbstractControllerService(ProcessType processType, RunningModeControl runningModeControl, ConfigurationPersister configurationPersister, ControlledProcessState processState, ResourceDefinition rootResourceDefinition, OperationStepHandler prepareStep, ExpressionResolver expressionResolver, ManagedAuditLogger auditLogger, DelegatingConfigurableAuthorizer authorizer) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
protected void	boot(BootContext context) Boot the controller.
protected boolean	boot(List<org.jboss.dmr.ModelNode> bootOperations, boolean rollbackOnRuntimeFailure)
protected boolean	boot(List<org.jboss.dmr.ModelNode> bootOperations, boolean rollbackOnRuntimeFailure, boolean skipModelValidation)
protected boolean	boot(List<org.jboss.dmr.ModelNode> bootOperations, boolean rollbackOnRuntimeFailure, boolean skipModelValidation, MutableRootResourceRegistrationProvider parallelBootRootResourceRegistrationProvider)
protected boolean	boot(List<org.jboss.dmr.ModelNode> bootOperations, boolean rollbackOnRuntimeFailure, MutableRootResourceRegistrationProvider parallelBootRootResourceRegistrationProvider)
protected void	bootThreadDone()
protected org.jboss.dmr.ModelNode	executeReadOnlyOperation(org.jboss.dmr.ModelNode operation, OperationMessageHandler handler, ModelController.OperationTransactionControl control, OperationAttachments attachments, OperationStepHandler prepareStep, int lockPermit) Deprecated. internal use only and only by legacy test controllers
protected org.jboss.dmr.ModelNode	executeReadOnlyOperation(org.jboss.dmr.ModelNode operation, OperationMessageHandler handler, ModelController.OperationTransactionControl control, OperationStepHandler prepareStep, int lockPermit) Deprecated. internal use only
protected void	finishBoot()
protected ManagedAuditLogger	getAuditLogger()
protected BootErrorCollector	getBootErrorCollector()
org.jboss.msc.value.InjectedValue<ExecutorService>	getExecutorServiceInjector()
protected AbstractControllerService.ModelControllerServiceInitializationParams	getModelControllerServiceInitializationParams() Override to return a AbstractControllerService.ModelControllerServiceInitializationParams.
protected MutableRootResourceRegistrationProvider	getMutableRootResourceRegistrationProvider()
ModelController	getValue()
protected abstract void	initModel(ManagementModel managementModel, Resource modelControllerResource)
protected org.jboss.dmr.ModelNode	internalExecute(org.jboss.dmr.ModelNode operation, OperationMessageHandler handler, ModelController.OperationTransactionControl control, OperationAttachments attachments, OperationStepHandler prepareStep) Deprecated. internal use only only for use by legacy test controllers
protected OperationResponse	internalExecute(Operation operation, OperationMessageHandler handler, ModelController.OperationTransactionControl control, OperationStepHandler prepareStep)
protected OperationResponse	internalExecute(Operation operation, OperationMessageHandler handler, ModelController.OperationTransactionControl control, OperationStepHandler prepareStep, boolean attemptLock)
protected org.jboss.dmr.ModelNode	registerModelControllerServiceInitializationBootStep(BootContext context) Used to add the operation used to initialise the ModelControllerServiceInitialization instances.
protected void	setConfigurationPersister(ConfigurationPersister persister)
void	start(org.jboss.msc.service.StartContext context)
void	stop(org.jboss.msc.service.StopContext context)
protected void	stopAsynchronous(org.jboss.msc.service.StopContext context) Hook for subclasses to perform work during the asynchronous task started by stop(org.jboss.msc.service.StopContext).

Methods inherited from class java.lang.Object

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

Field Detail

BOOT_STACK_SIZE_PROPERTY

public static final String BOOT_STACK_SIZE_PROPERTY

Name of the system property to set to control the stack size for the thread used to process boot operations. The boot sequence can have a very deep stack, so if needed setting this property can be used to create a larger memory area for storing data on the stack.

See Also:

DEFAULT_BOOT_STACK_SIZE, Constant Field Values

DEFAULT_BOOT_STACK_SIZE

public static final int DEFAULT_BOOT_STACK_SIZE

The default stack size for the thread used to process boot operations.

See Also:

BOOT_STACK_SIZE_PROPERTY, Constant Field Values

processType

protected final ProcessType processType

authorizer

protected final DelegatingConfigurableAuthorizer authorizer

Constructor Detail

AbstractControllerService

@Deprecated
protected AbstractControllerService(ProcessType processType,
                                                RunningModeControl runningModeControl,
                                                ConfigurationPersister configurationPersister,
                                                ControlledProcessState processState,
                                                DescriptionProvider rootDescriptionProvider,
                                                OperationStepHandler prepareStep,
                                                ExpressionResolver expressionResolver,
                                                ManagedAuditLogger auditLogger,
                                                DelegatingConfigurableAuthorizer authorizer)

Deprecated.

Construct a new instance.

Parameters:

processType - the type of process being controlled

runningModeControl - the controller of the process' running mode

configurationPersister - the configuration persister

processState - the controlled process state

rootDescriptionProvider - the root description provider

prepareStep - the prepare step to prepend to operation execution

expressionResolver - the expression resolver

auditLogger - the audit logger

AbstractControllerService

protected AbstractControllerService(ProcessType processType,
                                    RunningModeControl runningModeControl,
                                    ConfigurationPersister configurationPersister,
                                    ControlledProcessState processState,
                                    ResourceDefinition rootResourceDefinition,
                                    OperationStepHandler prepareStep,
                                    ExpressionResolver expressionResolver,
                                    ManagedAuditLogger auditLogger,
                                    DelegatingConfigurableAuthorizer authorizer)

Construct a new instance.

Parameters:

processType - the type of process being controlled

runningModeControl - the controller of the process' running mode

configurationPersister - the configuration persister

processState - the controlled process state

rootResourceDefinition - the root resource definition

prepareStep - the prepare step to prepend to operation execution

expressionResolver - the expression resolver

auditLogger - the audit logger

AbstractControllerService

@Deprecated
protected AbstractControllerService(ProcessType processType,
                                                RunningModeControl runningModeControl,
                                                ConfigurationPersister configurationPersister,
                                                ControlledProcessState processState,
                                                DescriptionProvider rootDescriptionProvider,
                                                OperationStepHandler prepareStep,
                                                ExpressionResolver expressionResolver)

Deprecated. Here for backwards compatibility for ModelTestModelControllerService

Construct a new instance. Simplified constructor for test case subclasses.

Parameters:

processType - the type of process being controlled

runningModeControl - the controller of the process' running mode

configurationPersister - the configuration persister

processState - the controlled process state

rootDescriptionProvider - the root description provider

prepareStep - the prepare step to prepend to operation execution

expressionResolver - the expression resolver

AbstractControllerService

@Deprecated
protected AbstractControllerService(ProcessType processType,
                                                RunningModeControl runningModeControl,
                                                ConfigurationPersister configurationPersister,
                                                ControlledProcessState processState,
                                                ResourceDefinition rootResourceDefinition,
                                                OperationStepHandler prepareStep,
                                                ExpressionResolver expressionResolver)

Deprecated. Here for backwards compatibility for ModelTestModelControllerService

Construct a new instance.

Parameters:

processType - the type of process being controlled

runningModeControl - the controller of the process' running mode

configurationPersister - the configuration persister

processState - the controlled process state

rootResourceDefinition - the root resource definition

prepareStep - the prepare step to prepend to operation execution

expressionResolver - the expression resolver

Method Detail

start

public void start(org.jboss.msc.service.StartContext context)
           throws org.jboss.msc.service.StartException

Specified by:

start in interface org.jboss.msc.service.Service<ModelController>

Throws:

org.jboss.msc.service.StartException

boot

protected void boot(BootContext context)
             throws ConfigurationPersistenceException

Boot the controller. Called during service start.

Parameters:

context - the boot context

Throws:

ConfigurationPersistenceException - if the configuration failed to be loaded

boot

protected boolean boot(List<org.jboss.dmr.ModelNode> bootOperations,
                       boolean rollbackOnRuntimeFailure)
                throws ConfigurationPersistenceException

Throws:

ConfigurationPersistenceException

boot

protected boolean boot(List<org.jboss.dmr.ModelNode> bootOperations,
                       boolean rollbackOnRuntimeFailure,
                       boolean skipModelValidation)
                throws ConfigurationPersistenceException

Throws:

ConfigurationPersistenceException

boot

protected boolean boot(List<org.jboss.dmr.ModelNode> bootOperations,
                       boolean rollbackOnRuntimeFailure,
                       MutableRootResourceRegistrationProvider parallelBootRootResourceRegistrationProvider)
                throws ConfigurationPersistenceException

Throws:

ConfigurationPersistenceException

boot

protected boolean boot(List<org.jboss.dmr.ModelNode> bootOperations,
                       boolean rollbackOnRuntimeFailure,
                       boolean skipModelValidation,
                       MutableRootResourceRegistrationProvider parallelBootRootResourceRegistrationProvider)
                throws ConfigurationPersistenceException

Throws:

ConfigurationPersistenceException

internalExecute

@Deprecated
protected org.jboss.dmr.ModelNode internalExecute(org.jboss.dmr.ModelNode operation,
                                                              OperationMessageHandler handler,
                                                              ModelController.OperationTransactionControl control,
                                                              OperationAttachments attachments,
                                                              OperationStepHandler prepareStep)

Deprecated. internal use only only for use by legacy test controllers

internalExecute

protected OperationResponse internalExecute(Operation operation,
                                            OperationMessageHandler handler,
                                            ModelController.OperationTransactionControl control,
                                            OperationStepHandler prepareStep)

internalExecute

protected OperationResponse internalExecute(Operation operation,
                                            OperationMessageHandler handler,
                                            ModelController.OperationTransactionControl control,
                                            OperationStepHandler prepareStep,
                                            boolean attemptLock)

executeReadOnlyOperation

@Deprecated
protected org.jboss.dmr.ModelNode executeReadOnlyOperation(org.jboss.dmr.ModelNode operation,
                                                                       OperationMessageHandler handler,
                                                                       ModelController.OperationTransactionControl control,
                                                                       OperationAttachments attachments,
                                                                       OperationStepHandler prepareStep,
                                                                       int lockPermit)

Deprecated. internal use only and only by legacy test controllers

executeReadOnlyOperation

@Deprecated
protected org.jboss.dmr.ModelNode executeReadOnlyOperation(org.jboss.dmr.ModelNode operation,
                                                                       OperationMessageHandler handler,
                                                                       ModelController.OperationTransactionControl control,
                                                                       OperationStepHandler prepareStep,
                                                                       int lockPermit)

Deprecated. internal use only

finishBoot

protected void finishBoot()
                   throws ConfigurationPersistenceException

Throws:

ConfigurationPersistenceException

bootThreadDone

protected void bootThreadDone()

getMutableRootResourceRegistrationProvider

protected final MutableRootResourceRegistrationProvider getMutableRootResourceRegistrationProvider()

stop

public void stop(org.jboss.msc.service.StopContext context)

Specified by:

stop in interface org.jboss.msc.service.Service<ModelController>

stopAsynchronous

protected void stopAsynchronous(org.jboss.msc.service.StopContext context)

Hook for subclasses to perform work during the asynchronous task started by stop(org.jboss.msc.service.StopContext). This base method does nothing.

Subclasses must not invoke LifecycleContext.complete()

Parameters:

context - the stop context

getValue

public ModelController getValue()
                         throws IllegalStateException,
                                IllegalArgumentException

Specified by:

getValue in interface org.jboss.msc.value.Value<ModelController>

Throws:

SecurityException - if the caller does not have ModelController.ACCESS_PERMISSION

IllegalStateException

IllegalArgumentException

getExecutorServiceInjector

public org.jboss.msc.value.InjectedValue<ExecutorService> getExecutorServiceInjector()

setConfigurationPersister

protected void setConfigurationPersister(ConfigurationPersister persister)

initModel

protected abstract void initModel(ManagementModel managementModel,
                                  Resource modelControllerResource)

getAuditLogger

protected ManagedAuditLogger getAuditLogger()

getBootErrorCollector

protected BootErrorCollector getBootErrorCollector()

registerModelControllerServiceInitializationBootStep

protected final org.jboss.dmr.ModelNode registerModelControllerServiceInitializationBootStep(BootContext context)

Used to add the operation used to initialise the ModelControllerServiceInitialization instances. The operation will only be registered, and called if the implementing class overrides and returns a non null value from getModelControllerServiceInitializationParams()

Parameters:

context - the boot context

getModelControllerServiceInitializationParams

protected AbstractControllerService.ModelControllerServiceInitializationParams getModelControllerServiceInitializationParams()

Override to return a AbstractControllerService.ModelControllerServiceInitializationParams. If null is returned, registerModelControllerServiceInitializationBootStep(BootContext) will not perform any initialization of ModelControllerServiceInitialization instances.

Returns:

the context to use for registering ModelControllerServiceInitialization instances