uk.co.westhawk.snmp.stack

Class PassiveSnmpContext

java.lang.Object

uk.co.westhawk.snmp.stack.AbstractSnmpContext

uk.co.westhawk.snmp.stack.SnmpContext

uk.co.westhawk.snmp.stack.PassiveSnmpContext

All Implemented Interfaces:

java.lang.Cloneable, java.lang.Runnable, java.util.EventListener, RawPduListener, SnmpContextBasisFace, SnmpContextFace

public class PassiveSnmpContext
extends SnmpContext

This class contains the SNMP v1 context that is needed by a Pdu to send a SNMP v1 request in environments where thread creation is unwanted.

This extends SnmpContext so that it does not create any threads to send PDUs. It must be used with the PDU class PassiveTrapPduv1. The original purpose of the Passive classes is to allow the stack to be used in environments where thread creation is unwanted, eg database JVMs such as Oracle JServer. See SNMPv2-PDU.

See notes on how to send traps in an Oracle JServer environment.

Since:

4_12

Version:

$Revision$ $Date$

Author:

Birgit Arkesteijn

See Also:

PassiveTrapPduv1

Field Summary

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

anyPduExpectingResponse, bindAddr, hostname, hostPort, isDestroyed, maxRecvSize, pduSupport, trapSupport, typeSocket

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

DEFAULT_COMMUNITY

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

DEFAULT_PORT, MAXPDU, MSS, STANDARD_SOCKET, TCP_SOCKET

Constructor Summary

Constructors

Modifier	Constructor and Description
	PassiveSnmpContext(java.lang.String host, int port) Constructor.
	PassiveSnmpContext(java.lang.String host, int port, java.lang.String typeSocketA) Constructor.
protected	PassiveSnmpContext(java.lang.String host, int port, java.lang.String bindAddress, java.lang.String typeSocketA) Constructor.

Method Summary

Modifier and Type	Method and Description
protected void	activate() Overrides the AbstractSnmpContext.activate() to do nothing.

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

clone, encodePacket, encodePacket, getCommunity, getHashKey, getVersion, processIncomingPdu, processIncomingResponse, setCommunity, toString

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

addPdu, addRequestPduListener, addRequestPduListener, addRequestPduListener, addTrapListener, addTrapListener, addTrapListener, destroy, freeTransmitters, 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, finalize, 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

Constructor Detail

PassiveSnmpContext

public PassiveSnmpContext(java.lang.String host,
                          int port)
                   throws java.io.IOException

Constructor.

Parameters:

host - The host to which the Pdu will be sent

port - The port where the SNMP server will be

Throws:

java.io.IOException

See Also:

SnmpContext.SnmpContext(String, int)

PassiveSnmpContext

public PassiveSnmpContext(java.lang.String host,
                          int port,
                          java.lang.String typeSocketA)
                   throws java.io.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 type of socket to use.

Throws:

java.io.IOException

See Also:

SnmpContext.SnmpContext(String, int, String), SnmpContextBasisFace.STANDARD_SOCKET, SnmpContextBasisFace.TCP_SOCKET

PassiveSnmpContext

protected PassiveSnmpContext(java.lang.String host,
                             int port,
                             java.lang.String bindAddress,
                             java.lang.String typeSocketA)
                      throws java.io.IOException

Constructor. If bindAddress is null, then the system will pick up a valid local address to bind the socket. The typeSocketA will indicate which type of socket to use. This way different handlers can be provided. It 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:

java.io.IOException - Thrown when the socket cannot be created.

Since:

4_14

See Also:

SnmpContextBasisFace.STANDARD_SOCKET, SnmpContextBasisFace.TCP_SOCKET

Method Detail

activate

protected void activate()

Overrides the AbstractSnmpContext.activate() to do nothing. This prevents the creation of threads in the base class.

Overrides:

activate in class AbstractSnmpContext

See Also:

AbstractSnmpContext.activate()