2014-06-18 BaoXinjian
一、摘要
Control层位于Model层和View层的中间，连接了Model层和View层，
主要存在两个功能
- 操作/初始化UI和数据
- 接受和处理页面上的用户的各种事件，并进行分发
本文的基本结构
- Designand Create an OA Controller - 基本概念和建立
- Handling an HTTP GET - 如何处理HTTP GET请求
- Data层面 - 进行初始化
- WebBean层面
- WebBean层面 - 动态修改WebBean的属性
- WebBean层面 - 动态创建WebBean
- Handing an HTTP POST - 如何处理HTTP POST请求
- processFormData( )
- processFormRequest( )
- Model Interaction - Contorl层和Model层的整合
- 在CO中通过pageContext.getRootApplicationModule()获取AM
- 查询 - 在CO中调用AM的Search方法
- 新增 - 在CO中调用AM的Create方法
- 删除 - 在CO中调用AM的Delete方法
- 提交 - 在CO中调用AM的Commit方法
OAF构成原件中Contorller的位置
二、具体解析
1. Designand Create an OA Controller - 基本概念和建立
选中PageRN，右击Set New Controller or Edit Contorller
系统会自动产生HTTP Get方法（processRequset）和HTTP Post方法（processFormRequest）
2. Handling an HTTP GET - 如何处理HTTP GET请求
2.1 修改WebBean的属性
比如动态修改TableText
processRequest(OAPageContext pageContext, OAWebBean webBean)
{
// Always call this before adding your own code. super.processRequest(pageContext, webBean);
OATableBean table = (OATableBean)webBean.findIndexedChildRecursive("OrdersTable");
if (table == null)
{
MessageToken[] tokens = { new MessageToken("OBJECT_NAME", "OrdersTable")};
throw new OAException("ICX", "FWK_TBX_OBJECT_NOT_FOUND", tokens);
}
// Set the purchase-order specific "control bar" select text:
// "Select Purchase Order(s) and..."
String selectPOText = pageContext.getMessage("ICX", "FWK_TBX_T_SELECT_PO", null);
table.setTableSelectionText(selectPOText);
}
2.2 创建WebBean
比如动态新增Table Row
OATableLayoutBean tableLayout = (OATableLayoutBean)findIndexedChildRecursive("tableLayout");
// Create a row layout and give it the unique ID "topRow"
OARowLayoutBean row = (OARowLayoutBean)createWebBean(pageContext,
OAWebBeanConstants.ROW_LAYOUT_BEAN,
null, // no need to specify a data type
"topRow");
// Create a row layout and give it the unique ID "bottomRow"
OARowLayoutBean anotherRow = (OARowLayoutBean)createWebBean(pageContext,
OAWebBeanConstants.ROW_LAYOUT_BEAN,
null, // no need to specify a data type
"bottomRow");
// Always check to see if a web bean exists.
if (tableLayout != null)
{
// Add the two row layout beans to the table so the "topRow" renders above
// the "bottomRow"
tableLayout.addIndexedChild(row);
tableLayout.addIndexedChild(anotherRow);
}
3. Handing an HTTP POST - 如何处理HTTP POST请求
public void processFormRequest(OAPageContext pageContext, OAWebBean webBean)
{
// Always call this before adding your code
super.processFormRequest(pageContext, webBean);
// Pressing the Go button causes the search to be executed. If (pageContext.getParameter("Go") != null)
{
String orderNumber = pageContext.getParameter("SearchOrder");
String created = pageContext.getParameter("Created");
String showMyOrders = pageContext.getParameter("MyOrders");
OAApplicationModule am = pageContext.getApplicationModule(webBean);
// All parameters passed using invokeMethod() must be serializable.
Serializable[] parameters = { orderNumber, created, showMyOrders };
am.invokeMethod("search", parameters);
// Now forward back to this page so we can implement UI changes as a
// consequence of the query in processRequest(). NEVER make UI changes in
// processFormRequest().
pageContext.setForwardURLToCurrentPage(null, // no parameters to pass
true, // retain the AM
OAWebBeanConstants.ADD_BREAD_CRUMB_NO,
OAWebBeanConstants.IGNORE_MESSAGES);
}
} // end processFormRequest();
4. Model Interaction - Contorl层和Model层的整合
4.1 在Am中调用Search方法，具体如何Search则定义在AM中
processFormRequest(OAPageContext pageContext, OAWebBean webBean)
{
// Check to see if the "Go" button was pressed...
if (pageContext.getParameter("gButton") != null)
{
// Get the search criteria
String orderNumber = pageContext.getParameter("SearchOrder");
String created = pageContext.getParameter("Created");
String showMyOrders = pageContext.getParameter("MyOrders");
OAApplicationModule am = pageContext.getApplicationModule(webBean);
// All parameters passed using invokeMethod() must be serializable. Serializable[] parameters = { orderNumber, created, showMyOrders };
am.invokeMethod("search", parameters);
}
}
4.2 在Am中调用Create方法，具体如何Create则定义在AM中
processFormRequest(OAPageContext pageContext, OAWebBean webBean)
{
OAApplicationModule am = pageContext.getApplicationModule(webBean);
am.invokeMethod("create", null);
}
4.3 在Am中调用Delete方法，具体如何Delete则定义在AM中
processFormRequest(OAPageContext pageContext, OAWebBean webBean)
{
if (pageContext.getParameter("DeleteYesButton") != null)
{
// User has confirmed that she wants to delete this purchase order.
// Invoke a method on the AM to set the current row in the VO and
// call remove() on this row.
String poHeaderId = pageContext.getParameter("poHeaderId");
Serializable[] parameters = { poHeaderId };
OAApplicationModule am = pageContext.getApplicationModule(webBean); am.invokeMethod("delete", parameters);
}
4.4 在Am中调用Commit方法，具体如何Commit则定义在AM中
processFormRequest(OAPageContext pageContext, OAWebBean webBean)
{
if (pageContext.getParameter("Approve") != null)
{
OAApplicationModule am = pageContext.getApplicationModule(webBean);
am.invokeMethod("Apply");
}
}
Thanks and Regards
