Mastering Oracle ADF Bindings

Mastering Oracle ADF Bindings

• 1.
  1  
• 3.
  About me 3
• 4.
  Ski Route 4
• 5.
  Let’s Go! 5
• 6.
  6 Bindings?
• 7.
  7 Application Layers
• 8.
  8 Layers Interaction
• 9.
  9 Fundamental Theorem ofSoftware Engineering (FTSE) We  can  solve  any  problem  by   introducing  an  extra  level  of   indirec8on.     …except  for  the  problem  of  too  many   levels  of  indirec8on  
• 10.
  10 Model Layer
• 11.
  10 ADF Model
• 12.
  12 ADF Model
• 13.
  Why ADF Bindings? 12 • A  core  part  of  Oracle  ADF   •  Powered  by  Oracle   •  Declara8ve  programming     approach   •  Common  UI  tasks  out-­‐of-­‐ the-­‐box                  –    Naviga8on                  –    Range  fetching                    –    State  Management   •  ADF  Bindings  API  
• 14.
  Ski Route 13
• 15.
  UI Component Binding 15  <af:inputText  value="#{bindings.FirstName.inputValue}"                                                        label="#{bindings.FirstName.hints.label}"                                                        required="#{bindings.FirstName.hints.mandatory}"                                                      …   EmpViewPageDef.xml  
• 16.
  16
• 17.
  ADF Model Artifacts 17   ² PageDef.xml   ² Binding  metadata   ² DataBinding.cpx   ² Page  defini8on  map   ² Data  Controls     ² Adfm.xml   ² DataBinding.cpx,  DataControls.dcx,     ² bc4j.xcfg,  *.jpx   ² Web.xml   ² ADFBindingFilter   ² ADF  libraries  
• 18.
  Page Definition File 18        <executables>                  <iterator  DataControl="EmployeesAMDataControl”                                                    Binds="VEmployees"                                                      RangeSize="25"                                                      id="VEmployeesIterator"/>          </executables>          <bindings>                  <acributeValues  id="EmployeeId”                                                                                IterBinding="VEmployeesIterator”>                          <AcrNames>                                          <Item  Value="EmployeeId"/>                          </AcrNames>                  </acributeValues>                  <acributeValues  id="FirstName”                                        IterBinding="VEmployeesIterator”>                          <AcrNames>                                          <Item  Value="FirstName"/>                          </AcrNames>                  </acributeValues>                  …          </bindings>   <af:inputText  value="#{bindings.FirstName.inputValue}”                                                        label="#{bindings.FirstName.hints.label}"          
• 19.
  Page Definition File.Executables 19 ² Iterator  <iterator>   ² Method  Iterator  <methodIterator>   ² Variable  Iterator  <varaibleIterator>   ² Invoke  Ac8on  <invokeAc8on>   ² Page  <page>   ² Search  Region  <searchRegion>   ² Task  Flow  <taskFlow>   ² Mul8task  Flow  <mul8TaskFlow>  
• 20.
  Page Definition File.Bindings 20 ² Ac8on  bindings   ² Ac8on  <ac8on>   ² Method  ac8on  <methodAc8on>   ² Value  bindings   ² Current  Row     ² Acribute  value  <acributeValues>   ² Boolean  value  <bucon>   ² List  <list,  listOfValues>   ² Row  Set   ² Tree  <tree>   ² DVT  <graph>    
• 21.
  Ski Route 21
• 22.
  22 Binding Context vsBinding Container
• 23.
  23 JSF Lifecycle vsADF Page Lifecycle
• 24.
  24 Bindings in ADFlifecycle. ADF Binding Filter
• 25.
  25 Bindings in ADFlifecycle. Restore View •  Restore  View   •  Apply  Request  Values   •  Process  valida8ons   •  Update  Model  Values     •  Invoke  Applica8on   •  Render  Response  
• 26.
  26 Bindings in ADFlifecycle. Restore View •  Restore  View              -­‐  Init  Context                  -­‐  Prepare  Model   •  …  
