com.groiss.notification

Class NotificationSuite

java.lang.Object

com.groiss.notification.NotificationSuite

public class NotificationSuite
extends java.lang.Object

A facade to the Notification framework. The primary entry point to send messages to clients.

Constructor Summary

Constructors

Constructor and Description
NotificationSuite()

Method Summary

Methods

Modifier and Type	Method and Description
static NotificationEvent	createEvent(NotificationItem ni, short type, Agent a) Create a NotificationEvent from a NotificationItem.
static void	disableNotification() Disables sending of notification for this transaction Default is enabled.
static void	enableNotification() Enables sending of notification for this transaction.
static boolean	isNotificationEnabled() Determine if Notifications are enabled for this transaction.
static void	publish(NotificationEvent e) Publish an event.
static void	publish(NotificationItem ni, short type) Publish a NotificationItem.
static void	publish(NotificationItem ni, short type, Agent a) Publish a NotificationItem.
static void	publishImmediate(NotificationEvent e) Publish an event immediately.
static void	publishImmediate(NotificationItem ni, short type) Publish a NotificationItem immediately.
static void	publishImmediate(NotificationItem ni, short type, Agent a) Publish a NotificationItem immediately.
static void	setAvoidAutoNotification(boolean avoidAutoNotification) Avoid sending of notifications to originating session.
static void	setMeToo(boolean meToo) Send notifications also to originating session.

Methods inherited from class java.lang.Object

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

Constructor Detail

NotificationSuite

public NotificationSuite()

Method Detail

disableNotification

public static void disableNotification()

Disables sending of notification for this transaction Default is enabled. After commit or rollback, it is enabled again. The state is checked only at commit time. This means that the last disable or enable operation is the relevant one. You cannot disable or enable single notifications within one transaction.

enableNotification

public static void enableNotification()

Enables sending of notification for this transaction. Default is enabled. After commit or rollback, it is enabled again. The state is checked only at commit time. This means that the last disable or enable operation is the relevant one. You cannot disable or enable single notifications within one transaction.

isNotificationEnabled

public static boolean isNotificationEnabled()

Determine if Notifications are enabled for this transaction.

Returns:

true, if Notifications are enabled for this transactions, false otherwise.

createEvent

public static NotificationEvent createEvent(NotificationItem ni,
                            short type,
                            Agent a)

Create a NotificationEvent from a NotificationItem. Usually, its not needed to explicitly create the event since NotificationItems can be published too.

Parameters:

ni - the item to be contained in the event object

type - the event type Names

a - the agent for which the event is destined

Returns:

publish

public static void publish(NotificationItem ni,
           short type)

Publish a NotificationItem. The item is published after the current transaction commits (and suppressed if the transaction is rolled back). The agent to publish to is determined by NotificationItem.getAgent()

Parameters:

ni - the item to publish

type - the event type Names

Throws:

java.lang.Exception

publish

public static void publish(NotificationItem ni,
           short type,
           Agent a)

Publish a NotificationItem. The item is published after the current transaction commits (and suppressed if the transaction is rolled back).

Parameters:

ni - the item to publish

type - the event type Names

a - the agent to sent the event to.

Throws:

java.lang.Exception

publish

public static void publish(NotificationEvent e)

Publish an event. Events are only needed in special cases. Usually, NotificationItems should be published. The event is published after the current transaction commits (and suppressed if the transaction is rolled back).

Parameters:

e -

publishImmediate

public static void publishImmediate(NotificationEvent e)
                             throws java.lang.Exception

Publish an event immediately. Events are only needed in special cases. Usually, NotificationItems should be published. The event is published instantaneously.

Parameters:

e -

Throws:

java.lang.Exception

publishImmediate

public static void publishImmediate(NotificationItem ni,
                    short type)
                             throws java.lang.Exception

Publish a NotificationItem immediately. The item is published instantaneously. The agent to publish to is determined by NotificationItem.getAgent()

Parameters:

ni - the item to publish

type - the event type Names

Throws:

java.lang.Exception

publishImmediate

public static void publishImmediate(NotificationItem ni,
                    short type,
                    Agent a)
                             throws java.lang.Exception

Publish a NotificationItem immediately. The item is published instantaneously.

Parameters:

ni - the item to publish

type - the event type Names

a - the agent to sent the event to.

Throws:

java.lang.Exception

setMeToo

public static void setMeToo(boolean meToo)

Send notifications also to originating session. Normally, the originating HTTP/Cometd session does not receive the events via notification but rather synchronously via the initiating thread.

This behavior can be changed (for all events in the current transaction), by setting meToo to true.

N.B.: meToo is ignored, when avoidAutoNotification is set. meToo is automatically set to true if the changing function has not been called from the main window.

Parameters:

meToo - true when notifications should also be send to the originating session.

setAvoidAutoNotification

public static void setAvoidAutoNotification(boolean avoidAutoNotification)

Avoid sending of notifications to originating session. Normally, the originating HTTP/Cometd session does receive the events from itself if the the changing function has not been called from the main window.

This behavior can be avoided (for all events in the current transaction), by setting avoidAutoNotification to true. Then,

N.B.: avoidAutoNotification is stronger than meToo.

Parameters:

avoidAutoNotification - true when sending to current session should be avoided.