Notification Service

Description
This bundle provides a notification service based on the Siena event notification system. The Siena package is included in the bundle, but in the future I will likely create a separate bundle for it. The notification bundle provides a publish/subscribe notification system. (This service allows bundles to access asynchronous event notification services when the security manager is enabled.)

Contributor(s)
Richard S. Hall (heavy@ungovenred.org)

License
GPL

Services
Name(s)
org.ungoverned.oscar.bundle.notification.NotificationService
Relevant interface(s)
public interface NotificationService
{
public NotificationQueue getQueueInterface();
public NotificationCallback getCallbackInterface();
}

public interface NotificationCallback
{
public void setCallback(Notifiable n);
public boolean publish(Notification n);
public boolean subscribe(Filter f);
public boolean unsubscribe(Filter f);
public boolean unsubscribe();
}

public interface NotificationQueue
{
public boolean publish(Notification n);
public boolean subscribe(Filter f);
public boolean unsubscribe(Filter f);
public boolean unsubscribe();

public boolean isAvailable();
public Notification dequeue();
public Notification dequeue(long timeout);
}

Properties
The notification bundle also offers the following configurable properties:

These properties can be configured using the standard bundle.properties file as described in the usage document. To better understand the use of these specific event notification properties, you should refer to the Siena Web pages for more documentation; Siena is the underlying system used by the notification bundle.

Requirements
None