org.w3c.www.mux
Class SampleMuxHandler

java.lang.Object
  org.w3c.www.mux.SampleMuxHandler

All Implemented Interfaces:

MuxStreamHandler

public class SampleMuxHandler
extends java.lang.Object
implements MuxStreamHandler

Field Summary

static int	DISCARD Well known protocols - The echo protocol identifier.
static int	ECHO Well known protocols - The echo protocol identifier.
protected java.util.Hashtable	protocols The hashtable of accepted protocols.
protected static SampleMuxHandler	sample The sigle instance of that class.

Constructor Summary

SampleMuxHandler()

Method Summary

boolean	acceptSession(MuxStream stream, int sessid, int protid) Are we willing to speak the given protocol on the given session.
static MuxStreamHandler	getStreamHandler() Get an instance of that sample mux stream handler.
protected void	log(java.lang.String msg) Log an error.
void	notifySession(MuxSession session) Setup the appropriate protocol handler for that accepted session.
void	registerDefaultHandlers() Register default protocol handlers for that stream handler.
void	registerHandler(int protid, MuxProtocolHandler handler) Register an instantiated protocol handler for the given protocol id.
void	registerHandler(int protid, java.lang.String strhandler) Register a protocol handler for the given protocol identifier.
void	unregisterHandler(int protid) Unregister any handler for that protocol.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ECHO

public static final int ECHO

Well known protocols - The echo protocol identifier.

See Also:

Constant Field Values

DISCARD

public static final int DISCARD

Well known protocols - The echo protocol identifier.

See Also:

Constant Field Values

sample

protected static SampleMuxHandler sample

The sigle instance of that class.

protocols

protected java.util.Hashtable protocols

The hashtable of accepted protocols.

Constructor Detail

SampleMuxHandler

public SampleMuxHandler()

Method Detail

log

protected void log(java.lang.String msg)

Log an error.

Parameters:

msg - The message to log.

getStreamHandler

public static MuxStreamHandler getStreamHandler()

Get an instance of that sample mux stream handler.

Returns:

A MuxStreamHandler conformant instance.

acceptSession

public boolean acceptSession(MuxStream stream,
                             int sessid,
                             int protid)

Are we willing to speak the given protocol on the given session.

Specified by:

acceptSession in interface MuxStreamHandler

Parameters:

stream - The stream that received the new session.

sessid - The proposed session identifier.

protid - The protocol to be spoken on that session.

Returns:

A bolean, true if the session is accepted, false otherwise.

notifySession

public void notifySession(MuxSession session)

Setup the appropriate protocol handler for that accepted session.

Specified by:

notifySession in interface MuxStreamHandler

Parameters:

session - The newly accepted session.

registerHandler

public void registerHandler(int protid,
                            java.lang.String strhandler)

Register a protocol handler for the given protocol identifier. This method register a class to handle all new connections for the given protocol identifier: each new connection will result in a new instance of the given class being created (the easy, but slow way).

Parameters:

protid - The protocol identifier.

handler - The name of the class to instantiate in order to get a suitable handler for that protocol.

See Also:

MuxProtocolHandler

registerHandler

public void registerHandler(int protid,
                            MuxProtocolHandler handler)

Register an instantiated protocol handler for the given protocol id. This other method of registering protocol handler is faster then the previous one: it allows you to spare the instantiation of a protocol handler on each new sessions.

The given handler will be invoked for all new sessions willing to speak the advertized protocol.

Parameters:

protid - The protocol identifier.

handler - The instantiated protocol handler.

unregisterHandler

public void unregisterHandler(int protid)

Unregister any handler for that protocol.

Parameters:

protid - The identifier of the protocol to unregister.

registerDefaultHandlers

public void registerDefaultHandlers()

Register default protocol handlers for that stream handler. This is the right method to override in order to either prevent well known protocols from being registered, or add new protocol handlers.

Default protocols registered by this class are:

echo

The echo protocol.

discard

The discard protocol.