EBS OAF 开发中的OAMessageRadioGroup控件

q2009a06z22

　　EBS OAF 开发中的OAMessageRadioGroup控件
　　（版权声明，本人原创或者翻译的文章如需转载，如转载用于个人学习，请注明出处；否则请与本人联系，违者必究）
　　简单介绍
　　RadioGroup控件在OAF12.2.4及之前的开发文档中没有想关介绍，也没有不论什么演示样例程序中有相关应用。在网上有介绍说，它是和radiobutton一块使用，其ID作为RadioButton的group name使用，而且有相关样例。可是这是错误的，本文就是用来介绍RadioGroup控件，并有对应的代码演示样例。
　　RadioGroup控件并不能和RaidioButton控件一块使用，它也和RadioButton控件关系不大，由于你使用它的时候，根本不须要手工加入不论什么RadioButton控件。它实际是和MessageChoice(Poplist)非常像，或者说全然和MessageChoice功能一样，都是值对形式，仅仅是显示形式不一样， MessageChoice显示为下拉菜单，而RadioGroup就显示为一组RadioButton。
　　MessageChoice会为其对应的VO中的每条记录在下拉列表生成一条记录；而RaidoGroup会为VO中的没条记录生成一个Radiobutton.
　　演示样例介绍
　　实现后的页面例如以下，假设选择了Quick Mode,以下利用PPR事件来先Quick Mode相关的区域（Region）；假设选择了Standard Mode，以下利用PPR事件来显示Standard Mode相关的区域。


　　
　　其页面声明式定义例如以下图，包括一个RadioGroup控件极其以下依据其值要显示的两个区域。
　　

　　演示样例实现步骤
　　1.      就像上面说的，由于RadioGroup和MessageChoice(Poplist)非常像，所以我们也须要为这个控件建立一个对应的VO，这里的VO是RadioGroupVO，这非常easy，仅仅是从表AK_SEARCH_MODE中查询出要使用的值对而已。


　　
　　这里表是我自己建立的，假设要用的话，建议使用EBS lookup,这样能够完美解决多语言问题等，我使用的脚本例如以下：
CREATETABLE AK_SEARCH_MODE
(search_modeVARCHAR2(20)   NOT NULL,
mode_valueVARCHAR2(20));


INSERTINTO AK_SEARCH_MODE VALUES ('Quick Mode', 'QUICK');
INSERT INTO AK_SEARCH_MODE VALUES ('Standard Mode','STANDARD');
　　2.      建立好VO，我们须要建立AM。这里能够把上面的VO加到AM中，也能够不加，这和poplist一样，依据须要，由于poplist和radiogroup都能够直接使用VO的长名称(包括路径)，也能够使用VO的演示样例名。
　　3.      建立页面结构，就像上面看到的一样，这里为RadioGroup控件设置例如以下，事实上全然和MessageChoice(poplist)全然一样。


　　
　　4.      由于我们要触发PPR事件，所以，这里也使用了PVO，当中加了两列分别用于控制当选择不同的mode时显示不同的区域。
　　5.      由于加入了PVO，所以我们须要在请求页面的时候，要初始化PVO，须要对这个页面加入CO，并在AM和VO里加入以下的代码。
　　AM代码：
　　public void initPVOAndRadioGroupVO()
{
OAViewObjectImpl pvo = getRadioGroupPVO1();
if(pvo!=null &&pvo.getFetchedRowCount()==0)
{
pvo.setMaxFetchSize(0);
pvo.executeQuery();
Row pvoRow = pvo.createRow();
pvoRow.setAttribute("RenderQuickRN", Boolean.TRUE);
pvoRow.setAttribute("RenderStdRN", Boolean.FALSE);
pvoRow.setNewRowState(Row.STATUS_INITIALIZED);
pvo.insertRow(pvoRow);


RadioGroupVOImpl mainVo =this.getRadioGroupVO1();
mainVo.executeQuery();
}
}

　　CO代码：
　　 public void processRequest(OAPageContextpageContext, OAWebBean webBean)
{
super.processRequest(pageContext, webBean);
OAApplicationModule am = pageContext.getApplicationModule(webBean);
am.invokeMethod("initPVOAndRadioGroupVO");
}

　　6.      设置页面中不同mode对应区域的render属性利用EL来绑定到PVO上建立的两个属性来实现PPR。


　　
　　7.      在第三步为RadioGroup加入了PPR事件，所以须要在AM和CO做对应的处理，代码例如以下,这里我们依据RadioGroup控件的值通过AM来设置PVO的值，然后依据PVO来动态显示不同的区域。
　　AM中的代码：
　　 public void handleRadioBtnChanged(Stringmode)
{
Row pvoRow = getRadioGroupPVO1().first();
if("QUICK".equals(mode))
{
pvoRow.setAttribute("RenderQuickRN", Boolean.TRUE);
pvoRow.setAttribute("RenderStdRN", Boolean.FALSE);
}
else
{
pvoRow.setAttribute("RenderQuickRN", Boolean.FALSE);
pvoRow.setAttribute("RenderStdRN", Boolean.TRUE);
}
}

　　CO中的代码：
　　public void processFormRequest(OAPageContextpageContext, OAWebBean webBean)
{
super.processFormRequest(pageContext,webBean);
OAApplicationModule am =pageContext.getApplicationModule(webBean);   
String event = pageContext.getParameter(OAWebBeanConstants.EVENT_PARAM);
String source =pageContext.getParameter(SOURCE_PARAM);
if(event.equals("handleModeChange"))
{
OAMessageRadioGroupBean radioGroupBean =(OAMessageRadioGroupBean)webBean.findChildRecursive("ModeRadioGroup");
String mode =(String)radioGroupBean.getValue(pageContext);
Serializable[]  paras = { mode };
am.invokeMethod("handleRadioBtnChanged", paras);
}
}

　　这样一个简单的RadioGroup控件演示样例就完毕。