org.xmlBlaster.client
Interface I_Callback

All Known Subinterfaces:

I_CallbackExtended

All Known Implementing Classes:

AbstractCallbackExtended, AllProtocols, ClientSub, ClientSubDispatch, ClientXml, HelloWorldMime, HelloWorldSubscribe, HelloWorldVolatile, HelloWorldVolatile2, JavascriptCallback, Latency, NotificationHandler, StreamCallback, StreamingCallback, SubscribeMessage, XmlBlasterConnector, XmlBlasterInvocationHandler, XmlBlasterNativeClient, XmlScriptAccess, XmlScriptClient

public interface I_Callback

Interface to receive asynchronously send callback messages from xmlBlaster.

Please implement this to receive your messages.

Version:

$Revision: 1.13 $

Author:

Marcel Ruff.

See Also:

HelloWorld8.java

Method Summary

java.lang.String

update(java.lang.String cbSessionId, UpdateKey updateKey, byte[] content, UpdateQos updateQos) This is the callback method invoked from I_XmlBlasterAccess informing the client in an asynchronous mode about a new message.

Method Detail

update

public java.lang.String update(java.lang.String cbSessionId,
                               UpdateKey updateKey,
                               byte[] content,
                               UpdateQos updateQos)
                        throws XmlBlasterException

This is the callback method invoked from I_XmlBlasterAccess informing the client in an asynchronous mode about a new message.

So you should implement in your client code the I_Callback interface - suppling the update() method where you can do with the message whatever you want.

The raw protocol driver specific update() method (e.g. CORBA-BlasterCallback.update()) is unpacked and for each arrived message this update is called.

Parameters:

cbSessionId - The session ID specified by the client which registered the callback. You can specify a cbSessionId during connection (with ConnectQos) and this is bounced back here so you can authenticate the message.

updateKey - The arrived key containing the topic name

content - The arrived message content. This is your payload.

Throws:

XmlBlasterException

See Also:

I_XmlBlasterAccess