org.jboss.as.controller

Class AbstractControllerService

java.lang.Object

org.jboss.as.controller.AbstractControllerService

All Implemented Interfaces:

org.jboss.msc.Service, 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
static interface	AbstractControllerService.ControllerInstabilityListener Listener for notifications that the ModelController is unstable and a process restart is necessary.
protected static class	AbstractControllerService.ModelControllerServiceInitializationParams Parameters for initializing ModelControllerServiceInitialization instances
protected static interface	AbstractControllerService.PartialModelIndicator Tracks whether the controller is working with a complete model or just a partial one.

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.
protected static RuntimeCapability<Void>	CLIENT_FACTORY_CAPABILITY Capability in-vm users of the controller use to create clients
static int	DEFAULT_BOOT_STACK_SIZE The default stack size for the thread used to process boot operations.
static RuntimeCapability<Void>	EXECUTOR_CAPABILITY Capability users of the controller use to perform asynchronous management tasks.
protected static RuntimeCapability<Void>	NOTIFICATION_REGISTRY_CAPABILITY Capability in-vm users of the controller use to register notification handlers
static RuntimeCapability<Void>	PATH_MANAGER_CAPABILITY Capability users of the controller use to coordinate changes to paths.
protected ProcessType	processType
protected ManagementSecurityIdentitySupplier	securityIdentitySupplier

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, ManagementSecurityIdentitySupplier securityIdentitySupplier) 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) 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, ManagementSecurityIdentitySupplier securityIdentitySupplier, CapabilityRegistry capabilityRegistry) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
protected void	acquireReadLock(int operationId)
protected void	boot(BootContext context) Boot the controller.
protected boolean	boot(List<org.jboss.dmr.ModelNode> bootOperations, boolean rollbackOnRuntimeFailure) Boot with the given operations, performing full model and capability registry validation.
protected boolean	boot(List<org.jboss.dmr.ModelNode> bootOperations, boolean rollbackOnRuntimeFailure, boolean skipModelValidation) Boot with the given operations, optionally disabling model and capability registry validation.
protected boolean	boot(List<org.jboss.dmr.ModelNode> bootOperations, boolean rollbackOnRuntimeFailure, boolean skipModelValidation, MutableRootResourceRegistrationProvider parallelBootRootResourceRegistrationProvider) Boot, optionally disabling model and capability registry validation, using the given provider for the root ManagementResourceRegistration.
protected boolean	boot(List<org.jboss.dmr.ModelNode> bootOperations, boolean rollbackOnRuntimeFailure, MutableRootResourceRegistrationProvider parallelBootRootResourceRegistrationProvider) Deprecated. internal use only only for use by legacy test controllers
protected void	bootThreadDone()
protected OperationStepHandler	createExtraValidationStepHandler()
protected org.jboss.dmr.ModelNode	executeReadOnlyOperation(org.jboss.dmr.ModelNode operation, ModelController.OperationTransactionControl control, OperationStepHandler prepareStep) 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
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 org.jboss.dmr.ModelNode	executeReadOnlyOperation(org.jboss.dmr.ModelNode operation, Resource model, ModelController.OperationTransactionControl control, OperationStepHandler prepareStep) Deprecated.
protected void	finishBoot()
protected ManagedAuditLogger	getAuditLogger()
protected BootErrorCollector	getBootErrorCollector()
protected org.jboss.msc.value.InjectedValue<AbstractControllerService.ControllerInstabilityListener>	getContainerInstabilityInjector()
org.jboss.msc.value.InjectedValue<ExecutorService>	getExecutorServiceInjector()
protected int	getMaxParallelBootExtensionTasks()
protected int	getMaxParallelBootSubsystemTasks()
protected AbstractControllerService.ModelControllerServiceInitializationParams	getModelControllerServiceInitializationParams() Override to return a AbstractControllerService.ModelControllerServiceInitializationParams.
protected MutableRootResourceRegistrationProvider	getMutableRootResourceRegistrationProvider()
protected NotificationSupport	getNotificationSupport()
protected AbstractControllerService.PartialModelIndicator	getPartialModelIndicator()
protected org.jboss.msc.service.StabilityMonitor	getStabilityMonitor()
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 OperationResponse	internalExecute(Operation operation, OperationMessageHandler handler, ModelController.OperationTransactionControl control, OperationStepHandler prepareStep, boolean attemptLock, boolean partialModel)
protected boolean	isExposingClientServicesAllowed() Gets whether this controller service should install a ModelControllerClientFactory and a NotificationHandlerRegistry as a service.
protected org.jboss.dmr.ModelNode	registerModelControllerServiceInitializationBootStep(BootContext context) Used to add the operation used to initialise the ModelControllerServiceInitialization instances.
protected void	releaseReadLock(int operationId)
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

Methods inherited from interface org.jboss.msc.Service

newInstance

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

CLIENT_FACTORY_CAPABILITY

