Copyright  Oracle Corporation, All rights reserved. 5 More on Creating Database Forms Using AppBuilder

Copyright  Oracle Corporation, All rights reserved. 5-2 Objectives After completing this lesson, you should be able to do the following: Create master-detail forms Use JBCL components programmatically in Java code Filter and sort data records Use data modules, and perform parameterized queries After completing this lesson, you should be able to do the following: Create master-detail forms Use JBCL components programmatically in Java code Filter and sort data records Use data modules, and perform parameterized queries

Copyright  Oracle Corporation, All rights reserved. 5-3 Master-Detail Relationships LOC NEW YORK DALLAS CHICAGO BOSTON DEPTNO DNAME ACCOUNTING RESEARCH SALES OPERATIONS Master table, DEPT EMPNO ENAME KING CLARK MILLER JONES FORD Details table, EMP DEPTNO 10 20

Copyright  Oracle Corporation, All rights reserved. 5-4 Master-Detail Form at Run Time This is how the Master-Detail form will appear at run time Master section Detail section This is how the Master-Detail form will appear at run time Master section Detail section

Copyright  Oracle Corporation, All rights reserved. 5-5 Two or more QueryDataSets are required in a master-detail form Specifying QueryDataSet Properties Detail query Master query

Copyright  Oracle Corporation, All rights reserved. 5-6 Establishing the Master-Detail Relationship Specify masterLink property in detail QueryDataSet

Copyright  Oracle Corporation, All rights reserved. 5-7 Connecting the Master Query to the Detail Query This column in the master query … … is linked to this column in the detail query

Copyright  Oracle Corporation, All rights reserved. 5-8 Data-aware controls can now be added to display the fields Fields attached to master query Fields attached to detail query Data-aware controls can now be added to display the fields Fields attached to master query Fields attached to detail query Using the Master and Detail QueryDataSets

Copyright  Oracle Corporation, All rights reserved. 5-9 Delayed Fetching Delayed fetching can improve performance Data in the “details” data set is fetched only when needed Select “Delay fetch…” check box in masterLink editor A WHERE clause is required in the SQL string of the detail QueryDataSet Delayed fetching can improve performance Data in the “details” data set is fetched only when needed Select “Delay fetch…” check box in masterLink editor A WHERE clause is required in the SQL string of the detail QueryDataSet

Copyright  Oracle Corporation, All rights reserved Calculated Columns It is also possible to define calculated columns in a QueryDataSet ENAME KING CLARK MILLER ANNUAL_SAL SAL

Copyright  Oracle Corporation, All rights reserved Adding a Calculated Column to a QueryDataSet 1.Select in the QueryDataSet 2. Open Inspector window 3.Set calcType field to calculated 4. Set columnName and dataType 1.Select in the QueryDataSet 2. Open Inspector window 3.Set calcType field to calculated 4. Set columnName and dataType

Copyright  Oracle Corporation, All rights reserved Supplying a Value for a Calculated Field When a calculated field needs evaluation: QueryDataSet component generates a calcFields event You must handle this event When a calculated field needs evaluation: QueryDataSet component generates a calcFields event You must handle this event

Copyright  Oracle Corporation, All rights reserved Guided Practice: Providing calcFields Handler Method Explain the following handler method: import java.math.BigDecimal; // Standard class … void queryDetail_calcFields(ReadRow readRow, DataRow dataRow, boolean boolean1) … { BigDecimal sal, ann; sal = readRow.getBigDecimal("SAL"); ann = sal.multiply(new BigDecimal(12)); dataRow.setBigDecimal("ANNUAL_SAL", ann); }

Copyright  Oracle Corporation, All rights reserved Calculated Columns at Run Time The GridControl displays the calculated column automatically Calculated column The GridControl displays the calculated column automatically Calculated column

Copyright  Oracle Corporation, All rights reserved Filtering Rows If required, a filter can be defined for a QueryDataSet Example: Filter employees earning less than a certain amount If required, a filter can be defined for a QueryDataSet Example: Filter employees earning less than a certain amount

Copyright  Oracle Corporation, All rights reserved QueryDataSets Generate filterRow Events A filterRow event is generated before each row is added to the data set You provide a handler method, to decide whether to keep or reject the row A filterRow event is generated before each row is added to the data set You provide a handler method, to decide whether to keep or reject the row

Copyright  Oracle Corporation, All rights reserved Supplying a Handler Method to Filter Rows void queryDetail_filterRow( ReadRow readRow, RowFilterResponse rowFilterResponse)… { String txt = txtMinSal.getText(); if (txt.equals("")) txt = "0.0"; BigDecimal min = new BigDecimal(txt); BigDecimal sal = readRow.getBigDecimal("SAL"); if (sal.compareTo(min) >= 0) rowFilterResponse.add(); }

Copyright  Oracle Corporation, All rights reserved Forcing a Row Filter to Occur void btn_actionPerformed(ActionEvent e) { try { queryDetail.refilter(); } catch(DataSetException dse) {} } Call refilter() to force rows to be refiltered

Copyright  Oracle Corporation, All rights reserved Sorting Rows A data set can be dynamically re-sorted at any time Example: ChoiceControl can specify the sort column A data set can be dynamically re-sorted at any time Example: ChoiceControl can specify the sort column

