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.registry.ManagementResourceRegistration.Factory.DEFAULT use ManagementResourceRegistration.Factory.forProcessType(ProcessType).
org.jboss.as.controller.CompositeOperationHandler.DOMAIN_EXECUTION_KEY
org.jboss.as.controller.AttributeParser.LIST
org.jboss.as.controller.services.path.PathManagerService.SERVICE_NAME ServiceName should be obtained from capability

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.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.operations.validation.EnumValidator.create(Class<E>, boolean, boolean) use EnumValidator.create(Class, EnumSet) with EnumSet.allOf(Class) since AttributeDefinition handles the nullable and expression checks.
org.jboss.as.controller.operations.validation.EnumValidator.create(Class<E>, boolean, boolean, E...) use EnumValidator.create(Class, Enum[]) since AttributeDefinition handles the nullable and expression checks.
org.jboss.as.controller.operations.validation.EnumValidator.create(Class<E>, boolean, E...) use EnumValidator.create(Class, Enum[]) since AttributeDefinition handles the nullable check.
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) use ManagementResourceRegistration.Factory.forProcessType(ProcessType).
org.jboss.as.controller.registry.ManagementResourceRegistration.Factory.create(ResourceDefinition, AccessConstraintUtilizationRegistry, CapabilityRegistry) use ManagementResourceRegistration.Factory.forProcessType(ProcessType).
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.AttributeDefinition.getAttributeMarshaller() use AttributeDefinition.getMarshaller()
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.AttributeDefinition.getFlags() In the next release, the return type of this method will become simply Set and the returned object will be immutable, so any callers should update their code to reflect that
org.jboss.as.controller.AttributeDefinition.getImmutableFlags() for internal use only; will be dropped when the semantic of AttributeDefinition.getFlags() is changed to return an immutable Set
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() Use ExtensionTransformerRegistration
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.SimpleAttributeDefinition.marshallAsElement(ModelNode, boolean, XMLStreamWriter)
org.jboss.as.controller.services.path.ResolvePathHandler.Builder.of(String, PathManager)
org.jboss.as.controller.SimpleAttributeDefinition.parse(String, XMLStreamReader) use AttributeDefinition.getParser()
org.jboss.as.controller.ListAttributeDefinition.parse(String, XMLStreamReader) use AttributeDefinition.getParser()
org.jboss.as.controller.PropertiesAttributeDefinition.parse(XMLExtendedStreamReader, ModelNode)
org.jboss.as.controller.ListAttributeDefinition.parseAndAddParameterElement(String, ModelNode, XMLStreamReader) use AttributeDefinition.getParser()
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.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.persistence.SubsystemXmlWriterRegistry.registerSubsystemWriter(String, XMLElementWriter<SubsystemMarshallingContext>) use SubsystemXmlWriterRegistry.registerSubsystemWriter(String, Supplier) variant
org.jboss.as.controller.SubsystemRegistration.registerXMLElementWriter(XMLElementWriter<SubsystemMarshallingContext>) use the SubsystemRegistration.registerXMLElementWriter(Supplier) variant
org.jboss.as.controller.AttributeDefinition.removeCapabilityRequirements(OperationContext, ModelNode) use AttributeDefinition.removeCapabilityRequirements(OperationContext, Resource, ModelNode) variant
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.AttributeDefinition(String, String, ModelNode, ModelType, boolean, boolean, MeasurementUnit, ParameterCorrector, ParameterValidator, boolean, String[], String[], AttributeMarshaller, boolean, DeprecationData, AccessConstraintDefinition[], Boolean, AttributeParser, AttributeAccess.Flag...) use AbstractAttributeDefinitionBuilder
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.operations.validation.EnumValidator(Class<E>, boolean, boolean) use EnumValidator.EnumValidator(Class, EnumSet) with EnumSet.allOf(Class) since AttributeDefinition handles the nullable and expression checks.
org.jboss.as.controller.operations.validation.EnumValidator(Class<E>, boolean, boolean, E...) use EnumValidator.EnumValidator(Class, Enum[]) with EnumSet.allOf(Class) since AttributeDefinition handles the nullable and expression checks.
org.jboss.as.controller.operations.validation.EnumValidator(Class<E>, boolean, E...) use EnumValidator.EnumValidator(Class, Enum[]) with EnumSet.allOf(Class) since AttributeDefinition handles the nullable and expressions checks.
org.jboss.as.controller.extension.ExtensionRegistry(ProcessType, RunningModeControl) Here for core-model-test and subsystem-test backwards compatibility
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.SimpleAttributeDefinition(String, ModelNode, ModelType, boolean) use SimpleAttributeDefinitionBuilder
org.jboss.as.controller.SimpleAttributeDefinition(String, ModelNode, ModelType, boolean, AttributeAccess.Flag...) use SimpleAttributeDefinitionBuilder
org.jboss.as.controller.SimpleAttributeDefinition(String, ModelType, boolean) use SimpleAttributeDefinitionBuilder
org.jboss.as.controller.SimpleAttributeDefinition(String, ModelType, boolean, AttributeAccess.Flag...) use SimpleAttributeDefinitionBuilder
org.jboss.as.controller.SimpleAttributeDefinition(String, ModelType, boolean, MeasurementUnit) use SimpleAttributeDefinitionBuilder
org.jboss.as.controller.SimpleAttributeDefinition(String, ModelType, boolean, MeasurementUnit, AttributeAccess.Flag...) use SimpleAttributeDefinitionBuilder
org.jboss.as.controller.SimpleOperationDefinition(String, ResourceDescriptionResolver) use SimpleOperationDefinitionBuilder
org.jboss.as.controller.SimpleOperationDefinition(String, ResourceDescriptionResolver, AttributeDefinition...) use SimpleOperationDefinitionBuilder
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)