public interface ManagementResourceRegistration extends ImmutableManagementResourceRegistration
Modifier and Type | Interface and Description |
---|---|
static class |
ManagementResourceRegistration.Factory
A factory for creating a new, root model node registration.
|
ACCESS_PERMISSION
Modifier and Type | Method and Description |
---|---|
ManagementResourceRegistration |
getOverrideModel(String name)
Get a specifically named resource that overrides this
wildcard registration
by adding additional attributes, operations or child types. |
ManagementResourceRegistration |
getSubModel(PathAddress address)
Get a sub model registration.
|
boolean |
isAllowsOverride()
Gets whether this registration will always throw an exception if
registerOverrideModel(String, OverrideDescriptionProvider) is invoked. |
void |
registerAlias(PathElement address,
AliasEntry aliasEntry)
Register an alias registration to another part of the model
|
void |
registerMetric(AttributeDefinition definition,
OperationStepHandler metricHandler)
Records that the given attribute is a metric.
|
void |
registerMetric(String attributeName,
OperationStepHandler metricHandler)
|
void |
registerMetric(String attributeName,
OperationStepHandler metricHandler,
EnumSet<AttributeAccess.Flag> flags)
|
void |
registerOperationHandler(OperationDefinition definition,
OperationStepHandler handler)
Register an operation handler for this resource.
|
void |
registerOperationHandler(OperationDefinition definition,
OperationStepHandler handler,
boolean inherited)
Register an operation handler for this resource.
|
void |
registerOperationHandler(String operationName,
OperationStepHandler handler,
DescriptionProvider descriptionProvider)
|
void |
registerOperationHandler(String operationName,
OperationStepHandler handler,
DescriptionProvider descriptionProvider,
boolean inherited)
|
void |
registerOperationHandler(String operationName,
OperationStepHandler handler,
DescriptionProvider descriptionProvider,
boolean inherited,
EnumSet<OperationEntry.Flag> flags)
|
void |
registerOperationHandler(String operationName,
OperationStepHandler handler,
DescriptionProvider descriptionProvider,
boolean inherited,
OperationEntry.EntryType entryType)
|
void |
registerOperationHandler(String operationName,
OperationStepHandler handler,
DescriptionProvider descriptionProvider,
boolean inherited,
OperationEntry.EntryType entryType,
EnumSet<OperationEntry.Flag> flags)
|
void |
registerOperationHandler(String operationName,
OperationStepHandler handler,
DescriptionProvider descriptionProvider,
EnumSet<OperationEntry.Flag> flags)
|
ManagementResourceRegistration |
registerOverrideModel(String name,
OverrideDescriptionProvider descriptionProvider)
Register a specifically named resource that overrides this
wildcard registration
by adding additional attributes, operations or child types. |
void |
registerProxyController(PathElement address,
ProxyController proxyController)
Register a proxy controller.
|
void |
registerReadOnlyAttribute(AttributeDefinition definition,
OperationStepHandler readHandler)
Records that the given attribute can be read from but not written to, and
optionally provides an operation handler for the read.
|
void |
registerReadOnlyAttribute(String attributeName,
OperationStepHandler readHandler,
AttributeAccess.Storage storage)
|
void |
registerReadOnlyAttribute(String attributeName,
OperationStepHandler readHandler,
EnumSet<AttributeAccess.Flag> flags)
|
void |
registerReadWriteAttribute(AttributeDefinition definition,
OperationStepHandler readHandler,
OperationStepHandler writeHandler)
Records that the given attribute can be both read from and written to, and
provides operation handlers for the read and the write.
|
void |
registerReadWriteAttribute(String attributeName,
OperationStepHandler readHandler,
OperationStepHandler writeHandler,
AttributeAccess.Storage storage)
|
void |
registerReadWriteAttribute(String attributeName,
OperationStepHandler readHandler,
OperationStepHandler writeHandler,
EnumSet<AttributeAccess.Flag> flags)
|
ManagementResourceRegistration |
registerSubModel(PathElement address,
DescriptionProvider descriptionProvider)
Deprecated.
|
ManagementResourceRegistration |
registerSubModel(ResourceDefinition resourceDefinition)
Register the existence of an addressable sub-resource of this resource.
|
void |
setRuntimeOnly(boolean runtimeOnly)
Sets whether this model node only exists in the runtime and has no representation in the
persistent configuration model.
|
void |
unregisterAlias(PathElement address)
Unregister an alias
|
void |
unregisterAttribute(String attributeName)
Remove that the given attribute if present.
|
void |
unregisterOperationHandler(String operationName)
Unregister an operation handler for this resource.
|
void |
unregisterOverrideModel(String name)
Unregister a specifically named resource that overrides a
wildcard registration
by adding additional attributes, operations or child types. |
void |
unregisterProxyController(PathElement address)
Unregister a proxy controller
|
void |
unregisterSubModel(PathElement address)
Unregister the existence of an addressable sub-resource of this resource.
|
getAccessConstraints, getAliasEntry, getAttributeAccess, getAttributeNames, getChildAddresses, getChildNames, getModelDescription, getOperationDescription, getOperationDescriptions, getOperationEntry, getOperationFlags, getOperationHandler, getProxyController, getProxyControllers, isAlias, isRemote, isRuntimeOnly
ManagementResourceRegistration getOverrideModel(String name)
wildcard registration
by adding additional attributes, operations or child types.name
- the specific name of the resource. Cannot be null
or PathElement.WILDCARD_VALUE
null
if there is noneSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
ManagementResourceRegistration getSubModel(PathAddress address)
This method overrides the superinterface method of the same name in order to require that the returned registration be mutable.
getSubModel
in interface ImmutableManagementResourceRegistration
address
- the address, relative to this nodenull
if there is noneSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated ManagementResourceRegistration registerSubModel(PathElement address, DescriptionProvider descriptionProvider)
registerSubModel(org.jboss.as.controller.ResourceDefinition)
address
- the address of the submodel (may include a wildcard)descriptionProvider
- source for descriptive information describing this
portion of the model (must not be null
)IllegalArgumentException
- if a submodel is already registered at address
IllegalStateException
- if ImmutableManagementResourceRegistration.isRuntimeOnly()
returns true
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
ManagementResourceRegistration registerSubModel(ResourceDefinition resourceDefinition)
resourceDefinition
will be given the opportunity to
register attributes
and register operations
.resourceDefinition
- source for descriptive information describing this
portion of the model (must not be null
)IllegalArgumentException
- if a submodel is already registered at address
IllegalStateException
- if ImmutableManagementResourceRegistration.isRuntimeOnly()
returns true
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void unregisterSubModel(PathElement address)
address
- the child of this registry that should no longer be availableSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
boolean isAllowsOverride()
registerOverrideModel(String, OverrideDescriptionProvider)
is invoked. An exception will always
be thrown for root resource registrations, non-wildcard registrations
, or
remote registrations
.true
if an exception will not always be thrown; false
if it willSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void setRuntimeOnly(boolean runtimeOnly)
runtimeOnly
- true
if the model node will have no representation in the
persistent configuration model; false
otherwiseSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
ManagementResourceRegistration registerOverrideModel(String name, OverrideDescriptionProvider descriptionProvider)
wildcard registration
by adding additional attributes, operations or child types.name
- the specific name of the resource. Cannot be null
or PathElement.WILDCARD_VALUE
descriptionProvider
- provider for descriptions of the additional attributes or child typesIllegalArgumentException
- if either parameter is null or if there is already a registration under name
IllegalStateException
- if ImmutableManagementResourceRegistration.isRuntimeOnly()
returns true
or if isAllowsOverride()
returns falseSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void unregisterOverrideModel(String name)
wildcard registration
by adding additional attributes, operations or child types.name
- the specific name of the resource. Cannot be null
or PathElement.WILDCARD_VALUE
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated void registerOperationHandler(String operationName, OperationStepHandler handler, DescriptionProvider descriptionProvider)
registerOperationHandler(org.jboss.as.controller.OperationDefinition, org.jboss.as.controller.OperationStepHandler)
operationName
- the operation namehandler
- the operation handlerdescriptionProvider
- the description provider for this operationIllegalArgumentException
- if either parameter is null
@Deprecated void registerOperationHandler(String operationName, OperationStepHandler handler, DescriptionProvider descriptionProvider, EnumSet<OperationEntry.Flag> flags)
registerOperationHandler(org.jboss.as.controller.OperationDefinition, org.jboss.as.controller.OperationStepHandler)
operationName
- the operation namehandler
- the operation handlerdescriptionProvider
- the description provider for this operationflags
- operational modifier flags for this operation (e.g. read-only)IllegalArgumentException
- if either parameter is null
@Deprecated void registerOperationHandler(String operationName, OperationStepHandler handler, DescriptionProvider descriptionProvider, boolean inherited)
registerOperationHandler(org.jboss.as.controller.OperationDefinition, org.jboss.as.controller.OperationStepHandler)
operationName
- the operation namehandler
- the operation handlerdescriptionProvider
- the description provider for this operationinherited
- true
if the operation is inherited to child nodes, false
otherwiseIllegalArgumentException
- if either parameter is null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated void registerOperationHandler(String operationName, OperationStepHandler handler, DescriptionProvider descriptionProvider, boolean inherited, OperationEntry.EntryType entryType)
registerOperationHandler(org.jboss.as.controller.OperationDefinition, org.jboss.as.controller.OperationStepHandler)
operationName
- the operation namehandler
- the operation handlerdescriptionProvider
- the description provider for this operationinherited
- true
if the operation is inherited to child nodes, false
otherwiseentryType
- the operation entry typeIllegalArgumentException
- if either parameter is null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated void registerOperationHandler(String operationName, OperationStepHandler handler, DescriptionProvider descriptionProvider, boolean inherited, EnumSet<OperationEntry.Flag> flags)
registerOperationHandler(org.jboss.as.controller.OperationDefinition, org.jboss.as.controller.OperationStepHandler)
operationName
- the operation namehandler
- the operation handlerdescriptionProvider
- the description provider for this operationinherited
- true
if the operation is inherited to child nodes, false
otherwiseflags
- operational modifier flags for this operation (e.g. read-only)IllegalArgumentException
- if either parameter is null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated void registerOperationHandler(String operationName, OperationStepHandler handler, DescriptionProvider descriptionProvider, boolean inherited, OperationEntry.EntryType entryType, EnumSet<OperationEntry.Flag> flags)
registerOperationHandler(org.jboss.as.controller.OperationDefinition, org.jboss.as.controller.OperationStepHandler)
operationName
- the operation namehandler
- the operation handlerdescriptionProvider
- the description provider for this operationinherited
- true
if the operation is inherited to child nodes, false
otherwiseentryType
- the operation entry typeflags
- operational modifier flags for this operation (e.g. read-only)IllegalArgumentException
- if either parameter is null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void registerOperationHandler(OperationDefinition definition, OperationStepHandler handler)
definition
- the definition of operationhandler
- the operation handlerSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void registerOperationHandler(OperationDefinition definition, OperationStepHandler handler, boolean inherited)
definition
- the definition of operationhandler
- the operation handlerinherited
- true
if the operation is inherited to child nodes, false
otherwiseSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void unregisterOperationHandler(String operationName)
operationName
- the operation nameIllegalArgumentException
- if operationName is not registeredSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated void registerReadWriteAttribute(String attributeName, OperationStepHandler readHandler, OperationStepHandler writeHandler, AttributeAccess.Storage storage)
attributeName
- the name of the attribute. Cannot be null
readHandler
- the handler for attribute reads. May be null
in which case the default handling is usedwriteHandler
- the handler for attribute writes. Cannot be null
storage
- the storage type for this attributeIllegalArgumentException
- if attributeName
or writeHandler
are null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated void registerReadWriteAttribute(String attributeName, OperationStepHandler readHandler, OperationStepHandler writeHandler, EnumSet<AttributeAccess.Flag> flags)
AttributeAccess.Storage.CONFIGURATION
unless parameter
flags
includes AttributeAccess.Flag.STORAGE_RUNTIME
.attributeName
- the name of the attribute. Cannot be null
readHandler
- the handler for attribute reads. May be null
in which case the default handling is usedwriteHandler
- the handler for attribute writes. Cannot be null
flags
- additional flags describing this attributeIllegalArgumentException
- if attributeName
or writeHandler
are null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void registerReadWriteAttribute(AttributeDefinition definition, OperationStepHandler readHandler, OperationStepHandler writeHandler)
AttributeAccess.Storage.CONFIGURATION
unless parameter
flags
includes AttributeAccess.Flag.STORAGE_RUNTIME
.definition
- the attribute definition. Cannot be null
readHandler
- the handler for attribute reads. May be null
in which case the default handling is usedwriteHandler
- the handler for attribute writes. Cannot be null
IllegalArgumentException
- if definition
or writeHandler
are null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated void registerReadOnlyAttribute(String attributeName, OperationStepHandler readHandler, AttributeAccess.Storage storage)
registerReadOnlyAttribute(org.jboss.as.controller.AttributeDefinition, org.jboss.as.controller.OperationStepHandler)
attributeName
- the name of the attribute. Cannot be null
readHandler
- the handler for attribute reads. May be null
in which case the default handling is usedstorage
- the storage type for this attributeIllegalArgumentException
- if attributeName
is null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated void registerReadOnlyAttribute(String attributeName, OperationStepHandler readHandler, EnumSet<AttributeAccess.Flag> flags)
registerReadOnlyAttribute(org.jboss.as.controller.AttributeDefinition, org.jboss.as.controller.OperationStepHandler)
AttributeAccess.Storage.CONFIGURATION
unless parameter
flags
includes AttributeAccess.Flag.STORAGE_RUNTIME
.attributeName
- the name of the attribute. Cannot be null
readHandler
- the handler for attribute reads. May be null
in which case the default handling is usedflags
- additional flags describing this attributeIllegalArgumentException
- if attributeName
is null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void registerReadOnlyAttribute(AttributeDefinition definition, OperationStepHandler readHandler)
AttributeAccess.Storage.CONFIGURATION
unless parameter
flags
includes AttributeAccess.Flag.STORAGE_RUNTIME
.definition
- the attribute definition. Cannot be null
readHandler
- the handler for attribute reads. May be null
in which case the default handling is usedIllegalArgumentException
- if definition
is null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
@Deprecated void registerMetric(String attributeName, OperationStepHandler metricHandler)
registerMetric(org.jboss.as.controller.AttributeDefinition, org.jboss.as.controller.OperationStepHandler)
attributeName
- the name of the attribute. Cannot be null
metricHandler
- the handler for attribute reads. Cannot be null
IllegalArgumentException
- if attributeName
or metricHandler
are null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void registerMetric(AttributeDefinition definition, OperationStepHandler metricHandler)
definition
- the attribute definition. Cannot be null
metricHandler
- the handler for attribute reads. Cannot be null
IllegalArgumentException
- if definition
or metricHandler
are null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void registerMetric(String attributeName, OperationStepHandler metricHandler, EnumSet<AttributeAccess.Flag> flags)
registerMetric(org.jboss.as.controller.AttributeDefinition, org.jboss.as.controller.OperationStepHandler)
attributeName
- the name of the attribute. Cannot be null
metricHandler
- the handler for attribute reads. Cannot be null
flags
- additional flags describing this attributeIllegalArgumentException
- if attributeName
or metricHandler
are null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void unregisterAttribute(String attributeName)
attributeName
- the name of the attribute. Cannot be null
SecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void registerProxyController(PathElement address, ProxyController proxyController)
address
- the child of this registry that should be proxiedproxyController
- the proxy controllerSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void unregisterProxyController(PathElement address)
address
- the child of this registry that should no longer be proxiedSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void registerAlias(PathElement address, AliasEntry aliasEntry)
address
- the child of this registry that is an aliasaliasEntry
- the target modelSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
void unregisterAlias(PathElement address)
address
- the child of this registry that is an aliasSecurityException
- if the caller does not have ImmutableManagementResourceRegistration.ACCESS_PERMISSION
Copyright © 2014 JBoss by Red Hat. All rights reserved.