XNIO API 2.1.0.CR2

org.jboss.xnio.channels
Interface WritableMessageChannel

All Superinterfaces:
Channel, Closeable, CloseableChannel, Configurable, SuspendableWriteChannel
All Known Subinterfaces:
DatagramChannel<A>, MessageChannel

public interface WritableMessageChannel
extends SuspendableWriteChannel, Configurable

A channel that can send messages.


Method Summary
 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.jboss.xnio.channels.SuspendableWriteChannel
awaitWritable, awaitWritable, flush, resumeWrites, shutdownWrites, suspendWrites
 
Methods inherited from interface java.nio.channels.Channel
close, isOpen
 
Methods inherited from interface org.jboss.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

XNIO API 2.1.0.CR2

Copyright © 2010 JBoss, a division of Red Hat, Inc.