Oracle ADF Controller API Reference 10g Release 2 (10.1.2)
B14363-01
November 2004


Uses of Class
oracle.adf.controller.lifecycle.LifecycleContext

Packages that use LifecycleContext
oracle.adf.controller.lifecycle Contains classes to define the phases of a data model lifecycle for a web page and the order in which they are executed.  
oracle.adf.controller.struts.actions Contains classes to define the Struts implementations of the lifecycle.  

 

Uses of LifecycleContext in oracle.adf.controller.lifecycle

 

Methods in oracle.adf.controller.lifecycle with parameters of type LifecycleContext
 void
PageLifecycle.handleLifecycle(LifecycleContext lcContext)
          Define all the phases of the lifecycle and the order they are executed..
 void
PageLifecycle.prepareModel(LifecycleContext lcContext)
          Give the opportunity for the data model to prepare and initialize. This method will throw if the data model cannot be prepared. If you need to set bind variable values on query objects in the business services layer in order to properly prepare the model, then you can set them by overriding this method and doing it before calling the superclass.
 void
PageLifecycle.processUpdateModel(LifecycleContext lcContext)
          Update the data model with values submitted in the request. Collect the new values from request parameters and update the model with them.
protected  void
PageLifecycle.updateModel(LifecycleContext lcContext, java.util.Map updatedValues)
          Apply each new values to the binding.
protected  java.util.Map
PageLifecycle.getRequestValues(LifecycleContext lcContext)
          Returns all the submited ADF values from the request parameters.
 boolean
PageLifecycle.shouldAllowModelUpdate(LifecycleContext lcContext)
          Allows clients to determine whether the model should be updated..
 void
PageLifecycle.validateModelUpdates(LifecycleContext lcContext)
          Forces model-level validation to occur. To delay model-level validation until Commit, override this method and replace it with a no-op.
 void
PageLifecycle.processComponentEvents(LifecycleContext lcContext)
           
protected  boolean
PageLifecycle.handleEvent(LifecycleContext lcContext, java.lang.String event)
          Handle an event.
 java.lang.reflect.Method
PageLifecycle.getEventMethod(LifecycleContext lcContext, java.lang.String name)
          Retrieve the Method class for an event name.
protected  void
PageLifecycle.initializeParameterValuesUsingRequestObject(LifecycleContext lcContext, oracle.jbo.uicli.binding.JUCtrlActionBinding actionBinding)
          In model 1 we do not have a way to initialize method parameters.
 void
PageLifecycle.initializeMethodParameters(LifecycleContext lcContext, oracle.jbo.uicli.binding.JUCtrlActionBinding actionBinding)
           
 boolean
PageLifecycle.invokeActionBinding(LifecycleContext lcContext, java.lang.String event)
          Invoke the action binding associated with the event name.
 void
PageLifecycle.invokeCustomMethod(LifecycleContext lcContext)
           
 boolean
PageLifecycle.hasErrors(LifecycleContext lcContext)
           
 void
PageLifecycle.refreshModel(LifecycleContext lcContext)
           
 void
PageLifecycle.handleError(LifecycleContext lcContext, java.lang.Exception ex)
          Handles any exceptions that occurred during the Lifecycle processing..
 void
PageLifecycle.reportErrors(LifecycleContext lcContext)
           
 void
PageLifecycle.buildEventList(LifecycleContext lcContext)
          Builds the list of events with their possible associated action binding from the request parameters. Possible events are request parameters named "event" or which name are prefixed with "event_".
protected  void
PageLifecycle.processEvent(LifecycleContext lcContext, java.lang.String event)
          Process a possible raw event coming as a request parameter.
 void
PageLifecycle.findForward(LifecycleContext lcContext)
          Forwards the request or redirects the response to the next web page in the flow..
 void
Lifecycle.handleLifecycle(LifecycleContext lcContext)
          Define all the phases of the lifecycle and the order they are executed.
 void
Lifecycle.buildEventList(LifecycleContext lcContext)
          Builds the list of events with their possible associated action binding from the request parameters.
 void
Lifecycle.prepareModel(LifecycleContext lcContext)
          Give the opportunity for the data model to prepare and initialize.
 boolean
Lifecycle.shouldAllowModelUpdate(LifecycleContext lcContext)
          Allows clients to determine whether the model should be updated.
 void
Lifecycle.processUpdateModel(LifecycleContext lcContext)
          Update the data model with values submitted in the request.
 void
Lifecycle.validateModelUpdates(LifecycleContext lcContext)
          Forces model-level validation to occur.
 boolean
Lifecycle.hasErrors(LifecycleContext lcContext)
          Ask the context if any errors have been recorded during this lifecycle.
 void
Lifecycle.processComponentEvents(LifecycleContext lcContext)
          Handle any events in the action binding list previously built in processUpdateModel using the buildEventList method.
 void
Lifecycle.initializeMethodParameters(LifecycleContext lcContext, oracle.jbo.uicli.binding.JUCtrlActionBinding actionBinding)
          This method is invoked before any ControlBinding or custom method is being executed.
 void
Lifecycle.invokeCustomMethod(LifecycleContext lcContext)
          Invokes the custom method associated with the binding container.
 void
Lifecycle.refreshModel(LifecycleContext lcContext)
          Used to notify the model when updates are over with.
 void
Lifecycle.handleError(LifecycleContext lcContext, java.lang.Exception ex)
          Handles any exceptions that occurred during the Lifecycle processing.
 void
Lifecycle.reportErrors(LifecycleContext lcContext)
          Report the error list to the view layer.
 void
Lifecycle.findForward(LifecycleContext lcContext)
          Forwards the request or redirects the response to the next web page in the flow.
 java.lang.reflect.Method
Lifecycle.getEventMethod(LifecycleContext lcContext, java.lang.String name)
          Retrieve the Method class for an event name.
static void
Evaluator.prepareContext(LifecycleContext lcContext)
           
static Evaluator
Evaluator.getEvaluator(LifecycleContext lcContext)
           
static void
Evaluator.destroy(LifecycleContext lcContext)
           

 

Uses of LifecycleContext in oracle.adf.controller.struts.actions

 

Subclasses of LifecycleContext in oracle.adf.controller.struts.actions
 class
DataActionContext
          Lifecycle Context customized to work with DataAction.

 

Methods in oracle.adf.controller.struts.actions with parameters of type LifecycleContext
 void
StrutsUixLifecycle.handleLifecycle(LifecycleContext lcContext)
           
 void
StrutsUixLifecycle.processUpdateModel(LifecycleContext lcContext)
           
 void
StrutsUixLifecycle.validateModelUpdates(LifecycleContext lcContext)
           
 void
StrutsUixLifecycle.processComponentEvents(LifecycleContext lcContext)
           
 void
StrutsUixLifecycle.reportErrors(LifecycleContext lcContext)
           
protected  boolean
StrutsUixLifecycle.handleEvent(LifecycleContext lcContext, java.lang.String event)
           
 void
StrutsPageLifecycle.prepareModel(LifecycleContext lcContext)
          Give the opportunity for the data model to prepare and initialize. This method will throw if the data model cannot be prepared.

If you need to set bind variable values on query objects in the business services layer in order to properly prepare the model, then you can set them by overriding this method and doing it before calling the superclass.

If you need to reference prepared model values and/or update the values of any bindings in the binding container, then you can do it by overriding this method and doing it after calling the superclass. In the Struts case, prepare the ADF formBean (ADFStrutsForm) with the current binding container.

 boolean
StrutsPageLifecycle.shouldAllowModelUpdate(LifecycleContext lcContext)
          Allows clients to determine whether the model should be updated..

Disable data model updates in two cases:

  • When specific action like 'rollback' will be executed during the lifecycle. This is done by calling the ignoreUpdates method or each action in the event list. The custom method ignoreUpdates is also called.
  • When the binding container of the previous page does not match. This is to get around the case where updates from the previous page in the forward chain are applied.
Bypassing update might be necessary for operations such as rollback or custom methods that want to veto the change.
Overide this method if you need to add logic to skip data model updates. This is the stuff needed to bypass update on some method like rollback.
 void
StrutsPageLifecycle.processUpdateModel(LifecycleContext lcContext)
          Handle update using a Struts formbean In case of error the method setInputValue will not throw but instead the errors will be collected in the binding container.
protected  void
StrutsPageLifecycle.updateModel(LifecycleContext lcContext, java.util.Map updatedValues)
           
protected  boolean
StrutsPageLifecycle.handleEvent(LifecycleContext lcContext, java.lang.String event)
          Handle an event.
protected  void
StrutsPageLifecycle.initializeParameterValuesUsingExpressions(LifecycleContext lcContext, oracle.jbo.uicli.binding.JUCtrlActionBinding actionBinding)
          This method allows for initialization of the action binding's parameters by evaluating the expression values stored in the action definition.
 void
StrutsPageLifecycle.initializeMethodParameters(LifecycleContext lcContext, oracle.jbo.uicli.binding.JUCtrlActionBinding actionBinding)
           
 void
StrutsPageLifecycle.invokeCustomMethod(LifecycleContext lcContext)
          Invoke custom method if one is defined in the mapping of the DataAction.
 void
StrutsPageLifecycle.reportErrors(LifecycleContext lcContext)
           This method retrieve the list of error from the dataControl and treat them as fit for the PageLifeCycle implementation.
 void
StrutsPageLifecycle.findForward(LifecycleContext lcContext)
          Determine the ActionForward that will be returned by the Struts action executing the Lifecycle.
 void
DataAction.handleLifecycle(LifecycleContext lcContext)
          Internal.
 void
DataAction.processComponentEvents(LifecycleContext lcContext)
          Internal.
 boolean
DataAction.hasErrors(LifecycleContext lcContext)
          Internal.
 void
DataAction.handleError(LifecycleContext lcContext, java.lang.Exception ex)
          Internal.
 void
DataAction.reportErrors(LifecycleContext lcContext)
          Internal.
 void
DataAction.buildEventList(LifecycleContext lcContext)
          Internal.
 void
DataAction.prepareModel(LifecycleContext lcContext)
          Internal.
 boolean
DataAction.shouldAllowModelUpdate(LifecycleContext lcContext)
          Internal.
 void
DataAction.processUpdateModel(LifecycleContext lcContext)
          Internal.
 void
DataAction.validateModelUpdates(LifecycleContext lcContext)
          Internal.
 void
DataAction.initializeMethodParameters(LifecycleContext lcContext, oracle.jbo.uicli.binding.JUCtrlActionBinding actionBinding)
          Internal.
 void
DataAction.invokeCustomMethod(LifecycleContext lcContext)
          Internal.
 void
DataAction.refreshModel(LifecycleContext lcContext)
          Internal.
 void
DataAction.findForward(LifecycleContext lcContext)
          Internal.
 void
DataAction.saveErrors(LifecycleContext lcContext)
          Internal.
 java.lang.reflect.Method
DataAction.getEventMethod(LifecycleContext lcContext, java.lang.String eventName)
          Internal.

 


Oracle ADF Controller API Reference 10g Release 2 (10.1.2)
B14363-01
November 2004


 

Copyright © 1997, 2004, Oracle.
All rights reserved.