org.glassfish.grizzly.asyncqueue

Interface AsyncQueueWriter<L>

Type Parameters:

L - the destination address type

All Superinterfaces:

AsyncQueue, Writer<L>

All Known Implementing Classes:

AbstractNIOAsyncQueueWriter, TCPNIOAsyncQueueWriter, UDPNIOAsyncQueueWriter

public interface AsyncQueueWriter<L>
extends Writer<L>, AsyncQueue

The AsyncQueue, which implements asynchronous write queue.

Author:

Alexey Stashok, Ryan Lubke

Nested Class Summary

Nested classes/interfaces inherited from interface org.glassfish.grizzly.Writer

Writer.Reentrant

Nested classes/interfaces inherited from interface org.glassfish.grizzly.asyncqueue.AsyncQueue

AsyncQueue.AsyncResult

Field Summary

Fields

Modifier and Type	Field and Description
static int	AUTO_SIZE Constant set via setMaxPendingBytesPerConnection(int) means the async write queue size will be configured automatically per NIOConnection depending on connections write buffer size.
static int	UNLIMITED_SIZE Constant set via setMaxPendingBytesPerConnection(int) means the async write queue size is unlimited.

Fields inherited from interface org.glassfish.grizzly.asyncqueue.AsyncQueue

EXPECTING_MORE_OPTION

Method Summary

Modifier and Type	Method and Description
boolean	canWrite(Connection<L> connection, int size) Deprecated. the size parameter will be ignored, use Writer.canWrite(org.glassfish.grizzly.Connection) instead.
int	getMaxPendingBytesPerConnection()
boolean	isAllowDirectWrite() Returns true, if async write queue is allowed to write buffer directly during write(...) method call, w/o adding buffer to the queue, or false otherwise.
void	notifyWritePossible(Connection<L> connection, WriteHandler writeHandler, int size) Deprecated. the size parameter will be ignored, use {@link #notifyWritePossible(org.glassfish.grizzly.Connection, org.glassfish.grizzly.WriteHandler) instead.
void	setAllowDirectWrite(boolean isAllowDirectWrite) Set true, if async write queue is allowed to write buffer directly during write(...) method call, w/o adding buffer to the queue, or false otherwise.
void	setMaxPendingBytesPerConnection(int maxQueuedWrites) Configures the maximum number of bytes pending to be written for a particular Connection.
void	write(Connection<L> connection, L dstAddress, WritableMessage message, CompletionHandler<WriteResult<WritableMessage,L>> completionHandler, PushBackHandler pushBackHandler, MessageCloner<WritableMessage> cloner) Deprecated. push back logic is deprecated

Methods inherited from interface org.glassfish.grizzly.Writer

canWrite, notifyWritePossible, write, write, write, write, write, write

Methods inherited from interface org.glassfish.grizzly.asyncqueue.AsyncQueue

close, isReady, onClose, processAsync

Field Detail

UNLIMITED_SIZE

static final int UNLIMITED_SIZE

Constant set via setMaxPendingBytesPerConnection(int) means the async write queue size is unlimited.

See Also:

Constant Field Values

AUTO_SIZE

static final int AUTO_SIZE

Constant set via setMaxPendingBytesPerConnection(int) means the async write queue size will be configured automatically per NIOConnection depending on connections write buffer size.

See Also:

Constant Field Values

Method Detail

write

@Deprecated
void write(Connection<L> connection,
                       L dstAddress,
                       WritableMessage message,
                       CompletionHandler<WriteResult<WritableMessage,L>> completionHandler,
                       PushBackHandler pushBackHandler,
                       MessageCloner<WritableMessage> cloner)

Deprecated. push back logic is deprecated

Method writes the Buffer to the specific address.

Parameters:

connection - the Connection to write to

dstAddress - the destination address the WritableMessage will be sent to

message - the WritableMessage, from which the data will be written

completionHandler - CompletionHandler, which will get notified, when write will be completed

pushBackHandler - PushBackHandler, which will be notified if message was accepted by transport write queue or refused

cloner - MessageCloner, which will be invoked by AsyncQueueWriter, if message could not be written to a channel directly and has to be put on a asynchronous queue

canWrite

@Deprecated
boolean canWrite(Connection<L> connection,
                             int size)

Deprecated. the size parameter will be ignored, use Writer.canWrite(org.glassfish.grizzly.Connection) instead.

Parameters:

connection - the Connection to test whether or not the specified number of bytes can be written to.

size - number of bytes to write.

Returns:

true if the queue has not exceeded it's maximum size in bytes of pending writes, otherwise false

Since:

2.2

notifyWritePossible

@Deprecated
void notifyWritePossible(Connection<L> connection,
                                     WriteHandler writeHandler,
                                     int size)

Deprecated. the size parameter will be ignored, use {@link #notifyWritePossible(org.glassfish.grizzly.Connection, org.glassfish.grizzly.WriteHandler) instead.

Registers WriteHandler, which will be notified ones the Connection is able to accept more bytes to be written. Note: using this method from different threads simultaneously may lead to quick situation changes, so at time WriteHandler is called - the queue may become busy again.

Parameters:

connection - Connection

writeHandler - WriteHandler to be notified.

size - number of bytes queue has to be able to accept before notifying WriteHandler.

Since:

2.2

setMaxPendingBytesPerConnection

void setMaxPendingBytesPerConnection(int maxQueuedWrites)

Configures the maximum number of bytes pending to be written for a particular Connection.

Parameters:

maxQueuedWrites - maximum number of bytes that may be pending to be written to a particular Connection.

getMaxPendingBytesPerConnection

int getMaxPendingBytesPerConnection()

Returns:

the maximum number of bytes that may be pending to be written to a particular Connection. By default, this will be four times the size of the Socket send buffer size.

isAllowDirectWrite

boolean isAllowDirectWrite()

Returns true, if async write queue is allowed to write buffer directly during write(...) method call, w/o adding buffer to the queue, or false otherwise.

Returns:

true, if async write queue is allowed to write buffer directly during write(...) method call, w/o adding buffer to the queue, or false otherwise.

setAllowDirectWrite

void setAllowDirectWrite(boolean isAllowDirectWrite)

Set true, if async write queue is allowed to write buffer directly during write(...) method call, w/o adding buffer to the queue, or false otherwise.

Parameters:

isAllowDirectWrite - true, if async write queue is allowed to write buffer directly during write(...) method call, w/o adding buffer to the queue, or false otherwise.