javax.websocket
Interface MessageHandler.Async<T>

Type Parameters:

T - The type of the object that represent pieces of the incoming message that this MessageHandler will consume.

All Superinterfaces:

MessageHandler

Enclosing interface:

MessageHandler

public static interface MessageHandler.Async<T>
extends MessageHandler

This kind of handler is notified by the implementation as it becomes ready to deliver parts of a whole message.

For handling parts of text messages, the type T is String

For handling parts of binary messages, the allowable types for T are

• ByteBuffer
• byte[]

Developers should not continue to reference message objects of type ByteBuffer after the completion of the onMessage() call, since they may be recycled by the implementation.

Note: Implementations may choose their own schemes for delivering large messages in smaller parts through this API. These schemes may or may not bear a relationship to the underlying websocket dataframes in which the message is received off the wire.

Since:

DRAFT 002

Nested Class Summary

Nested classes/interfaces inherited from interface javax.websocket.MessageHandler

MessageHandler.Async<T>, MessageHandler.Basic<T>

Method Summary

void	onMessage(T partialMessage, boolean last) Called when the next part of a message has been fully received.

Method Detail

onMessage

void onMessage(T partialMessage,
               boolean last)

Called when the next part of a message has been fully received.

Parameters:

partialMessage - the partial message data.

last - flag to indicate if this partialMessage is the last of the whole message being delivered.