Class DefaultMOTable<R extends MOTableRow,C extends MOColumn,M extends MOTableModel<R>>
- All Implemented Interfaces:
ManagedObject
,ManagedObjectValueAccess
,MOTable<R,
,C, M> MOScope
,RegisteredManagedObject
,SerializableManagedObject
- Direct Known Subclasses:
SNMPv2MIB.SysOREntry
DefaultMOTable
class is the default implementation of the
MOTable
class. For most use cases, it is not necessary to customize
this class through deriving your own sub-class. Instead, using a different
MOTableModel
as table data provider is sufficient.
The default table model can be used to hold the data of a SNMP conceptual
table as real tabular data. If you want to implement a virtual table, you
will have to directly implement the interfaces MOTableModel
or
MOMutableTableModel
to access the data based on the actual view.
- Version:
- 2.6.1
- Author:
- Frank Fock
-
Nested Class Summary
-
Field Summary
Modifier and TypeFieldDescriptionprotected Vector<MOChangeListener>
protected M
protected Vector<MOTableRowListener<R>>
protected WeakHashMap<Request,
Map<org.snmp4j.smi.OID, R>> protected WeakHashMap<Request,
Map<org.snmp4j.smi.OID, DefaultMOTable.ChangeSet>> -
Constructor Summary
ConstructorDescriptionDefaultMOTable
(org.snmp4j.smi.OID oid, MOTableIndex indexDef, C[] columns) DefaultMOTable
(org.snmp4j.smi.OID oid, MOTableIndex indexDef, C[] columns, M model) Creates a new SNMP table with the specified "Entry" OID, INDEX, columns, andMOTableModel
. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Adds aMOChangeListener
that needs to be informed about state changes of this table.void
Adds aMOTableRowListener
listener that needs to be informed about row changes (creation, addition, removal).addNewRow
(org.snmp4j.smi.OID index, org.snmp4j.smi.Variable[] initialValues) Creates a new row for this table with the supplied index and initial values and then immediately callsMOTable.addRow(MOTableRow)
.protected DefaultMOTable.ChangeSet
addPendingChanges
(SubRequest subRequest, MOTableRow row, boolean newRow) boolean
Adds the supplied row to the underlying table model and fires the appropriateMOTableRowEvent
.void
cleanup
(SubRequest request) Cleansup a (sub)request and frees all resources locked during the preparation phase.void
commit
(SubRequest request) Commits a previously prepared SET (sub)request.boolean
covers
(org.snmp4j.smi.OID oid) Checks if this scope covers the supplied OID.createRow
(org.snmp4j.smi.OID index) Creates a new row for this table with the supplied index and default values.createRow
(org.snmp4j.smi.OID index, org.snmp4j.smi.Variable[] initialValues) Creates a new row for this table with the supplied index and initial values.org.snmp4j.smi.OID
Finds the object identifier of the first object instance in the specified range.protected MOTableCellInfo
findCell
(MOScope range, SubRequest request) protected void
fireAfterMOChange
(MOChangeEvent changeEvent) protected void
fireAfterPrepareMOChange
(MOChangeEvent changeEvent) protected void
fireBeforeMOChange
(MOChangeEvent changeEvent) protected void
fireBeforePrepareMOChange
(MOChangeEvent changeEvent) protected void
fireRowChanged
(MOTableRowEvent<R> event) void
get
(SubRequest request) Processes a GET request and return the result in the supplied sub-request.getCellInfo
(org.snmp4j.smi.OID oid) Returns aMOTableCellInfo
instance for the supplied cell OID.org.snmp4j.smi.OID
getCellOID
(org.snmp4j.smi.OID index, int col) protected int
getChangesFromRequest
(org.snmp4j.smi.OID index, MOTableRow row, SubRequest request, org.snmp4j.smi.Variable[] values, boolean setDefaultValues, boolean newRow) getColumn
(int index) Gets the column definition for the specified column.int
Returns the number of columns in this table.int
getColumnIndex
(int id) Returns the zero based column index for the specified column sub-identifier.C[]
Gets the column definitions for this table.org.snmp4j.smi.Variable[]
Returns an array of variables where each variable corresponds to the column with the same index.org.snmp4j.smi.OID
getID()
Gets the unique object ID of the managed object.Gets the index definition of this table.final org.snmp4j.smi.OID
getIndexPart
(org.snmp4j.smi.OID anyOID) Returns the index part of a column instance identifier of this table.org.snmp4j.smi.OID
Gets the lower bound OID of the scope.getModel()
Gets the table model of this table.getNewRows
(Request key) org.snmp4j.smi.OID
getOID()
Returns the OID of the table entry.protected DefaultMOTable.ChangeSet
getPendingChangeSet
(SubRequest subRequest, org.snmp4j.smi.OID index) protected org.snmp4j.smi.Variable[]
Gets the values of a row that need to be made persistent on behalf of asave(MOOutput output)
call.getScope()
Returns the scope of object identifiers this managed object is managing.org.snmp4j.smi.OID
Gets the upper bound OID of the scope.protected org.snmp4j.smi.Variable
getValue
(MOTableRow row, int col, SubRequest req) org.snmp4j.smi.Variable
getValue
(org.snmp4j.smi.OID cellOID) Gets the value of the cell instance with the specified instance OID.org.snmp4j.smi.Variable
getValue
(org.snmp4j.smi.OID index, int col) Gets the value of the cell instance in the specified column and row.org.snmp4j.smi.Variable
getValue
(org.snmp4j.smi.OID index, int col, SubRequest req) protected boolean
hasNewRows
(Request key) protected boolean
isChangeSetComplete
(SubRequest subRequest, org.snmp4j.smi.OID index, int column) boolean
Checks whether the supplied scope is covered by this scope.boolean
Indicates whether the lower bound OID is included in the scope or not.boolean
isOverlapping
(MOScope other) Checks whether the supplied scope overlap with this one, thus sharing at least one OID with the supplied one.boolean
Indicates whether the upper bound OID is included in the scope or not.boolean
Tests if this instance of a SerializableManagedObject should be serialized or deserialized through persistent storage load or save operation.void
Loads the content of the managed object from the specified input (stream).boolean
next
(SubRequest request) Finds the successor instance for the object instance ID (OID) given by the supplied sub-request and returns it within the supplied sub-request object.void
prepare
(SubRequest request) Prepares a SET (sub)request.int
Removes all rows from this table.void
Removes aMOChangeListener
void
RemovesMOTableRowListener
instance.removeRow
(org.snmp4j.smi.OID index) Removes the row with the specified index and returns it if the operation was successful.void
Saves the (non-volatile) content of this managed object to the specified output (stream).void
boolean
setValue
(org.snmp4j.smi.VariableBinding newValueAndInstancceOID) Sets the value of a particular MIB object instance managed by thisManagedObject
.void
setVolatile
(boolean isVolatile) toString()
void
undo
(SubRequest request) Compensates (undo) a (sub)request when a commit of another subrequest failed with an error.void
Update the content of this table that is covered by the supplied scope.protected void
update
(MOScope range, SubRequest request) Update this table for the supplied search range and sub-request if it has not yet been updated for that request.
-
Field Details
-
model
-
newRows
-
pendingChanges
-
moChangeListeners
-
moTableRowListeners
-
-
Constructor Details
-
DefaultMOTable
-
DefaultMOTable
Creates a new SNMP table with the specified "Entry" OID, INDEX, columns, andMOTableModel
.- Parameters:
oid
- the OID of the SNMP table's Entry object. If the table is ifTable (1.3.6.1.2.1.2.2) then the OID to provide is 1.3.6.1.2.1.2.2.1 which is the ifEntry OID. By SMI rule, you can simply append ".1" to the table OID.indexDef
- the index definition of the table based on the INDEX clause of the table MIB definition.columns
- the column definitions which may also include non-accessible columns.model
- the table model holding the table data.
-
-
Method Details
-
getCellInfo
Description copied from interface:MOTable
Returns aMOTableCellInfo
instance for the supplied cell OID. The returned object contains the index, column index, and column ID of the specified cell, if available.- Specified by:
getCellInfo
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
oid
- cell instance OID.- Returns:
- a
MOTableCellInfo
instance with the index, column index and column ID of the specified cell if available.
-
getColumnIndex
public int getColumnIndex(int id) Description copied from interface:MOTable
Returns the zero based column index for the specified column sub-identifier.- Specified by:
getColumnIndex
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
id
- a column sub-identifier (normally one based) as defined in the MIB specification.- Returns:
- a value greater or equal to zero denoting the column index
of the column associated with
id
. The column index points into the column array returned byMOTable.getColumns()
. A value less than zero indicates that such a column does not exists currently but could be inserted at the(-n)-1
position ifn
is the returned value.
-
getColumn
Description copied from interface:MOTable
Gets the column definition for the specified column.- Specified by:
getColumn
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
index
- the (zero-based) column index.- Returns:
- a
MOColumn
instance describing the attributes of requested column.
-
getColumnCount
public int getColumnCount()Description copied from interface:MOTable
Returns the number of columns in this table.- Specified by:
getColumnCount
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Returns:
- the column count.
-
createRow
Creates a new row for this table with the supplied index and initial values. If the underlying table model is not aMOMutableTableModel
instance or if one of theMOTableRowListener
deny the row creation attempt thennull
will be returned.- Specified by:
createRow
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
index
- the index OID of the new row.initialValues
- the initial values that should be assigned to the new row. If the array contains less values than this table has columns, default values will be created for the missing columns.- Returns:
- the created
MOTableRow
instance ornull
if the row cannot be created.
-
addNewRow
Description copied from interface:MOTable
Creates a new row for this table with the supplied index and initial values and then immediately callsMOTable.addRow(MOTableRow)
. If one of theMOTableRowListener
deny the row creation attempt thennull
will be returned andMOTable.addRow(MOTableRow)
will not be called.This method is the same as calling:
R newRow = createRow(index, initialValues); if (newRow != null) { addRow(newRow); } return newRow;
- Specified by:
addNewRow
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
index
- the index OID of the new row.initialValues
- the initial values that should be assigned to the new row.- Returns:
- the created
MOTableRow
instance ornull
if the row cannot be created.
-
createRow
Description copied from interface:MOTable
Creates a new row for this table with the supplied index and default values. If one of theMOTableRowListener
deny the row creation attempt thennull
will be returned.- Specified by:
createRow
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
index
- the index OID of the new row.- Returns:
- the created
MOTableRow
instance ornull
if the row cannot be created.
-
addRow
Adds the supplied row to the underlying table model and fires the appropriateMOTableRowEvent
. Since this method is typically called during the commit phase of a SET request that creates a table, it should be avoided to return an error here. Instead, error checking should be placed in theprepare(org.snmp4j.agent.request.SubRequest)
method.- Specified by:
addRow
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
row
- theMOTableRow
to add.- Returns:
true
if the row has been added orfalse
if it could not be added.
-
removeRow
Description copied from interface:MOTable
Removes the row with the specified index and returns it if the operation was successful.- Specified by:
removeRow
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
index
- the index OID of the row to remove.- Returns:
- the removed row or
null
if the row cannot be found or cannot be removed.
-
removeAll
public int removeAll()Removes all rows from this table. Before a row is removed the corresponding DELETE event is fired and listeners may veto these events for all rows. Only if there is no veto, a row will be deleted. The number of deleted rows is then returned.- Returns:
- the number of removed rows or -1 if the table model does not support row removal.
-
commit
Description copied from interface:ManagedObject
Commits a previously prepared SET (sub)request. This is the second phase of a two phase commit. The change is committed but the resources locked during prepare not freed yet.- Specified by:
commit
in interfaceManagedObject
- Parameters:
request
- theSubRequest
to process.
-
getIndexPart
public final org.snmp4j.smi.OID getIndexPart(org.snmp4j.smi.OID anyOID) Description copied from interface:MOTable
Returns the index part of a column instance identifier of this table.- Specified by:
getIndexPart
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
anyOID
- the OID of a column instance. The returned result is undefined, when this OID is not a column instance OID.- Returns:
- an OID representing the index OID of the row identified by the
instanceIdentifier
column instance OID.
-
getCellOID
public org.snmp4j.smi.OID getCellOID(org.snmp4j.smi.OID index, int col) -
find
Description copied from interface:MOTable
Finds the object identifier of the first object instance in the specified range.- Specified by:
find
in interfaceManagedObject
- Specified by:
find
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
range
- aMOScope
specifying the search range.- Returns:
- the OID of the lexicographic first instance in the search range or
null
if no such instance exists.
-
findCell
-
getScope
Description copied from interface:ManagedObject
Returns the scope of object identifiers this managed object is managing.- Specified by:
getScope
in interfaceManagedObject
- Returns:
- the
MOScope
that defines a range (possibly also a single or none instance OID) of object IDs managed by this managed object.
-
getValue
public org.snmp4j.smi.Variable getValue(org.snmp4j.smi.OID cellOID) Description copied from interface:MOTable
Gets the value of the cell instance with the specified instance OID.- Specified by:
getValue
in interfaceManagedObjectValueAccess
- Specified by:
getValue
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
cellOID
- the instance OID of the requested cell.- Returns:
- the value of the cell or
null
if such a cell does not exist.
-
getValue
-
getValue
public org.snmp4j.smi.Variable getValue(org.snmp4j.smi.OID index, int col) Description copied from interface:MOTable
Gets the value of the cell instance in the specified column and row.- Specified by:
getValue
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
index
- the row index of the cell.col
- the column index of the cell.- Returns:
- the value of the cell or
null
if such a cell does not exist.
-
getValue
-
update
Update the content of this table that is covered by the supplied scope.This method is part of the
UpdatableManagedObject
interface. Although theDefaultMOTable
does not implement that interface, subclasses of this class may do so easily by overriding this hook-up method.- Parameters:
updateScope
- the scope to update. Ifnull
the whole managed object is updated.- Since:
- 1.2
- See Also:
-
update
Update this table for the supplied search range and sub-request if it has not yet been updated for that request.By default, the
update(MOScope updateScope)
is being called on behalf of this method call (which itself does not nothing by default). You may choose either to implement theUpdatableManagedObject
interface and implement its interface in a subclass. Then it is recommended to overwrite this method by an empty method. Otherwise, do not implement theUpdatableManagedObject
interface.- Parameters:
range
- the search range.request
- the sub-request triggered the update ornull
if that request cannot be determined.
-
get
Description copied from interface:ManagedObject
Processes a GET request and return the result in the supplied sub-request.- Specified by:
get
in interfaceManagedObject
- Parameters:
request
- theSubRequest
to process.
-
next
Description copied from interface:ManagedObject
Finds the successor instance for the object instance ID (OID) given by the supplied sub-request and returns it within the supplied sub-request object.- Specified by:
next
in interfaceManagedObject
- Parameters:
request
- theSubRequest
to process.- Returns:
true
if the search request found an appropriate instance,false
otherwise.
-
prepare
Description copied from interface:ManagedObject
Prepares a SET (sub)request. This method represents the first phase of a two phase commit. During preparation all necessary resources should be locked in order to be able to execute the commit without claiming additional resources.- Specified by:
prepare
in interfaceManagedObject
- Parameters:
request
- theSubRequest
to process.
-
getChangesFromRequest
protected int getChangesFromRequest(org.snmp4j.smi.OID index, MOTableRow row, SubRequest request, org.snmp4j.smi.Variable[] values, boolean setDefaultValues, boolean newRow) -
hasNewRows
-
getNewRows
-
isChangeSetComplete
-
addPendingChanges
protected DefaultMOTable.ChangeSet addPendingChanges(SubRequest subRequest, MOTableRow row, boolean newRow) -
getPendingChangeSet
protected DefaultMOTable.ChangeSet getPendingChangeSet(SubRequest subRequest, org.snmp4j.smi.OID index) -
cleanup
Description copied from interface:ManagedObject
Cleansup a (sub)request and frees all resources locked during the preparation phase.- Specified by:
cleanup
in interfaceManagedObject
- Parameters:
request
- theSubRequest
to process.
-
undo
Description copied from interface:ManagedObject
Compensates (undo) a (sub)request when a commit of another subrequest failed with an error. This also frees any resources locked during the preparation phase.- Specified by:
undo
in interfaceManagedObject
- Parameters:
request
- theSubRequest
to process.
-
getOID
public org.snmp4j.smi.OID getOID()Description copied from interface:MOTable
Returns the OID of the table entry.- Specified by:
getOID
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Returns:
- a table entry OID (including the .1 suffix).
-
setModel
-
setVolatile
public void setVolatile(boolean isVolatile) -
getModel
Description copied from interface:MOTable
Gets the table model of this table.- Specified by:
getModel
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Returns:
- a MOTableModel instance.
-
getColumns
Description copied from interface:MOTable
Gets the column definitions for this table.- Specified by:
getColumns
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Returns:
- an array with the column definitions of this table.
-
getIndexDef
Description copied from interface:MOTable
Gets the index definition of this table.- Specified by:
getIndexDef
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Returns:
- a MOTableIndex instance containing the sub-index definitions for this table.
-
isVolatile
public boolean isVolatile()Description copied from interface:SerializableManagedObject
Tests if this instance of a SerializableManagedObject should be serialized or deserialized through persistent storage load or save operation.- Specified by:
isVolatile
in interfaceSerializableManagedObject
- Returns:
true
ifSerializableManagedObject.load(org.snmp4j.agent.io.MOInput)
andSerializableManagedObject.save(org.snmp4j.agent.io.MOOutput)
should not be called through a persistent storage operation andfalse
if these method should be called.
-
getLowerBound
public org.snmp4j.smi.OID getLowerBound()Description copied from interface:MOScope
Gets the lower bound OID of the scope. Whether the lower bound is included or excluded from the scope's region is determined byMOScope.isLowerIncluded()
.- Specified by:
getLowerBound
in interfaceMOScope
- Returns:
- an OID.
-
getUpperBound
public org.snmp4j.smi.OID getUpperBound()Description copied from interface:MOScope
Gets the upper bound OID of the scope. Whether the upper bound is included or excluded from the scope's region is determined byMOScope.isUpperIncluded()
.- Specified by:
getUpperBound
in interfaceMOScope
- Returns:
- OID
-
isLowerIncluded
public boolean isLowerIncluded()Description copied from interface:MOScope
Indicates whether the lower bound OID is included in the scope or not.- Specified by:
isLowerIncluded
in interfaceMOScope
- Returns:
true
if the lower bound is included.
-
isUpperIncluded
public boolean isUpperIncluded()Description copied from interface:MOScope
Indicates whether the upper bound OID is included in the scope or not.- Specified by:
isUpperIncluded
in interfaceMOScope
- Returns:
true
if the upper bound is included.
-
isCovered
Description copied from interface:MOScope
Checks whether the supplied scope is covered by this scope. -
isOverlapping
Description copied from interface:MOScope
Checks whether the supplied scope overlap with this one, thus sharing at least one OID with the supplied one.- Specified by:
isOverlapping
in interfaceMOScope
- Parameters:
other
- aMOScope
.- Returns:
true
if there exists at least one OID that is included in both scopes.
-
addMOChangeListener
Description copied from interface:MOTable
Adds aMOChangeListener
that needs to be informed about state changes of this table.- Specified by:
addMOChangeListener
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
l
- aMOChangeListener
instance.
-
removeMOChangeListener
Description copied from interface:MOTable
Removes aMOChangeListener
- Specified by:
removeMOChangeListener
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
l
- aMOChangeListener
instance.
-
fireBeforePrepareMOChange
-
fireAfterPrepareMOChange
-
fireBeforeMOChange
-
fireAfterMOChange
-
addMOTableRowListener
Description copied from interface:MOTable
Adds aMOTableRowListener
listener that needs to be informed about row changes (creation, addition, removal).- Specified by:
addMOTableRowListener
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
l
- aMOTableRowListener
instance.
-
removeMOTableRowListener
Description copied from interface:MOTable
RemovesMOTableRowListener
instance.- Specified by:
removeMOTableRowListener
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Parameters:
l
- aMOTableRowListener
instance.
-
fireRowChanged
-
getID
public org.snmp4j.smi.OID getID()Description copied from interface:RegisteredManagedObject
Gets the unique object ID of the managed object.- Specified by:
getID
in interfaceRegisteredManagedObject
- Returns:
- an OID.
-
load
Description copied from interface:SerializableManagedObject
Loads the content of the managed object from the specified input (stream).- Specified by:
load
in interfaceSerializableManagedObject
- Parameters:
input
- aMOInput
instance.- Throws:
IOException
- if an MOInput operation fails.
-
save
Description copied from interface:SerializableManagedObject
Saves the (non-volatile) content of this managed object to the specified output (stream).- Specified by:
save
in interfaceSerializableManagedObject
- Parameters:
output
- aMOOutput
instance.- Throws:
IOException
- if an MOOutput operation fails.
-
getPersistentValues
Gets the values of a row that need to be made persistent on behalf of asave(MOOutput output)
call.- Parameters:
row
- a MOTableRow that is being saved into a MOOutput stream.- Returns:
- an array of
Variable
instances that need to be saved. Typically, these are all columns of the row - including hidden extension columns/values. - Since:
- 1.2
-
getDefaultValues
public org.snmp4j.smi.Variable[] getDefaultValues()Description copied from interface:MOTable
Returns an array of variables where each variable corresponds to the column with the same index. If a column has a default value, the returned variable is notnull
and contains that default value.- Specified by:
getDefaultValues
in interfaceMOTable<R extends MOTableRow,
C extends MOColumn, M extends MOTableModel<R>> - Returns:
- the default variables for a newly created row as an array of
Variable
instances.
-
toString
-
covers
public boolean covers(org.snmp4j.smi.OID oid) Description copied from interface:MOScope
Checks if this scope covers the supplied OID. -
setValue
public boolean setValue(org.snmp4j.smi.VariableBinding newValueAndInstancceOID) Description copied from interface:ManagedObjectValueAccess
Sets the value of a particular MIB object instance managed by thisManagedObject
. This is a low level operation, thus no change events will be fired.- Specified by:
setValue
in interfaceManagedObjectValueAccess
- Parameters:
newValueAndInstancceOID
- aVariableBinding
identifying the object instance to modify by its OID and the new value by its variable part.- Returns:
true
if the object instance exists and has been modified successfully,false
otherwise.
-