org.apache.mina.filter.codec.demux

Class DemuxingProtocolEncoder

java.lang.Object

org.apache.mina.filter.codec.demux.DemuxingProtocolEncoder

All Implemented Interfaces:

ProtocolEncoder

public class DemuxingProtocolEncoder
extends java.lang.Object
implements ProtocolEncoder

A composite ProtocolEncoder that demultiplexes incoming message encoding requests into an appropriate MessageEncoder.

Disposing resources acquired by MessageEncoder

Override dispose(IoSession) method. Please don't forget to call super.dispose().

See Also:

MessageEncoderFactory, MessageEncoder

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	DemuxingProtocolEncoder.DefaultConstructorMessageEncoderFactory<T>
private static class	DemuxingProtocolEncoder.SingletonMessageEncoderFactory<T>
private class	DemuxingProtocolEncoder.State

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.Class<?>[]	EMPTY_PARAMS
private AttributeKey	STATE
private java.util.Map<java.lang.Class<?>,MessageEncoderFactory>	type2encoderFactory

Constructor Summary

Constructors

Constructor and Description
DemuxingProtocolEncoder()

Method Summary

Modifier and Type	Method and Description
void	addMessageEncoder(java.lang.Class<?> messageType, java.lang.Class<? extends MessageEncoder> encoderClass)
<T> void	addMessageEncoder(java.lang.Class<T> messageType, MessageEncoder<? super T> encoder)
<T> void	addMessageEncoder(java.lang.Class<T> messageType, MessageEncoderFactory<? super T> factory)
void	addMessageEncoder(java.lang.Iterable<java.lang.Class<?>> messageTypes, java.lang.Class<? extends MessageEncoder> encoderClass)
<T> void	addMessageEncoder(java.lang.Iterable<java.lang.Class<? extends T>> messageTypes, MessageEncoder<? super T> encoder)
<T> void	addMessageEncoder(java.lang.Iterable<java.lang.Class<? extends T>> messageTypes, MessageEncoderFactory<? super T> factory)
void	dispose(IoSession session) Releases all resources related with this encoder.
void	encode(IoSession session, java.lang.Object message, ProtocolEncoderOutput out) Encodes higher-level message objects into binary or protocol-specific data.
protected MessageEncoder<java.lang.Object>	findEncoder(DemuxingProtocolEncoder.State state, java.lang.Class<?> type)
private MessageEncoder<java.lang.Object>	findEncoder(DemuxingProtocolEncoder.State state, java.lang.Class<?> type, java.util.Set<java.lang.Class<?>> triedClasses)
private DemuxingProtocolEncoder.State	getState(IoSession session)

Methods inherited from class java.lang.Object

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

Field Detail

STATE

private final AttributeKey STATE

type2encoderFactory

private final java.util.Map<java.lang.Class<?>,MessageEncoderFactory> type2encoderFactory

EMPTY_PARAMS

private static final java.lang.Class<?>[] EMPTY_PARAMS

Constructor Detail

DemuxingProtocolEncoder

public DemuxingProtocolEncoder()

Method Detail

addMessageEncoder

public void addMessageEncoder(java.lang.Class<?> messageType,
                              java.lang.Class<? extends MessageEncoder> encoderClass)

addMessageEncoder

public <T> void addMessageEncoder(java.lang.Class<T> messageType,
                                  MessageEncoder<? super T> encoder)

addMessageEncoder

public <T> void addMessageEncoder(java.lang.Class<T> messageType,
                                  MessageEncoderFactory<? super T> factory)

addMessageEncoder

public void addMessageEncoder(java.lang.Iterable<java.lang.Class<?>> messageTypes,
                              java.lang.Class<? extends MessageEncoder> encoderClass)

addMessageEncoder

public <T> void addMessageEncoder(java.lang.Iterable<java.lang.Class<? extends T>> messageTypes,
                                  MessageEncoder<? super T> encoder)

addMessageEncoder

public <T> void addMessageEncoder(java.lang.Iterable<java.lang.Class<? extends T>> messageTypes,
                                  MessageEncoderFactory<? super T> factory)

encode

public void encode(IoSession session,
                   java.lang.Object message,
                   ProtocolEncoderOutput out)
            throws java.lang.Exception

Encodes higher-level message objects into binary or protocol-specific data. MINA invokes ProtocolEncoder.encode(IoSession, Object, ProtocolEncoderOutput) method with message which is popped from the session write queue, and then the encoder implementation puts encoded messages (typically IoBuffers) into ProtocolEncoderOutput.

Specified by:

encode in interface ProtocolEncoder

Throws:

java.lang.Exception - if the message violated protocol specification

findEncoder

protected MessageEncoder<java.lang.Object> findEncoder(DemuxingProtocolEncoder.State state,
                                                       java.lang.Class<?> type)

findEncoder

private MessageEncoder<java.lang.Object> findEncoder(DemuxingProtocolEncoder.State state,
                                                     java.lang.Class<?> type,
                                                     java.util.Set<java.lang.Class<?>> triedClasses)

dispose

public void dispose(IoSession session)
             throws java.lang.Exception

Releases all resources related with this encoder.

Specified by:

dispose in interface ProtocolEncoder

Throws:

java.lang.Exception - if failed to dispose all resources

getState

private DemuxingProtocolEncoder.State getState(IoSession session)
                                        throws java.lang.Exception

Throws:

java.lang.Exception