public class

JvmThreadInstanceTableMetaImpl

extends JvmThreadInstanceTableMeta

java.lang.Object
↳	com.sun.jmx.snmp.agent.SnmpMibNode
	↳	com.sun.jmx.snmp.agent.SnmpMibTable
		↳	sun.management.snmp.jvmmib.JvmThreadInstanceTableMeta
			↳	sun.management.snmp.jvminstr.JvmThreadInstanceTableMetaImpl

Class Overview

The class is used for implementing the "JvmThreadInstanceTable" group.

Summary

Constants
int	MAX_STACK_TRACE_DEPTH	Maximum depth of the stacktrace that might be returned through SNMP.

Fields
protected SnmpTableCache	cache

[Expand]

Inherited Fields

From class sun.management.snmp.jvmmib.JvmThreadInstanceTableMeta

From class com.sun.jmx.snmp.agent.SnmpMibTable

From class com.sun.jmx.snmp.agent.SnmpMibNode

Public Constructors
	JvmThreadInstanceTableMetaImpl(SnmpMib myMib, SnmpStandardObjectServer objserv) Constructor for the table.

Public Methods
Object	getEntry(SnmpOid oid) Get the entry corresponding to the specified rowOid.

Protected Methods
boolean	contains(SnmpOid oid, Object userData) Return true if the entry identified by the given OID index is contained in this table.
SnmpTableHandler	getHandler(Object userData) Get the SnmpTableHandler that holds the jvmThreadInstanceTable data.
SnmpOid	getNextOid(Object userData) Return the first entry OID registered in the table.
SnmpOid	getNextOid(SnmpOid oid, Object userData) Get the `SnmpOid` index of the row that follows the given `oid` in the table.

[Expand]

Inherited Methods

From class sun.management.snmp.jvmmib.JvmThreadInstanceTableMeta

synchronized void	addEntry(SnmpOid rowOid, ObjectName objname, Object entry) Add a new entry in this `SnmpMibTable`.
void	check(SnmpMibSubRequest req, SnmpOid rowOid, int depth) This method is used internally and is implemented by the `SnmpMibTable` subclasses generated by `mibgen`.
JvmThreadInstanceEntryMeta	createJvmThreadInstanceEntryMetaNode(String snmpEntryName, String tableName, SnmpMib mib, MBeanServer server) Factory method for "JvmThreadInstanceEntry" entry metadata class.
void	createNewEntry(SnmpMibSubRequest req, SnmpOid rowOid, int depth) This method is invoked when the creation of a new entry is requested by a remote SNMP manager.
void	get(SnmpMibSubRequest req, SnmpOid rowOid, int depth) This method is used internally and is implemented by the `SnmpMibTable` subclasses generated by `mibgen`.
long	getNextVarEntryId(SnmpOid rowOid, long var, Object data) Returns the arc of the next columnar object following "var".
boolean	isReadableEntryId(SnmpOid rowOid, long var, Object data) Returns true if "var" identifies a readable scalar object.
boolean	isRegistrationRequired() Tell whether the specific version of this metadata generated by `mibgen` requires entries to be registered with the MBeanServer.
void	registerEntryNode(SnmpMib mib, MBeanServer server)
void	set(SnmpMibSubRequest req, SnmpOid rowOid, int depth) This method is used internally and is implemented by the `SnmpMibTable` subclasses generated by `mibgen`.
boolean	skipEntryVariable(SnmpOid rowOid, long var, Object data, int pduVersion) Hook for subclasses.
void	validateVarEntryId(SnmpOid rowOid, long var, Object data) check that the given "var" identifies a columnar object.

From class com.sun.jmx.snmp.agent.SnmpMibTable

void	addEntry(SnmpOid rowOid, Object entry) Add a new entry in this `SnmpMibTable`.
synchronized void	addEntry(SnmpOid oid, ObjectName name, Object entry) Add a new entry in this `SnmpMibTable`.
synchronized void	addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback) Enable to add an SNMP entry listener to this `SnmpMibTable`.
synchronized void	beginRowAction(SnmpMibSubRequest req, SnmpOid rowOid, int depth, int rowAction) This method takes care of initial RowStatus handling during the check() phase of a SET request.
abstract void	check(SnmpMibSubRequest req, SnmpOid rowOid, int depth) This method is used internally and is implemented by the `SnmpMibTable` subclasses generated by `mibgen`.
void	check(SnmpMibSubRequest req, int depth) Generic handling of the `check` operation.
void	checkRemoveTableRow(SnmpMibSubRequest req, SnmpOid rowOid, int depth) Check whether the specified row can be removed from the table.
void	checkRowStatusChange(SnmpMibSubRequest req, SnmpOid rowOid, int depth, int newStatus) Check whether the control variable of the given row can be switched to the new specified `newStatus`.
boolean	contains(SnmpOid oid, Object userData) Return true if the entry identified by the given OID index is contained in this table.
abstract void	createNewEntry(SnmpMibSubRequest req, SnmpOid rowOid, int depth) This method is invoked when the creation of a new entry is requested by a remote SNMP manager.
void	endRowAction(SnmpMibSubRequest req, SnmpOid rowOid, int depth, int rowAction) This method takes care of final RowStatus handling during the set() phase of a SET request.
abstract void	get(SnmpMibSubRequest req, SnmpOid rowOid, int depth) This method is used internally and is implemented by the `SnmpMibTable` subclasses generated by `mibgen`.
void	get(SnmpMibSubRequest req, int depth) Generic handling of the `get` operation.
Object[]	getBasicEntries() Return the entries stored in this table `SnmpMibTable`.
synchronized Object	getEntry(SnmpOid rowOid) Get the entry corresponding to the specified rowOid.
synchronized ObjectName	getEntryName(SnmpOid rowOid) Get the ObjectName of the entry corresponding to the specified rowOid.
SnmpOid	getNextOid(Object userData) Return the first entry OID registered in the table.
SnmpOid	getNextOid(SnmpOid oid, Object userData) Get the `SnmpOid` index of the row that follows the given `oid` in the table.
abstract long	getNextVarEntryId(SnmpOid rowOid, long var, Object userData) This method is used internally and is implemented by the `SnmpMibTable` subclasses generated by `mibgen`.
long	getNextVarEntryId(SnmpOid rowOid, long var, Object userData, int pduVersion) Return the next OID arc corresponding to a readable columnar object in the underlying entry OBJECT-TYPE, possibly skipping over those objects that must not or cannot be returned.
MBeanNotificationInfo[]	getNotificationInfo() Return a `NotificationInfo` object containing the notification class and the notification type sent by the `SnmpMibTable`.
int	getRowAction(SnmpMibSubRequest req, SnmpOid rowOid, int depth) Return the RowStatus code value specified in this request.
int	getSize() Get the size of the table.
boolean	hasRowStatus() Return `true` if the conceptual row contains a columnar object used to control creation/deletion of rows in this table.
boolean	isCreationEnabled() Tell whether a new entry should be created when a SET operation is received for an entry that does not exist yet.
abstract boolean	isReadableEntryId(SnmpOid rowOid, long var, Object userData) This method is used internally and is implemented by the `SnmpMibTable` subclasses generated by `mibgen`.
abstract boolean	isRegistrationRequired() Tell whether the specific version of this metadata generated by `mibgen` requires entries to be registered with the MBeanServer.
boolean	isRowReady(SnmpOid rowOid, Object userData) Tell whether the specified row is ready and can be put in the notInService state.
boolean	isRowStatus(SnmpOid rowOid, long var, Object userData) Return true if the columnar object identified by `var` is used to control the addition/deletion of rows in this table.
int	mapRowStatus(SnmpOid rowOid, SnmpVarBind vbstatus, Object userData) Map the value of the `vbstatus` varbind to the corresponding RowStatus code defined in `EnumRowStatus`.
void	registerEntryFactory(SnmpTableEntryFactory factory) Register the factory through which table entries should be created when remote entry creation is enabled.
synchronized void	removeEntry(SnmpOid rowOid, Object entry) Remove the specified entry from the table.
void	removeEntry(SnmpOid rowOid) Remove the specified entry from the table.
synchronized void	removeEntry(int pos, Object entry) Remove the specified entry from the table.
synchronized void	removeNotificationListener(NotificationListener listener) Enable to remove an SNMP entry listener from this `SnmpMibTable`.
void	removeTableRow(SnmpMibSubRequest req, SnmpOid rowOid, int depth) Remove a table row upon a remote manager request.
abstract void	set(SnmpMibSubRequest req, SnmpOid rowOid, int depth) This method is used internally and is implemented by the `SnmpMibTable` subclasses generated by `mibgen`.
void	set(SnmpMibSubRequest req, int depth) Generic handling of the `set` operation.
void	setCreationEnabled(boolean remoteCreationFlag) This method lets you dynamically switch the creation policy.
SnmpValue	setRowStatus(SnmpOid rowOid, int newStatus, Object userData) Set the control variable to the specified `newStatus` value.
boolean	skipEntryVariable(SnmpOid rowOid, long var, Object userData, int pduVersion) Hook for subclasses.
abstract void	validateVarEntryId(SnmpOid rowOid, long var, Object userData) This method is used internally and is implemented by the `SnmpMibTable` subclasses generated by `mibgen`.

