org.snmp4j.agent.mo
Interface MOMutableRow2PC

All Superinterfaces:

MOMutableTableRow, MOTableRow

All Known Implementing Classes:

DefaultMOMutableRow2PC, NotificationLogMib.NlmConfigLogEntryRow, NotificationLogMib.NlmLogEntryRow, NotificationLogMib.NlmLogVariableEntryRow, NotificationLogMib.NlmStatsLogEntryRow, Snmp4jDemoMib.Snmp4jDemoEntryRow, Snmp4jHeartbeatMib.Snmp4jAgentHBCtrlEntryRow, Snmp4jLogMib.Snmp4jLogLoggerRow, Snmp4jProxyMib.Snmp4jProxyEntryRow, SnmpProxyMIB.SnmpProxyRow, SnmpTargetMIB.SnmpTargetAddrEntryRow, SnmpTlsTmMib.SnmpTlstmAddrEntryRow, SnmpTlsTmMib.SnmpTlstmCertToTSNEntryRow, SnmpTlsTmMib.SnmpTlstmParamsEntryRow, UsmMIB.UsmTableRow

public interface MOMutableRow2PC
extends MOMutableTableRow

The MOMutableRow2PC interface adds support for 2-Phase-Commit to mutable table rows.

Version:

1.0

Author:

Frank Fock

Method Summary

void	cleanup(SubRequest subRequest, int column) Cleanups resources holds for changes to a single column.
void	cleanupRow(SubRequest request, DefaultMOTable.ChangeSet changeSet) Cleans up resources for a row.
void	commit(SubRequest subRequest, MOTableRow changeSet, int column) Commits changes to single column.
void	commitRow(SubRequest subRequest, MOTableRow changeSet) Commits a row as described by the supplied change set.
void	prepare(SubRequest subRequest, MOTableRow changeSet, int column) Prepares changing a single column.
void	prepareRow(SubRequest subRequest, MOTableRow changeSet) Prepares a row for changes described by the supplied change set.
void	undo(SubRequest subRequest, int column) Undos the changes to a single column.
void	undoRow(SubRequest request, DefaultMOTable.ChangeSet changeSet) Undos changes to a row.

Methods inherited from interface org.snmp4j.agent.mo.MOMutableTableRow

setBaseRow, setValue

Methods inherited from interface org.snmp4j.agent.mo.MOTableRow

getBaseRow, getIndex, getValue, size

Method Detail

prepareRow

void prepareRow(SubRequest subRequest,
                MOTableRow changeSet)

Prepares a row for changes described by the supplied change set. If the modification cannot be successfully prepared, the error status of the supplied subRequest should be set to the appropriate error status value.

This method is called only once per modified row.

Parameters:

subRequest - the sub-request that triggered the row change and that can be used to deny the commit phase by setting its error status.

changeSet - a MOTableRow instance that represents the state of the row if all changes have been applied successfully.

prepare

void prepare(SubRequest subRequest,
             MOTableRow changeSet,
             int column)

Prepares changing a single column.

Parameters:

subRequest - the sub-request that corresponds to the column change. This object can be used to deny the commit phase by setting its error status.

changeSet - a MOTableRow instance that represents the state of the row if all changes have been applied successfully.

column - the column index of the column to be changed.

commit

void commit(SubRequest subRequest,
            MOTableRow changeSet,
            int column)

Commits changes to single column.

Parameters:

subRequest - the sub-request that corresponds to the column change. This object can be used to deny the commit phase and triggering the undo phase by setting its error status.

changeSet - a MOTableRow instance that represents the state of the row if all changes have been applied successfully.

column - the column index of the column to be changed.

commitRow

void commitRow(SubRequest subRequest,
               MOTableRow changeSet)

Commits a row as described by the supplied change set. If the modification cannot be successfully committed, the error status of the supplied subRequest should be set to commitFailed. Setting this error should be avoided under any circumstances.

This method is called only once per modified row.

Parameters:

subRequest - the sub-request that triggered the row change and that can be used to trigger the undo phase by setting its error status.

changeSet - a MOTableRow instance that represents the state of the row if all changes have been applied successfully.

cleanup

void cleanup(SubRequest subRequest,
             int column)

Cleanups resources holds for changes to a single column.

Parameters:

subRequest - the sub-request that corresponds to the column change.

column - the column index of the changed column.

cleanupRow

void cleanupRow(SubRequest request,
                DefaultMOTable.ChangeSet changeSet)

Cleans up resources for a row.

This method is called only once per modified row.

Parameters:

request - the sub-request that triggered the row change.

changeSet - a MOTableRow instance that represents the state of the row if all changes have been applied successfully.

undo

void undo(SubRequest subRequest,
          int column)

Undos the changes to a single column.

Parameters:

subRequest - the sub-request that corresponds to the column change.

column - the column index of the changed column.

undoRow

void undoRow(SubRequest request,
             DefaultMOTable.ChangeSet changeSet)

Undos changes to a row.

This method is called only once per modified row.

Parameters:

request - the sub-request that triggered the row change.

changeSet - a MOTableRow instance that represents the state of the row if all changes have been applied successfully.