Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
org.jboss.as.controller.extension.ExtensionContextSupplement for internal use only; may be removed at any time

Deprecated Classes

Class and Description
org.jboss.as.controller.transform.AliasOperationTransformer
org.jboss.as.controller.access.Caller Replaced by the Elytron SecurityIdentity
org.jboss.as.controller.CurrentOperationIdHolder internal usage only
org.jboss.as.controller.operations.validation.ParametersOfValidator use ObjectTypeValidator and ObjectTypeAttributeDefinition
org.jboss.as.controller.ServiceVerificationHandler has no function and will be removed in a later release

Deprecated Exceptions

Exceptions and Description
org.jboss.as.controller.NoSuchResourceException use parent class Resource.NoSuchResourceException

Deprecated Fields

Field and Description
org.jboss.as.controller.CompositeOperationHandler.DOMAIN_EXECUTION_KEY
org.jboss.as.controller.operations.common.InterfaceRemoveHandler.INSTANCE
org.jboss.as.controller.operations.common.InterfaceAddHandler.NAMED_INSTANCE
org.jboss.as.controller.services.path.PathManagerService.SERVICE_NAME ServiceName should be obtained from capability
org.jboss.as.controller.operations.common.InterfaceAddHandler.SPECIFIED_INSTANCE

Deprecated Methods

