Package io.netty.handler.codec.smtp

Class SmtpResponseDecoder

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelInboundHandlerAdapter

io.netty.handler.codec.ByteToMessageDecoder

io.netty.handler.codec.LineBasedFrameDecoder

io.netty.handler.codec.smtp.SmtpResponseDecoder

All Implemented Interfaces:

ChannelHandler, ChannelInboundHandler

@UnstableApi
public final class SmtpResponseDecoder
extends LineBasedFrameDecoder

Decoder for SMTP responses.

Nested Class Summary

Nested classes/interfaces inherited from class io.netty.handler.codec.ByteToMessageDecoder

ByteToMessageDecoder.Cumulator

Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler

ChannelHandler.Sharable

Field Summary

Fields inherited from class io.netty.handler.codec.ByteToMessageDecoder

COMPOSITE_CUMULATOR, MERGE_CUMULATOR

Constructor Summary

Constructors

Constructor	Description
SmtpResponseDecoder(int maxLineLength)	Creates a new instance that enforces the given maxLineLength and a default limit of 64 KiB on the accumulated size of a multi-line response.
SmtpResponseDecoder(int maxLineLength, int maxResponseSize)	Creates a new instance that enforces the given maxLineLength and maxResponseSize.

Method Summary

Modifier and Type	Method	Description
protected SmtpResponse	decode(ChannelHandlerContext ctx, ByteBuf buffer)	Create a frame out of the ByteBuf and return it.

Methods inherited from class io.netty.handler.codec.LineBasedFrameDecoder

decode

Methods inherited from class io.netty.handler.codec.ByteToMessageDecoder

actualReadableBytes, callDecode, channelInactive, channelRead, channelReadComplete, decodeLast, discardSomeReadBytes, handlerRemoved, handlerRemoved0, internalBuffer, isSingleDecode, setCumulator, setDiscardAfterReads, setSingleDecode, userEventTriggered

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

channelActive, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, handlerAdded, isSharable

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.netty.channel.ChannelHandler

handlerAdded

Constructor Details

SmtpResponseDecoder

public SmtpResponseDecoder(int maxLineLength)

Creates a new instance that enforces the given maxLineLength and a default limit of 64 KiB on the accumulated size of a multi-line response.

Parameters:

maxLineLength - the maximum length of a single response line, in bytes.

SmtpResponseDecoder

public SmtpResponseDecoder(int maxLineLength,
 int maxResponseSize)

Creates a new instance that enforces the given maxLineLength and maxResponseSize.

The lines of a multi-line response are buffered until its terminating line arrives. maxResponseSize bounds that buffering. Once it is exceeded, decoding fails with a TooLongFrameException. The limit is approximate and tracks retained memory rather than bytes received, as it charges each buffered line a fixed object overhead in addition to its detail bytes, and ignores the response code, the separator and the terminating line.

Parameters:

maxLineLength - the maximum length of a single response line, in bytes.

maxResponseSize - the maximum accumulated size of a multi-line response, in bytes.

Method Details

decode

protected SmtpResponse decode(ChannelHandlerContext ctx,
 ByteBuf buffer)
                       throws Exception

Description copied from class: LineBasedFrameDecoder

Create a frame out of the ByteBuf and return it.

Overrides:

decode in class LineBasedFrameDecoder

Parameters:

ctx - the ChannelHandlerContext which this ByteToMessageDecoder belongs to

buffer - the ByteBuf from which to read data

Returns:

frame the ByteBuf which represent the frame or null if no frame could be created.

Throws:

Exception