File Doc Category Size Date Package
SnmpTableEntryFactory.java API Doc Java SE 6 API 2889 Tue Jun 10 00:22:08 BST 2008 com.sun.jmx.snmp.agent

SnmpTableEntryFactory

public interface SnmpTableEntryFactory implements SnmpTableCallbackHandler

This interface is implemented by mibgen generated table objects inheriting from {@link com.sun.jmx.snmp.agent.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.

This API is a Sun Microsystems internal API and is subject to change without notice.

Fields Summary
Constructors Summary
Methods Summary
public void createNewEntry(com.sun.jmx.snmp.agent.SnmpMibSubRequest request, com.sun.jmx.snmp.SnmpOid rowOid, int depth, com.sun.jmx.snmp.agent.SnmpMibTable meta)
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 {@link com.sun.jmx.snmp.agent.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 directlty.
param
request The SNMP subrequest containing the sublist of varbinds for the new entry.
param
rowOid The OID indexing the conceptual row (entry) for which the creation was requested.
param
depth The depth reached in the OID tree (the position at which the columnar object ids start in the OIDs included in the varbind).
param
meta The metadata object impacted by the subrequest
exception
SnmpStatusException The new entry cannot be created.