Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• 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.capability.AbstractCapability Will be made non-public in a future release.
org.jboss.as.controller.operations.validation.AbstractParameterValidator Adds no value versus implementing the interface directly
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

Deprecated Fields

Field and Description
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.AbstractCapability.addressValueToDynamicName(PathAddress) Will be made non-public in a future release.
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.PersistentResourceXMLParser.cacheXMLDescription() Experimental; for internal use only. May be removed at any time.
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.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.PersistentResourceXMLDescription.decorator(String) decorator element support is currently considered as preview
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.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.capability.Capability.getDynamicOptionalRequirements() Never returns anything but an empty set and likely will be removed in the next release.
org.jboss.as.controller.capability.Capability.getDynamicRequirements() Never returns anything but an empty set and likely will be removed in the next release.
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.capability.Capability.getOptionalRequirements() Never returns anything but an empty set and likely will be removed in the next release.
org.jboss.as.controller.capability.Capability.getRuntimeOnlyRequirements() Never returns anything but an empty set and likely will be removed in the next release.
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.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.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.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 a ParameterValidator does not have access to all expression resolution sources

Deprecated Constructors

Constructor and Description
org.jboss.as.controller.capability.AbstractCapability(String, boolean, Set<String>, Set<String>, Set<String>, Set<String>, Set<String>, Function<PathAddress, String[]>) Expected to be removed or hidden in the next WildFly Core release
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.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.operations.validation.OperationValidator(ImmutableManagementResourceRegistration, boolean, boolean)
org.jboss.as.controller.operations.validation.OperationValidator(ImmutableManagementResourceRegistration, boolean, boolean, boolean)
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.SimpleAttributeDefinition(String, ModelType, boolean) 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)