com.zink.fly

Interface NotiFly

All Superinterfaces:

FlyPrime

All Known Subinterfaces:

Fly

All Known Implementing Classes:

FlyStub

public interface NotiFly
extends FlyPrime

NotiFly is the interface to the Fly Notify methods - please excuse the pun.

Method Summary

Modifier and Type	Method and Description
boolean	notify(java.lang.Object template, NotifyHandler handler, long leaseTime) Deprecated. This method will be removed at version 2.0
boolean	notifyTake(java.lang.Object template, Notifiable handler, long leaseTime) The notifyTake method sets up a template object in the Fly Space.
boolean	notifyWrite(java.lang.Object template, Notifiable handler, long leaseTime) The notifyWrite method sets up a template object in the Fly Space.

Methods inherited from interface com.zink.fly.FlyPrime

read, snapshot, take, write

Method Detail

notify

boolean notify(java.lang.Object template,
               NotifyHandler handler,
               long leaseTime)

Deprecated. This method will be removed at version 2.0

Parameters:

template - - the template to match to triger this notify

handler - - An object that implements the NotifyHandler interface

leaseTime - - The time in milliseconds the template will live in the Space

Returns:

boolen - Setup ok

notifyWrite

boolean notifyWrite(java.lang.Object template,
                    Notifiable handler,
                    long leaseTime)

The notifyWrite method sets up a template object in the Fly Space. If an object is written to the Space in the lifetime of the notify template, that matches the template, then the method templateMatched() will be called in the object that implements the interface NotifyHandler. Take care when setting up notify templates; a large number of pending notifies can impead 'write' performance in the space. Set the lease of the notify template to a reasonable time and renew the template lease periodicaly. Use the NotifyLeaseRenewer helper in the examples to periodicly renew leases.

Parameters:

template - - the template to match to triger this notify

handler - - An object that implements the NotifyHandler interface

leaseTime - - The time in milliseconds the template will live in the Space

Returns:

boolen - Setup ok

notifyTake

boolean notifyTake(java.lang.Object template,
                   Notifiable handler,
                   long leaseTime)

The notifyTake method sets up a template object in the Fly Space. If an object is taken from the Space in the lifetime of the notify template that matches the template, then the method templateMatched() will be called in the object that implements the interface NotifyHandler. Take care when setting up notify templates; a large number of peneding notifies can impead 'take' performance in the space. Set the lease of the notify template to a reasonable time and renew the template lease periodicaly. Use the NotifyLeaseRenewer helper in the examples to periodicly renew leases.

Parameters:

template - - the template to match to triger this notify

handler - - An object that implements the NotifyHandler interface

leaseTime - - The time in milliseconds the template will live in the Space

Returns:

boolen - Setup ok