Package io.undertow.conduits

Class AbstractFramedStreamSinkConduit

java.lang.Object

org.xnio.conduits.AbstractConduit<D>

org.xnio.conduits.AbstractSinkConduit<D>

org.xnio.conduits.AbstractStreamSinkConduit<org.xnio.conduits.StreamSinkConduit>

io.undertow.conduits.AbstractFramedStreamSinkConduit

All Implemented Interfaces:

org.xnio.conduits.Conduit, org.xnio.conduits.SinkConduit, org.xnio.conduits.StreamSinkConduit

public class AbstractFramedStreamSinkConduit
extends org.xnio.conduits.AbstractStreamSinkConduit<org.xnio.conduits.StreamSinkConduit>

Utility class to ease the implementation of framed protocols. This call provides a queue of frames, and a callback that can be invoked when a frame event occurs.

When a write takes place all frames are attempted to be written out at once via a gathering write. Frames can be queued via queueFrame(io.undertow.conduits.AbstractFramedStreamSinkConduit.FrameCallBack, java.nio.ByteBuffer...).

Author:

Stuart Douglas

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AbstractFramedStreamSinkConduit.FrameCallBack	Interface that is called when a frame event takes place.
protected static class	AbstractFramedStreamSinkConduit.PooledBufferFrameCallback
protected static class	AbstractFramedStreamSinkConduit.PooledBuffersFrameCallback

Field Summary

Fields inherited from class org.xnio.conduits.AbstractConduit

next

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractFramedStreamSinkConduit(org.xnio.conduits.StreamSinkConduit next)	Construct a new instance.

Method Summary

Modifier and Type	Method	Description
protected void	doTerminateWrites()
protected void	finished()
protected boolean	flushQueuedData()
protected boolean	isWritesTerminated()
protected void	queueCloseFrames()
protected long	queuedDataLength()
protected void	queueFrame(AbstractFramedStreamSinkConduit.FrameCallBack callback, java.nio.ByteBuffer... data)	Queues a frame for sending.
void	terminateWrites()
long	transferFrom(java.nio.channels.FileChannel src, long position, long count)
long	transferFrom(org.xnio.channels.StreamSourceChannel source, long count, java.nio.ByteBuffer throughBuffer)
void	truncateWrites()
int	write(java.nio.ByteBuffer src)
long	write(java.nio.ByteBuffer[] srcs, int offs, int len)
int	writeFinal(java.nio.ByteBuffer src)
long	writeFinal(java.nio.ByteBuffer[] srcs, int offs, int len)

Methods inherited from class org.xnio.conduits.AbstractConduit

getWorker

Methods inherited from class org.xnio.conduits.AbstractSinkConduit

awaitWritable, awaitWritable, flush, getWriteThread, isWriteResumed, isWriteShutdown, resumeWrites, setWriteReadyHandler, suspendWrites, wakeupWrites

Methods inherited from interface org.xnio.conduits.Conduit

getWorker

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xnio.conduits.SinkConduit

awaitWritable, awaitWritable, flush, getWriteThread, isWriteResumed, isWriteShutdown, resumeWrites, setWriteReadyHandler, suspendWrites, wakeupWrites

Constructor Detail

AbstractFramedStreamSinkConduit

protected AbstractFramedStreamSinkConduit(org.xnio.conduits.StreamSinkConduit next)

Construct a new instance.

Parameters:

next - the delegate conduit to set

Method Detail

queueFrame

protected void queueFrame(AbstractFramedStreamSinkConduit.FrameCallBack callback,
                          java.nio.ByteBuffer... data)

Queues a frame for sending.

Parameters:

callback -

data -

transferFrom

public long transferFrom(java.nio.channels.FileChannel src,
                         long position,
                         long count)
                  throws java.io.IOException

Specified by:

transferFrom in interface org.xnio.conduits.StreamSinkConduit

Overrides:

transferFrom in class org.xnio.conduits.AbstractStreamSinkConduit<org.xnio.conduits.StreamSinkConduit>

Throws:

java.io.IOException

transferFrom

public long transferFrom(org.xnio.channels.StreamSourceChannel source,
                         long count,
                         java.nio.ByteBuffer throughBuffer)
                  throws java.io.IOException

Specified by:

transferFrom in interface org.xnio.conduits.StreamSinkConduit

Overrides:

transferFrom in class org.xnio.conduits.AbstractStreamSinkConduit<org.xnio.conduits.StreamSinkConduit>

Throws:

java.io.IOException

write

public int write(java.nio.ByteBuffer src)
          throws java.io.IOException

Specified by:

write in interface org.xnio.conduits.StreamSinkConduit

Overrides:

write in class org.xnio.conduits.AbstractStreamSinkConduit<org.xnio.conduits.StreamSinkConduit>

Throws:

java.io.IOException

write

public long write(java.nio.ByteBuffer[] srcs,
                  int offs,
                  int len)
           throws java.io.IOException

Specified by:

write in interface org.xnio.conduits.StreamSinkConduit

Overrides:

write in class org.xnio.conduits.AbstractStreamSinkConduit<org.xnio.conduits.StreamSinkConduit>

Throws:

java.io.IOException

writeFinal

public int writeFinal(java.nio.ByteBuffer src)
               throws java.io.IOException

Specified by:

writeFinal in interface org.xnio.conduits.StreamSinkConduit

Overrides:

writeFinal in class org.xnio.conduits.AbstractStreamSinkConduit<org.xnio.conduits.StreamSinkConduit>

Throws:

java.io.IOException

writeFinal

public long writeFinal(java.nio.ByteBuffer[] srcs,
                       int offs,
                       int len)
                throws java.io.IOException

Specified by:

writeFinal in interface org.xnio.conduits.StreamSinkConduit

Overrides:

writeFinal in class org.xnio.conduits.AbstractStreamSinkConduit<org.xnio.conduits.StreamSinkConduit>

Throws:

java.io.IOException

queuedDataLength

protected long queuedDataLength()

terminateWrites

public void terminateWrites()
                     throws java.io.IOException

Specified by:

terminateWrites in interface org.xnio.conduits.SinkConduit

Overrides:

terminateWrites in class org.xnio.conduits.AbstractSinkConduit<org.xnio.conduits.StreamSinkConduit>

Throws:

java.io.IOException

doTerminateWrites

protected void doTerminateWrites()
                          throws java.io.IOException

Throws:

java.io.IOException

flushQueuedData

protected boolean flushQueuedData()
                           throws java.io.IOException

Throws:

java.io.IOException

truncateWrites

public void truncateWrites()
                    throws java.io.IOException

Specified by:

truncateWrites in interface org.xnio.conduits.SinkConduit

Overrides:

truncateWrites in class org.xnio.conduits.AbstractSinkConduit<org.xnio.conduits.StreamSinkConduit>

Throws:

java.io.IOException

isWritesTerminated

protected boolean isWritesTerminated()

queueCloseFrames

protected void queueCloseFrames()

finished

protected void finished()