8/15/2003System Specialists Corporation How to implement BC4J with the Struts Framework Eugene Sicat Technical Architect/Project Manager System Specialists

8/15/2003 System Specialists Corporation

How to implement BC4J with the Struts Framework

Eugene SicatTechnical Architect/Project Manager

System Specialists Corporation

Session Id: 36702


Next Steps …• Recommended sessions

– 40212 - “Take Control” of Your J2EE Applications with Apache Struts and Oracle JDeveloper 10g – Focus on the MVC Controller

– 37002 - Developing J2EE Applications with Oracle9i JDeveloper and Struts

• Recommended demos and/or hands-on labs– http://otn.oracle.com/products/jdev/htdocs/handson/Frameworks/bc4jh

andson.html– http://otn.oracle.com/sample_code/products/jdev/bc4jknowledgeBase/r

eadme.html#ID148

• See Your Business in Our Software– Visit the DEMOgrounds

• Relevant web sites to visit for more information– http://otn.oracle.com/products/jdev/htdocs/j2ee_bc4j.html– http://otn.oracle.com/products/jdev/howtos/jsp/StrutsHowTo.html

http://otn.oracle.com/products/jdev/htdocs/handson/Frameworks/bc4jhandson.html


http://otn.oracle.com/sample_code/products/jdev/bc4jtoystore/readme.html#ID148

http://otn.oracle.com/sample_code/products/jdev/bc4jtoystore/readme.html#ID148

http://otn.oracle.com/products/jdev/htdocs/j2ee_bc4j.html

http://otn.oracle.com/products/jdev/howtos/jsp/StrutsHowTo.html

http://otn.oracle.com/products/jdev/howtos/jsp/StrutsHowTo.html


Reminder

Please complete the OracleWorld online session survey

Thank you.


Outline

• Sample App

• MVC, BC4J, Struts

• BC4J/Struts Integration

• Master/Detail code


Approach

• Better approach to learning• Show the running application• Browse the code

– Start from the view– Drill to the controller – Drill to the model


Sample App


Sample App


Sample App


Sample App


JSP (View)

<table>

<jbo:RowsetIterate …>

<tr> :

<td><jbo:ShowValue dataitem=“kbDesc"/></td>

<td><jbo:ShowValue dataitem=“repDate"/></td>

<td><jbo:ShowValue dataitem=“repBy"/></td>

</tr>

</jbo:RowsetIterate>

</table>


XML Config (Controller)

<action path="/browsekb" type=“com.ssc.kb.controller.BrowseDataAction">

<set-property property="application" value="KnowledgeBaseAppModule"/>

<set-property property="viewobject" value="KnowledgeBaseDataView"/>

<forward name="success" path="/WEB-INF/jsp/browsekb.jsp"/>

</action>


View Object (Model)<ViewObject

Name=“KnowledgeBaseDataView"

:

<SQLQuery><![CDATA[

SELECT KB_ID, KB_DESC, ENT_DATE, ENT_BY

FROM KNOWLEDGE_BASE

]]></SQLQuery>

:


MVC

View(JSP)

Controller(User input / page flow handling logic)

Model(Business Service, Objects, Data)


Struts Framework

• Consistent development approach


Struts Framework

• Consistent development approach

View

Controller

Model


Struts Framework

• Separate configuration from code


Struts Framework

• Separate configuration from code– Java– XML


Struts Framework• Separate configuration from code

– XML (struts-config.xml)

<action path="/browsekb"

type=“com.ssc.kb.controller.BrowseDataAction">

<set-property property="viewobject"

value="KnowledgeBaseDataView"/>

<forward name="success"

path="/WEB-INF/jsp/browsekb.jsp"/>

</action>


Struts Framework

• Components– JSP using Struts Tag– Controller setup in struts-config.xml– ActionForm– Action


Struts Framework

• Easy to test


Struts Framework

• Easy to test– StrutsTestCase– MockObjects– Cactus


Struts Framework

• Much simpler than Sun’s Java Pet Store Demo


BC4J Framework

• Entity Objects and Associations


BC4J Framework

• Entity Objects and Associations– business rules– persistence details – express the relationships


BC4J Framework

• Entity Objects and Associations– business rules– persistence details – express the relationships

• Excellent Reference– http://otn.oracle.com/products/jdev/htdocs/han

dson/Frameworks/bc4jhandson.html




BC4J Framework


BC4J Framework

• View objects and links


BC4J Framework

• View objects and links– Updateable data transfer objects – Based on SQL queries


BC4J Framework


BC4J Framework


BC4J Framework

• Application Module– Transactional business services – “Business Delegate” J2EE Design Pattern


BC4J Framework


BC4J/Struts Integration

• BC4J complements the model layer of Struts


BC4J/Struts Integration• automate interaction of Form Beans and BC4J's

objects


BC4J/Struts Integration• automate interaction of Form Beans and BC4J's

objects <action path="/browsekb"

