Class RoleInfo

java.lang.Object

javax.management.relation.RoleInfo

All Implemented Interfaces:: Serializable

public class RoleInfo extends Object implements Serializable

A RoleInfo object summarises a role in a relation type.

The serialVersionUID of this class is 2504952983494636987L.

Since:

1.5

See Also:

Field Summary

Modifier and Type	Field	Description
`static final int`	`ROLE_CARDINALITY_INFINITY`	To specify an unlimited cardinality.

Constructor Summary

Constructor	Description
`RoleInfo(String roleName, String mbeanClassName)`	Constructor.
`RoleInfo(String roleName, String mbeanClassName, boolean read, boolean write)`	Constructor.
`RoleInfo(String roleName, String mbeanClassName, boolean read, boolean write, int min, int max, String descr)`	Constructor.
`RoleInfo(RoleInfo roleInfo)`	Copy constructor.

Method Summary

Modifier and Type	Method	Description
`boolean`	`checkMaxDegree(int value)`	Returns true if the `value` parameter is lower than or equal to the expected maximum degree, false otherwise.
`boolean`	`checkMinDegree(int value)`	Returns true if the `value` parameter is greater than or equal to the expected minimum degree, false otherwise.
`String`	`getDescription()`	Returns description text for the role.
`int`	`getMaxDegree()`	Returns maximum degree for corresponding role reference.
`int`	`getMinDegree()`	Returns minimum degree for corresponding role reference.
`String`	`getName()`	Returns the name of the role.
`String`	`getRefMBeanClassName()`	Returns name of type of MBean expected to be referenced in corresponding role.
`boolean`	`isReadable()`	Returns read access mode for the role (true if it is readable).
`boolean`	`isWritable()`	Returns write access mode for the role (true if it is writable).
`String`	`toString()`	Returns a string describing the role info.

Methods declared in class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Modifier and Type	Method	Description
`protected Object`	`clone()`	Creates and returns a copy of this object.
`boolean`	`equals(Object obj)`	Indicates whether some other object is "equal to" this one.
`protected void`	`finalize()`	Deprecated, for removal: This API element is subject to removal in a future version. Finalization is deprecated and subject to removal in a future release.
`final Class<?>`	`getClass()`	Returns the runtime class of this `Object`.
`int`	`hashCode()`	Returns a hash code value for this object.
`final void`	`notify()`	Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()`	Wakes up all threads that are waiting on this object's monitor.
`final void`	`wait()`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
`final void`	`wait(long timeoutMillis)`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis, int nanos)`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

Field Details

ROLE_CARDINALITY_INFINITY

public static final int ROLE_CARDINALITY_INFINITY

To specify an unlimited cardinality.

See Also:

Constructor Details

RoleInfo

public RoleInfo(String roleName, String mbeanClassName, boolean read, boolean write, int min, int max, String descr) throws IllegalArgumentException, InvalidRoleInfoException, ClassNotFoundException, NotCompliantMBeanException

Constructor.

Parameters:: roleName - name of the role.; mbeanClassName - name of the class of MBean(s) expected to be referenced in corresponding role. If an MBean M is in this role, then the MBean server must return true for isInstanceOf(M, mbeanClassName).; read - flag to indicate if the corresponding role can be read; write - flag to indicate if the corresponding role can be set; min - minimum degree for role, i.e. minimum number of MBeans to provide in corresponding role Must be less than or equal to max. (ROLE_CARDINALITY_INFINITY for unlimited); max - maximum degree for role, i.e. maximum number of MBeans to provide in corresponding role Must be greater than or equal to min (ROLE_CARDINALITY_INFINITY for unlimited); descr - description of the role (can be null)
Throws:: IllegalArgumentException - if null parameter; InvalidRoleInfoException - if the minimum degree is greater than the maximum degree.; ClassNotFoundException - As of JMX 1.2, this exception can no longer be thrown. It is retained in the declaration of this class for compatibility with existing code.; NotCompliantMBeanException - if the class mbeanClassName is not a MBean class.

RoleInfo

public RoleInfo(String roleName, String mbeanClassName, boolean read, boolean write) throws IllegalArgumentException, ClassNotFoundException, NotCompliantMBeanException

Constructor.

Parameters:

roleName - name of the role

mbeanClassName - name of the class of MBean(s) expected to be referenced in corresponding role. If an MBean M is in this role, then the MBean server must return true for isInstanceOf(M, mbeanClassName).

read - flag to indicate if the corresponding role can be read

write - flag to indicate if the corresponding role can be set

Minimum and maximum degrees defaulted to 1.

Description of role defaulted to null.

Throws:

IllegalArgumentException - if null parameter

ClassNotFoundException - As of JMX 1.2, this exception can no longer be thrown. It is retained in the declaration of this class for compatibility with existing code.

NotCompliantMBeanException - As of JMX 1.2, this exception can no longer be thrown. It is retained in the declaration of this class for compatibility with existing code.

RoleInfo

public RoleInfo(String roleName, String mbeanClassName) throws IllegalArgumentException, ClassNotFoundException, NotCompliantMBeanException

Constructor.

Parameters:

roleName - name of the role

IsReadable and IsWritable defaulted to true.

Minimum and maximum degrees defaulted to 1.

Description of role defaulted to null.

Throws:

IllegalArgumentException - if null parameter

ClassNotFoundException - As of JMX 1.2, this exception can no longer be thrown. It is retained in the declaration of this class for compatibility with existing code.

NotCompliantMBeanException - As of JMX 1.2, this exception can no longer be thrown. It is retained in the declaration of this class for compatibility with existing code.

RoleInfo

public RoleInfo(RoleInfo roleInfo) throws IllegalArgumentException

Copy constructor.

Parameters:: roleInfo - the RoleInfo instance to be copied.
Throws:: IllegalArgumentException - if null parameter

Method Details

getName

public String getName()

Returns the name of the role.

Returns:: the name of the role.

isReadable

public boolean isReadable()

Returns read access mode for the role (true if it is readable).

Returns:: true if the role is readable.

isWritable

public boolean isWritable()

Returns write access mode for the role (true if it is writable).

Returns:: true if the role is writable.

getDescription

public String getDescription()

Returns description text for the role.

Returns:: the description of the role.

getMinDegree

public int getMinDegree()

Returns minimum degree for corresponding role reference.

Returns:: the minimum degree.

getMaxDegree

public int getMaxDegree()

Returns maximum degree for corresponding role reference.

Returns:: the maximum degree.

getRefMBeanClassName

public String getRefMBeanClassName()

Returns name of type of MBean expected to be referenced in corresponding role.

Returns:: the name of the referenced type.

checkMinDegree

public boolean checkMinDegree(int value)

Returns true if the value parameter is greater than or equal to the expected minimum degree, false otherwise.

Parameters:: value - the value to be checked
Returns:: true if greater than or equal to minimum degree, false otherwise.

checkMaxDegree

public boolean checkMaxDegree(int value)

Returns true if the value parameter is lower than or equal to the expected maximum degree, false otherwise.

Parameters:: value - the value to be checked
Returns:: true if lower than or equal to maximum degree, false otherwise.

toString

public String toString()

Returns a string describing the role info.

Overrides:: toString in class Object
Returns:: a description of the role info.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.