Package uk.co.westhawk.snmp.stack

Class SnmpContextv2c

java.lang.Object

uk.co.westhawk.snmp.stack.AbstractSnmpContext

uk.co.westhawk.snmp.stack.SnmpContext

uk.co.westhawk.snmp.stack.SnmpContextv2c

All Implemented Interfaces:

Cloneable, Runnable, EventListener, RawPduListener, SnmpContextBasisFace, SnmpContextFace, SnmpContextv2cFace

Direct Known Subclasses:

PassiveSnmpContextv2c

public class SnmpContextv2c
extends SnmpContext
implements SnmpContextv2cFace, Cloneable

This class contains the SNMP v2c context that is needed by every PDU to send a SNMP v2c request.

destroy() should be called when the context is no longer used. This is the only way the threads will be stopped and garbage collected.

Version:

$Revision: 3.16 $ $Date: 2009/03/05 12:54:04 $

Author:

Birgit Arkesteijn

See Also:

• SnmpContextv2cFace
• SnmpContextv2cPool

Field Summary

Fields inherited from interface uk.co.westhawk.snmp.stack.SnmpContextBasisFace

DEFAULT_PORT, MAXPDU, MSS, STANDARD_SOCKET, TCP_SOCKET

Fields inherited from interface uk.co.westhawk.snmp.stack.SnmpContextFace

DEFAULT_COMMUNITY

Constructor Summary

Constructors

Constructor	Description
SnmpContextv2c(String host, int port)	Constructor.
SnmpContextv2c(String host, int port, String typeSocketA)	Constructor.
SnmpContextv2c(String host, int port, String bindAddress, String typeSocketA)	Constructor.

Method Summary

Modifier and Type	Method	Description
Object	clone()	Returns a clone of this SnmpContextv2c.
byte[]	encodePacket(byte msg_type, int rId, int errstat, int errind, Enumeration ve, Object obj)	Encodes a PDU.
String	getHashKey()	Returns the hash key.
int	getVersion()	Returns the SNMP version of this context.
Pdu	processIncomingPdu(byte[] message)	Processes an incoming pdu (but not a response).
String	toString()	Returns a string representation of the object.

Methods inherited from class uk.co.westhawk.snmp.stack.SnmpContext

encodePacket, getCommunity, setCommunity

Methods inherited from class uk.co.westhawk.snmp.stack.AbstractSnmpContext

addPdu, addRequestPduListener, addRequestPduListener, addRequestPduListener, addTrapListener, addTrapListener, addTrapListener, destroy, getBindAddress, getDebugString, getHost, getHostAddress, getMaxRecvSize, getPort, getReceivedFromHostAddress, getSendToHostAddress, getTypeSocket, isDestroyed, rawPduReceived, removePdu, removeRequestPduListener, removeRequestPduListener, removeRequestPduListener, removeTrapListener, removeTrapListener, removeTrapListener, run, sendPacket, setMaxRecvSize, stop

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface uk.co.westhawk.snmp.stack.SnmpContextBasisFace

addPdu, addRequestPduListener, addRequestPduListener, addRequestPduListener, addTrapListener, addTrapListener, addTrapListener, destroy, getBindAddress, getHost, getPort, getReceivedFromHostAddress, getSendToHostAddress, getTypeSocket, isDestroyed, removePdu, removeRequestPduListener, removeRequestPduListener, removeRequestPduListener, removeTrapListener, removeTrapListener, removeTrapListener, sendPacket

Methods inherited from interface uk.co.westhawk.snmp.stack.SnmpContextFace

getCommunity, setCommunity

Constructor Details

SnmpContextv2c

public SnmpContextv2c(String host,
 int port)
               throws IOException

Constructor.

Parameters:

host - The host to which the PDU will be sent

port - The port where the SNMP server will be

Throws:

IOException

See Also:

• AbstractSnmpContext(String, int)

SnmpContextv2c

public SnmpContextv2c(String host,
 int port,
 String typeSocketA)
               throws IOException

Constructor. Parameter typeSocketA should be either STANDARD_SOCKET, TCP_SOCKET or a fully qualified classname.

Parameters:

host - The host to which the Pdu will be sent

port - The port where the SNMP server will be

typeSocketA - The local address the server will bind to

Throws:

IOException

See Also:

• AbstractSnmpContext(String, int, String)

SnmpContextv2c

public SnmpContextv2c(String host,
 int port,
 String bindAddress,
 String typeSocketA)
               throws IOException

Constructor. Parameter typeSocketA should be either STANDARD_SOCKET, TCP_SOCKET or a fully qualified classname.

Parameters:

host - The host to which the PDU will be sent

port - The port where the SNMP server will be

bindAddress - The local address the server will bind to

typeSocketA - The type of socket to use.

Throws:

IOException

Since:

4_14

See Also:

• AbstractSnmpContext(String, int, String, String)
• SnmpContextBasisFace.STANDARD_SOCKET
• SnmpContextBasisFace.TCP_SOCKET

Method Details

getVersion

public int getVersion()

Description copied from class: AbstractSnmpContext

Returns the SNMP version of this context. Has to be overload by each context.

Specified by:

getVersion in interface SnmpContextBasisFace

Overrides:

getVersion in class SnmpContext

Returns:

The version

See Also:

• SnmpConstants.SNMP_VERSION_1
• SnmpConstants.SNMP_VERSION_2c
• SnmpConstants.SNMP_VERSION_3

encodePacket

public byte[] encodePacket(byte msg_type,
 int rId,
 int errstat,
 int errind,
 Enumeration ve,
 Object obj)
                    throws IOException,
EncodingException

Description copied from class: AbstractSnmpContext

Encodes a PDU. This is for internal use only and should NOT be called by the developer. This is called by the the PDU itself and is added to the interface to cover the different kind of Contexts. Has to be overload by each context.

Specified by:

encodePacket in interface SnmpContextBasisFace

Overrides:

encodePacket in class SnmpContext

Parameters:

msg_type - The message type

rId - The message id

errstat - The error status

errind - The error index

ve - The varbind list

obj - Additional object (only used in SNMPv3)

Returns:

The encoded packet

Throws:

IOException

EncodingException

processIncomingPdu

public Pdu processIncomingPdu(byte[] message)
                       throws DecodingException,
IOException

Description copied from class: AbstractSnmpContext

Processes an incoming pdu (but not a response). Has to be overload by each context.

Specified by:

processIncomingPdu in interface SnmpContextBasisFace

Overrides:

processIncomingPdu in class SnmpContext

Throws:

DecodingException

IOException

See Also:

• AbstractSnmpContext.rawPduReceived(uk.co.westhawk.snmp.event.RawPduEvent)

clone

public Object clone()
             throws CloneNotSupportedException

Returns a clone of this SnmpContextv2c.

Specified by:

clone in interface SnmpContextBasisFace

Overrides:

clone in class SnmpContext

Throws:

CloneNotSupportedException - Thrown when the constructor generates an IOException

getHashKey

public String getHashKey()

Returns the hash key. This key is built out of all properties. It serves as key for a hashtable of (v2c) contexts.

Specified by:

getHashKey in interface SnmpContextBasisFace

Overrides:

getHashKey in class SnmpContext

Returns:

The hash key

Since:

4_14

toString

public String toString()

Returns a string representation of the object.

Overrides:

toString in class SnmpContext

Returns:

The string