Skip navigation links

oracle.adf.view.rich.activedata
Class DataUpdateManager

java.lang.Object
oracle.adf.view.rich.activedata.DataUpdateManager

public abstract class DataUpdateManager

extends java.lang.Object

The DataUpdateManager class controls the registration and deregistration of components for both automatic PPR update and for active data

Constructor Summary

DataUpdateManager()

Method Summary

java.util.List<ActiveDataModel>	getModelList() Returns the list of ActiveDataModel intances registered.
abstract java.util.Iterator<java.lang.String>	getPartialTargets(javax.faces.context.FacesContext context) Returns the current set of partial targets needing to be rerendered.
abstract java.util.Set<ActiveDataModel.ActiveDataPolicy>	getSupportedPolicies() Returns the Set of ActiveDataPolicies supported by this DataUpdateManager.
abstract void	registerComponent(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, ActiveDataModel model, ActiveDataEncoder encoder) Register active or PPR coomponent's model and encoder.
abstract void	registerComponentForPPR(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, ActiveDataModel model, AutoPPRFilter filter) Registers a component as interested in being automatically re-rendered in the next render phase in response to changes on an ActiveDataModel.
abstract void	registerSubtrees(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, java.util.Collection<java.lang.Object> rowKeys) Register component with the collections identified by the rowKeys.
abstract void	startActiveData(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, int startChangeCount) Called when a previously registered component is ready to being receiving active data starting from a specified startChangeCount.
abstract void	unregisterComponent(javax.faces.context.FacesContext context, java.lang.String clientId) Unregister the component from the DataUpdateManager
abstract void	unregisterSubtrees(javax.faces.context.FacesContext context, java.lang.String clientId, java.util.Collection<java.lang.Object> rowKeys) Unregister component from the collections of the containers identified by the rowKeys

Methods inherited from class java.lang.Object

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

Constructor Detail

DataUpdateManager

public DataUpdateManager()

Method Detail

getSupportedPolicies

public abstract java.util.Set<ActiveDataModel.ActiveDataPolicy> getSupportedPolicies()

Returns the Set of ActiveDataPolicies supported by this DataUpdateManager. Components can use this information to determine whether to bother calling any of the other methods of the DataUpdateManager.

Returns:

the Set of ActiveDataPolicies supported by this DataUpdateManager.

registerComponentForPPR

public abstract void registerComponentForPPR(javax.faces.context.FacesContext context,
                                             javax.faces.component.UIComponent component,
                                             ActiveDataModel model,
                                             AutoPPRFilter filter)

Registers a component as interested in being automatically re-rendered in the next render phase in response to changes on an ActiveDataModel.

Parameters:

context - current FacesContext

component - Component interested in being automatically PPR'ed in response to model changes.

model - ActiveDataModel to listen for ActiveDataEvents on

filter - AutoPPRFilter used to determine if ActiveDataEvents generated by the ActiveDataModel should cause the component to be rerendered in the next rendering phase.

registerComponent

public abstract void registerComponent(javax.faces.context.FacesContext context,
                                       javax.faces.component.UIComponent component,
                                       ActiveDataModel model,
                                       ActiveDataEncoder encoder)

Register active or PPR coomponent's model and encoder.

Parameters:

context - current FacesContext

component - the UI component to be registered

encoder - the ActiveDataEncoder used for encoding the active data generated for the UI component. If this value is null, the component will be registered as PPR component. Otherwise, the component will be registered as active component.

model - Active Data model which will generate active events

Throws:

java.lang.IllegalStateException - if the component is re-registered with different model

See Also:

ActiveDataEncoder

registerSubtrees

public abstract void registerSubtrees(javax.faces.context.FacesContext context,
                                      javax.faces.component.UIComponent component,
                                      java.util.Collection<java.lang.Object> rowKeys)

Register component with the collections identified by the rowKeys. This method must be called after the component is registered with its model and encoder by using registerComponent

Parameters:

context - current FacesContext

component - the UI component to be registered

rowKeys - the container row keys of collections from which the component is to receive active data events

Throws:

java.lang.IllegalArgumentException - if rowKeys is null

java.lang.IllegalStateException - if the component is not registered for its model and encoder

startActiveData

public abstract void startActiveData(javax.faces.context.FacesContext context,
                                     javax.faces.component.UIComponent component,
                                     int startChangeCount)

Called when a previously registered component is ready to being receiving active data starting from a specified startChangeCount. In order to handle error cases, the startChangeCount may be earlier than the changeCount of the most recent events delivered by the ActiveDataModel, however the startChangeCount should never be later than the most recent received changeCount.

Parameters:

context - current FacesContext

component - the UI component to beging receiving active data

startChangeCount - Event change count to start sending active data from.

Throws:

java.lang.IllegalStateException - if the component is already started or the eventId is later than the most recently delivered eventId

unregisterComponent

public abstract void unregisterComponent(javax.faces.context.FacesContext context,
                                         java.lang.String clientId)

Unregister the component from the DataUpdateManager

Parameters:

context - current FacesContext

clientId - UI Component to unregister

unregisterSubtrees

public abstract void unregisterSubtrees(javax.faces.context.FacesContext context,
                                        java.lang.String clientId,
                                        java.util.Collection<java.lang.Object> rowKeys)

Unregister component from the collections of the containers identified by the rowKeys

Parameters:

context - current FacesContext

clientId - UI Component to unregister

rowKeys - the container row keys of collections from which the component has regsitered to receive active data events

Throws:

java.lang.IllegalArgumentException - if rowKeys is null

getPartialTargets

public abstract java.util.Iterator<java.lang.String> getPartialTargets(javax.faces.context.FacesContext context)

Returns the current set of partial targets needing to be rerendered.

Parameters:

context - current FacesContext

Returns:

An iterator of the partial targets

getModelList

public java.util.List<ActiveDataModel> getModelList()

Returns the list of ActiveDataModel intances registered. This is used by FacesBindingRewiringListener to rewire registered ActiveDataModel instances to a new binding object is the current bound one is released.

Returns:

The list of ActiveDataModel intances registered.

Skip navigation links