SAMClientEventListenerImpl

java.lang.Object

net.i2p.sam.client.SAMClientEventListenerImpl

All Implemented Interfaces:: SAMReader.SAMClientEventListener

Direct Known Subclasses:: SAMEventHandler

public class SAMClientEventListenerImplextends Object implements SAMReader.SAMClientEventListener

Basic noop client event listener.

Field Summary
Fields inherited from interface SAMReader.SAMClientEventListener
NAMING_REPLY_INVALID_KEY, NAMING_REPLY_KEY_NOT_FOUND, NAMING_REPLY_OK, SESSION_STATUS_DUPLICATE_DEST, SESSION_STATUS_I2P_ERROR, SESSION_STATUS_INVALID_KEY, SESSION_STATUS_OK, STREAM_CLOSED_CANT_REACH_PEER, STREAM_CLOSED_I2P_ERROR, STREAM_CLOSED_OK, STREAM_CLOSED_PEER_NOT_FOUND, STREAM_CLOSED_TIMEOUT, STREAM_STATUS_CANT_REACH_PEER, STREAM_STATUS_I2P_ERROR, STREAM_STATUS_INVALID_KEY, STREAM_STATUS_OK, STREAM_STATUS_TIMEOUT
Modifier and Type
Field
Description
static final String
NAMING_REPLY_INVALID_KEY
Naming lookup failed because the private key is invalid.
static final String
NAMING_REPLY_KEY_NOT_FOUND
Naming lookup failed because no key matches the requested name.
static final String
NAMING_REPLY_OK
Naming lookup succeeded.
static final String
SESSION_STATUS_DUPLICATE_DEST
Session creation failed because the destination is already in use.
static final String
SESSION_STATUS_I2P_ERROR
SESSION_STATUS_I2P_ERROR.
static final String
SESSION_STATUS_INVALID_KEY
Session creation failed because the supplied private key is invalid.
static final String
SESSION_STATUS_OK
Session creation succeeded.
static final String
STREAM_CLOSED_CANT_REACH_PEER
Stream closed because the peer became unreachable.
static final String
STREAM_CLOSED_I2P_ERROR
STREAM_CLOSED_I2P_ERROR.
static final String
STREAM_CLOSED_OK
Stream closed normally.
static final String
STREAM_CLOSED_PEER_NOT_FOUND
Stream closed because the destination was no longer known to the router.
static final String
STREAM_CLOSED_TIMEOUT
Stream closed because the lease expired.
static final String
STREAM_STATUS_CANT_REACH_PEER
Stream connect failed because the peer could not be reached.
static final String
STREAM_STATUS_I2P_ERROR
STREAM_STATUS_I2P_ERROR.
static final String
STREAM_STATUS_INVALID_KEY
Stream connect failed because the private key is invalid.
static final String
STREAM_STATUS_OK
Stream connect succeeded.
static final String
STREAM_STATUS_TIMEOUT
Stream connect failed because the lease expired before it was established.
Constructor Summary
Constructors
Constructor
Description
SAMClientEventListenerImpl()
A listener that discards every event; the methods below are no-ops and there is no field to set, so a bare instance is the whole implementation.
Method Summary
All Methods
Modifier and Type
Method
Description
void
datagramReceived(String dest, byte[] data, int offset, int length, int fromPort, int toPort)
Called when a datagram arrives.
void
destReplyReceived(String publicKey, String privateKey)
Called when a DEST reply arrives.
void
helloReplyReceived(boolean ok, String version)
Called when the HELLO reply arrives.
void
namingReplyReceived(String name, String result, String value, String message)
Called when a NAMING reply arrives.
void
pingReceived(String data)
Called when a PING reply arrives.
void
pongReceived(String data)
Called when a PONG reply arrives.
void
rawReceived(byte[] data, int offset, int length, int fromPort, int toPort, int protocol)
Called when a raw datagram arrives.
void
sessionStatusReceived(String result, String destination, String message)
Called when a SESSION STATUS reply arrives.
void
streamClosedReceived(String result, String id, String message)
Called when a STREAM CLOSED reply arrives.
void
streamConnectedReceived(String remoteDestination, String id)
Called when a STREAM CONNECTED reply arrives.
void
streamDataReceived(String id, byte[] data, int offset, int length)
Called when data arrives on a stream.
void
streamStatusReceived(String result, String id, String message)
Called when a STREAM STATUS reply arrives.
void
unknownMessageReceived(String major, String minor, Properties params)
Called for a SAM message the reader does not parse.
Methods inherited from class Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details
- SAMClientEventListenerImpl
  public SAMClientEventListenerImpl()
  A listener that discards every event; the methods below are no-ops and there is no field to set, so a bare instance is the whole implementation.
Method Details
- destReplyReceived
  public void destReplyReceived(String publicKey, String privateKey)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a DEST reply arrives.
  Specified by:
  destReplyReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  publicKey - the base64 destination the bridge generated for us
  privateKey - the base64 private key matching that destination
- helloReplyReceived
  public void helloReplyReceived(boolean ok, String version)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when the HELLO reply arrives.
  Specified by:
  helloReplyReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  ok - whether the SAM bridge accepted our HELLO greeting
  version - the bridge version string it reported, null if none was sent
- namingReplyReceived
  public void namingReplyReceived(String name, String result, String value, String message)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a NAMING reply arrives.
  Specified by:
  namingReplyReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  name - the requested host name or service string
  result - the reply status, one of the NAMING_REPLY_* constants
  value - the resolved value, null when the lookup failed
  message - the human-readable explanation supplied by the bridge
- sessionStatusReceived
  public void sessionStatusReceived(String result, String destination, String message)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a SESSION STATUS reply arrives.
  Specified by:
  sessionStatusReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  result - the session status, one of the SESSION_STATUS_* constants
  destination - the base64 destination the status refers to
  message - the human-readable explanation supplied by the bridge
- streamClosedReceived
  public void streamClosedReceived(String result, String id, String message)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a STREAM CLOSED reply arrives.
  Specified by:
  streamClosedReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  result - the close status, one of the STREAM_CLOSED_* constants
  id - the stream ID of the stream that was closed
  message - the human-readable explanation supplied by the bridge
- streamConnectedReceived
  public void streamConnectedReceived(String remoteDestination, String id)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a STREAM CONNECTED reply arrives.
  Specified by:
  streamConnectedReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  remoteDestination - the base64 destination the stream is connected to
  id - the stream ID assigned by the SAM bridge
- streamDataReceived
  public void streamDataReceived(String id, byte[] data, int offset, int length)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when data arrives on a stream.
  Specified by:
  streamDataReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  id - the stream ID the data arrived on
  data - the buffer holding the payload
  offset - the index within data where the payload starts
  length - the number of payload bytes valid from offset
- streamStatusReceived
  public void streamStatusReceived(String result, String id, String message)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a STREAM STATUS reply arrives.
  Specified by:
  streamStatusReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  result - the stream status, one of the STREAM_STATUS_* constants
  id - the stream ID from the reply, null under SAM v3
  message - the human-readable explanation supplied by the bridge
- datagramReceived
  public void datagramReceived(String dest, byte[] data, int offset, int length, int fromPort, int toPort)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a datagram arrives.
  Specified by:
  datagramReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  dest - the base64 destination that sent the datagram
  data - the buffer holding the datagram body
  offset - the index within data where the body starts
  length - the number of body bytes valid from offset
  fromPort - the source port in host byte order
  toPort - the destination port in host byte order
- rawReceived
  public void rawReceived(byte[] data, int offset, int length, int fromPort, int toPort, int protocol)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a raw datagram arrives.
  Specified by:
  rawReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  data - the buffer holding the raw datagram body
  offset - the index within data where the body starts
  length - the number of body bytes valid from offset
  fromPort - the source port in host byte order
  toPort - the destination port in host byte order
  protocol - the IP protocol number, or I2PSession.PROTO_DATAGRAM_RAW when unreported
- pingReceived
  public void pingReceived(String data)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a PING reply arrives.
  Specified by:
  pingReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  data - the payload echoed back, limited to the first token of the line
- pongReceived
  public void pongReceived(String data)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called when a PONG reply arrives.
  Specified by:
  pongReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  data - the payload echoed back, limited to the first token of the line
- unknownMessageReceived
  public void unknownMessageReceived(String major, String minor, Properties params)
  Description copied from interface: SAMReader.SAMClientEventListener
  Called for a SAM message the reader does not parse.
  Specified by:
  unknownMessageReceived in interface SAMReader.SAMClientEventListener
  Parameters:
  major - the first token of the SAM message, naming the command family
  minor - the second token, naming the specific command within that family
  params - the remaining name=value pairs of the line, quotes stripped

Field Summary

Fields inherited from interface SAMReader.SAMClientEventListener

Constructor Summary

Method Summary

Methods inherited from class Object

Constructor Details

Method Details

destReplyReceived

helloReplyReceived

namingReplyReceived

sessionStatusReceived

streamClosedReceived

streamConnectedReceived

streamDataReceived

streamStatusReceived

datagramReceived

rawReceived

pingReceived

pongReceived

unknownMessageReceived