Copyright  Oracle Corporation, All rights reserved Performing a Sort Programmatically void choiceControl1_itemStateChanged(ItemEvent e){ String[] s = new String[1]; s[0] = choiceControl1.getSelectedItem(); SortDescriptor sd; sd = new SortDescriptor(s, true, false); try { queryDetail.close(); queryDetail.setSort(sd); queryDetail.open(); } catch (DataSetException dse) {} }

Copyright  Oracle Corporation, All rights reserved Practice 5-1 Overview Define a master-detail form Add a calculated column to a QueryDataSet Add a filter to a QueryDataSet Add sort capabilities to a QueryDataSet Define a master-detail form Add a calculated column to a QueryDataSet Add a filter to a QueryDataSet Add sort capabilities to a QueryDataSet

Copyright  Oracle Corporation, All rights reserved The Bigger Picture The programs we have seen so far comprise a single applet The applet contains the Database and QueryDataSet components The programs we have seen so far comprise a single applet The applet contains the Database and QueryDataSet components database1 queryDataSet1 queryDataSet2 Java applet

Copyright  Oracle Corporation, All rights reserved Working with Larger Programs Complex programs can have many frames Each frame may need its own Database and QueryDataSet components Complex programs can have many frames Each frame may need its own Database and QueryDataSet components database1 queryDataSet1 queryDataSet2 Java applet database1 queryDataSet1 queryDataSet2 Frame 1 database1 queryDataSet1 queryDataSet2 Frame 2

Copyright  Oracle Corporation, All rights reserved The Benefit of Data Modules To avoid duplication, data components can be placed in a shared Data Module database1 queryDataSet1 queryDataSet2 Data module Applet Frame 1 Frame 2 queryDataSet3

Copyright  Oracle Corporation, All rights reserved Creating a Data Module in AppBuilder Select File— >New, and double-click the Data Module icon Fill in details for the new data module

Copyright  Oracle Corporation, All rights reserved Adding Components to a Data Module Add shared Database and QueryDataSet components to the data module

Copyright  Oracle Corporation, All rights reserved Linking an Applet to a Data Module Applets can be linked to a data module, as follows: Data module automatically added to Structure Pane Applets can be linked to a data module, as follows: Data module automatically added to Structure Pane public class MyApplet extends Applet { MyDataModule dm = MyDataModule.getDataModule(); XYLayout xYLayout1 = new XYLayout(); // Etc … };

Copyright  Oracle Corporation, All rights reserved Designing the Applet User Interface Data-aware controls can be added to the applet, as usual The QueryDataSet is now located in the data module Data-aware controls can be added to the applet, as usual The QueryDataSet is now located in the data module

Copyright  Oracle Corporation, All rights reserved Adding a Frame to Display Orders Information Select File—>New, and double-click the Frame icon Fill in details for the new frame

Copyright  Oracle Corporation, All rights reserved Linking a Frame to a Data Module Frames are linked to a data module in exactly the same way as for applets: Data module automatically added to the Structure Pane Frames are linked to a data module in exactly the same way as for applets: Data module automatically added to the Structure Pane public class MyFrame extends DecoratedFrame { MyDataModule dm = MyDataModule.getDataModule(); XYLayout xYLayout1 = new XYLayout(); // Etc … };

Copyright  Oracle Corporation, All rights reserved Specifying a SQL String to Populate the Frame Our frame will display all the orders made by a selected customer Define a separate QueryDataSet to perform this query Place this query in the data module Our frame will display all the orders made by a selected customer Define a separate QueryDataSet to perform this query Place this query in the data module select ORDID, ORDERDATE, SHIPDATE, TOTAL from ORD where CUSTID = :currCust

Copyright  Oracle Corporation, All rights reserved Defining Parameterized Rows The Orders query takes a parameter to specify the current customer This parameter must be represented by a ParameterRow object: The Orders query takes a parameter to specify the current customer This parameter must be represented by a ParameterRow object: void jbInit() … { // Code in MyDataModule ParameterRow pr = new ParameterRow(); pr.addColumn("currCust", Variant.BIGDECIMAL); pr.setBigDecimal("currCust", new BigDecimal(0)); queryOrders.setQuery( new QueryDescriptor(…, pr, true, false)); }

Copyright  Oracle Corporation, All rights reserved Executing the Orders Query void btnControl1_actionPerformed(ActionEvent e) { try { QueryDataSet qc = dm.getQueryCustomers(); BigDecimal custid = qc.getBigDecimal("CUSTID"); QueryDataSet qo = dm.getQueryOrders(); ReadWriteRow pr = qo.getParameterRow(); pr.setBigDecimal("currCust", custid); qo.executeQuery(); new MyFrame().show(); } catch(DataSetException dse) {} }

Copyright  Oracle Corporation, All rights reserved Putting It All Together

Copyright  Oracle Corporation, All rights reserved Summary Master-detail forms can be defined, using the masterLink property Calculated columns can be added to a data set Rows can be filtered and sorted In large programs, a data module can be used for shared components Parameterized queries can be used to specify query values at run time Master-detail forms can be defined, using the masterLink property Calculated columns can be added to a data set Rows can be filtered and sorted In large programs, a data module can be used for shared components Parameterized queries can be used to specify query values at run time

Copyright  Oracle Corporation, All rights reserved Practice 5-2 Overview Define a data module Attach a panel to the data module, and add the panel to an applet Attach a frame window to the data module Launch the frame window from the applet Define a data module Attach a panel to the data module, and add the panel to an applet Attach a frame window to the data module Launch the frame window from the applet

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices

Copyright  Oracle Corporation, All rights reserved Full Notes Page for Practices