Class TextLineEncoder

java.lang.Object

org.apache.mina.filter.codec.ProtocolEncoderAdapter

org.apache.mina.filter.codec.textline.TextLineEncoder

All Implemented Interfaces:

ProtocolEncoder

public class TextLineEncoder
extends ProtocolEncoderAdapter

A ProtocolEncoder which encodes a string into a text line which ends with the delimiter.

Field Summary

Fields

Modifier and Type	Field	Description
private final Charset	charset
private final LineDelimiter	delimiter
private static final AttributeKey	ENCODER
private int	maxLineLength

Constructor Summary

Constructors

Constructor	Description
TextLineEncoder()	Creates a new instance with the current default Charset and LineDelimiter.UNIX delimiter.
TextLineEncoder(String delimiter)	Creates a new instance with the current default Charset and the specified delimiter.
TextLineEncoder(Charset charset)	Creates a new instance with the specified charset and LineDelimiter.UNIX delimiter.
TextLineEncoder(Charset charset, String delimiter)	Creates a new instance with the specified charset and the specified delimiter.
TextLineEncoder(Charset charset, LineDelimiter delimiter)	Creates a new instance with the specified charset and the specified delimiter.
TextLineEncoder(LineDelimiter delimiter)	Creates a new instance with the current default Charset and the specified delimiter.

Method Summary

Modifier and Type	Method	Description
void	dispose()	Dispose the encoder
void	encode(IoSession session, Object message, ProtocolEncoderOutput out)	Encodes higher-level message objects into binary or protocol-specific data.
int	getMaxLineLength()
void	setMaxLineLength(int maxLineLength)	Sets the allowed maximum size of the encoded line.

Methods inherited from class ProtocolEncoderAdapter

dispose

Methods inherited from class Object

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

Field Details

ENCODER

private static final AttributeKey ENCODER

charset

private final Charset charset

delimiter

private final LineDelimiter delimiter

maxLineLength

private int maxLineLength

Constructor Details

TextLineEncoder

public TextLineEncoder()

Creates a new instance with the current default Charset and LineDelimiter.UNIX delimiter.

TextLineEncoder

public TextLineEncoder(String delimiter)

Creates a new instance with the current default Charset and the specified delimiter.

Parameters:

delimiter - The line delimiter to use

TextLineEncoder

public TextLineEncoder(LineDelimiter delimiter)

Creates a new instance with the current default Charset and the specified delimiter.

Parameters:

delimiter - The line delimiter to use

TextLineEncoder

public TextLineEncoder(Charset charset)

Creates a new instance with the specified charset and LineDelimiter.UNIX delimiter.

Parameters:

charset - The Charset to use

TextLineEncoder

public TextLineEncoder(Charset charset,
 String delimiter)

Creates a new instance with the specified charset and the specified delimiter.

Parameters:

charset - The Charset to use

delimiter - The line delimiter to use

TextLineEncoder

public TextLineEncoder(Charset charset,
 LineDelimiter delimiter)

Creates a new instance with the specified charset and the specified delimiter.

Parameters:

charset - The Charset to use

delimiter - The line delimiter to use

Method Details

getMaxLineLength

public int getMaxLineLength()

Returns:

the allowed maximum size of the encoded line. If the size of the encoded line exceeds this value, the encoder will throw a IllegalArgumentException. The default value is Integer.MAX_VALUE.

setMaxLineLength

public void setMaxLineLength(int maxLineLength)

Sets the allowed maximum size of the encoded line. If the size of the encoded line exceeds this value, the encoder will throw a IllegalArgumentException. The default value is Integer.MAX_VALUE.

Parameters:

maxLineLength - The maximum line length

encode

public void encode(IoSession session,
 Object message,
 ProtocolEncoderOutput out)
            throws 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.

Parameters:

session - The current Session

message - the message to encode

out - The ProtocolEncoderOutput that will receive the encoded message

Throws:

Exception - if the message violated protocol specification

dispose

public void dispose()
             throws Exception

Dispose the encoder

Throws:

Exception - If the dispose failed