From class com.sun.jmx.snmp.agent.SnmpMibNode

abstract void	check(SnmpMibSubRequest req, int depth) Generic handling of the `check` operation.
abstract void	get(SnmpMibSubRequest req, int depth) Generic handling of the `get` operation.
final static int	getNextIdentifier(int[] table, long value) This will give the first element greater than `value` in a sorted array.
long	getNextVarId(long id, Object userData, int pduVersion) Get the next OID arc corresponding to a readable scalar variable, a branch leading to a subgroub, or a table, possibly skipping over those arcs that must not or cannot be returned.
long	getNextVarId(long id, Object userData) Get the next OID arc corresponding to a readable scalar variable, a branch leading to a subgroub, or a table.
void	getRootOid(Vector<Integer> result) Computes the root OID of the MIB.
abstract void	set(SnmpMibSubRequest req, int depth) Generic handling of the `set` operation.
boolean	skipVariable(long id, Object userData, int pduVersion) Hook for subclasses.
static void	sort(int[] array) Sorts the specified integer array.

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the 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.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

From interface javax.management.NotificationBroadcaster

Constants

public static final int MAX_STACK_TRACE_DEPTH

Maximum depth of the stacktrace that might be returned through SNMP. Since we do not export the stack trace through SNMP, we set MAX_STACK_TRACE_DEPTH=0 so that ThreadMXBean.getThreadInfo(long) does not compute the stack trace.

Constant Value: 0 (0x00000000)

Fields

protected SnmpTableCache cache

Public Constructors

public JvmThreadInstanceTableMetaImpl (SnmpMib myMib, SnmpStandardObjectServer objserv)

Constructor for the table. Initialize metadata for "JvmThreadInstanceTableMeta". The reference on the MBean server is updated so the entries created through an SNMP SET will be AUTOMATICALLY REGISTERED in Java DMK.

Public Methods

public Object getEntry (SnmpOid oid)

Get the entry corresponding to the specified rowOid.

Parameters

oid	The `SnmpOid` identifying the row to be retrieved.

Returns

The entry.

Throws

SnmpStatusException

Protected Methods

protected boolean contains (SnmpOid oid, Object userData)

Return true if the entry identified by the given OID index is contained in this table.

Do not call this method directly.

This method is provided has a hook for subclasses. It is called when a get/set request is received in order to determine whether the specified entry is contained in the table. You may want to override this method if you need to perform e.g. lazy evaluation of tables (you need to update the table when a request is received) or if your table is virtual.

Note that this method is called by the Runtime from within a synchronized block.

Parameters

oid	The index part of the OID we're looking for.
userData	A contextual object containing user-data. This object is allocated through the `SnmpUserDataFactory` for each incoming SNMP request.

Returns

true if the entry is found, false otherwise.

protected SnmpTableHandler getHandler (Object userData)

Get the SnmpTableHandler that holds the jvmThreadInstanceTable data. First look it up in the request contextual cache, and if it is not found, obtain it from the weak cache.
The request contextual cache will be released at the end of the current requests, and is used only to process this request.
The weak cache is shared by all requests, and is only recomputed when it is found to be obsolete.
Note that the data put in the request contextual cache is never considered to be obsolete, in order to preserve data coherency.

protected SnmpOid getNextOid (Object userData)

Return the first entry OID registered in the table.

Parameters

userData	A contextual object containing user-data. This object is allocated through the `SnmpUserDataFactory` for each incoming SNMP request.

Returns

The SnmpOid of the first entry in the table.

Throws

SnmpStatusException

protected SnmpOid getNextOid (SnmpOid oid, Object userData)

Get the SnmpOid index of the row that follows the given oid in the table. The given oid does not need to be a valid row OID index.

Parameters

oid	The OID from which the search will begin.
userData	A contextual object containing user-data. This object is allocated through the `SnmpUserDataFactory` for each incoming SNMP request.

Returns

The next SnmpOid index.

Throws

SnmpStatusException

Interfaces

Classes

JvmThreadInstanceTableMetaImpl

Class Overview

Summary

Constants

public static final int MAX_STACK_TRACE_DEPTH

Fields

protected SnmpTableCache cache

Public Constructors

public JvmThreadInstanceTableMetaImpl (SnmpMib myMib, SnmpStandardObjectServer objserv)

Public Methods

public Object getEntry (SnmpOid oid)

Parameters

Returns

Throws

Protected Methods

protected boolean contains (SnmpOid oid, Object userData)

Parameters

Returns

protected SnmpTableHandler getHandler (Object userData)

protected SnmpOid getNextOid (Object userData)

Parameters

Returns

Throws

protected SnmpOid getNextOid (SnmpOid oid, Object userData)

Parameters

Returns

Throws