XNIO API 2.0.2.GA

org.jboss.xnio.channels
Interface WritableMessageChannel

All Superinterfaces:
java.nio.channels.Channel, java.io.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 handler for this channel.
 ChannelListener.Setter<? extends WritableMessageChannel> getWriteSetter()
          Get the setter which can be used to change the write handler for this channel.
 boolean send(java.nio.ByteBuffer buffer)
          Send a complete message.
 boolean send(java.nio.ByteBuffer[] buffers)
          Send a complete message.
 boolean send(java.nio.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(java.nio.ByteBuffer buffer)
             throws java.io.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:
java.io.IOException - if an I/O error occurs

send

boolean send(java.nio.ByteBuffer[] buffers)
             throws java.io.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:
java.io.IOException - if an I/O error occurs

send

boolean send(java.nio.ByteBuffer[] buffers,
             int offs,
             int len)
             throws java.io.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:
java.io.IOException - if an I/O error occurs

getWriteSetter

ChannelListener.Setter<? extends WritableMessageChannel> getWriteSetter()
Get the setter which can be used to change the write handler for this channel. When the handler 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 handler for this channel. If the channel is already closed, then the handler will not be called.

Specified by:
getCloseSetter in interface CloseableChannel
Specified by:
getCloseSetter in interface SuspendableWriteChannel
Returns:
the setter

XNIO API 2.0.2.GA

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