type=“com.ssc.kb.controller.BrowseDataAction">

<set-property property="application" value="KnowledgeBaseAppModule"/>

<set-property property="viewobject" value="KnowledgeBaseDataView"/>

<forward name="success" path="/WEB-INF/jsp/browsekb.jsp"/>

</action>



• High-performance Business Delegate



• High-performance Business Delegate– finds and pools business service components




am.findViewObject(“string-key-name”)





:

am.createRecord(aRecord)





:

am.createRecord(aRecord)

:

am.commitChanges()



• Customized Struts Request Processor



• Customized Struts Request Processor

<controller debug="0" locale="true"

processorClass=

“com.ssc.kb.controller.KnowledgeBaseRequestProcessor"

contentType="text/html"

/>



• Customized Struts Request Processor- processRoles- processActionForward- processActionForm


How to

• Options#1 Create from scratch

#2 Migrate old MVC


Option #1: Create from scratch• Create entity objects and associations

• Create view objects

• Create view links

• Create application module

• Create complete struts-app using wizard

Reference:





Option #1: Create from scratch


Option #1: Create from scratch


Option #2: Migrate old MVC

1. inherit from struts.Action



1. inherit from struts.Action

public class KnowledgeBaseAction extends Action {public ActionForward execute

( ActionMapping mapping

, ActionForm form

, HttpServletRequest request

, HttpServletResponse response)



2. migrate action mappings to struts-config.xml

<action path="/browsekb“

type="org.apache.struts.action.ForwardAction“>

<forward name="success“

path="/browsekb.jsp"/>

</action>



3. configure to use struts.ActionServlet

web.xml:

<servlet-class>

org.apache.struts.action.ActionServlet

</servlet-class>



4. migrate messages and labels to resources

ApplicationResources.properties:

DataTransaction.commit=Commit

DataQuery.search=Search

DataTable.edit=Edit

:


Installation/Configuration

1.1. web.xml – action servlet

<servlet-class>

org.apache.struts.action.ActionServlet

</servlet-class>



1.2. web.xml – Taglib<taglib> <taglib-uri>/webapp/DataTags.tld</taglib-uri> <taglib-location>/WEB-INF/lib/datatags.jar</taglib-

location></taglib><taglib> <taglib-uri>/WEB-INF/struts-bean.tld</taglib-uri> <taglib-location>/WEB-INF/struts-bean.tld</taglib-

location></taglib>


Installation/Configuration2.1. JAR files - BC4J jars - under <OC4J_HOME>/BC4J/lib


Installation/Configuration2.2. JAR files - Struts jar - under <webroot>/WEB-INF/lib



3.1. struts-config.xml

install under <webroot>/WEB-INF/lib

3.2. TagLib definition files - *tld

install under <webroot>/WEB-INF/lib


Challenge with Master/Detail

• What’s the common challenge?• What does a user normally want in their

application?• How does it affect your architecture?


Browse


Edit Master/Display Detail


Edit Detail


JBO Tag

• Java Business Object tag


JBO Tag


<%@ taglib uri="/webapp/DataTags.tld"

prefix="jbo" %>


JBO Tag


<%@ taglib uri="/webapp/DataTags.tld" prefix="jbo" %>

:<jbo:RowsetIterate …>

: <jbo:ShowValue dataitem=“KbDesc"/></td>

<jbo:ShowValue dataitem=“EntDate"/></td></jbo:RowsetIterate>


Struts tag

<%@ taglib uri="/WEB-INF/struts-nested.tld" prefix=“nested" %>


Struts tag

<%@ taglib uri="/WEB-INF/struts-nested.tld" prefix=“nested" %>

<nested:iterate property="details">

<nested:text property="entDate"/>

<nested:text property="details"/>

<nested:text property="ref"/>

</nested:iterate>


JBO vs Struts tags

• JBO for RAD


JBO vs Struts tags

• JBO for RAD• JBO integration with BC4J objects


JBO vs Struts tags

• JBO for RAD• JBO integration with BC4J objects• JBO consistency


JBO vs Struts tags

• Struts flexibility


JBO vs Struts tags

• Struts flexibility• Struts richness


JBO vs Struts tags

• Struts flexibility• Struts richness• Struts many contributors


Where to use Struts tags

• Sophisticated browse with sort, display formats


Where to use Struts tags

• Sophisticated browse with sort, display formats• Master/Detail CRUD


Master/Detail


Master/Detail


Master/Detail

• BC4J– KnowledgeBase*– KnowledgeBaseDetail*– KnowledgeBaseDetailViewLink*– KnowledgeBaseAppModule


Master/Detailpublic class KnowledgeBaseForm extends ActionForm {

String kbBaseId;String kbDesc;String repDate;String repBy;ArrayList kbFormDetails;

:public ArrayList getDetails(…) {…}public void setDetails(…) {…}publjc void setKnowledgeBaseFromViewObject

(KnowledgeBaseVIew kbView){…}public void setKnowledgeBaseFromViewObject

(KnowledgeBaseDetailVIew kbDetailView() {…}}


Master/Detail

public class KnowledgeBaseDetail {String kbId;String entDate;String details;String ref;public void KnowledgeBaseDetail() {…}

:public String getEntDate() {…};

:public void setEntDate(…) {…};

}


Master/Detailpublic class KnowledgeBaseAction extends Action {

public ActionForward execute(ActionForm newForm, .) {String id = request.getParameter(“id”);KnowledgeBaseForm form =

(KnowledgeBaseForm) newForm;KnowledgeBaseAccess access =

new KnowledgeBaseAccess();if (action.equals(“Edit”) {

access.getKnowledgeBase(id, form); return (mapping.findForward("success"));

} else if ( action.equals(“Save”) {if (access.saveKnowledgeBase(form) )

return (mapping.findForward("saved"));else return (mapping.findForward(“failure"));

}}}


Master/Detailpublic class KnowledgeBaseAccess {

public void getKnowledgeBase(String id, … form) {KnowledgeBaseView kbView = (KnowledgeBaseView)

appModule.findKnowledgeBaseView(id);/* no need to find the dtl because the view link forced the

child to follow the parent so just get it */KnowledgeBaseDetailViewImpl kbDetailView =

appModule.getKnowledgeBaseDetailView();

form.setKnowledgeBaseFromViewObject(kbView);form.setKnowledgeBaseDetailFromViewObject

(kbDetailView);}

}


Master/Detailpublic class KnowledgeBaseAccess {

public void saveKnowledgeBase(…kbForm) { Long id = kbForm.getKnowledgeBaseId(); Key key = new Key(new Object[] { id });

Row kbRow[] =appModule.findKnowledgeBaseView(key);

setKnowledgeBase(kbForm, kbRow[0]); KnowledgeBaseDetailViewImpl kbFormDetailView =

appModule.getKnowledgeBaseDetailView(); setKnowledgeBaseDetails(kbForm, kbFormDetailView); }


Master/Detail

private void setKnowledgeBase(… kbForm

, Row row) { row.setAttribute(“KbId", kbForm.getMKbId());

row.setAttribute("RepDt", kbForm.getRepDt());

row.setAttribute("RepBy", kbForm.getRepBy());

row.setAttribute("KbDesc“, kbForm.getKbDesc());

}


Master/Detail

private void setKnowledgeBaseDetails(… kbForm, … kbFormDetailView)) {

List kbFormDetails = kbForm.getDetails(); Iterator i = kbFormDetails.iterator(); while (i.hasNext()) { KnowledgeBaseDetail kbFormDetail =

(KnowledgeBaseDetail) i.next(); setOneKnowledgeBaseDetail

(kbFormDetail,kbFormDetailView); }}


Master/Detail

private void setOneKnowledgeBaseDetail (…kbFormDetail, ... kbFormDetailView) {

Row row = getKbDetailViewRow

(kbFormDetailView, kbFormDetail);

row.setAttribute(“Detail", kbFormDetail.getDetail());

row.setAttribute(“EntDt", kbFormDetail.getEntDt());

row.setAttribute(“Ref", kbFormDetail.getRef());

}

}


Master/DetailStruts-config.xml

<action path="/editKnowledgeBase"

type=“com.ssc.kb.model.KnowledgeBaseAction"

attribute="knowledgeBaseForm"…>

<forward name="success"

path="/editKnowledgeBase.jsp"/>

<forward name=“saved"

path="/browseKnowledgeBase.jsp"/>

<forward name=“failure"

path="/editKnowledgeBase.jsp"/>

</action>


Master/Detail - JSP<tr>

<th>Knowledge Base Id:</th><td><bean:write property="kbId"/></td>

</tr><tr>

<th>Description:</th><td><html:text property="description"/></td>

</tr><tr> <th>Date Reported:</th>

<td><html:text property="repDate"/></td></tr>


Master/Detail – JSP cont’n<table>

<th align="center">Date</th> <th align="center">Details</th> <th align="center">Reference</th> <nested:iterate property="details">

<tr> <td><nested:text property="entDate"/></td>

<td><nested:text property="details"/></td> <td><nested:text property="ref"/></td></tr>

</nested:iterate><table>


Master/Detail


Summary

• BC4J and Struts – great combination


Summary

• BC4J and Struts – great combination• RAD


Summary

• BC4J and Struts – great combination• RAD• Consistent


Summary

• BC4J and Struts – great combination• RAD• Consistent• Industry standard


Summary

• BC4J and Struts – great combination• RAD• Consistent• Industry standard• Becoming widely used


Summary

• BC4J and Struts – great combination• RAD• Consistent• Industry standard• Becoming widely used• Easy to learn


Q & A

• Questions and Answers

Documents

8/15/2003System Specialists Corporation How to implement BC4J with the Struts Framework Eugene Sicat Technical Architect/Project Manager System Specialists