uk.ac.rdg.resc.jstyx.client
Class MessageCallback

java.lang.Object
  uk.ac.rdg.resc.jstyx.client.MessageCallback

Direct Known Subclasses:

CreateCallback, DownloadCallback, GetChildrenCallback, GetFidCallback, OpenCallback, OpenOrCreateCallback, ReadCallback, RefreshCallback, UploadCallback, WriteCallback

public abstract class MessageCallback
extends java.lang.Object

Callback class that is associated with an outgoing Tmessage. When the reply arrives, the gotReply() method is called by StyxConnection.replyArrived(). If the reply is of the correct type, the replyArrived() method of this class is called; otherwise the error() method is called.

Author:

Jon Blower $Revision: 373 $ $Date: 2005-08-31 09:15:57 +0100 (Wed, 31 Aug 2005) $ $Log$ Revision 1.6 2005/08/31 08:15:57 jonblower Corrections to comments Revision 1.5 2005/06/27 17:17:15 jonblower Changed MessageCallback to pass Tmessage as parameter, rather than storing in the instance Revision 1.4 2005/05/25 15:39:02 jonblower Bug fixes Revision 1.3 2005/05/23 16:48:17 jonblower Overhauled CStyxFile (esp. asynchronous methods) and StyxConnection (added cache of CStyxFiles) Revision 1.1.1.1 2005/02/16 18:58:18 jonblower Initial import

Constructor Summary

MessageCallback()

Method Summary

abstract void	error(java.lang.String message, StyxMessage tMessage) Called when an error occurs (this may occur if the server returned an Rerror message, or if the reply was not of the expected type, or for other reasons).
abstract void	replyArrived(StyxMessage rMessage, StyxMessage tMessage) Called when the reply arrives.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MessageCallback

public MessageCallback()

Method Detail

replyArrived

public abstract void replyArrived(StyxMessage rMessage,
                                  StyxMessage tMessage)

Called when the reply arrives. If the reply is an RreadMessage, the message's buffer should be released when it is no longer needed, using rMessage.getData().release().

Parameters:

rMessage - the reply

tMessage - the original T-message

error

public abstract void error(java.lang.String message,
                           StyxMessage tMessage)

Called when an error occurs (this may occur if the server returned an Rerror message, or if the reply was not of the expected type, or for other reasons).

Parameters:

message - The error string

tMessage - The T-message that caused this error to happen