protected static final RuntimeCapability<Void> CLIENT_FACTORY_CAPABILITY

Capability in-vm users of the controller use to create clients

NOTIFICATION_REGISTRY_CAPABILITY

protected static final RuntimeCapability<Void> NOTIFICATION_REGISTRY_CAPABILITY

Capability in-vm users of the controller use to register notification handlers

PATH_MANAGER_CAPABILITY

public static final RuntimeCapability<Void> PATH_MANAGER_CAPABILITY

Capability users of the controller use to coordinate changes to paths. This capability isn't necessarily directly related to this class but we declare it here as it's as good a place as any at this time.

EXECUTOR_CAPABILITY

public static final RuntimeCapability<Void> EXECUTOR_CAPABILITY

Capability users of the controller use to perform asynchronous management tasks. This capability isn't necessarily directly related to this class but we declare it here as it's as good a place as any at this time.

processType

protected final ProcessType processType

authorizer

protected final DelegatingConfigurableAuthorizer authorizer

securityIdentitySupplier

protected final ManagementSecurityIdentitySupplier securityIdentitySupplier

Constructor Detail

AbstractControllerService

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

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,
                                    ManagementSecurityIdentitySupplier securityIdentitySupplier,
                                    CapabilityRegistry capabilityRegistry)

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

authorizer - handles authorization

capabilityRegistry - the capability registry

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

AbstractControllerService

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

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

Throws:

org.jboss.msc.service.StartException

getMaxParallelBootExtensionTasks

protected int getMaxParallelBootExtensionTasks()

getMaxParallelBootSubsystemTasks

protected int getMaxParallelBootSubsystemTasks()

isExposingClientServicesAllowed

protected boolean isExposingClientServicesAllowed()

Gets whether this controller service should install a ModelControllerClientFactory and a NotificationHandlerRegistry as a service. Default is true; this method allows test infrastructure subclasses to turn this off.

Returns:

true if a service should be installed

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

Boot with the given operations, performing full model and capability registry validation.

Parameters:

bootOperations - the operations. Cannot be null

rollbackOnRuntimeFailure - true if the boot should fail if operations fail in the runtime stage

Returns:

true if boot was successful

Throws:

ConfigurationPersistenceException

boot

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

Boot with the given operations, optionally disabling model and capability registry validation.

Parameters:

bootOperations - the operations. Cannot be null

rollbackOnRuntimeFailure - true if the boot should fail if operations fail in the runtime stage

skipModelValidation - true if model and capability validation should be skipped.

Returns:

true if boot was successful

Throws:

ConfigurationPersistenceException

boot

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

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

Throws:

ConfigurationPersistenceException

boot

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

Boot, optionally disabling model and capability registry validation, using the given provider for the root ManagementResourceRegistration.

Parameters:

bootOperations - the operations. Cannot be null

rollbackOnRuntimeFailure - true if the boot should fail if operations fail in the runtime stage

skipModelValidation - true if model and capability validation should be skipped.

parallelBootRootResourceRegistrationProvider - provider of the root resource registration

Returns:

true if boot was successful

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)

internalExecute

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

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

executeReadOnlyOperation

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

Deprecated.

executeReadOnlyOperation

@Deprecated
protected org.jboss.dmr.ModelNode executeReadOnlyOperation(org.jboss.dmr.ModelNode operation,
                                                                       Resource model,
                                                                       ModelController.OperationTransactionControl control,
                                                                       OperationStepHandler prepareStep)

Deprecated.

finishBoot

protected void finishBoot()
                   throws ConfigurationPersistenceException

Throws:

ConfigurationPersistenceException

bootThreadDone

protected void bootThreadDone()

getNotificationSupport

protected NotificationSupport getNotificationSupport()

getMutableRootResourceRegistrationProvider

protected final MutableRootResourceRegistrationProvider getMutableRootResourceRegistrationProvider()

getPartialModelIndicator

protected AbstractControllerService.PartialModelIndicator getPartialModelIndicator()

getStabilityMonitor

protected final org.jboss.msc.service.StabilityMonitor getStabilityMonitor()

stop

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

Specified by:

stop in interface org.jboss.msc.Service

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()

getContainerInstabilityInjector

protected org.jboss.msc.value.InjectedValue<AbstractControllerService.ControllerInstabilityListener> getContainerInstabilityInjector()

setConfigurationPersister

protected void setConfigurationPersister(ConfigurationPersister persister)

initModel

protected abstract void initModel(ManagementModel managementModel,
                                  Resource modelControllerResource)

getAuditLogger

protected ManagedAuditLogger getAuditLogger()

getBootErrorCollector

protected BootErrorCollector getBootErrorCollector()

createExtraValidationStepHandler

protected OperationStepHandler createExtraValidationStepHandler()

acquireReadLock

protected void acquireReadLock(int operationId)
                        throws InterruptedException

Throws:

InterruptedException

releaseReadLock

protected void releaseReadLock(int operationId)

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