I2PSessionDemultiplexer (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- net.i2p.client.impl.I2PSessionDemultiplexer

All Implemented Interfaces:
I2PSessionListener, I2PSessionMuxedListener
```
public class I2PSessionDemultiplexer
extends Object
implements I2PSessionMuxedListener
```
Implement multiplexing with a 1-byte 'protocol' and a two-byte 'port'. Listeners register with either addListener() or addMuxedListener(), depending on whether they want to hear about the protocol, from port, and to port for every received message. messageAvailable() only calls one listener, not all that apply. The others call all listeners.

Constructor Summary
Constructors
Constructor and Description
I2PSessionDemultiplexer(I2PAppContext ctx)
Create a new demultiplexer.

Constructors
Constructor and Description
`I2PSessionDemultiplexer(I2PAppContext ctx)` Create a new demultiplexer.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addListener(I2PSessionListener l, int proto, int port)` For those that don't need to hear about the protocol and ports in messageAvailable() (Streaming lib)
`void`	`addMuxedListener(I2PSessionMuxedListener l, int proto, int port)` For those that do care UDP perhaps
`void`	`disconnected(I2PSession session)` Notify the client that the session has been terminated.
`void`	`errorOccurred(I2PSession session, String message, Throwable error)` Notify the client that some error occurred.
`void`	`messageAvailable(I2PSession session, int msgId, long size)` Will be called only if you register via setSessionListener() or addSessionListener().
`void`	`messageAvailable(I2PSession session, int msgId, long size, int proto, int fromport, int toport)` Instruct the client that the given session has received a message Will be called only if you register via addMuxedSessionListener().
`static String`	`protocolNumberToString(int proto)` Convert a protocol number to a human-readable string.
`void`	`removeListener(int proto, int port)` Remove a listener for the given protocol and port.
`void`	`reportAbuse(I2PSession session, int severity)` Instruct the client that the session specified seems to be under attack and that the client may wish to move its destination to another router.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - I2PSessionDemultiplexer
```
public I2PSessionDemultiplexer(I2PAppContext ctx)
```
    Create a new demultiplexer.
    Parameters:
    ctx - context
- Method Detail
  - addListener
```
public void addListener(I2PSessionListener l,
                        int proto,
                        int port)
```
    For those that don't need to hear about the protocol and ports in messageAvailable() (Streaming lib)
    Parameters:
    l - the listener
    proto - the protocol number
    port - the port number
  - addMuxedListener
```
public void addMuxedListener(I2PSessionMuxedListener l,
                             int proto,
                             int port)
```
    For those that do care UDP perhaps
    Parameters:
    l - the listener
    proto - the protocol number
    port - the port number
  - disconnected
```
public void disconnected(I2PSession session)
```
    Description copied from interface: I2PSessionMuxedListener
    Notify the client that the session has been terminated. All registered listeners will be called.
    Specified by:
    disconnected in interface I2PSessionListener
    Specified by:
    disconnected in interface I2PSessionMuxedListener
    Parameters:
    session - the session
  - errorOccurred
```
public void errorOccurred(I2PSession session,
                          String message,
                          Throwable error)
```
    Description copied from interface: I2PSessionMuxedListener
    Notify the client that some error occurred. All registered listeners will be called.
    Specified by:
    errorOccurred in interface I2PSessionListener
    Specified by:
    errorOccurred in interface I2PSessionMuxedListener
    Parameters:
    session - the session
    message - the error message
    error - can be null? or not?
  - messageAvailable
```
public void messageAvailable(I2PSession session,
                             int msgId,
                             long size)
```
    Description copied from interface: I2PSessionMuxedListener
    Will be called only if you register via setSessionListener() or addSessionListener(). And if you are doing that, just use I2PSessionListener. If you register via addSessionListener(), this will be called only for the proto(s) and toport(s) you register for. After this is called, the client should call receiveMessage(msgId). There is currently no method for the client to reject the message. If the client does not call receiveMessage() within a timeout period (currently 30 seconds), the session will delete the message and log an error.
    Specified by:
    messageAvailable in interface I2PSessionListener
    Specified by:
    messageAvailable in interface I2PSessionMuxedListener
    Parameters:
    session - session to notify
    msgId - message number available
    size - size of the message - why it's a long and not an int is a mystery
  - messageAvailable
```
public void messageAvailable(I2PSession session,
                             int msgId,
                             long size,
                             int proto,
                             int fromport,
                             int toport)
```
    Description copied from interface: I2PSessionMuxedListener
    Instruct the client that the given session has received a message Will be called only if you register via addMuxedSessionListener(). Will be called only for the proto(s) and toport(s) you register for. After this is called, the client should call receiveMessage(msgId). There is currently no method for the client to reject the message. If the client does not call receiveMessage() within a timeout period (currently 30 seconds), the session will delete the message and log an error. Only one listener is called for a given message, even if more than one have registered. See I2PSessionDemultiplexer for details.
    Specified by:
    messageAvailable in interface I2PSessionMuxedListener
    Parameters:
    session - session to notify
    msgId - message number available
    size - size of the message - why it's a long and not an int is a mystery
    proto - 1-254 or 0 for unspecified
    fromport - 1-65535 or 0 for unspecified
    toport - 1-65535 or 0 for unspecified
  - protocolNumberToString
```
public static String protocolNumberToString(int proto)
```
    Convert a protocol number to a human-readable string.
    Parameters:
    proto - protocol number
    Returns:
    human-readable protocol name
  - removeListener
```
public void removeListener(int proto,
                           int port)
```
    Remove a listener for the given protocol and port.
    Parameters:
    proto - the protocol number
    port - the port number
  - reportAbuse
```
public void reportAbuse(I2PSession session,
                        int severity)
```
    Description copied from interface: I2PSessionMuxedListener
    Instruct the client that the session specified seems to be under attack and that the client may wish to move its destination to another router. All registered listeners will be called. Unused. Not fully implemented.
    Specified by:
    reportAbuse in interface I2PSessionListener
    Specified by:
    reportAbuse in interface I2PSessionMuxedListener
    Parameters:
    session - session to report abuse to
    severity - how bad the abuse is

Class I2PSessionDemultiplexer

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

I2PSessionDemultiplexer

Method Detail

addListener

addMuxedListener

disconnected

errorOccurred

messageAvailable

messageAvailable

protocolNumberToString

removeListener

reportAbuse