com.sun.management.snmp.agent
Interface SnmpTableEntryFactory

All Superinterfaces:

SnmpTableCallbackHandler

All Known Implementing Classes:

SnmpTableSupport, TableUsmUserTable, TableUsmUserTableImpl

public interface SnmpTableEntryFactory
extends SnmpTableCallbackHandler

This interface is implemented by mibgen generated table objects inheriting from SnmpTableSupport.

It is used internally by the metadata whenever a remote SNMP manager requests the creation of a new entry through an SNMP SET.

At creation, the mibgen generated table object retrieves its corresponding metadata from the MIB and registers with this metadata as a SnmpTableEntryFactory.

Since:

Java DMK 5.1

Method Summary

void	createNewEntry(SnmpMibSubRequest request, SnmpOid rowOid, int depth, SnmpMibTable meta) This method is called by the SNMP runtime whenever a new entry creation is requested by a remote manager.

Methods inherited from interface com.sun.management.snmp.agent.SnmpTableCallbackHandler

addEntryCb, removeEntryCb

Method Detail

createNewEntry

void createNewEntry(SnmpMibSubRequest request,
                    SnmpOid rowOid,
                    int depth,
                    SnmpMibTable meta)
                    throws SnmpStatusException

This method is called by the SNMP runtime whenever a new entry creation is requested by a remote manager. The factory is responsible for instantiating the appropriate MBean and for registering it with the appropriate metadata object. Usually this method will:

• Check whether the creation can be accepted
• Instantiate a new entry
• Possibly register this entry with the MBeanServer, if needed.
• Call addEntry() on the given meta object.

This method is usually generated by mibgen on table objects (inheriting from SnmpTableSupport).

This method is called internally by the SNMP runtime whenever a new entry creation is requested by a remote SNMP manager. You should never need to call this method directly.

Parameters:

request - The SNMP subrequest containing the sublist of varbinds for the new entry.

rowOid - The OID indexing the conceptual row (entry) for which the creation was requested.

depth - The depth reached in the OID tree (the position at which the columnar object ids start in the OIDs included in the varbind).

meta - The metadata object impacted by the subrequest

Throws:

SnmpStatusException - The new entry cannot be created.