rice.post
Class PostClient

java.lang.Object
  java.util.Observable
      rice.post.PostClient

Direct Known Subclasses:

EmailService, PKnoISecurityModule

public abstract class PostClient

extends java.util.Observable

This class is a superclass for clients running on top of the Post object.

Version:

$Id: PostClient.java 2047 2004-09-04 05:32:02Z amislove $

Constructor Summary

PostClient()
Builds a PostClient.

Method Summary

PostClientAddress	getAddress() Returns the address of this PostClient.
abstract void	getContentHashReferences(Continuation command) This method is periodically invoked by Post in order to get a list of all handles under which the application has live objects.
abstract void	getLogs(Continuation command) This method is periodically invoked by Post in order to get a list of all mutable data which the application is interested in.
abstract void	notificationReceived(NotificationMessage nm, Continuation command) This method is how the Post object informs the clients that there is an incoming notification.

Methods inherited from class java.util.Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

PostClient

public PostClient()

Builds a PostClient.

Method Detail

notificationReceived

public abstract void notificationReceived(NotificationMessage nm,
                                          Continuation command)

This method is how the Post object informs the clients that there is an incoming notification.

Parameters:

nm - The incoming notification.

command - THe command to return whether or not the notification should be accepted (Boolean true or false)

getContentHashReferences

public abstract void getContentHashReferences(Continuation command)

This method is periodically invoked by Post in order to get a list of all handles under which the application has live objects. This used to implement the garbage collection service, thus, the application must ensure that all data which it is still interested in is returned. The applications should return a ContentHashReference[] containing all of the handles The application is still interested in to the provided continatuion.

getLogs

public abstract void getLogs(Continuation command)

This method is periodically invoked by Post in order to get a list of all mutable data which the application is interested in. The applications should return a Log[] containing all of the data The application is still interested in to the provided continatuion.

getAddress

public final PostClientAddress getAddress()

Returns the address of this PostClient. This method is automatically provided in order to allow address to happen transparently.

Returns:

The unique address of this PostClient.