org.diirt.datasource

Class NotificationSupport<T>

java.lang.Object

org.diirt.datasource.TypeSupport<T>

org.diirt.datasource.NotificationSupport<T>

Type Parameters:

T - type for which the notifications are prepared

public abstract class NotificationSupport<T>
extends TypeSupport<T>

Dedicated notification type support.

Since:

17.01.2011

Author:

bknerr

Constructor Summary

Constructors

Constructor and Description
NotificationSupport(Class<T> clazz) Creates a new notification type support.

Method Summary

Modifier and Type	Method and Description
static <T> NotificationSupport<T>	findNotificationSupportFor(T newValue) Retrieves the notification support based on the given value.
static <T> NotificationSupport<T>	immutableTypeSupport(Class<T> clazz) Support for notification of immutable types.
static <T> Notification<T>	notification(T oldValue, T newValue) Returns the final value by using the appropriate type support.
abstract Notification<T>	prepareNotification(T oldValue, T newValue) Given the old and new value, prepare the final value that will be notified.

Methods inherited from class org.diirt.datasource.TypeSupport

addTypeSupport, findTypeSupportFor, getType, getTypeSupportFamily, isTypeDirectlySupported, isTypeSupported, typeSupportsFor

Methods inherited from class java.lang.Object

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

Constructor Detail

NotificationSupport

public NotificationSupport(Class<T> clazz)

Creates a new notification type support.

Parameters:

clazz - the type being supported

Method Detail

notification

public static <T> Notification<T> notification(T oldValue,
                                               T newValue)

Returns the final value by using the appropriate type support.

Type Parameters:

T - the type of the value

Parameters:

oldValue - the oldValue, which was previously in the previous notification

newValue - the newValue, which was computed during the scanning

Returns:

the value to be notified

findNotificationSupportFor

public static <T> NotificationSupport<T> findNotificationSupportFor(T newValue)

Retrieves the notification support based on the given value.

If no support is found, an exception is thrown.

Type Parameters:

T - value type

Parameters:

newValue - the value; can't be null

Returns:

the notification support

prepareNotification

public abstract Notification<T> prepareNotification(T oldValue,
                                                    T newValue)

Given the old and new value, prepare the final value that will be notified. This method is guaranteed to be called in the notification thread (the UI thread). This method may either update the old value or return the new value, depending on whether the type is immutable or what is more efficient.

Parameters:

oldValue - the oldValue, which was previously in the previous notification

newValue - the newValue, which was computed during the scanning

Returns:

the value to be notified

immutableTypeSupport

public static <T> NotificationSupport<T> immutableTypeSupport(Class<T> clazz)

Support for notification of immutable types. Notification is enabled if the value changed according to Object.equals(java.lang.Object).

Type Parameters:

T - type for which to add support

Parameters:

clazz - type for which to add support

Returns:

support for immutable objects of the given type