org.xnio.channels

Interface WritableMessageChannel

All Superinterfaces:

AutoCloseable, Channel, Closeable, CloseableChannel, Configurable, InterruptibleChannel, SuspendableWriteChannel

All Known Subinterfaces:

ConnectedMessageChannel, MessageChannel

All Known Implementing Classes:

FramedMessageChannel

public interface WritableMessageChannel
extends SuspendableWriteChannel, Configurable

A channel that can send messages.

Method Summary

Methods

Modifier and Type	Method and Description
ChannelListener.Setter<? extends WritableMessageChannel>	getCloseSetter() Get the setter which can be used to change the close listener for this channel.
ChannelListener.Setter<? extends WritableMessageChannel>	getWriteSetter() Get the setter which can be used to change the write listener for this channel.
boolean	send(ByteBuffer buffer) Send a complete message.
boolean	send(ByteBuffer[] buffers) Send a complete message.
boolean	send(ByteBuffer[] buffers, int offs, int len) Send a complete message.

Methods inherited from interface org.xnio.channels.SuspendableWriteChannel

awaitWritable, awaitWritable, close, flush, getWriteThread, isWriteResumed, resumeWrites, shutdownWrites, suspendWrites, wakeupWrites

Methods inherited from interface org.xnio.channels.CloseableChannel

getWorker

Methods inherited from interface java.nio.channels.Channel

isOpen

Methods inherited from interface org.xnio.channels.Configurable

getOption, setOption, supportsOption

Method Detail

send

boolean send(ByteBuffer buffer)
             throws IOException

Send a complete message.

Parameters:

buffer - the message to send

Returns:

the result of the send operation; true if the message was sent, or false if it would block

Throws:

IOException - if an I/O error occurs

send

boolean send(ByteBuffer[] buffers)
             throws IOException

Send a complete message.

Parameters:

buffers - the buffers holding the message to send

Returns:

the result of the send operation; true if the message was sent, or false if it would block

Throws:

IOException - if an I/O error occurs

send

boolean send(ByteBuffer[] buffers,
           int offs,
           int len)
             throws IOException

Send a complete message.

Parameters:

buffers - the buffers holding the message to send

offs - the offset into the buffer array of the first buffer

len - the number of buffers that contain data to send

Returns:

the result of the send operation; true if the message was sent, or false if it would block

Throws:

IOException - if an I/O error occurs

getWriteSetter

ChannelListener.Setter<? extends WritableMessageChannel> getWriteSetter()

Get the setter which can be used to change the write listener for this channel. When the listener is called, additional notifications are automatically suspended.

Specified by:

getWriteSetter in interface SuspendableWriteChannel

Returns:

the setter

getCloseSetter

ChannelListener.Setter<? extends WritableMessageChannel> getCloseSetter()

Get the setter which can be used to change the close listener for this channel. If the channel is already closed, then the listener will not be called.

Specified by:

getCloseSetter in interface CloseableChannel

Specified by:

getCloseSetter in interface SuspendableWriteChannel

Returns:

the setter