Package org.jboss.netty.handler.codec.serialization

Class CompatibleObjectEncoder

java.lang.Object

org.jboss.netty.handler.codec.oneone.OneToOneEncoder

org.jboss.netty.handler.codec.serialization.CompatibleObjectEncoder

All Implemented Interfaces:

ChannelDownstreamHandler, ChannelHandler

public class CompatibleObjectEncoder
extends OneToOneEncoder

An encoder which serializes a Java object into a ChannelBuffer (interoperability version).

This encoder is interoperable with the standard Java object streams such as ObjectInputStream and ObjectOutputStream.

Nested Class Summary

Nested classes/interfaces inherited from interface org.jboss.netty.channel.ChannelHandler

ChannelHandler.Sharable

Field Summary

Fields

Modifier and Type	Field	Description
private java.util.concurrent.atomic.AtomicReference<ChannelBuffer>	buffer
private java.io.ObjectOutputStream	oout
private int	resetInterval
private int	writtenObjects

Constructor Summary

Constructors

Constructor	Description
CompatibleObjectEncoder()	Creates a new instance with the reset interval of 16.
CompatibleObjectEncoder(int resetInterval)	Creates a new instance.

Method Summary

Modifier and Type	Method	Description
private ChannelBuffer	buffer(ChannelHandlerContext ctx)
protected java.lang.Object	encode(ChannelHandlerContext context, Channel channel, java.lang.Object msg)	Transforms the specified message into another message and return the transformed message.
protected java.io.ObjectOutputStream	newObjectOutputStream(java.io.OutputStream out)	Creates a new ObjectOutputStream which wraps the specified OutputStream.

Methods inherited from class org.jboss.netty.handler.codec.oneone.OneToOneEncoder

doEncode, handleDownstream

Methods inherited from class java.lang.Object

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

Field Detail

buffer

private final java.util.concurrent.atomic.AtomicReference<ChannelBuffer> buffer

resetInterval

private final int resetInterval

oout

private volatile java.io.ObjectOutputStream oout

writtenObjects

private int writtenObjects

Constructor Detail

CompatibleObjectEncoder

public CompatibleObjectEncoder()

Creates a new instance with the reset interval of 16.

CompatibleObjectEncoder

public CompatibleObjectEncoder(int resetInterval)

Creates a new instance.

Parameters:

resetInterval - the number of objects between ObjectOutputStream.reset(). 0 will disable resetting the stream, but the remote peer will be at the risk of getting OutOfMemoryError in the long term.

Method Detail

newObjectOutputStream

protected java.io.ObjectOutputStream newObjectOutputStream(java.io.OutputStream out)
                                                    throws java.lang.Exception

Creates a new ObjectOutputStream which wraps the specified OutputStream. Override this method to use a subclass of the ObjectOutputStream.

Throws:

java.lang.Exception

encode

protected java.lang.Object encode(ChannelHandlerContext context,
                                  Channel channel,
                                  java.lang.Object msg)
                           throws java.lang.Exception

Description copied from class: OneToOneEncoder

Transforms the specified message into another message and return the transformed message. Note that you can not return null, unlike you can in OneToOneDecoder.decode(ChannelHandlerContext, Channel, Object); you must return something, at least ChannelBuffers.EMPTY_BUFFER.

Specified by:

encode in class OneToOneEncoder

Throws:

java.lang.Exception

buffer

private ChannelBuffer buffer(ChannelHandlerContext ctx)
                      throws java.lang.Exception

Throws:

java.lang.Exception