• 27.
  Binding Container atPrepare Model 27 ² Page  Parameters   ² Task  Flow  Parameters   ² Executables  with  Refresh=prepareModel   ² Iterators,  Invoke  Ac8ons       ² Page  Template     ² Task  Flow  bindings    
• 28.
  28 Bindings in ADFlifecycle. Render Response •  Restore  View   •  Apply  Request  Values   •  Process  valida8ons   •  Update  Model  Values     •  Invoke  Applica8on   •  Render  Response                    -­‐  Prepare  render  (render  Model)  
• 29.
  Iterator Refresh Attribute 29 ² default  (deferred)   ²  On  demand   ² always   ²  Prepare  Model,Update  Model,            Render  Model     ² ifNeeded       ²  Prepare  Model,  Render  Model   ² never     ² prepareModel   ² prepareModelifNeeded   ² renderModel   ² renderModelifNeeded   #{viewScope.reallyNeedToRefresh}  
• 30.
  Ski Route 30
• 31.
  Accessing Binding Container 31 public  BindingContainer  getBindingContainer()  {                  BindingContext  bindingContext  =  BindingContext.getCurrent();                  return  bindingContext.getCurrentBindingsEntry();   }   ²  Get Binding Context instance ²  Get Current Binding Container  
• 32.
  Executing Method Action 32 ² Get Operation Binding from Binding Container ²  Set up parameters ²  Execute ²  Check for errors   public  void  raisePay(Integer  employeeId)  {                  BindingContainer  bindings  =  getBindings();                  Opera8onBinding  op  =  bindings.getOpera8onBinding("raisePay");                  op.getParamsMap().put("employeeId",  employeeId);                  Object  result  =  op.execute();                  if  (!op.getErrors().isEmpty())  {                          //Do  something  with  this  list  of  JboExcep8ons                          List  errorList  =  op.getErrors();                  }          }    <methodAc8on  Ac8on="invokeMethod”    MethodName="raisePay”  id="raisePay”        ...  
• 33.
  Accessing Attribute Binding 33  public  String  getEmailValue()  {                  BindingContainer  bindings  =  getBindings();                  AcributeBinding  emailBinding  =                            (AcributeBinding)  bindings.getControlBinding("Email");                  return  (String)  emailBinding.getInputValue();          }   ²  Get Binding Container ²  Find Attribute Binding by Id ²  Return Input Value     <bindings>          <acributeValues  IterBinding="VEmployeesIterator"  id="Email">                              <AcrNames>                                      <Item  Value="Email"/>                              </AcrNames>            </acributeValues>   …  
• 34.
  Accessing LOV Binding 34 ² Get Binding Container ²  Find JUCtrlListBinding by Id ²  Get Selected Row ²  Return Attribute Value          public  String  getDepartmentName()  {                  BindingContainer  bindings  =  getBindings();                  JUCtrlListBinding  lov  =                            (JUCtrlListBinding)  bindings.getControlBinding("DepartmentId");                  //  Get  the  selected  row                  Row  selectedRow  =  (Row)  lov.getSelectedValue();                  return  (String)  selectedRow.getAcribute("DepartmentName");  }             <bindings>    <list  IterBinding="VEmployeesIterator"  Sta8cList="false"                      DTSupportsMRU="true"  SelectItemValueMode="ListObject"                    Uses="LOV_DepartmentId"  id="DepartmentId”/>   …  
• 35.
  Accessing Iterator Binding 35 ² Get Binding Container as DCBindingContainer ²  Find DCIteratorBinding by Id ²  Execute VO query ²  Get Current Row (ViewRowImpl) ²  Get View Object Instance          public  void  workWithIterator()  {                  DCBindingContainer  bindings  =  (DCBindingContainer)  getBindings();                  DCIteratorBinding  iter  =  bindings.findIteratorBinding("VEmployeesIterator");                  //Execute  RowSet  query                  iter.executeQuery();                  //Get  current  row                    Row  r  =  iter.getCurrentRow();                  //Get  View  Object                  ViewObject  vo  =  iter.getViewObject();  }    <iterator  Binds="VEmployees"  RangeSize="25"                                        DataControl="EmployeesAMDataControl"  id="VEmployeesIterator"/>  
• 36.
  Ski Route 36
• 37.
  Composite ADF page 37
• 38.
  38 Composite ADF page ² Everything  in  one  page   ²  Regions  with  task  flows   ²  Dynamic  declara8ve  component  
• 39.
  39 Composite ADF page ² Everything  in  one  page   ²  Regions  with  task  flows   ²  Dynamic  declara8ve  component  
• 40.
  40 Composite ADF page ² Everything  in  one  page   ²  Regions  with  task  flows   ²  Dynamic  declara@ve  component  
• 41.
  Dynamic Declarative Component 41 ² Uses Binding Container of the parent page ²  Doesn’t have own Binding Container   …   <af:gridCell  ...>            <af:declara8veComponent  viewId="/fragments/Approvals.jsff"  id="dc1"/>   </af:gridCell>   ….   <ui:composi8on  xmlns:ui="hcp://java.sun.com/jsf/facelets"     ...    <af:componentDef  var="acrs"  componentVar="comp">                  <af:panelBox  text="Approvals"  id="pb1">                          <af:listView  value="#{bindings.Approvals.collec8onModel}"  var="item”                                                                      fetchSize="#{bindings.Approvals.rangeSize}"  id="lv1”>   …   MainPage.jsf   Approvals.jsff  
• 42.
  Bindings for DeclarativeComponent 42 ²  Create Page Def file for the fragment ²  Add mapping to the DataBindings.cpx  <pageMap>                <page  path="/fragments/Approvals.jsff”  usageId="dashboard_view_ApprovalsPageDef"/>      </pageMap>      <pageDefini8onUsages>                  <page  id="dashboard_view_ApprovalsPageDef"                              path="com.adfprac8ce.dashboard.view.pageDefs.ApprovalsPageDef"/>      </pageDefini8onUsages>     <pageDefini8on  id="ApprovalsPageDef"                                  Package="com.adfprac8ce.dashboard.view.pageDefs">          <executables>                  <iterator  Binds="Approvals”  id="ApprovalsIterator”  …                  ...     DataBindings.cpx   ApprovalsPageDef.xml  
• 43.
  Bindings for DeclarativeComponent 43 ²  Find or Create BC with findBindingContainerByPath ²  Refer to the Backing Bean property     public  class  ApprovalsBean  {          public  BindingContainer  getBindings()  {                  BindingContext  bc  =  BindingContext.getCurrent();                  return  bc.findBindingContainerByPath("/fragments/Approvals.jsff");          }   …   <ui:composi8on  xmlns:ui="hcp://java.sun.com/jsf/facelets"      <c:set  var="bindings"  value="#{backingBeanScope.ApprovalsBean.bindings}"/>    <af:componentDef  var="acrs"  componentVar="comp">                  <af:panelBox  text="Approvals"  id="pb1">                          <af:listView  value="#{bindings.Approvals.collec8onModel}"  var="item”                                                                      fetchSize="#{bindings.Approvals.rangeSize}"  id="lv1”>   …   ApprovalsBean.java   Approvals.jsff  
• 44.
  Ski Route 44
• 45.
  Bindings for AdaptiveUI 45
• 46.
  Bindings for DynamicTable 46  <executables>              <iterator  Binds="#{pageFlowScope.voName}"                                                DataControl=”DynamicDataModelServiceDataControl“                                                id=”VDynamicIterator"/>    </executables>    <bindings>            <tree  IterBinding="VDynamicIterator"  id="VDynamic">                  <nodeDefini8on  Name="VDynamic0"/>          </tree>    </bindings>     <af:table  rows="#{bindings.VDynamic.rangeSize}"                                    fetchSize="#{bindings.VDynamic.rangeSize}”                                      …  
• 47.
  Dynamic Table 47 <af:table  rows="#{bindings.VDynamic.rangeSize}"                                    fetchSize="#{bindings.VDynamic.rangeSize}"                                    emptyText="#{bindings.VDynamic.viewable  ?                                                                                    'No  data  to  display.'  :  'Access  Denied.'}"                                    var="row"  rowBandingInterval="0”  value="#{bindings.VDynamic.collec8onModel}"                                    selectedRowKeys="#{bindings.VDynamic.collec8onModel.selectedRow}"                                    selec8onListener="#{bindings.VDynamic.collec8onModel.makeCurrent}"                                    rowSelec8on="single"  id="t1">          <af:forEach  items="#{bindings.VDynamic.acributeDefs}”  var="def">                  <af:column  headerText="#{bindings.VDynamic.labels[def.name]}“                                                            sortable="true"  sortProperty="#{def.name}“  id="c2">                          <af:outputText  value="#{row[def.name]}"  id="ot2"/>                  </af:column>          </af:forEach>   </af:table>    
• 48.
  Bindings for DynamicForm 48  <executables>              <iterator  Binds="#{pageFlowScope.voName}"                                                DataControl=”DynamicDataModelServiceDataControl“                                                id=”VDynamicIterator"/>    </executables>                                                                        <dynamic:form  value="#{bindings.VDynamicIterator}"  id="f1"/>  
• 49.
  Dynamic Component (12c) 49     <af:iterator  id="i1"  value="#{bindings.VDynamic.acributesModel.acributes}"  var="acr">                  <af:dynamicComponent  id="d2"  acributeModel="#{acr}"                                                                                                          value="#{bindings[acr.containerName][acr.name].inputValue}"/>    </af:iterator>                                                                                                                                          <tree  IterBinding=”VDynamicIterator"  id="VDynamic">                                                                                                                                                              <nodeDefini8on  Name="VDynamic0"/>                                                                                                                                          </tree>  
• 50.
  Hand Made DynamicForm 50 ²  DynamicComponent has limitations ²  af:Iterator + af:switcher approach can be used      <af:iterator  value=”#{bindings.VDynamic.acributesModel.acributes}"  var="acr"  id="dc_i1">                              <af:switcher  id="dc_s1"  defaultFacet="Default"                                                                            facetName=”#{bindings[acr.containerName][acr.name].dynamicTypeID}”>                                  <f:facet  name="DATE">                                      <af:inputDate  id="dc_id1"                                                                                          label=”#{bindings[acr.containerName][acr.name].label}”                                                                                                                                                  value=”#{bindings[acr.containerName][acr.name].inputValue}”                                                                                                                          shortDesc="#{bindings[acr.containerName][acr.name].tool8p}”                                                                                          />                                  </f:facet>                                <f:facet  name=”INT”>                                  …    <tree  IterBinding="VDynamicterator"  id="VDynamic">                  <nodeDefini8on  Name="VDynamic0"/>    </tree>    
• 51.
  Ski Route 51
• 52.
  Dynamic Bindings. Why? 52 ² DynamicForm is straight forward ²  DynamicForm is not good for Facelets ²  Jdeveloper 12c is still new ²  DynamicComponent has limitations ²  Tree bindings might be expensive ²  Useful for declarative components ²  It’s fun! ²  Have to finish the route  <tree  IterBinding="VDynamicterator"                            id="VDynamic">                  <nodeDefini8on  Name="VDynamic0"/>    </tree>    
• 53.
  Creating Value Binding 53 ² Get Control Definition Factory Defini8onFactory  defFactory  =  JUMetaObjectManager.getJUMom().getControlDefFactory();   ²  Create an instance of Control Value Definition (JUCtrlAcrsDef,  JUCtrlBoolDef,  …)              JUCtrlValueDef  acrDef  =  (JUCtrlValueDef)  defFactory.createControlDef(BINDING_TYPE);     ²  Initialize Control Value Definition HashMap  initValues  =  new  HashMap();              initValues.put(PARAM_NAME,  PARAM_VALUE);              acrDef.init(initValues);     ²  Create an instance of Control Value Binding JUCtrlValueBinding  acr  =  (JUCtrlValueBinding)    acrDef.createControlBinding(getBindings());   ²  Add Control Value Binding to Binding Container  getBindings().addControlBinding(acr.getName(),  acr);  
• 54.
  Dynamic Attribute ValueBinding 54 private  JUCtrlAcrsBinding  createAcrValue(String  acrName,  String  iteratorName)  {      Defini8onFactory  defFactory  =    JUMetaObjectManager.getJUMom().getControlDefFactory();      JUCtrlAcrsDef  acrDef  =  (JUCtrlAcrsDef)  defFactory.createControlDef(DCDefBase.PNAME_TextField);          //Ini8alize  acribute  values  binding  defini8on      HashMap  initValues  =  new  HashMap();      initValues.put(DCControlBindingDef.PNAME_IterBinding,  iteratorName);      initValues.put(ListBindingDef.PNAME_AcrNames,  new  String[]  {acrName});      initValues.put(JUTags.ID,  acrName);      acrDef.init(initValues);                //Create  an  instance  of  acribute  values  binding      JUCtrlAcrsBinding  acr  =  (JUCtrlAcrsBinding)    acrDef.createControlBinding(getBindings());            //Add  the  instance  to  the  current  binding  container      getBindings().addControlBinding(acrDef.getName(),  acr);      return  acr;    }    
• 55.
  Dynamic Attribute ValueBinding 55  <af:inputText  value="#{BackingBean.accountNo.inputValue}”                                                      label="#{BackingBean.accountNo.hints.label}”                                                      required="#{BackingBean.accountNo.hints.mandatory}”                                                      …   public  JUCtrlAcrsBinding  getAccountNo()  {                  String  acrName  =  "AccountNo";          DCControlBinding  acr  =                          getBindings().findCtrlBinding(acrName);            if  (acr  ==  null)  {                  acr  =  createAcrValue(acrName,  "VDynamicIterator");            }              return  (JUCtrlAcrsBinding)  acr;   }    <acributeValues                          IterBinding="VDynamicIterator”                          id="AccountNo">                    <AcrNames>                                <Item  Value="AccountNo"/>                    </AcrNames>        </acributeValues>   #{bindings.AccountNo}  
• 56.
  Dynamic Boolean (button)Value Binding 56 private  JUCtrlBoolBinding  createBoolValue(String  acrName,  String  iteratorName)  {      Defini8onFactory  defFactory  =    JUMetaObjectManager.getJUMom().getControlDefFactory();      JUCtrlBoolDef  acrDef  =  (JUCtrlBoolDef)  defFactory.createControlDef(DCDefBase.PNAME_BuIon);        HashMap  initValues  =  new  HashMap();      initValues.put(DCControlBindingDef.PNAME_IterBinding,  iteratorName);      initValues.put(ListBindingDef.PNAME_AcrNames,  new  String[]  {acrName});      initValues.put(ListBindingDef.PNAME_ValueList,  new  String[]  {"Y","N"});      …      return  acr;   }        <bucon  IterBinding="VDynamicIterator"  id="AccountClosed"  DTSupportsMRU="false"  Sta8cList="true">              <AcrNames>                          <Item  Value="AccountClosed"/>              </AcrNames>              <ValueList>      <Item  Value="Y"/>                  <Item  Value="N"/>    </ValueList>    </bucon>  
• 57.
  Dynamic LOV Binding 57 private  JUCtrlListBinding  createLOV(String  acrName,  String  lovName,  String  iteratorName)  {      Defini8onFactory  defFactory  =  JUMetaObjectManager.getJUMom().getControlDefFactory();      JUCtrlValueDef  lovDef  =  (JUCtrlValueDef)  defFactory.createControlDef(JUTags.PNAME_listOfValues);          HashMap  initValues  =  new  HashMap();      initValues.put(DCControlBindingDef.PNAME_IterBinding,  iteratorName);      initValues.put(ListBindingDef.PNAME_AcrNames,  new  String[]  {acrName});    //Specify  LOV  name.  e.g.  “LOV_Currency”      initValues.put(ListBindingDef.PNAME_ListServerBindingName,  lovName);                      initValues.put(JUTags.ID,  acrName);      lovDef.init(initValues);        JUCtrlListBinding  lov  =  (JUCtrlListBinding)  lovDef.createControlBinding(getBindings());      getBindings().addControlBinding(lovDef.getName(),  lov);      return  lov;   }           <listOfValues  Sta8cList="false"  IterBinding="VDynamicIterator"  Uses="LOV_Currency"  id="Currency"/>  
• 58.
  Dynamic Tree Binding 58  public  JUCtrlHierBinding  createTree(String  treeName,  String  iteratorName)  {                      Defini8onFactory  defFactory  =  JUMetaObjectManager.getJUMom().getControlDefFactory();                  JUCtrlValueDef  treeDef  =  (JUCtrlValueDef)  defFactory.createControlDef(DCDefBase.PNAME_Tree);                    HashMap  initValues  =  new  HashMap();                      initValues.put(JUTags.ID,  treeName);                  initValues.put(JUCtrlHierDef.PNAME_IterBinding,  iteratorName);                                JUCtrlHierTypeBinding  typeBinding  =  new  JUCtrlHierTypeBinding();                      initValues.put(JUCtrlHierDef.PNAME_TypeBindings,  new  JUCtrlHierTypeBinding[]  {  typeBinding  });                        treeDef.init(initValues);                    JUCtrlValueBinding  tree  =  (JUCtrlValueBinding)treeDef.createControlBinding(getBindings());                                  getBindings().addControlBinding(treeDef.getName(),  tree);                  return  (JUCtrlHierBinding)  tree;          }    <tree  IterBinding="VDynamicterator"                            id="VDynamic">                  <nodeDefini8on  Name="VDynamic0"/>    </tree>    
• 59.
  Dynamic Value Binding 59  private  JUCtrlValueBinding  createBinding(BindingDef  bindingDef)  {              Defini8onFactory  defFactory  =                        JUMetaObjectManager.getJUMom().getControlDefFactory();              JUCtrlValueDef  valueDef  =                        (JUCtrlValueDef)  defFactory.createControlDef(bindingDef.getBindingType());                              HashMap  initValues  =  bindingDef.getInitMap();                          valueDef.init(initValues);                                JUCtrlValueBinding  binding  =  (JUCtrlValueBinding)  valueDef.createControlBinding(getBindings());                            getBindings().addControlBinding(valueDef.getName(),  binding);              return  binding;          }  
• 60.
  Dynamic Value Binding 60  private  class  BooleanBindingDef  extends  BindingDef  {                    @Override                  public  HashMap  getInitMap()  {                                  HashMap  map  =  new  HashMap();                                  map.put(DCControlBindingDef.PNAME_IterBinding,  iteratorName);                                  map.put(ListBindingDef.PNAME_AcrNames,  new  String[]  {acrName});                                  map.put(ListBindingDef.PNAME_ValueList,  new  String[]  {"Y","N"});                                  map.put(JUTags.ID,  acrName);                                  return  map;                                                  }                    @Override                  public  String  getBindingType()  {                                  return  DCDefBase.PNAME_Bucon;                          }            }  
• 61.
  Dynamic Iterator Binding 61  public  DCIteratorBinding  createIterator(String  iteratorName,  String  voName,  String  dataControlName)  {                        Defini8onFactory  defFactory  =  JUMetaObjectManager.getJUMom().getControlDefFactory();        //Create  and  init  an  iterator  binding  defini8on            JUIteratorDef  iterDef  =  (JUIteratorDef)defFactory.createControlDef(DCDefBase.PNAME_Iterator);                                HashMap  initValues  =  new  HashMap();            initValues.put(JUTags.ID,  iteratorName);        initValues.put(JUTags.DataControl  ,  dataControlName);            initValues.put(JUTags.PNAME_VOName  ,  voName);            iterDef.init(initValues);                          //Create  an  iterator  binding  instance              DCIteratorBinding  iter  =  iterDef.createIterBinding(BindingContext.getCurrent(),  getBindings());                                          //Add  the  instance  to  the  current  binding  container              getBindings().addIteratorBinding(iteratorName,  iter);            return  iter;    }      <iterator  Binds="VEmployees"                                DataControl="AppModuleDataControl"                                id=“VDynamiciterator"/>  
• 62.
  Ski Route 62
• 63.
  63