EBS OAF 开发中的OAMessageRadioGroup控件

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，这很简单，只是从表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控件示例就完成。