Package org.apache.tapestry5.commons.services

Interface InvalidationEventHub

All Known Subinterfaces:

InternalComponentInvalidationEventHub, MessagesSource, ResourceChangeTracker, ResourceDigestManager

All Known Implementing Classes:

ComponentTemplateSourceImpl, InternalComponentInvalidationEventHubImpl, InvalidationEventHubImpl, MessagesSourceImpl, ResourceChangeTrackerImpl, ResourceDigestManagerImpl

public interface InvalidationEventHub

An object which manages a list of InvalidationListeners. There are multiple event hub services implementing this interface, each with a specific marker annotation; each can register listeners and fire events; these are based on the type of resource that has been invalidated. Tapestry has built-in support for:

message catalog resources

marker annotation

component templates

marker annotation

component classes

marker annotation

Starting in Tapestry 5.3, these services are disabled in production (it does nothing).

Since:

5.1.0.0

Method Summary

Modifier and Type	Method	Description
void	callback)	Adds a callback that is invoked when an underlying tracked resource has changed.
void	addInvalidationListener(InvalidationListener listener)	Deprecated. in 5.4, use addInvalidationCallback(Runnable) instead}
void	<?,?> map)	Adds a callback that clears the map.

Method Detail

addInvalidationListener

void addInvalidationListener(InvalidationListener listener)

Deprecated.

in 5.4, use addInvalidationCallback(Runnable) instead}

Adds a listener, who needs to know when an underlying resource of a given category has changed (so that the receiver may discard any cached data that may have been invalidated). Does nothing in production mode.

addInvalidationCallback

void  callback)

Adds a callback that is invoked when an underlying tracked resource has changed. Does nothing in production mode.

Since:

5.4

clearOnInvalidation

void <?,?> map)

Adds a callback that clears the map.

Since:

5.4