|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
SNMPRequestListener is an interface that must be implemented by any class which wishes to act as a handler for request messages sent from remote SNMP management entities. The SNMPv1AgentInterface class listens for request messages, and passes any it receives on to SNMPRequestListener subclasses that have registered with it through its addRequestListener() method.
Method Summary | |
SNMPSequence |
processGetNextRequest(SNMPPDU requestPDU,
java.lang.String communityName)
Handles Get-Next- request messages. |
SNMPSequence |
processRequest(SNMPPDU requestPDU,
java.lang.String communityName)
Handles Get- or Set- request messages. |
Method Detail |
public SNMPSequence processRequest(SNMPPDU requestPDU, java.lang.String communityName) throws SNMPGetException, SNMPSetException
SNMPGetException,
- SNMPSetException
If a listener receives a request for an OID which it is intended to handle, but there is a problem with
the request - e.g., a set-request for a value which is read-only, or an incorrect value type for a set - the
listener should throw an SNMPGetException or SNMPSetException to indicate the error. The exception should
include both the index of the OID in the list of supplied OIDs, as well as an error status code (status values
are provided as constants in the SNMPRequestException class definition). The SNMPRequestException class and
subclasses provide constructors allowing the specification of the error index and status code. Note that the
error index follows the SNMP convention of starting at 1, not 0: thus if there is a problem with the first OID,
the error index should be 1. The SNMPAgentInterface will use the information in the exception to communicate
the error to the requesting management entity. The community name should also be used to determine if a request
is valid for the supplied community name.
SNMPGetException
SNMPSetException
public SNMPSequence processGetNextRequest(SNMPPDU requestPDU, java.lang.String communityName) throws SNMPGetException
SNMPGetException
- If a listener receives a request for an OID which it is intended to handle, but there is a problem with
the request - e.g., a get-next request for a value which is not readable for the supplied community name -
the listener should throw an SNMPGetException to indicate the error. The exception should
include both the index of the OID in the list of supplied OIDs, as well as an error status code (status values
are provided as constants in the SNMPRequestException class definition). The SNMPRequestException class and
subclasses provide constructors allowing the specification of the error index and status code. Note that the
error index follows the SNMP convention of starting at 1, not 0: thus if there is a problem with the first OID,
the error index should be 1. The SNMPAgentInterface will use the information in the exception to communicate
the error to the requesting management entity. The community name should also be used to determine if a request
is valid for the supplied community name.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |