|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.i2p.client.I2PSessionImpl
abstract class I2PSessionImpl
Implementation of an I2P session running over TCP. This class is NOT thread safe - only one thread should send messages at any given time
Nested Class Summary | |
---|---|
protected class |
I2PSessionImpl.AvailabilityNotifier
|
protected class |
I2PSessionImpl.VerifyUsage
|
Field Summary | |
---|---|
protected I2PSessionImpl.AvailabilityNotifier |
_availabilityNotifier
thread that we tell when new messages are available who then tells us to fetch them. |
protected java.util.Map<java.lang.Long,MessagePayloadMessage> |
_availableMessages
map of Long --> MessagePayloadMessage |
protected boolean |
_closed
whether the session connection has already been closed (or not yet opened) |
protected boolean |
_closing
whether the session connection is in the process of being closed |
protected I2PAppContext |
_context
used to seperate things out so we can get rid of singletons |
protected I2PClientMessageHandlerMap |
_handlerMap
|
protected java.lang.String |
_hostname
hostname of router |
protected Log |
_log
|
protected boolean |
_opening
whether the session connection is in the process of being opened |
protected java.io.OutputStream |
_out
where we pipe our messages |
protected int |
_portNum
port num to router |
protected I2CPMessageProducer |
_producer
class that generates new messages |
protected I2CPMessageReader |
_reader
reader that always searches for messages |
protected I2PSessionListener |
_sessionListener
who we send events to |
protected java.net.Socket |
_socket
socket for comm |
protected ClientWriterRunner |
_writer
writer message queue |
static int |
LISTEN_PORT
|
Fields inherited from interface net.i2p.client.I2PSession |
---|
PORT_ANY, PORT_UNSPECIFIED, PROTO_ANY, PROTO_DATAGRAM, PROTO_STREAMING, PROTO_UNSPECIFIED |
Constructor Summary | |
---|---|
I2PSessionImpl()
for extension |
|
I2PSessionImpl(I2PAppContext context,
java.io.InputStream destKeyStream,
java.util.Properties options)
Create a new session, reading the Destination, PrivateKey, and SigningPrivateKey from the destKeyStream, and using the specified options to connect to the router |
Method Summary | |
---|---|
void |
addNewMessage(MessagePayloadMessage msg)
Recieve a payload message and let the app know its available |
int[] |
bandwidthLimits()
Get the current bandwidth limits |
void |
connect()
Connect to the router and establish a session. |
(package private) void |
dateUpdated()
|
void |
destroySession()
Tear down the session, and do NOT reconnect. |
void |
destroySession(boolean sendDisconnect)
Tear down the session, and do NOT reconnect. |
protected void |
disconnect()
|
void |
disconnected(I2CPMessageReader reader)
Recieve notification that the I2CP connection was disconnected |
PrivateKey |
getDecryptionKey()
Retrieve the decryption PrivateKey |
(package private) LeaseSet |
getLeaseSet()
|
Destination |
getMyDestination()
Retrieve the destination of the session |
(package private) boolean |
getOpening()
|
(package private) java.util.Properties |
getOptions()
Retrieve the configuration options |
protected java.lang.String |
getPrefix()
|
SigningPrivateKey |
getPrivateKey()
Retrieve the signing SigningPrivateKey |
(package private) I2CPMessageProducer |
getProducer()
Retrieve the helper that generates I2CP messages |
(package private) SessionId |
getSessionId()
Retrieve the session's ID |
boolean |
isClosed()
has the session been closed (or not yet connected)? |
long |
lastActivity()
|
protected void |
loadConfig(java.util.Properties options)
Parse the config for anything we know about |
Destination |
lookupDest(Hash h)
Lookup up a Hash |
void |
messageReceived(I2CPMessageReader reader,
I2CPMessage message)
Recieve notification of some I2CP message and handle it if possible |
(package private) void |
propogateError(java.lang.String msg,
java.lang.Throwable error)
Pass off the error to the listener Misspelled, oh well. |
void |
readError(I2CPMessageReader reader,
java.lang.Exception error)
Recieve notifiation of an error reading the I2CP stream |
byte[] |
receiveMessage(int msgId)
Pull the unencrypted data from the message that we've already prefetched and notified the user that its available. |
abstract void |
receiveStatus(int msgId,
long nonce,
int status)
|
protected boolean |
reconnect()
|
void |
reportAbuse(int msgId,
int severity)
Report abuse with regards to the given messageId |
abstract boolean |
sendMessage(Destination dest,
byte[] payload)
Send the data to the destination. |
abstract boolean |
sendMessage(Destination dest,
byte[] payload,
SessionKey keyUsed,
java.util.Set tagsSent)
Like sendMessage above, except the key used and the tags sent are exposed to the application. |
(package private) void |
sendMessage(I2CPMessage message)
Deliver an I2CP message to the router |
(package private) void |
setLeaseSet(LeaseSet ls)
|
(package private) void |
setOpening(boolean ls)
|
void |
setReduced()
|
(package private) void |
setSessionId(SessionId id)
|
void |
setSessionListener(I2PSessionListener lsnr)
configure the listener |
protected boolean |
shouldReconnect()
|
java.lang.String |
toString()
|
protected void |
updateActivity()
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface net.i2p.client.I2PSession |
---|
addMuxedSessionListener, addSessionListener, removeListener, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage, sendMessage |
Field Detail |
---|
protected Log _log
protected java.lang.String _hostname
protected int _portNum
protected java.net.Socket _socket
protected I2CPMessageReader _reader
protected ClientWriterRunner _writer
protected java.io.OutputStream _out
protected I2PSessionListener _sessionListener
protected I2CPMessageProducer _producer
protected java.util.Map<java.lang.Long,MessagePayloadMessage> _availableMessages
protected I2PClientMessageHandlerMap _handlerMap
protected I2PAppContext _context
protected boolean _closed
protected boolean _closing
protected boolean _opening
protected I2PSessionImpl.AvailabilityNotifier _availabilityNotifier
public static final int LISTEN_PORT
Constructor Detail |
---|
public I2PSessionImpl()
public I2PSessionImpl(I2PAppContext context, java.io.InputStream destKeyStream, java.util.Properties options) throws I2PSessionException
I2PSessionException
- if there is a problem loading the private keys orMethod Detail |
---|
void dateUpdated()
protected void loadConfig(java.util.Properties options)
void setLeaseSet(LeaseSet ls)
LeaseSet getLeaseSet()
void setOpening(boolean ls)
boolean getOpening()
public void connect() throws I2PSessionException
connect
in interface I2PSession
I2PSessionException
- if there is a configuration error or the router is
not reachablepublic byte[] receiveMessage(int msgId) throws I2PSessionException
receiveMessage
in interface I2PSession
msgId
- message to fetch
I2PSessionException
public void reportAbuse(int msgId, int severity) throws I2PSessionException
reportAbuse
in interface I2PSession
msgId
- message that was abusive (or -1 for not message related)severity
- how abusive
I2PSessionException
public abstract boolean sendMessage(Destination dest, byte[] payload) throws I2PSessionException
sendMessage
in interface I2PSession
dest
- location to send the messagepayload
- body of the message to be sent (unencrypted)
I2PSessionException
public abstract boolean sendMessage(Destination dest, byte[] payload, SessionKey keyUsed, java.util.Set tagsSent) throws I2PSessionException
I2PSession
SessionKeyManager.getInstance().tagsDelivered(dest.getPublicKey(), keyUsed, tagsSent);If an application is using guaranteed delivery mode, this is not useful, but for applications using best effort delivery mode, if they can know with certainty that a message was delivered and can update the SessionKeyManager appropriately, a significant performance boost will occur (subsequent message encryption and decryption will be done via AES and a SessionTag, rather than ElGamal+AES, which is 1000x slower).
sendMessage
in interface I2PSession
keyUsed
- unused - no end-to-end cryptotagsSent
- unused - no end-to-end cryptodest
- location to send the messagepayload
- body of the message to be sent (unencrypted)
I2PSessionException
public abstract void receiveStatus(int msgId, long nonce, int status)
public void addNewMessage(MessagePayloadMessage msg)
public void messageReceived(I2CPMessageReader reader, I2CPMessage message)
messageReceived
in interface I2CPMessageReader.I2CPMessageEventListener
reader
- I2CPMessageReader to notifymessage
- the I2CPMessagepublic void readError(I2CPMessageReader reader, java.lang.Exception error)
readError
in interface I2CPMessageReader.I2CPMessageEventListener
reader
- I2CPMessageReader to notifyerror
- Exception that was thrownpublic Destination getMyDestination()
getMyDestination
in interface I2PSession
public PrivateKey getDecryptionKey()
getDecryptionKey
in interface I2PSession
public SigningPrivateKey getPrivateKey()
getPrivateKey
in interface I2PSession
I2CPMessageProducer getProducer()
java.util.Properties getOptions()
SessionId getSessionId()
void setSessionId(SessionId id)
public void setSessionListener(I2PSessionListener lsnr)
setSessionListener
in interface I2PSession
lsnr
- listener to retrieve eventspublic boolean isClosed()
isClosed
in interface I2PSession
void sendMessage(I2CPMessage message) throws I2PSessionException
I2PSessionException
- if the message is malformed or there is an error writing it outvoid propogateError(java.lang.String msg, java.lang.Throwable error)
public void destroySession()
destroySession
in interface I2PSession
public void destroySession(boolean sendDisconnect)
public void disconnected(I2CPMessageReader reader)
disconnected
in interface I2CPMessageReader.I2CPMessageEventListener
reader
- I2CPMessageReader to notifyprotected void disconnect()
protected boolean shouldReconnect()
protected boolean reconnect()
protected java.lang.String getPrefix()
public Destination lookupDest(Hash h) throws I2PSessionException
I2PSession
lookupDest
in interface I2PSession
I2PSessionException
public int[] bandwidthLimits() throws I2PSessionException
I2PSession
bandwidthLimits
in interface I2PSession
I2PSessionException
protected void updateActivity()
public long lastActivity()
public void setReduced()
public java.lang.String toString()
toString
in class java.lang.Object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |