Deep Dive into Oracle ADF Transactions
3 likes2,202 views
This document provides an overview of transaction management in Oracle Application Development Framework (ADF). It discusses key concepts like ADF Business Components (BC) transactions, shared transactions, the transaction commit cycle, managing savepoints with BC, ADF Model transactions using multiple data controls, and the data control frame for defining transaction scopes. The briefing covers programming approaches and options for task flow and data control transactions.
Deep Dive into Oracle ADF Transactions
- 1. 1
- 3. About  me  3  Eugene  Fedorenko   Master  principal  R&D  architect  adfprac=ce-Ââfedor.blogspot.com  @ïŹsbudo      Â
- 4. The  BrieïŹng  4  ADF BC Transaction Shared Transaction Transaction Commit Cycle ADF BC Save Points ADF Model Transaction Data Control Frame Programmatic Approach Q&A Data Control Scope Task Flow Transaction Options Transaction Definition
- 5. 5 Â
- 6. Transac=on  Ăï⯠A logical unit-of-work with a start and end Ăï⯠Must be entirely completed or aborted Ăï⯠If the start state is valid, the end state is valid Ăï⯠Is not affected by and does not affect any other transaction Ăï⯠State management of uncommitted changes 6 Â
- 7. 7  ADF  Business  Components  ADF  Faces  ADF  Task  Flows  ADF  Data  Controls  /  ADF  Bindings  DB  Transac=on  Management  in  Oracle  ADF Â
- 8. Giant  Stride  Entry  8 Â
- 9. The  BrieïŹng  9  ADF BC Transaction Shared Transaction Transaction Commit Cycle ADF BC Save Points ADF Model Transaction Data Control Frame Programmatic Approach Q&A Data Control Scope Task Flow Transaction Options Transaction Definition
- 10. Oracle  ADF  BC  Revisited  10  View  Object   Nested  Applica?on  Module    En?ty  Object  Â
- 11. DB  Transac=on  Object  11  JDBC  Connec?on  DB  View  Object   Nested  Applica?on  Module    En?ty  Object    Â
- 12. Shared  Transac=on  12  JDBC  Connec?on  DB  View  Object   En?ty  Object     View  Object  View  Object Â
- 13. Ăï⯠Based on jbo.shared.txn property Ăï⯠Designed for shared Application Modules Ăï⯠Used for not-shared root AMs to reduce number of DB connections  Shared  Transac=on  13 Â
- 14. The  BrieïŹng  14  ADF BC Transaction Shared Transaction Transaction Commit Cycle ADF BC Save Points ADF Model Transaction Data Control Frame Programmatic Approach Q&A Data Control Scope Task Flow Transaction Options Transaction Definition
- 15. Ăï⯠Validation Listener List Ăï⯠Entities for validation Ăï⯠Transaction Post Listener List Ăï⯠Dirty entities Ăï⯠Transaction Listener List Ăï⯠AMs and entities listening to commit phase  DB  Transac=on  Listeners  15 Â
- 16. 16   DB  Transac?on   Commit  Cycle   AM    En?ty   Commit  beforeValidate  validate  aFerValidate  postChanges  lock  prepareForDML  doDML  beforeCommit  doCommit  beforeCommit  aFerCommit  aFerCommit Â
- 17. Ăï⯠Validation Ăï⯠Raises validation exception Ăï⯠Post Changes Ăï⯠Rollbacks DB to savepoint Ăï⯠Restores state of posted entities Ăï⯠Raises an exception Ăï⯠Before Commit or Commit Ăï⯠Rollbacks DB to savepoint Ăï⯠Raises an exception Ăï⯠Does not restore state of posted entities by default  Failure  at  Commit  Cycle  17 Â
- 18. Ăï⯠Validation logic in beforeCommit method Ăï⯠Deferrable constraints Ăï⯠jbo.txn.handleafterpostexc = true Ăï⯠Forces in memory passivation snapshot Ăï⯠Activation of all AMs with all VO instances Error  at  Commit  phase  18   public  void  beforeCommit(Transac?onEvent  e)  {      if  (  !isDataValid()  )         throw  new  Valida?onExcep?on(VALIDATION_EXCEPTION);    }  CONSTRAINT  "CK_DIVEBOAT_WIDTH"  CHECK  (WIDTH<5)  DEFERRABLE  INITIALLY  DEFERRED Â
- 19. The  BrieïŹng  19  ADF BC Transaction Shared Transaction Transaction Commit Cycle ADF BC Save Points ADF Model Transaction Data Control Frame Programmatic Approach Q&A Data Control Scope Task Flow Transaction Options Transaction Definition
- 20. Ăï⯠Invoke a PL/SQL procedure Ăï⯠Modify entity attributes Ăï⯠Invoke another PL/SQL procedure Ăï⯠Commit the transaction   public  class  AppModuleImpl  extends  Applica?onModuleImpl  {     public  void  someBusinessServiceMethod()  {          invokePLSQLProcedure1();          modifySomeA^ributes();          invokePLSQLProcedure2();                 getDBTransac?on().commit();                      }   Business  Service  Method  20 Â
- 21. Ăï⯠passivateStateForUndo Ăï⯠Makes a snapshot with AMâs state Ăï⯠activateStateForUndo Ăï⯠Restores AMâs state from snapshot Ăï⯠Rollbacks the transaction  public  class  AppModuleImpl  extends  Applica?onModuleImpl  {     private  String  passivateStateForUndo()  {          String  savePoint  =  super.passivateStateForUndo(null,  null,  PASSIVATE_UNDO_FLAG);          return  savePoint;       }      private  void  ac?vateStateForUndo(String  savePointId)  {           super.ac?vateStateForUndo(savePointId,   ACTIVATE_UNDO_FLAG);          }     Managing  Savepoints  with  ADF  BC  21 Â
- 22.   public  class  AppModuleImpl  extends  Applica?onModuleImpl  {    public  void  someBusinessServiceMethod()  {            String  spid  =  passivateStateForUndo();            try  {                           invokePLSQLProcedure1();                            modifySomeA^ributes();                           invokePLSQLProcedure2();                       getDBTransac?on().commit();                           }  catch  (Run?meExcep?on  e)  {                ac=vateStateForUndo(spid);                throw  new  JboExcep?on(e);            }        }    Managing  Savepoints  with  ADF  BC  22 Â
- 23. The  BrieïŹng  23  ADF BC Transaction Shared Transaction Transaction Commit Cycle ADF BC Save Points ADF Model Transaction Data Control Frame Programmatic Approach Q&A Data Control Scope Task Flow Transaction Options Transaction Definition
- 24. Oracle  ADF  Model  24  ADF  Faces  ADF  Bindings  DB  ADF  Data  Controls  ADF  Task  Flows  ADF  Business  Components Â
- 25. Ăï⯠ADF BC Ăï⯠EJB Ăï⯠Bean Ăï⯠WebService (SOAP/REST) Ăï⯠URL Ăï⯠JMX Ăï⯠BAM Ăï⯠Placeholder Ăï⯠Custom Data Controls    ADF  Data  Controls  25 Â
- 26. Mul=ple  Data  Controls  26  REST  API  DB  ADF  BC  Global  Divers  Accommoda?on
- 27. Data  Control  Frame  27  REST  API  DB  ADF  BC  Data  Control  Frame  Global  Divers  Accommoda?on BC  Data  Control  REST  Data  Control  Transac=on Â
- 28. Oracle  ADF  Controller  28  ADF  Faces   ADF  Bindings   DB  ADF  Data  Controls  ADF  Task  Flows  ADF  Business  Components Â
- 29.    Task  Flow  29 Â
- 30.    Task  Flow  Transac=on  Op=ons  30 Â
- 31. Ăï⯠Shared Data Control Frame Ăï⯠Data Control Instance (same type & name) ĂïâŻAM instance ĂïâŻVO instances Ăï⯠Transaction Handler ĂïâŻDB Transaction Object ĂïâŻDB Connection ĂïâŻEntity Cache Ăï⯠Default Option for BTF   Shared  Data  Control  Scope  31 Â
- 32. Ăï⯠Isolated Data Control Frame Ăï⯠Data Control Instance (same type & name) ĂïâŻAM instance ĂïâŻVO instances Ăï⯠Transaction Handler ĂïâŻDB Transaction Object ĂïâŻDB Connection ĂïâŻEntity Cache Ăï⯠Always for UTF   Isolated  Data  Control  Scope  32 Â
- 33. The  BrieïŹng  33  ADF BC Transaction Shared Transaction Transaction Commit Cycle ADF BC Save Points ADF Model Transaction Data Control Frame Programmatic Approach Q&A Data Control Scope Task Flow Transaction Options Transaction Definition
- 34. Data  Control  Frame  #1  Data  Control  Frames  34  Main.jspx  UTF  Menu  BTF  Data  Control  Frame  #2  Divers  BTF  Log  Book  Record  BTF  Data  Control  Frame  #3  Dive  Sites  BTF Â
- 35.  Task  Flow  Transac=on  Op=ons  35       <transac?on>          <new-Ââtransac?on/>       </transac?on>   Â
- 36. Ăï⯠Starts a new transaction on Data Control Frame Ăï⯠Supports Both Data Control Scopes Ăï⯠Isolated Ăï⯠Shared ĂïâŻCalled from UTF ĂïâŻThe caller has âNo Controller Transactionâ Ăï⯠Must Finish the Transaction   Always  Begin  New  Transac=on  (new-Ââtransac=on)  36 Â
- 37. Ăï⯠Only Transaction starter can finish it Ăï⯠Always Begin New Transaction Ăï⯠Use Existing Transaction if Possible (no callerâs transaction)   Commit  and  Rollback  on  Return  37 Â
- 38. 38   Data  Control  Frame   Task  Flow  Commit   Transac?on    Data  Control   Commit  commit  commitTransac?on  commit   DB  Transac?on   For  each  data  control Â
- 39. Ăï⯠Prematurely Terminated Task Flow Ăï⯠Finished not via return activities Ăï⯠Task Flowâs container is not rendered anymore Ăï⯠Has been refreshed by the parent Ăï⯠Task Flow owns the transaction Ăï⯠Auto-rollback behavior   Prematurely  Terminated  Transac=on  39 Â
- 40. The  BrieïŹng  40  ADF BC Transaction Shared Transaction Transaction Commit Cycle ADF BC Save Points ADF Model Transaction Data Control Frame Programmatic Approach Q&A Data Control Scope Task Flow Transaction Options Transaction Definition
- 41. Ăï⯠Joins an existing transaction Ăï⯠Supports Only Shared Data Control Scope Ăï⯠Isolated is disabled Ăï⯠Can not Finish the Transaction   Always  Use  Exis=ng  Transac=on  (requires-Ââexis=ng-Ââtransac=on)  41 Â
- 42. Ăï⯠Created by default when shared transaction is reused Ăï⯠Used to restore model state on task flow exit Ăï⯠âNo Save Point on Task Flow Entryâ to prevent creation   Task  Flow  Save  Points  42 Â
- 43. Ăï⯠Root AM requires a dedicated DB connection Ăï⯠Parent and Child Task Flows should share Transaction Ăï⯠Too many DB connections for multi-root-AMs application   Root  AM  Connec=on  Challenge  43  Divers  VO  Log  Book  VO  Divers Root AM Log Book Root AM Log Book Record BTFDivers BTF
- 44. Ăï⯠Root AMs refer to the same data source Ăï⯠Task Flows use Transaction Options Ăï⯠Any but <No Controller Transaction> Ăï⯠Value for jbo.shared.txn is generated Ăï⯠Transaction is shared   Root  AM  Connec=on  Sharing  44  JDBC  Connec?on  Divers  VO    Log  Book  VO  Divers Root AM Log Book Root AM
- 45. The  BrieïŹng  45  ADF BC Transaction Shared Transaction Transaction Commit Cycle ADF BC Save Points ADF Model Transaction Data Control Frame Programmatic Approach Q&A Data Control Scope Task Flow Transaction Options Transaction Definition
- 46. Ăï⯠Dynamic transaction option Ăï⯠Isolated Data Control Scope Ăï⯠Always Begin New Transaction Ăï⯠Shared Data Control Scope ĂïâŻThere is open transaction Ăï⯠Always Use Existing Transaction ĂïâŻThere is No open transaction Ăï⯠Always Begin New Transaction   Use  Exis=ng  Transac=on  if  Possible  (requires-Ââtransac=on)  46 Â
- 47. Ăï⯠Switches Off controller transaction management Ăï⯠Does not start a transaction on task flow entry Ăï⯠Does not create a save point on task flow entry Ăï⯠Does not restore to save point Ăï⯠Does not rollback or commit transaction   No  Controller  Transac=on  47 Â
- 48. Ăï⯠Get current binding context Ăï⯠Get current Data Control Frame Ăï⯠Start a new transaction on the frame   public  void  startTransac?on()  {      BindingContext  context  =  BindingContext.getCurrent();             //Get  the  name  of  Data  Control  Frame      String  dcFrameName  =  context.getCurrentDataControlFrame();       //Get  Data  Control  Frame      DataControlFrame  dcFrame  =  context.ïŹndDataControlFrame(dcFrameName);            //Start  Transac?on      dcFrame.beginTransac?on(new  Transac?onProper?es());    }     Start  a  Transac=on  48 Â
- 49. Ăï⯠Get current binding context Ăï⯠Get current Data Control Frame Ăï⯠Commit or Rollback transaction   public  void  ïŹnishTransac?on()  {      BindingContext  context  =  BindingContext.getCurrent();            //Get  the  name  of  Data  Control  Frame      String  dcFrameName  =  context.getCurrentDataControlFrame();       //Get  Data  Control  Frame      DataControlFrame  dcFrame  =  context.ïŹndDataControlFrame(dcFrameName);            //Finish  Transac?on       if  (doRollback)  dcFrame.rollback();         else  dcFrame.commit();     }   Finish  a  Transac=on  49 Â
- 50. Ăï⯠Create Save Point Ăï⯠Save Save Point handle in pageFlowScope bean Ăï⯠Restore Save Point   private  SavepointHandle  savepointHandle;       public  void  createSavePoint()  {      DataControlFrame  dcFrame  =  getCurrentDataControlFrame();      savepointHandle  =  dcFrame.createSavepoint();     }     public  void  restoreSavePoint()  {      DataControlFrame  dcFrame  =  getCurrentDataControlFrame();      dcFrame.restoreSavepoint(savepointHandle);    }  Create  Savepoint  &  Restore  to  Savepoint  50 Â
- 51.    CRUD  Task  Flow  51 Â
- 52. Safety  Stop.  Ques=ons  &  Answers  52  ADF BC Transaction Shared Transaction Transaction Commit Cycle ADF BC Save Points ADF Model Transaction Data Control Frame Programmatic Approach Q&A Data Control Scope Task Flow Transaction Options Transaction Definition
- 53. 53 Join Your Community! Tonight from 8:00 â 10:00 in Sheraton I ADF Monday Night Foosball What is more fun than foosball and beer at your best friendâs house? Well, how about a foosball tournament with a whole bunch of friends at Kscope16? Join your fellow ADF enthusiasts for some great networking and friendly competition.
- 54. 54