org.apache.tapestry5.internal.services
Interface PersistentFieldManager

All Known Implementing Classes:
PersistentFieldManagerImpl

@UsesMappedConfiguration(value=PersistentFieldStrategy.class)
public interface PersistentFieldManager

Handle persistent property changes. Primarily, delegates to a number of PersistentFieldStrategy instances.


Method Summary
 void discardChanges(String pageName)
          Discards all changes for the indicated page.
 void discardChanges(String pageName, String strategyName)
          Discards changes on the indicated page for a specific strategy only.
 PersistentFieldBundle gatherChanges(String pageName)
          Locates all persistently stored changes to all properties within the page (for the current session and request) and gathers them together into a bundle.
 void postChange(String pageName, ComponentResources resources, String fieldName, Object newValue)
          Posts a change of a persistent property.
 

Method Detail

postChange

void postChange(String pageName,
                ComponentResources resources,
                String fieldName,
                Object newValue)
Posts a change of a persistent property.

Parameters:
pageName - the logical name of the page containing the component
resources - the resources for the component or mixin (used to determine the persistence strategy)
fieldName - the name of the field whose persistent value has changed
newValue - the new value for the field, possibly null

gatherChanges

PersistentFieldBundle gatherChanges(String pageName)
Locates all persistently stored changes to all properties within the page (for the current session and request) and gathers them together into a bundle.

Parameters:
pageName - the logical name of the page to gather changes for
Returns:
a bundle identifying all such changes

discardChanges

void discardChanges(String pageName)
Discards all changes for the indicated page. This will not affect pages that have already been attached to this request, but will affect subsequent page attachments in this and later requests.

Parameters:
pageName - logical name of page whose persistent field data is to be discarded

discardChanges

void discardChanges(String pageName,
                    String strategyName)
Discards changes on the indicated page for a specific strategy only. This will not affect pages that have already been attached to this request, but will affect subsequent page attachments in this and later requests.

Parameters:
pageName - logical name of page whose persistent field data is to be discarded
strategyName - name of the strategy of which field data is to be discarded


Copyright © 2003-2012 The Apache Software Foundation.