Method and Description
org.jboss.as.controller.AttributeDefinition.addCapabilityRequirements(OperationContext, ModelNode) use @{link AttributeDefinition.addCapabilityRequirements(OperationContext, Resource, ModelNode)} variant
org.jboss.as.controller.CapabilityReferenceRecorder.addCapabilityRequirements(OperationContext, String, String...) use @{link CapabilityReferenceRecorder.addCapabilityRequirements(OperationContext, Resource, String, String...)} instead
org.jboss.as.controller.CapabilityReferenceRecorder.DefaultCapabilityReferenceRecorder.addCapabilityRequirements(OperationContext, String, String...)
org.jboss.as.controller.capability.RuntimeCapability.Builder.addDynamicOptionalRequirements(String...) nothing is currently done with this data and unless a true use is implemented this method may be removed
org.jboss.as.controller.capability.RuntimeCapability.Builder.addDynamicRequirements(String...) nothing is currently done with this data and unless a true use is implemented this method may be removed
org.jboss.as.controller.capability.RuntimeCapability.Builder.addOptionalRequirements(String...) nothing is currently done with this data and unless a true use is implemented this method may be removed
org.jboss.as.controller.capability.RuntimeCapability.Builder.addRuntimeOnlyRequirements(String...) nothing is currently done with this data and unless a true use is implemented this method may be removed
org.jboss.as.controller.ObjectTypeAttributeDefinition.addValueTypeDescription(ModelNode, String, ResourceBundle, ResourceDescriptionResolver, Locale) use #addValueTypeDescription(ModelNode, String, ResourceBundle, boolean, ResourceDescriptionResolver, Locale)
org.jboss.as.controller.AbstractControllerService.boot(List<ModelNode>, boolean, MutableRootResourceRegistrationProvider) internal use only only for use by legacy test controllers
org.jboss.as.controller.transform.description.ChainedTransformationDescriptionBuilder.buildAndRegister(SubsystemRegistration, ModelVersion[]...) use #buildAndRegister(SubsystemTransformerRegistration, ModelVersion[]...) instead
org.jboss.as.controller.PersistentResourceXMLDescription.builder(PersistentResourceDefinition) please use PersistentResourceXMLBuilder(PathElement, String) variant
org.jboss.as.controller.PersistentResourceXMLDescription.builder(PersistentResourceDefinition, String) please use PersistentResourceXMLBuilder(PathElement, String) variant
org.jboss.as.controller.PersistentResourceXMLDescription.builder(ResourceDefinition) please use PersistentResourceXMLBuilder(PathElement, String) variant
org.jboss.as.controller.registry.AliasEntry.convertToTargetAddress(PathAddress) This will be removed in WildFly Core 3; override convertToTargetAddress(PathAddress, AliasContext) instead
org.jboss.as.controller.registry.ManagementResourceRegistration.Factory.create(DescriptionProvider) DescriptionProvider shouldn't be used anymore, use ResourceDefinition variant
org.jboss.as.controller.registry.ManagementResourceRegistration.Factory.create(DescriptionProvider, AccessConstraintUtilizationRegistry) DescriptionProvider shouldn't be used anymore, use ResourceDefinition variant
org.jboss.as.controller.remote.RemoteProxyController.create(ManagementChannelHandler, PathAddress, ProxyOperationAddressTranslator) only present for test case use
org.jboss.as.controller.registry.ManagementResourceRegistration.Factory.create(ResourceDefinition)
org.jboss.as.controller.registry.ManagementResourceRegistration.Factory.create(ResourceDefinition, AccessConstraintUtilizationRegistry) use ManagementResourceRegistration.Factory.create(ResourceDefinition, AccessConstraintUtilizationRegistry, CapabilityRegistry)
org.jboss.as.controller.registry.ManagementResourceRegistration.Factory.create(ResourceDefinition, AccessConstraintUtilizationRegistry, CapabilityRegistry)
org.jboss.as.controller.ModelController.createClient(Executor) Use ModelControllerClientFactory. Will be removed in the next major or minor release.
org.jboss.as.controller.services.path.PathResourceDefinition.createNamed(PathManagerService) only for use by the kernel. May be removed at any time.
org.jboss.as.controller.services.path.PathResourceDefinition.createSpecifiedNoServices(PathManagerService) only for use by the kernel. May be removed at any time
org.jboss.as.controller.AccessAuditContext.currentAccessAuditContext() Internal use, will be changed without warning at any time.
org.jboss.as.controller.AbstractControllerService.executeReadOnlyOperation(ModelNode, ModelController.OperationTransactionControl, OperationStepHandler)
org.jboss.as.controller.AbstractControllerService.executeReadOnlyOperation(ModelNode, OperationMessageHandler, ModelController.OperationTransactionControl, OperationAttachments, OperationStepHandler, int) internal use only and only by legacy test controllers
org.jboss.as.controller.AbstractControllerService.executeReadOnlyOperation(ModelNode, OperationMessageHandler, ModelController.OperationTransactionControl, OperationStepHandler, int) internal use only
org.jboss.as.controller.AbstractControllerService.executeReadOnlyOperation(ModelNode, Resource, ModelController.OperationTransactionControl, OperationStepHandler)
org.jboss.as.controller.capability.RuntimeCapability.fromBaseCapability(RuntimeCapability<T>, String) use RuntimeCapability.fromBaseCapability(String...) on base
org.jboss.as.controller.CapabilityReferenceRecorder.getBaseDependentName() No longer required and may throw UnsupportedOperationException
org.jboss.as.controller.OperationContext.getCaller() Use OperationContext.getSecurityIdentity() instead.
org.jboss.as.controller.extension.ExtensionRegistry.getExtensionContext(String, ManagementResourceRegistration, boolean) use ExtensionRegistry.getExtensionContext(String, ManagementResourceRegistration, ExtensionRegistryType). Main code should be using this, but this is left behind in case any tests need to use this code.
org.jboss.as.controller.operations.common.GenericSubsystemDescribeHandler.getModelDescription(Locale) use GenericSubsystemDescribeHandler.DEFINITION for registration of operation
org.jboss.as.controller.ModelController.getNotificationRegistry() Use NotificationHandlerRegistry. Will be removed in the next major or minor release.
org.jboss.as.controller.AbstractAttributeDefinitionBuilder.getNullSignficant() Use AbstractAttributeDefinitionBuilder.getNullSignificant().
org.jboss.as.controller.AbstractControllerService.internalExecute(ModelNode, OperationMessageHandler, ModelController.OperationTransactionControl, OperationAttachments, OperationStepHandler) internal use only only for use by legacy test controllers
org.jboss.as.controller.AttributeDefinition.isAllowNull() use either AttributeDefinition.isRequired() or AttributeDefinition.isNillable() depending on which provides the desired information
org.jboss.as.controller.CapabilityReferenceRecorder.isDynamicDependent() No longer required and may throw UnsupportedOperationException
org.jboss.as.controller.ExtensionContext.isRegisterTransformers() Experimental, the way transformers are registered may change to be the same as we do for parsers
org.jboss.as.controller.AbstractAttributeDefinitionBuilder.isValidateNull() meaningless and not used.
org.jboss.as.controller.AttributeDefinition.isValidatingNull() this is no longer configurable, so this getter may be removed in a future major release.
org.jboss.as.controller.DefaultAttributeMarshaller.marshallAsElement(AttributeDefinition, ModelNode, XMLStreamWriter)
org.jboss.as.controller.services.path.ResolvePathHandler.Builder.of(String, PathManager)
org.jboss.as.controller.PropertiesAttributeDefinition.parse(XMLExtendedStreamReader, ModelNode)
org.jboss.as.controller.ListAttributeDefinition.parseAndSetParameter(String, ModelNode, XMLStreamReader) in favour of using attribute parser
org.jboss.as.controller.AbstractBoottimeAddStepHandler.performBoottime(OperationContext, ModelNode, ModelNode, ServiceVerificationHandler, List<ServiceController<?>>)
org.jboss.as.controller.AbstractBoottimeAddStepHandler.performRuntime(OperationContext, ModelNode, ModelNode, ServiceVerificationHandler, List<ServiceController<?>>) subclasses should override AbstractBoottimeAddStepHandler.performBoottime(OperationContext, org.jboss.dmr.ModelNode, org.jboss.as.controller.registry.Resource)
org.jboss.as.controller.AbstractAddStepHandler.performRuntime(OperationContext, ModelNode, ModelNode, ServiceVerificationHandler, List<ServiceController<?>>) instead override one of the non-deprecated overloaded variants
org.jboss.as.controller.RestartParentWriteAttributeHandler.recreateParentService(OperationContext, PathAddress, ModelNode, ServiceVerificationHandler) override RestartParentWriteAttributeHandler.recreateParentService(OperationContext, PathAddress, org.jboss.dmr.ModelNode)
org.jboss.as.controller.RestartParentResourceHandlerBase.recreateParentService(OperationContext, PathAddress, ModelNode, ServiceVerificationHandler) override RestartParentResourceHandlerBase.recreateParentService(OperationContext, PathAddress, org.jboss.dmr.ModelNode)
org.jboss.as.controller.transform.description.TransformationDescription.Tools.register(TransformationDescription, SubsystemRegistration, ModelVersion...)
org.jboss.as.controller.transform.description.TransformationDescription.Tools.register(TransformationDescription, SubsystemRegistration, ModelVersionRange)
org.jboss.as.controller.SimpleResourceDefinition.registerAddOperation(ManagementResourceRegistration, OperationStepHandler, OperationEntry.Flag...) use SimpleResourceDefinition.registerAddOperation(org.jboss.as.controller.registry.ManagementResourceRegistration, AbstractAddStepHandler, org.jboss.as.controller.registry.OperationEntry.Flag...)
org.jboss.as.controller.OperationContext.registerCapability(RuntimeCapability, String) use OperationContext.registerCapability(RuntimeCapability)
org.jboss.as.controller.SubsystemRegistration.registerModelTransformers(ModelVersionRange, CombinedTransformer) use SubsystemTransformerRegistration
org.jboss.as.controller.SubsystemRegistration.registerModelTransformers(ModelVersionRange, ResourceTransformer) use SubsystemTransformerRegistration
org.jboss.as.controller.SubsystemRegistration.registerModelTransformers(ModelVersionRange, ResourceTransformer, OperationTransformer) use SubsystemRegistration.registerModelTransformers(ModelVersionRange, ResourceTransformer, OperationTransformer, boolean)
org.jboss.as.controller.SubsystemRegistration.registerModelTransformers(ModelVersionRange, ResourceTransformer, OperationTransformer, boolean) use SubsystemTransformerRegistration
org.jboss.as.controller.SimpleResourceDefinition.registerRemoveOperation(ManagementResourceRegistration, OperationStepHandler, OperationEntry.Flag...)
org.jboss.as.controller.ExtensionContext.registerSubsystem(String, int, int) ExtensionContext.registerSubsystem(String, ModelVersion)
org.jboss.as.controller.ExtensionContext.registerSubsystem(String, int, int, int) ExtensionContext.registerSubsystem(String, ModelVersion)
org.jboss.as.controller.ExtensionContext.registerSubsystem(String, int, int, int, boolean) ExtensionContext.registerSubsystem(String, ModelVersion, boolean)
org.jboss.as.controller.AttributeDefinition.removeCapabilityRequirements(OperationContext, ModelNode) use AttributeDefinition.removeCapabilityRequirements(OperationContext, Resource, ModelNode) variant
org.jboss.as.controller.CapabilityReferenceRecorder.removeCapabilityRequirements(OperationContext, String, String...)
org.jboss.as.controller.CapabilityReferenceRecorder.DefaultCapabilityReferenceRecorder.removeCapabilityRequirements(OperationContext, String, String...)
org.jboss.as.controller.AbstractRemoveStepHandler.requireNoChildResources() never called; this handler now always removes child resources
org.jboss.as.controller.AbstractAddStepHandler.requiresRuntimeVerification() has no effect
org.jboss.as.controller.AbstractBoottimeAddStepHandler.rollbackRuntime(OperationContext, ModelNode, ModelNode, List<ServiceController<?>>)
org.jboss.as.controller.AbstractAddStepHandler.rollbackRuntime(OperationContext, ModelNode, ModelNode, List<ServiceController<?>>) instead override AbstractAddStepHandler.rollbackRuntime(OperationContext, org.jboss.dmr.ModelNode, org.jboss.as.controller.registry.Resource)
org.jboss.as.controller.AbstractAttributeDefinitionBuilder.setAllowNull(boolean) use AbstractAttributeDefinitionBuilder.setRequired(boolean)
org.jboss.as.controller.AbstractAttributeDefinitionBuilder.setNullSignficant(boolean) Use AbstractAttributeDefinitionBuilder.setNullSignificant(boolean).
org.jboss.as.controller.registry.ManagementResourceRegistration.setRuntimeOnly(boolean) this property should be controlled by ResourceDefinition.isRuntime()
org.jboss.as.controller.parsing.ExtensionParsingContext.setSubsystemXmlMapping(String, String, XMLElementReader<List<ModelNode>>) Use ExtensionParsingContext.setSubsystemXmlMapping(java.lang.String, java.lang.String, java.util.function.Supplier) instead.
org.jboss.as.controller.AbstractAttributeDefinitionBuilder.setValidateNull(boolean) has no effect
org.jboss.as.controller.PropertiesAttributeDefinition.Builder.setWrapperElement(String) use setParser(new AttributeParser.PropertiesParsers(wrapper)
org.jboss.as.controller.PropertiesAttributeDefinition.Builder.setWrapXmlElement(boolean) use setParser(new AttributeParser.PropertiesParsers(wrapper)
org.jboss.as.controller.PropertiesAttributeDefinition.Builder.setXmlName(String) use setParser(new AttributeParser.PropertiesParsers(wrapper)
org.jboss.as.controller.OperationContext.stepCompleted() invoking this method is unnecessary since if an OperationStepHandler does not call one of the variants from its execute method, a no-op ResultHandler will automatically be registered
org.jboss.as.controller.operations.validation.ParametersValidator.validateResolved(ModelNode) use ParametersValidator.validate(ModelNode)
org.jboss.as.controller.operations.validation.ParameterValidator.validateResolvedParameter(String, ModelNode) Callers should resolve the value themselves with an ExpressionResolver and then use ParameterValidator.validateParameter(String, ModelNode) since ModelNode.resolve() is not an adequate expression resolution approach

Deprecated Constructors

Constructor and Description
org.jboss.as.controller.AbstractControllerService(ProcessType, RunningModeControl, ConfigurationPersister, ControlledProcessState, DescriptionProvider, OperationStepHandler, ExpressionResolver) Here for backwards compatibility for ModelTestModelControllerService
org.jboss.as.controller.AbstractControllerService(ProcessType, RunningModeControl, ConfigurationPersister, ControlledProcessState, DescriptionProvider, OperationStepHandler, ExpressionResolver, ManagedAuditLogger, DelegatingConfigurableAuthorizer, ManagementSecurityIdentitySupplier)
org.jboss.as.controller.AbstractControllerService(ProcessType, RunningModeControl, ConfigurationPersister, ControlledProcessState, ResourceDefinition, OperationStepHandler, ExpressionResolver) Here for backwards compatibility for ModelTestModelControllerService
org.jboss.as.controller.AbstractControllerService(ProcessType, RunningModeControl, ConfigurationPersister, ControlledProcessState, ResourceDefinition, OperationStepHandler, ExpressionResolver, ManagedAuditLogger, DelegatingConfigurableAuthorizer) Here for backwards compatibility for ModelTestModelControllerService
org.jboss.as.controller.transform.DiscardAttributesTransformer(AttributeDefinition...) use a variant that takes a DiscardAttributesTransformer.DiscardApprover
org.jboss.as.controller.transform.DiscardAttributesTransformer(Set<String>) use a variant that takes a DiscardAttributesTransformer.DiscardApprover
org.jboss.as.controller.transform.DiscardAttributesTransformer(String...) use a variant that takes a DiscardAttributesTransformer.DiscardApprover
org.jboss.as.controller.extension.ExtensionRegistry(ProcessType, RunningModeControl) Here for core-model-test and subsystem-test backwards compatibility
org.jboss.as.controller.ListAttributeDefinition(String, boolean, ParameterValidator)
org.jboss.as.controller.ListAttributeDefinition(String, boolean, ParameterValidator, AttributeAccess.Flag...)
org.jboss.as.controller.MapAttributeDefinition(String, boolean, ParameterValidator)
org.jboss.as.controller.OperationDefinition(String, OperationEntry.EntryType, EnumSet<OperationEntry.Flag>, ModelType, ModelType, boolean, DeprecationData, AttributeDefinition[], AttributeDefinition[], AccessConstraintDefinition...) use OperationDefinition.OperationDefinition(SimpleOperationDefinitionBuilder)
org.jboss.as.controller.OperationFailedException(ModelNode) provide a message and use OperationFailedException.OperationFailedException(String, org.jboss.dmr.ModelNode) or if the description model node is ModelType.STRING, just use OperationFailedException.OperationFailedException(String)
org.jboss.as.controller.services.path.PathAddHandler(PathManagerService, boolean, SimpleAttributeDefinition) not for use outside the kernel; may be removed at any time
org.jboss.as.controller.services.path.PathRemoveHandler(PathManagerService, boolean) not for use outside the kernel; may be removed at any time
org.jboss.as.controller.capability.RuntimeCapability(String, T, Set<String>) use a RuntimeCapability.Builder
org.jboss.as.controller.capability.RuntimeCapability(String, T, Set<String>, Set<String>) use a RuntimeCapability.Builder
org.jboss.as.controller.capability.RuntimeCapability(String, T, String...) use a RuntimeCapability.Builder
org.jboss.as.controller.SimpleOperationDefinition(String, ResourceDescriptionResolver, EnumSet<OperationEntry.Flag>) use SimpleOperationDefinitionBuilder
org.jboss.as.controller.SimpleOperationDefinition(String, ResourceDescriptionResolver, OperationEntry.EntryType, EnumSet<OperationEntry.Flag>) use SimpleOperationDefinitionBuilder
org.jboss.as.controller.SimpleOperationDefinition(String, ResourceDescriptionResolver, OperationEntry.EntryType, EnumSet<OperationEntry.Flag>, AttributeDefinition...) use SimpleOperationDefinitionBuilder
org.jboss.as.controller.SimpleOperationDefinition(String, ResourceDescriptionResolver, ResourceDescriptionResolver, OperationEntry.EntryType, EnumSet<OperationEntry.Flag>, ModelType, ModelType, boolean, DeprecationData, AttributeDefinition[], AttributeDefinition...) use SimpleOperationDefinitionBuilder
org.jboss.as.controller.SimpleOperationDefinition(String, ResourceDescriptionResolver, ResourceDescriptionResolver, OperationEntry.EntryType, EnumSet<OperationEntry.Flag>, ModelType, ModelType, boolean, DeprecationData, AttributeDefinition[], AttributeDefinition[], AccessConstraintDefinition[]) use SimpleOperationDefinitionBuilder
org.jboss.as.controller.SimpleResourceDefinition(PathElement, DescriptionProvider) Use SimpleResourceDefinition.SimpleResourceDefinition(Parameters)
org.jboss.as.controller.SimpleResourceDefinition(PathElement, ResourceDescriptionResolver, boolean) Use SimpleResourceDefinition.SimpleResourceDefinition(Parameters)
org.jboss.as.controller.SimpleResourceDefinition(PathElement, ResourceDescriptionResolver, OperationStepHandler, OperationStepHandler, boolean) Use SimpleResourceDefinition.SimpleResourceDefinition(Parameters)
org.jboss.as.controller.SimpleResourceDefinition(PathElement, ResourceDescriptionResolver, OperationStepHandler, OperationStepHandler, DeprecationData) Use SimpleResourceDefinition.SimpleResourceDefinition(Parameters)
org.jboss.as.controller.SimpleResourceDefinition(PathElement, ResourceDescriptionResolver, OperationStepHandler, OperationStepHandler, OperationEntry.Flag, OperationEntry.Flag) Use SimpleResourceDefinition.SimpleResourceDefinition(Parameters)
org.jboss.as.controller.SimpleResourceDefinition(PathElement, ResourceDescriptionResolver, OperationStepHandler, OperationStepHandler, OperationEntry.Flag, OperationEntry.Flag, DeprecationData) Use SimpleResourceDefinition.SimpleResourceDefinition(Parameters)
org.jboss.as.controller.SimpleResourceDefinition(PathElement, ResourceDescriptionResolver, OperationStepHandler, OperationStepHandler, OperationEntry.Flag, OperationEntry.Flag, DeprecationData, boolean) Use SimpleResourceDefinition.SimpleResourceDefinition(Parameters)