在AOM中使用动态语言

2. 在AOM中使用ELite

由于AOM中内嵌有ELite的支持，所以在使用AOM作为Web框架开发的应用中可以很方便的使用ELite这种动态语言，不管是在xhtml页面中直接当作EL表达式来使用，或者在后台Bean中直接使用ELite编写，都是非常自然和可靠的选择。

2.1. ELite的介绍

ELite的介绍还需要从EL（Expression Language）表达式语言说起，在JSP 2.0中，推出了一种称之为Expression Language的表达式语言，主要目的是方便用户存取后台的Java Bean。在JSF 1.1中，由于JSP 2.0 的EL不能够满足所有的需求，因此，在JSF 1.1中也定义了一套自己的EL表达式语言；幸运的是，在 JSP 2.1与JSF 12中，这两者进行了统一，并重新命名为：Unified Expression Language，简称：EL。

ELite脱胎于AOM中的EL运行引擎，在JSR-252的基础上对EL表达式语言做了很大的扩充，成为了一种新的动态语言，并且ELite是一个集命令式和函数式风格为一身的面向对象的程序设计语言，既有高阶函数（first-class functions）、列表推导（list-comprehension）、模式匹配（pattern-matching）、延时求值（lazy-evaluation）等函数式语言所具有的语言特征， 又具有和Java相近的语法结构，让熟悉Java的使用者便于上手。

目前，ELIte 已经从 OperaMasks 中抽离出来，其项目主页为：www.sourceforge.net/projects/aom-elite，而在最新下载的Apusic Application Server 5.1或者最新的AOM2.0中都包含有ELite引擎。

2.2. 在AOM中使用ELite

ELite本身是一个可以独立运行的动态语言引擎，如何单独使用ELite可以参见http://aom.group.javaeye.com/group/blog/170038 的介绍。而在AOM中使用ELite是非常简单的一件事情，建立一个Apusic 标准工程，给当前工程添加一个带有AOM支持的web模块，这个时候就可以在这个工程中使用ELite了。具体的Apusic Studio以及Apusic工程的介绍，请参见http://www.operamasks.org/articles/studioProject/html_single 等系列文章。通过一个简单的示例，讲解一下如何在AOM中使用ELite来进行Web应用的开发，希望能让读者对ELite的使用有一个初步的了解。

在WebContent目录下新建一个Facelets文件calc_elite.xhtml

<f:view xmlns="http://www.w3.org/1999/xhtml" xmlns:f="http://java.sun.com/jsf/core"
  xmlns:w="http://www.apusic.com/jsf/widget" xmlns:layout="http://www.apusic.com/jsf/layout"
  xmlns:h="http://java.sun.com/jsf/html" renderKitId="AJAX">
  <w:page title="Calculator">
    <w:form id="calc" transient="true">
      <layout:panelGrid columns="3">
        <h:outputLabel for="first" />
        <w:textField id="first" />
        <h:message for="first" />
        <h:outputLabel for="second" />
        <w:textField id="second" />
        <h:message for="second" />
        <h:outputLabel for="result" />
        <h:outputText id="result" />
      </layout:panelGrid>
      <br/>
      <layout:panelGrid columns="4">
        <w:button id="add" />
        <w:button id="subtract" />
        <w:button id="multiply" />
        <w:button id="divide" />
      </layout:panelGrid>
    </w:form>
  </w:page>
</f:view>

在 WEB-INF/scripts 里面有一个 calc_elite.elite 的文件，代码示例如下：

@Bind @Required first::double = 22;
@Bind @Required second::double = 7;


@Bind @Pattern("#,##0.00") result::double;



@Action void add()      => result = first + second;
@Action void subtract() => result = first - second;
@Action void multiply() => result = first * second;
@Action void divide()   => result = first / second;

	声明一个 double 的变量，语法形式是ELite语法，但同样可以任意的利用各种Java的annotation
	用到了 @Pattern 的标注，用来指定数字的显示样式。你可以参考 AOM API文档。
	声明一个@Action 方法，这个方法你还可以这样写： @Action void add() { result = first + second; System.out.println("add method invoked"); }

那么，calc_elite.xhtml 与 calc_elite.elite 是怎样关联起来的呢？在 operamasks.xml 中进行声明：

<view-mapping>
  <url-pattern>/calc_elite.xhtml</url-pattern>
  <model-bean>/WEB-INF/scripts/calc_elite.elite</model-bean>
</view-mapping>

如果觉得在 operamasks.xml 中进行配置很繁琐，那么，还可以这样：在页面中通过<om:elite>标签，将 ELite 代码片断放在其中。

<f:view xmlns="http://www.w3.org/1999/xhtml" xmlns:f="http://java.sun.com/jsf/core"
  xmlns:w="http://www.apusic.com/jsf/widget" xmlns:layout="http://www.apusic.com/jsf/layout"
  xmlns:h="http://java.sun.com/jsf/html" renderKitId="AJAX" xmlns:om="http://www.apusic.com/jsf/misc">
  

<om:elite>
  <![CDATA[
@Bind @Required first::double = 22;
@Bind @Required second::double = 7;
@Bind result::double = 0;

@Action add()=> result = first + second;  
@Action subtract() => result = first - second;
@Action multiply() => result = first * second;
@Action divide()   => result = first / second;
  ]]>
  </om:elite>
  <w:page title="Calculator">
    <w:form id="calc">
      <layout:panelGrid columns="3">
        <h:outputLabel for="first" />
        <w:textField id="first" />
        <h:message for="first" />
        <h:outputLabel for="second" />
        <w:textField id="second" />
        <h:message for="second" />
        <h:outputLabel for="result" />
        <h:outputText id="result" />
      </layout:panelGrid>
      <br />
      <layout:panelGrid columns="4">
        <w:button id="add" />
        <w:button id="subtract" />
        <w:button id="multiply" />
        <w:button id="divide" />
      </layout:panelGrid>
    </w:form>
  </w:page>
</f:view>

这个例子只是简单的介绍了一下ELite 在 AOM 中的应用，ELite能给使用者带来的绝对不仅仅是这些，希望 ELite 能够成为您的另外一种奇妙的选择。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE HTML PUBLIC "" "">
<f:view xmlns="http://www.w3.org/1999/xhtml" xmlns:f="http://java.sun.com/jsf/core"
xmlns:w="http://www.apusic.com/jsf/widget" xmlns:layout="http://www.apusic.com/jsf/layout"
xmlns:ajax="http://www.apusic.com/jsf/ajax" xmlns:h="http://java.sun.com/jsf/html"
renderKitId="AJAX">
    <w:head>
          <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    </w:head>
    <w:page title="Insert title here">
         <h:form>
             <h:inputText value="#{myBean.text}"></h:inputText>
             <h:commandButton action="#{myBean.click}" value="Submit"></h:commandButton>  
             You typed: #{myBean.text}  
         </h:form>
    </w:page>
</f:view>

public interface IMyBeanController {  
  public String getText();  
  public void setText(String text);  
  public String click();  
}  

require 'java'  
    
include_class 'jruby.IMyBeanController'  
 
class MyBeanController  
 include IMyBeanController  
  
  @text = nil 
  
  def setText(text)  
      @text = text  
  end    
  def getText  
      @text  
  end      
  def save  
      puts @text  
  end     
end  

<lang:jruby id="myBean"  
 script-interfaces="jruby.MyBeanController"  
script-source="classpath:jruby/MyBeanController.rb" scope="request">  
</lang:jruby> 

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师
• JavaEye问答大赛开始了！ 从6月23日 至 7月6日，奖品丰厚 ！
• 快来参加7月17日在成都举行的SOA中国技术论坛
• Oracle专区上线，有Oracle最新文章，重要下载及知识库等精彩内容，欢迎访问。

AOM组件规范

Chapter 2. 组件使用

2.1. 组件体系

AOM2.0中常用组件约70多个（未包括图表类组件与JSF原生组件），在设计时已按照其功能特性分别归类到以下命名空间中：

• http://www.apusic.com/jsf/widget ：.  此命名空间中的组件大部分是常用的界面组件，通过这些组件可以快速的搭建应用程序。同时此命名空间中也提供了一些用于展现风格控制，页结构声明等场景的非可视化组件。下文中属于此命名的组件将以w:为命名空间前缀

• http://www.apusic.com/jsf/layout ：.  此命名空间中包含了一系列布局组件，通过使用这些布局组件，可以方便、灵活的对页面进行布局。下文中属于此命名的组件将以layout:为命名空间前缀。

• http://www.apusic.com/jsf/ajax ：.  此命名空间中包含了一组实用的ajax工具组件，可以很容易的为系统增加ajax特性。下文中属于此命名的组件将以ajax:为命名空间前缀。

• http://www.apusic.com/jsf/misc ：.  此命名空间中包含了与服务器端逻辑声明相关的一些标签。下文中属于此命名的组件将以om:为命名空间前缀。

由于命名空间本身会影响到用户的编程体验与设计工具的布局，因此在这里采用了较粗粒度的分类。对于AOM中的组件还可以从以下角度进行分类：

• 从页面组件是否关联到JSF的实体组件类（UIComponent的子类）来分类。 关联到组件类的页面组件（下文称为实体组件）将在服务器端组件树中创建对应的组件类，由AOM引擎来维护其组件树层次结构、状态恢复、模型绑定等特性。而 没有关联到组件类的页面组件（下文简称为非实体组件）在服务器端组件树中不存在对应的实体组件类，自然也无法在模型对象中绑定此类组件的组件类。

• 从 页面组件的可视化功能进行分类。从可视化特性来划分，组件可以大体分为可视组件与非可视组件。可视组件将对应最终呈现页面上的一块区域，并在其中展现其内 容。非可视组件则主要负责声明与功能行为，其自身在页面上不可见。但非可视组件仍可能对最终呈现的效果产生影响。例如<w: forEach>、<w:stylesheet>等组件。

  大部分可视组件属于实体组件，但也存在例外，非实体 的可视组件往往是一个结构性实体组件的子组件，例如<w:dataGrid>的<w:outputColumn>组件，或 <w:panelGrid>的<w:cell>组件等等。

下面将对可视组件与非可视组件按照其功能再作进一步的分类。这里仅列出各类组件的标签名称，组件的具体作用请参考组件文档。进行这种分类有助于下文对组件的共性与各类规则的描述。

2.1.1. 可视组件

下表列出了AOM2.0支持的可视组件标签，同时列出实体组件所对应的组件类。若标签没有指明组件类，则此标签为非实体组件。

2.1.2. 非可视组件

下表列出了AOM2.0支持的非可视组件标签，同时列出实体组件所对应的组件类。若标签没有指明组件类，则此标签为非实体组件。

2.2. 组件类

在页面中使用标签放置的实体组件，都对应一个服务器端组件类的实例。这个组件类实例可通过标签的bind属性或IoVC的@Bind标注与ManagedBean中的属性进行绑定，在ManagedBean中通过组件类的API进行各种操作。

一般来说，可视组件类的命名规则应为“UI”加上首字大写的页面标签名。例如<w:button>对应的组件类是UIButton。 http://www.apusic.com/jsf/ajax命名空间下的组件类以“Ajax”开头加上首字大写的页面标签名（此包下的可视组件亦以此 规则为准），例如<ajax:updater>的组件类是AjaxUpdater。非可视组件类的命名为首字大写的页面标签名。上一节的列表 中列出了与组件标签对应的组件类，对于不符合以上命名规则的组件类，用橙色标出。

2.2.1. 组件属性

2.2.1.1. 属性命名规则

本节列出一些常见属性的命名规则，描述中使用以下术语：

• 以...为前缀：表示名称以某字符串开头，不应改变其大小写。

• 以...为标识：表示名称中应包含某字符串，若其位于名称开头，应首字小写，否则，应首字大写。

• 以...命名：表示应以此字符串作为名称，不应改变其大小写。

常见属性的命名遵循以下规则：

1. 可见性属性：

   • rendered属性表示此组件是否被渲染。目前所有组件均有此属性，但应注意此属性不支持在ajax环境下动态修改，需要配合<ajax:updater>使用。

   • visible属性表示此组件会被渲染时在客户端设定的可见性。

     * 目前违反此规则的属性与对应组件有：

     hidden : outputColumn idColumn

   • 组件部件的可见性，以前缀show加上首字大写部件为名称的属性表示是否显示此部件。

     * 目前违反此规则的属性和对应组件有：

     border           : accordionLayout columnLayout tree iframe tabLayout borderLayout tableLayout editDataGrid gridLayout panelBox cardLayout panelGrid dataGrid window absoluteLayout panel
     footer           : cardLayout accordionLayout columnLayout tree dataGrid tabLayout borderLayout window tableLayout editDataGrid panel absoluteLayout
     frameborder      : iframe
     header           : accordionLayout columnLayout tree tabLayout borderLayout tableLayout editDataGrid cardLayout dataGrid outputColumn window idColumn absoluteLayout panel 
     hideBorders      : cardLayout accordionLayout columnLayout tree dataGrid tabLayout borderLayout window tableLayout editDataGrid panel absoluteLayout 
     hideCollapseTool : cardLayout accordionLayout columnLayout tree dataGrid tabLayout borderLayout window tableLayout editDataGrid panel absoluteLayout 
     hideHeaders      : dataGrid editDataGrid 
     hideLabel        : checkBox numberField textField combo timeField dateField textArea calcNumberField simpleHtmlEditor 
     hideParent       : cardLayout accordionLayout columnLayout tree dataGrid tabLayout borderLayout window tableLayout editDataGrid panel absoluteLayout 
     hideTrigger      : combo timeField dateField 
     drawArrow        : textAnnotation 
     drawBaseLine     : xAxis axis yAxis 
     drawGridLine     : xAxis axis yAxis 
     drawItemLabel    : compositeChart scatterChart timeDataItem curveAreaChart lineChart chart areaChart curveChart xyDataItem functionItem histogramDataItem barChart radarChart pieChart dataItem 
     drawLine         : xAxis axis yAxis 
     drawLines        : curveChart functionItem xyDataItem timeDataItem curveAreaChart lineChart histogramDataItem dataItem 
     drawMarkers      : curveChart functionItem xyDataItem timeDataItem curveAreaChart lineChart histogramDataItem dataItem 
     drawOutline      : compositeChart scatterChart timeDataItem curveAreaChart lineChart chart areaChart curveChart xyDataItem functionItem histogramDataItem barChart radarChart pieChart dataItem 
     drawTickLabels   : xAxis axis yAxis 
     drawTickMarks    : xAxis axis yAxis

2. 有效性属性：

   • disabled属性用于决定组件自身的有效性；

   • 根据组件有效性设置而生效的属性，以enabled或disabled为前缀。例如disabledClass等。

   • 动作的有效性使用动词的able形式。例如editable，closable等；

   • 特性或子部件的有效性使用“enableXXX”形式，例如enableColumnMove等。

     目前违反此规则的属性和对应组件有：

     maskDisabled : cardLayout accordionLayout columnLayout tree dataGrid tabLayout borderLayout window tableLayout editDataGrid panel absoluteLayout

   • 表示是否需要引擎提供支持（更新，回调，注入等）的属性，使用require为前缀。

     目前违反此规则的属性和对应组件有：

     updateAble : treeNode

3. 可接受性属性：

   • 表示允许接受某种子组件或输入值的属性，使用allow为前缀。例如allowChildren。

   • 具体列出允许或不允许的取值的属性，使用allowed或disallowed为前缀。

   • readOnly属性表示是否允许用户输入。

     目前违反此规则的属性和对应组件有：

     readonly: chooseSkin dateMenu slider datePicker button

4. 有序属性：

   • 表示“排序前一位”或“上一次”的属性使用prev为前缀。例如<w:pagingToolbar>的prevText。

   • 表示“排序后一位”或“下一次”的属性使用next为前缀。

   • 表示第一位或第一次的属性使用first为前缀。

   • 表示最后一位或最后一次的属性使用last为前缀。

   • 表示显示位置的前面使用before为前缀。例如<w:pagingToolbar>的beforePageText。表示显示位置的后面使用after为前缀。

5. 统计量属性：

   • 表示最大值的属性，在不引起歧义的情况下，可使用maximum作为属性名。若同一组件可设定多种最大值，组件自身取值的最大值使用maxValue作为属性名，其它表示最大值的属性应以max为前缀。

   • 表示最小值的属性，在不引起歧义的情况下，可使用minimum作为属性名。若同一组件可设定多种最小值，组件自身取值的最小值使用minValue作为属性名，其它表示最大值的属性应以min为前缀。

6. 信息属性：

   • 标题统一以title命名（或前缀）。

     目前违反此规则的属性和对应组件有：

     captionClass : panelGrid gridLayout 
     captionStyle : panelGrid gridLayout

   • 表示组件的标签性提示信息的属性，以label为标识。（注，以xxx为标识指属性名中包含此字符串，若其并非开头，应按照java bean属性命名规则首字大写。下同。）

   • 表示跟随鼠标弹出提示信息的属性，以tip为标识。

   • 表示正常情况下提示信息的属性，以text为标识。例如：emptyText

   • 表示出错提示信息（包括未符合其他属性所指定的条件）的属性，以message为标识。

     目前违反上述两项的属性和对应组件有：

     blankText            : numberField textField combo timeField dateField textArea calcNumberField
     disabledDatesText    : dateField
     disabledDaysText     : dateField
     invalidText          : checkBox numberField textField combo timeField dateField textArea calcNumberField simpleHtmlEditor
     maxLengthText        : numberField textField combo timeField dateField textArea calcNumberField
     maxText              : numberField timeField dateField calcNumberField
     minLengthText        : numberField textField combo timeField dateField textArea calcNumberField
     minText              : numberField timeField dateField
     nanText              : numberField calcNumberField
     regexText            : numberField textField combo timeField dateField textArea calcNumberField
     valueNotFoundText    : combo timeField
     vtypeText            : numberField textField combo timeField dateField textArea calcNumberField
     
     completeMessage      : fileUploadProgress
     startMessage         : fileUploadProgress
     uploadingMessage     : fileUploadProgress

7. 样式属性：

   • 背景颜色属性统一命名为bgcolor。与背景相关的属性统一以bg为前缀

     backgroundAlpha      : scatterChart compositeChart curveChart curveAreaChart lineChart barChart chart radarChart pieChart areaChart 
     backgroundColor      : scatterChart compositeChart legend curveChart title curveAreaChart lineChart barChart chart radarChart pieChart areaChart 
     backgroundImage      : scatterChart compositeChart curveChart curveAreaChart lineChart barChart chart radarChart pieChart areaChart 
     backgroundImageAlpha : scatterChart compositeChart curveChart curveAreaChart lineChart barChart chart radarChart pieChart areaChart 
     backgroundImagePosition : scatterChart compositeChart curveChart curveAreaChart lineChart barChart chart radarChart pieChart areaChart

   • 与CSS Class相关的属性以class为标识（不应称为XXXStyleClass）。

     contentStyleClass    : panelBox
     startStyleClass      : status
     stopStyleClass       : status
     styleClass           : drawImage form chart simpleDataGrid gridLayout separator toolBar menuItem pieChart menu idColumn fileUpload radioMenuItem scatterChart compositeChart checkMenuItem menuBar curveAreaChart updater lineChart cell status commandMenuItem areaChart linkMenuItem chooseSkin curveChart panelBox panelGrid dataView slider page barChart progressBar outputColumn renderGroup radarChart logger

   • 与CSS Style相关的属性以style为标识。组件自身的CSS Style的属性命名为style。

8. 连接属性：

   • 对外部网址的引用属性（不经JSF导航规则处理），使用href命名。

   • 对会经过JSF导航规则处理的地址引用，使用url命名。

2.3. 组件事件

AOM中存在着多种事件，包括请求生命周期事件，组件事件，应用事件等。本文只对组件事件进行规范。

根据组件事件的发起位置，可以分为UI（User Interface）事件和模型事件两类：

• UI事件：指跟UI相关并由用户的操作而产生的事件。例如一个<w:button>组件的onclick事件，或一个<w:textField>组件的onchange事件等。

• 模型事件：指跟UI无关，主要由于组件模型自身机制而产生的事件。例如dataGrid在装载数据时所广播的ondataload事件。

2.3.1. UI事件

根据UI事件侦听逻辑的执行位置，可以分为客户端侦听与服务器端侦听两种。

2.3.1.1. 在客户端侦听并响应UI事件

客户端的侦听逻辑通过组件属性暴露，若需要在客户端侦听并响应UI事件，应在组件的事件属性中使用客户端脚本（javascript）编写侦听逻 辑。事件属性的命名应为“on”开头后续全小写的事件名称，例如<w:button onclick="...">。事件属性的取值应为String类型，或结果为String类型的EL表达式，取值为javascript代码，代 码前可以加上javascript:标识，也可以忽略。因此，在AOM中以下三种写法是等价的：

• 页面：
  <w:button onclick="alert('I am clicked');"/>

   

• 页面：
  <w:button onclick="#{bean.clickedJs}/>
  
  ManagedBean：
  public String getClickedJs() {
      return "javascript:alert('I am clicked');"
  }

   

• 页面：
  <w:button onclick="#{bean.clickedJs()}/>
  
  ManagedBean：
  public String clickedJs() {
      return "alert('I am clicked');"
  }

2.3.1.2. 在服务器端侦听并响应UI事件

2.3.1.2.1. 静态定义服务器端侦听方法

在AOM中，所有在客户端执行的事件都可通过<ajax:action>标签转变为在服务器端执行，根据下面规则：

• <ajax:action>作为UI组件的子组件，侦听其父组件的UI事件，并引起页面提交，触发服务器端处理逻辑。 可使用以下三种方式之一指定<ajax:action>所侦听的事件：

  1. 使用<ajax:action>标签的event属性指定事件名称。

     <w:textField id="txt">
         <ajax:action event="onblur" action="#{bean.txtBlurAction}"/>
     </w:textField>

  2. 使用@Action或@ActionListener标注在ManagedBean上作IoVC绑定，用标注的event属性指定事件名称指定。

     页面代码：
     <w:textField id="txt"/>
     
     ManagedBean：
     @Action(id = "txt", event = "onblur")
     public void txtBlurAction()

     注：@ActionListener与@Action作用相同，但@ActionListener标注的方法还可接收一个类型为javax.faces.event.ActionEvent的参数，获取触发此侦听方法的事件实例。例如：

     @ActionListener(id = "btn1")
     private void action1(ActionEvent event) {
         System.out.println("action1 called by " + event.getSource().getClass());
     }
         
     @ActionListener(id = "btn1")
     private void action2() {
         System.out.println("action2 called");
     }

     单击页面中所绑定的<w:button id="btn1"/>按钮，得到的输出为：

     action1 called by class org.operamasks.faces.component.widget.UIButton
     action2 called

     使用@ActionListener可为一个组件绑定多个侦听方法，但这些侦听方法执行顺序未作定义。此外，使用标签@ActionListeners应可为多个组件事件指定同一个侦听方法：

     @ActionListeners({
         @ActionListener(id = "btn1"),
         @ActionListener(id = "btn2")})
     private void action(ActionEvent event) {
         System.out.println("action called by " + ((UIComponent)event.getSource()).getId());
     }

  3. 使用@Action或@ActionListener标注在ManagedBean上作IoVC绑定，由被标注方法的命名约定“<UI组件id>_<侦听事件名称>”指定。

     页面代码：
     <w:textField id="txt"/>
     
     ManagedBean：
     @Action
     public void txt_onblur()

• 服务器端侦听方法可使用以下两种方式之一指定（示例同上）：

  1. 使用<ajax:action>标签的action属性指定类型为MethodExpression的统一EL表达式。

  2. 使用@Action或@ActionListener标注在ManagedBean中绑定侦听方法。

  服务器端侦听方法允许使用以下两种签名之一：

  • 无参数

  • 带一个类型为AjaxEvent的参数。AjaxEvent接口定位为：

    /**
     * 获取触发事件的UI组件
     */
    public UIComponent getSource();
    
    /**
     * 获取本事件的相关参数
     */
    public Map<String, Object> getParams();

注：计划加入支持静态定义AjaxActionListener的方式（关于AjaxActionListener接口详见Section 2.3.1.2.2, “动态定义服务器端侦听器” ），但具体方案仍在设计中。初定在UI组件标签中加入名为“<事件名称>Listener”的属性，用于指定结果类型为AjaxActionListener的统一EL表达式。例如可通过以下代码加入一个onclick事件的服务器端侦听器：

<w:button id="btn" onclickListener="#{mylistener}"/>

其中mylistener是一个实现了AjaxActionListener接口的ManagedBean。

2.3.1.2.2. 动态定义服务器端侦听器

在AOM中，可通过组件类实例的addFacesListener(FacesListener listener)方法动态加入一个服务器端侦听器。传入的listener应为AjaxActionListener接口的实现类。 AjaxActionListener接口暴露以下方法：

public interface AjaxActionListener extends javax.faces.event.FacesListener {
   /**
    * 返回此侦听器所侦听的事件名称
    */
   Set<String> getListeningEvents();

   /**
    * 事件被触发时的处理逻辑
    */
   void process(AjaxEvent event);
}

2.3.1.3. 客户端侦听方法与服务器端侦听器的执行关系

若一个组件的一个事件同时定义了客户端侦听方法与服务器端侦听器，执行顺序为：事件触发时，首先在客户端执行客户端侦听方法，若此方法顺利执行并返 回true（若方法无返回值，默认为true），则提交页面，执行服务器端侦听器逻辑。若客户端侦听方法显式返回false，则不会提交页面，自然也不执 行服务器端侦听器逻辑。

2.3.2. 模型事件

由于组件模型自身机制而产生的事件称为模型事件，此类事件统一以消息总线（MessageBus）的形式进行处理。例如以下代码定义了id为grid的DataGrid组件的ondataload事件的侦听方法：

@EventListener("grid_ondataload")
private void ondataload(AjaxEvent event) {
   ...
}

2.4. transient属性

所有UI组件均具有transient属性，在AOM中，此属性为false（默认）指UI组件将保存完整ViewState信息，为true表明 此UI组件只保存无法从faces页面重建的部分ViewStateView。由于ViewState本身对用户透明，因此对于任一组件，除非需要在运行 期动态修改其子组件树结构，否则该组件在transient属性为true时的渲染结果和行为应与transient属性为false时一致。

若需要让transient属性为true的组件支持动态子组件树，需要将其置于<om:stateAware>组件之中：

<om:stateAware deep="true">
    <ajax:updater binding="#{DynamicPageBean.updater}">
          <layout:panelGrid binding="#{DynamicPageBean.panelGrid}" columns="1" border="1">
          </layout:panelGrid>
    </ajax:updater>
</om:stateAware>

• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师
• Oracle专区上线，有Oracle最新文章，重要下载及知识库等精彩内容，欢迎访问。
• 快来参加7月17日在成都举行的SOA中国技术论坛
• JavaEye问答大赛开始了！ 从6月23日 至 7月6日，奖品丰厚 ！

@Bind
private List<user> grid;

<w:datagrid paged="true" rows="20" id="users" contextmenu="true" toolbarposition="top" var="user">
  <w:outputcolumn header="用户名" value="#{user.username}">
  <w:outputcolumn header="电子邮件" value="#{user.email}">
</w:outputcolumn>

<f:view xmlns="http://www.w3.org/1999/xhtml" xmlns:f="http://java.sun.com/jsf/core" xmlns:w="http://www.apusic.com/jsf/widget" xmlns:layout="http://www.apusic.com/jsf/layout" xmlns:ajax="http://www.apusic.com/jsf/ajax" renderkitid="AJAX">
	<w:head>
		
	</w:head>
	<w:page title="Grid Demo">
		<w:datagrid id="grid">
	</w:datagrid>
</w:page>

<w:dataGrid id="grid"/>

@Bind
private UIDataGrid grid;

public class User {
	private String id;
	private String name;
	private String email;
        //getter and setter ...

        public User(String id, String name, String email) {
		super();
		this.id = id;
		this.name = name;
		this.email = email;
	}

	public User() {

	}
        //顺手写几个测试数据，用于下面的测试
	public static List<User> samples(){
		List<User> users = new ArrayList<User>();
		users.add(new User("1","AAA","a@g.com"));
		users.add(new User("2","bbb","b@g.com"));
		users.add(new User("3","CCC","c@g.com"));
		users.add(new User("4","ddd","d@g.com"));
		users.add(new User("5","EEE","e@g.com"));
		users.add(new User("6","fff","f@g.com"));
		return users;
	}
}

@Bind(id = "grid", attribute = "value")
private List<User> users = User.samples();

	@Bind(id = "grid", attribute = "viewProvider")
	private GridViewProvider viewProvider = new GridViewProvider() {
                //GridViewProvider 是一接口，需要我们实现如下三个方法
                //getColumnModel 为Grid的数据列模型，
		public GridColumnModel getColumnModel(Object input) {
			GridColumnModel model = new GridColumnModel();
                        //新增列，指定id为name
			GridColumn column = new GridColumn("name");
                        //指定宽度为150
                        column.setWidth(150);
                        //可以排序
			column.setEnableSort(true);
                        //添加到grid的数据模型 
			model.addColumn(column);

                        //新增列，指定id为email
			column = new GridColumn("email");
			model.addColumn(column);

                        //新增列，指定id为id
			column = new GridColumn("id");
                        //并将该列设置为隐藏列
			column.setHidden(true);
			model.addColumn(column);
                        
                        //在展示数据的时候，显示行号 
			model.setShowRowNumber(true);
			return model;
		}

		public GridHeaderModel getHeaderModel(Object input) {
			GridHeaderModel model = new GridHeaderModel();
			GridHeader header = new GridHeader();
			GridHeaderCell cell;
                        //新增列的头单元，并命名为"名称" 
			cell = new GridHeaderCell("名称");
			header.addCell(cell);
                        //新增列的头单元，并命名为"电子邮件"    
			cell = new GridHeaderCell("电子邮件");
			header.addCell(cell);
			model.addHeader(header);
			return model;
		}

		public GridSelectionModel getSelectionModel(Object input) {
			return null;
		}
	};

@Bind(id = "grid", attribute = "rowDataProvider")
	private GridRowDataProvider rowProvider = new GridRowDataProvider() {
                //其中 rowData为每行数据，column 为列信息。
                //通过column.getId可以获得上面定义的列ID
		public Object getLabel(Object rowData, GridColumn column) {
                        //获取当前列的ID
			String id = column.getId();
			User user = (User) rowData;
                        //判断，根据不同的id，展示不同的数据，如果上面的Grid的数据列模型设置了转换，那么会自动调用
			if ("name".equals(id)) {
                                //列的id是name,显示用户名
				return user.getName();
			} else if ("email".equals(id)) {
                                //列的id是email,显示电子邮件
				return user.getEmail();
			}
			return null;
		}
	};

<w:datagrid paged="true" rows="20" contextmenu="true" toolbarposition="top" .... />

<w:datagrid id="grid"/>

@ComponentAttributes(id = "grid")
private Map<String, Object> config;

public GridBean() {
    this.config = = new HashMap<String, Object>();
    //分页
    this.config.put("paged", true);
    //每页10条记录
    this.config.put("rows", 10);
    //根据记录的多少，自动调整表格高度
    this.config.put("autoHeight", true);
    //.....
}

	public static List<User> samples2(){
		List<User> users = new ArrayList<User>();
		for(int i=0;i<10;i++){
			users.addAll(samples());
		}
		return users;
	}

<w:form>
  <w:button id="btn" />
</w:form>
<w:dataGrid id="grid"/>

@Bind(id = "btn", attribute = "value")
private String btn_label = "Reload Data";

@Action(id = "btn")
public void changeValues() {
        //首先，赋值新的数据
	this.users = User.samples2();
        //配置第一个显示的记录，这里是估计用了2，用来演示，如果不填写，或者0 那么将会全部展示
	grid.setFirst(2);
        //重新配置表格的每页显示的条数，更新为15条每页
	grid.setRows(15);
        //重新版定Grid,展示新的数据
	this.grid.rebind();
}

grid.setViewProvider(GridBeanHelper.getTrainViewProvider());
grid.setRowDataProvider(GridBeanHelper.getTrainRowProvider());

• 搜狐网站诚聘Java、PHP和C++工程师
• Oracle专区上线，有Oracle最新文章，重要下载及知识库等精彩内容，欢迎访问。
• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 快来参加7月17日在成都举行的SOA中国技术论坛
• JavaEye问答大赛开始了！ 从6月23日 至 7月6日，奖品丰厚 ！

伴随着我国信息化的发展，项目管理越来越成为项目成功的关键问题。许多项目配备了足够优秀的人手，仍然以失败告终，根本原因就是没有良好的管理，大家都在努力工作，但是每个人却冲着不同的方向，结果可想而知。那么如何才能有效的管理呢？
首先，控制需求。
采集需求的书多如牛毛，每个人都提出了自己的观点。作者认为控制需求中主要把握好以下三点：
● 充分阅读招标方案中客户的要求，最好将之细化成具体的、量化的、可操作的目标。当然最初的阅读无法达到细化的需要，但是充分理解招投标方案是对行业知识最快的学习方法，还需要通过不同侧面去了解所做项目的行业背景，这就是俗话所说的做功课。；
● 充分认识“客户永远是对的”。刚接手项目时，没有行业经验必须先虚心向客户学习。确定需求时，还必须具备专家的能力理解和引导客户需求。与客户最危险的沟通方式就是问：这个项目想做点啥？不设条件的让客户去想，要不客户不理解信息化项目说不出东西，要不就是客户终于有个表达自己的机会说出无数的需求，使项目范围无限扩大。其实，这些都是因为自己没有对项目充分认识，自己不懂当然会被别人牵着鼻子走了。；
● 充分理解需求变更的现实意义。软件工程早期人们极端的认为客户无理地变更需求导致项目失败，但是随着极限编程概念的推广和软件开发效率的不断提升，大家也越来越理解需求变更的合理性。但是，管理需求变更仍然是非常重要的工作。如果担心得罪客户而一味的迁就，或者硬顶客户并且所有事情都找他签字，结果都会给项目推进带来不必要的麻烦。因此，确定合理的变更流程，并且引导客户认识并承担需求变更的成本与风险。就能够有效规避需求变更本身给项目带来的冲击。
例如：作者参与过的公安项目，以前根本没有公安行业的背景，于是经历过一个月的痛苦学习阶段，然后才具备了与客户正面沟通的实力，指出客户需求中与本次项目中有所冲突的地方，并且为客户提出其他的解决方案，最终协助客户找到项目完工的真正目标，促使拖了近一年的项目用两个月的时间完成了收尾、上线、初验并收款。而项目的成功推进根本原因是控制好需求，清晰了目标，有了方向工作就好做了。

其次，建立团队。
一个优秀的团队一定会有一个优秀的项目经理，项目经理可以说是整个团队的灵魂，因此一个项目要成功必须要找到合适的项目经理。
项目经理会负责选择合适的团队成员将团队组织在一起，团队至少包括：技术负责人、软件开发人员、软件测试人员，比例是1:2:1，这个配置是根据中国情况提供的最低标准。中国很少能够组织完整的项目团队，资源的严重不足导致团队人员只能按最低配置完成。由比例可以得知团队至少需要5个人，这是团队组织标准7±2的最低要求，这样的团队才是有战斗力的团队。
由于项目太多，许多公司连这样的团队都无法组织。如果是这样，作者建议宁愿一个团队接多个项目，也不要一个项目只配1～2个人。因为这是团队建设中的第二个重要问题：分工。术有专攻，自古就已经得到认同。同时，现代科学技术越来越复杂，没有人是全才。还有，公司不可能养得起许多个高手。因此，这样的团队由：项目经理＋技术负责人＋技术熟手＋技术生手＋测试人员是一个非常好的搭配，大大减低公司在人员上的成本投入，不同层面的人员搭配可以使项目中各种工作都有相应的人员去应对，同时不同层次的工程师配合也使知识在项目中得到有效传递，而生手的成熟只有靠项目完成，有老手帮带也使项目质量容易管控。同时可以保证每个人在项目中有事做，有成长的机会，有成就感。

然后，制定计划。
“凡事预则立，不预则废”，因此没有计划的工作失败是难免的事情，成功完全是碰运气。但是制定计划本身也是一件技术活，在计划之前一定要先完成需求准备工作，就是为项目确定目标，没有目标也就无从谈起计划了。只有目标本身是可量化的，计划才能够有效制定出来。小时候经常会制定目标考100分，现在发现那不叫目标叫愿望。目标是对项目进行有效评估，了解具体的工作是哪些，大致需要多久时间才，确认目标实现后项目就可以结束。这些才是项目的真正目标，并以每个目标评估的时间消耗为基础，制定项目计划，项目计划出来后直接乘2就是最终项目的完成时间表。但是现实是项目时间表根本没法获得公司或者客户的认可，时间肯定会被大大压缩，这时就需要对计划中的目标排优先级，重新阅读每个目标，如果是可做可不做的先删除，直到留下来不得不做的，再重新评估时间，基本上会比实际项目时间短很多，但是以这个为基础开始项目实施吧。
作者参与过一个公司内部项目，将地理信息系统应用从J2EE平台移植到DotNET上，技术风险比较多，人员也是临时组建的，本来三个月的项目最后被压缩成一个半月，但是项目最终完成并通过公司和投资人的验收。因为，从开始就排定了项目目标的优先级，并且作为项目经理时刻提醒组员关注项目前进方向；其次，一直把应用集成排在项目的第一目标，在三周左右项目就已经可以上线运行，于是测试工作与开发工作保持同步展开；最后，与客户（领导和投资人）保持紧密沟通，时刻报知项目进度和完成的内容，使客户了解项目是否提供了他所需要的最基础的功能，以及真正理解项目未实现的目标原因，并能够提早接受这样的现实情况，为项目最终验收奠定了基础。

最后，有效执行。
执行力是许多管理者关注的问题，常常感叹为什么有Power就推不动事情的前进呢？其实，就如国家实力一样，分硬实力和软实力。管理者拥有的只是公司提供的这个Power叫硬实力，但是还需要在工作中积累自己的软实力，通过增强团队凝聚力、提升团队文化、创造团队成员的个人发展环境来增强自己的软实力。有了软实力，团队成员更愿意付出努力来为团队目标奋斗，许多事情自然不需要花大力气推动，而有了水到渠成的感觉。

• Oracle专区上线，有Oracle最新文章，重要下载及知识库等精彩内容，欢迎访问。
• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 快来参加7月17日在成都举行的SOA中国技术论坛
• JavaEye问答大赛开始了！ 从6月23日 至 7月6日，奖品丰厚 ！

记录此文，是想记住今天在飞机上与别人交流的一点心得。

今天谈论的是摄影，我也喜欢摄影，但是以前总希望自己能够有时间专业的学习摄影，于是我放弃了。一直想等到有时间进行专业学习了，再好好的感受摄影。

但是今天的交流使我重新思考自己的想法。因为飞机上的朋友介绍他自己就是不断地拍，当然每次拍也会用心考虑用什么方式拍，但是并没有被那些手段约束自己。虽然拍的大部分时候都让人不满意，但是他希望通过不断地拍寻找自己的感觉，当什么时候找到自己喜欢的拍摄方式，得到的片子也令自己满意的时候，那就代表有了自己的思想了，然后再以这个思想为基础去与别人交流，吸收别人那里对自己有价值的东西，而不是盲从。

写这个也是想告诉自己，有些时候最重要的是行动，行动的时候不要太在乎目标，只是用心去感受过程就好了，因为需要通过在许多结果中寻找自己的感觉，然后以这样的感觉为基础再去学习别人的技巧，这样就不是死抄，而是在丰富自己的感觉，收获就大不同了。

其实也是想给三十岁的自己定个方向，不用在乎我自己在学计算机哪个方面的知识，充分地丰富自己是最重要的，也不用在乎学到什么程度，重要的是感受自己什么时候做的最开心，以此为基础再去学习其他的东西，相信就拥有了别人不可复制的东西。

• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 搜狐网站诚聘Java、PHP和C++工程师
• 快来参加7月17日在成都举行的SOA中国技术论坛
• Oracle专区上线，有Oracle最新文章，重要下载及知识库等精彩内容，欢迎访问。
• JavaEye问答大赛开始了！ 从6月23日 至 7月6日，奖品丰厚 ！

近一段时间以来，Apusic Studio功能特性全部完成，性能也逐步稳定，预计近期将会发布Release版本。随着开发工作的暂告一段落，Studio快速开发指南的文档撰写工作开始提上日程。计划今日开始文档的规划和撰写工作，预计一周至一周半左右完成。

文档的目的：旨在提供一份详实的文档使用户快速熟悉如何使用Apusic Studio进行J2EE（AOM）的开发工作。

初步的文档大纲为：

                                                         Apusic Studio 快速开发指南

1. Apusic标准工程介绍
    1.1. 概述
    1.2. 目录结构
    1.3. Apusic系统工程简介
    1.4. 操作
        1.4.1. 新建Apusic标准工程
        1.4.2. 新建模块
        1.4.3. 部署与调试
        1.4.4  新增,修改,删除服务器
        1.4.4. 导出Apusic工程
        1.4.5  导入Apusic工程

2. Web开发介绍
    3.1. 概述
        3.1.1. Web开发环境
        3.1.2. 新建Web模块
        3.1.3. 新建Facelets页面
    3.2. 可视化开发
        3.2.1. 标签栏
        3.2.2. Web页面编辑器
        3.2.3. 属性视图
        3.2.4. 大纲
    3.3.  基本组件
    3.4. 布局组件
        3.3.1
        .... <九个布局组件>     
        3.3.9
    3.5. LiteBean
        3.4.1. 概述
        3.4.2. 新建LiteBean
        3.4.3. LiteBean支持
    3.6 IoVC
        3.5.1 概述
        3.5.2 IoVC支持    

3. EJB开发介绍
    2.1. 概述
    2.2. EJB模块
        2.2.1. 新建EJB模块
        2.2.2. 如何引用外部jar包
    2.3. 新建会话Bean
    2.4  JPA建模
        2.4.1 新建JPA实体
        2.4.2 如何从数据库导入JPA实体
        2.4.3 生成Service实现
        2.4.4 生成数据库脚本
        2.4.5 生成测试案例
       
4. 其他功能
     4.1 Property Editor
     4.2 管理Apusic服务器
     4.3 监控Apusic服务器

5. Apusic Stuido实用技巧
     5.1 快捷部署应用
     5.2 快捷访问应用页面
     5.3 快捷定位文件系统
     5.4 页面与托管Bean切换
     5.6 定制WebEditor页签
     5.7 快速定位父标签

6. 示例
    6.1. 如何获取在线示例
    6.2. Hello Duke
        6.2.1. 前言
        6.2.2. Step By Step
7. 新特性

8. 法律声明

该大纲不会是最终版，在撰写中会根据实际情况进行相应调整。

• 快来参加7月17日在成都举行的SOA中国技术论坛
• JavaEye问答大赛开始了！ 从6月23日 至 7月6日，奖品丰厚 ！
• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师
• Oracle专区上线，有Oracle最新文章，重要下载及知识库等精彩内容，欢迎访问。

本文首发于operamaks

社区(www.operamasks.org)，原文地址为：http://www.operamasks.org/articles/studio_newfeature/html_single。

 

Apusic Studio 5.1M5 新特性一览 1. 说明 Apusic Studio 5.1M5发布以来,版本号已经更新至Patch2，功能也不断增强和完善。本文将会就M5版本中新添加或增强的特性进行详尽的介绍。 Apusic Studio 5.1M5版本中新添加或增强的主要特性有： Section 2.1, “快捷部署” Section 2.2, “增强的Web模块” Section 2.3, “增强的Web编辑器” Section 2.4, “IoVC支持” Section 2.5, “组件可视化增强” Section 2.6, “自定义复合组件” Section 2.7, “Properties Editor” Section 2.8, “生成JPA 业务实现” Section 2.9, “生成JPA 测试案例” Section 2.10, “快捷的文件定位” 2. 内容 2.1. 快捷部署 在Apusic Studio 5.1M5版本以前，常规部署应用的方式为：工程上右键-->部署到服务器-->部署(卸载/重新启动应用/停止应用/启动应用)，如下图: Figure 1. 常规部署应用 常规运行Web页面的方式为：页面上右键-->Run As-->在Apusic 应用服务器上运行。如下图所示： Figure 2. 常规运行页面 在M5版本中，新加入了快捷部署的功能。具体为： 快捷部署应用 在 Apusic Studio 快捷工具栏上新添加有快捷部署应用的按钮，如下图： Figure 3. 快捷部署按钮 快捷按钮分为默认选项和其余选项两栏，默认选项表示直接点击时执行的操作项（快捷键为Alt +F11）。 选中Apusic工程后，按钮即呈现有效状态。反之，如该按钮将呈现非有效状态。 按钮会根据历史记录，对其选项进行排序，将最近一次的历史操作加入默认选项中。例如我们选中ear1工程，通过快捷按钮进行“重新启动应用ear1"操作后，会发现”重新启动应用ear1”成为默认选项，此时直接点击快捷按钮，会执行“重新启动应用ear1”操作。 快捷访问/部署页面 实际开发过程中，常常遇到这样的场景：在Studio中进行页面编辑的同时，想看看该页面实际的访问效果如何？ 针对这种场景，M5版本新添加了页面部署快捷键Ctrl+F11，通过它能直接访问（或部署）当前焦点所处的页面（编辑器打开或者页面被选中）。如下图： Figure 4. 快捷访问按钮 在弹出对话框内选择在Apusic应用服务器上运行。 当页面所属应用已经部署时，该操作会执行打开系统浏览器访问该页面。反之，该操作会先执行应用部署，再执行页面访问。操作。 2.2. 增强的Web模块 M5版本中对web模块部分特性进行了增强和迁移，具体涉及有： 提供是否支持AOM选项 默认勾选，表示新建的Web模块支持AOM（支持JSF）。反之表示新建普通Web模块。 提供是否支持IoVC选项 默认勾选，表示该Web模块支持IoVC。反之，表示不支持。该特性将会影响到IoVC 特性支持 配置默认命名空间 定义生成Faces页面时默认绑定的LiteBean包名。 配置映射规则 定义页面所属文件夹和对应LiteBean命名前缀的映射规则，该规则将写入operamasks.xml文件中。 配置View类型 默认Facelets View，表示采用Facelets 作为jsf表现层展现，选择JSP View，表示采用JSP 作为JSF 表现层展现。 注：当采用Facelets View时，新建Faces页面应为.xhtml后缀，采用JSP View，新建Faces页面应为.jsp后缀。 2.3. 增强的Web编辑器 M5版本（Patch2）中为Web Page Editor（默认Faces页面编辑器）添加了诸多特性，其中包括： 提供页面源码（Source）页签（默认） 由于原有可视化设计器（Design页签）受可视化效果，代码设计实时同步等设计制约，导致其代码编辑效率不高。M5版本中添加了页面源码（Source）编辑页签，以提升编辑器的源码编辑性能。该源码编辑器提供了诸如代码辅助，语法高亮，代码格式化等功能。如下图： Figure 5. 页面源码页签 提供页面对应LiteBean编辑器页签（可选） 当“显示LiteBean页签 ”选项勾选时，会以页签的方式显示页面绑定的LiteBean（该LiteBean可以通过operamasks.xml中配置或采用<useBean>标签注入）。如下图： Figure 6. LiteBean页签 注：该LiteBean编辑器提供Java Source编辑器的基本功能。 Web编辑器偏好配置 用户如果需要对Web编辑器的默认显示页签内容等偏好进行配置，可以通过Window-->Preferences-->Apusic-->Web进行配置。如下图： Figure 7. Web编辑器偏好配置 默认提供3种偏好配置，分别为： Table 1. 可视化Web页面编辑器显示页签配置 显示Design页签 默认项，不可取消 显示Source页签 显示页面源码编辑页签 显示Preview页签 显示页面预览页签（Browser） 显示LiteBean页签 显示页面绑定LiteBean页签（当页面绑定多个LiteBean时，会出现多页签）   Table 2. 可视化Web页面编辑器默认显示配置 默认显示Source页签 打开编辑器时，Source页签为默认显示页签 默认显示Design页签 打开编辑器时，Design页签为默认显示页签   2.4. IoVC支持 M5版本中针对AOM2.0提供了原生的支持，其中一个显著的特性就是IoVC（IoVC用法指南可以参阅AOM2.0用户指南第6章节）支持。具体为： 组件与LiteBean绑定 在设计视图中可以通过双击组件，右键菜单等多种方式为用户自动进行组件的IoVC绑定。 Web模块支持IoVC ： 默认IoVC绑定 在设计视图中，双击组件（当组件没有指定ID时，会弹出ID输入框让用户输入) 会触发组件的IoVC默认绑定行为。弹出组件IoVC默认绑定向导。如下图： Figure 8. IoVC组件默认绑定向导 选择欲绑定的LiteBean，点击Finish后，即可在后台LiteBean中自动生成默认绑定代码。 指定IoVC绑定 在设计视图中，用户可以通过：组件上右键-->IoVC中选择欲绑定的IoVC类别，即会弹出绑定详细配置向导，在向导内指定欲绑定的组件属性即可。如下图： Figure 9. 选择IoVC绑定类别 Figure 10. 绑定详细配置向导 组件双击 在设计视图中，双击组件，执行默认IoVC绑定或者进入LiteBean绑定代码操作。 Web模块不支持IoVC ： 组件双击 在设计视图中，双击组件，当组件默认行为没有绑定后台ManagedBean时，弹出新建ManagedBean向导，如下图： Figure 11. 新建ManagedBean向导 用户可以指定已有的ManagedBean进行绑定，或者新建ManagedBean（新建后，会自动生成组件的默认行为绑定）。当组件的默认行为已经和后台ManagedBean绑定后，在设计视图中双击组件，能直接进入绑定代码。 页面与LiteBean绑定（web模块需支持IoVC） 新建Faces页面时，会默认生成根据命名规则定义 的LiteBean。如果不需要生成，可以在新建Faces页面向导第三页中取消生成托管Bean选项的勾选即可。 新建Faces页面时，如不采用默认命名规则生成LiteBean 。则Studio会默认将其该页面与LiteBean的映射写入operamasks.xml文件中。 2.5. 组件可视化增强 Apusic Studio 5.1M5版本中，可视化效果增强的组件列表如下： Table 3. 可视化效果增强组件列表--Widget类 组件名 内容 checkBox boxLabel属性可视化支持 checked属性可视化支持 fieldLabel属性可视化支持 Combo emptyText属性可视化支持 fieldLabel属性可视化支持 Menu 实现可视化效果，单击控制Menu展开和收缩，同时支持多级Menu的可视化，支持拖拽添加MenuItem numberField emptyText属性可视化支持 value属性可视化支持 fieldLabel属性可视化支持 textArea fieldLabel属性可视化支持 emptyText属性可视化支持 value属性可视化支持 textField inputType="password"属性可视化支持 fieldLabel属性可视化支持 timeField fieldLabel属性可视化支持 下拉列表内容填充（预览） toolBar 实现可视化效果。 simpleHtmlEditor enableColors属性可视化支持 enableFont属性可视化支持 enableLinks属性可视化支持 enableFontSize属性可视化支持 enableAlignments属性可视化支持 enableSourceEdit属性可视化支持 enableFormat属性可视化支持 Table 4. 可视化效果增强组件列表--Layout类 组件名 内容 absoluteLayout 子组件Panel绝对定位可视化支持 cardLayout 子组件Panel翻页可视化支持 tabLayout 子组件Panel翻页可视化支持 更多关于可视化效果的详细介绍，可以参阅Apusic Studio 快速开发指南。 2.6. 自定义复合组件 M5版本（patch2）中，添加了自定义复合组件功能。具体用法如下： 选中Apusic 工程，右键-->Import-->Apusic Studio-->Facelets复合组件，弹出导入Facelets复合组件向导。如下图： Figure 12. 导入Facelets复合组件向导 指定欲导入的taglib.xml（文件系统内或jar包内），指定自定义复合组件前缀。点击Finish，完成导入。 完成上述操作后，打开页面 Design设计器，即可在其工具栏中发现自定义的复合组件，同时可以采用拖拽的方式进行可视化设计。如下图： Figure 13. 工具栏 2.7. Properties Editor M5版本中，新添加了Properties Editor编辑器，便于用户进行国际化资源文件的编写，查看，修改等工作。在资源文件上双击即可打开Properties Editor，如下图： Figure 14. Properties Editor 更多详细的用法请参阅Apusic Stuido快速开发指南。 2.8. 生成JPA 业务实现 M5以前的版本，JPA 业务实现的生成方式是通过JPA模型设计器生成（生成JPA的时候自动生成对应的业务实现）。因为该方式灵活性较欠缺，不能满足复杂应用中按需定制的实际 需求，所以M5版本重构了JPA 业务实现的生成方式。改为手动指定、模板定制的方式。具体如下： JavaEE资源管理器视图中，在对应包名上右键-->实体模型-->生成业务实现。如下图： Figure 15. 生成业务实现 在弹出的生成业务实现向导第一页中选择Session Bean，（Spring Bean和WebService暂不支持）如下图： Figure 16. 新建业务实现向导 向导第二页选择欲生成业务实现的JPA实体。 向导第三页中配置业务实现的输出路径，实现方法等，同时可以通过点击“配置代码模板”进入业务方法模板配置界面，在其中进行业务实现 方法的定制。如下图： Figure 17. 业务实现详细配置 Figure 18. 配置代码模板 注：业务方法模板中支持${entity}通配符，在生成的业务实现代码中，会根据该通配符将对应的entity类名填充。 2.9. 生成JPA 测试案例 针对自定制的JPA业务实现，M5版本加入了生成JPA测试案例的新功能，以完成从建模到业务实现到测试案例的一体化工作。具体用法如下： JavaEE资源管理器视图中，ejbJar上右键-->生成测试案例，或对应包上右键-->实体模型-->生成测试案例，弹出测试案例向导。如下图： Figure 19. 新建JPA测试案例向导 向导第一页中指定相关内容（包名，测试类名等等），测试类（Class under test）为对应的JPA业务实现类。 在向导第二页中指定欲测试的方法名。如下图： 生成JPA测试案例后，将工程部署至Apusic服务器，即可通过类上右键-->Run As-->Junit test运行测试。 2.10. 快捷的文件定位 实际上文件系统定位功能是Apusic Studio 5.0版本以后就自带的功能，但一直没有进行介绍，本文中将其作为M5的新特性囊括其中，做出说明。 在实际开发中，我们经常需要定位文件系统，或进入终端，针对这种需求，Apusic Studio提供了快捷的文件系统定位和终端定位功能，具体用法如下： 选择欲定位的文件或则目录，右键-->Apusic Tools-->Open Terminal（Show in Explorer）。其中Open Terminal表示在终端内打开，Show in Explorer表示在文件系统内打开。如下图示： Figure 20. 快捷文件定位 根据不同的操作系统，用户可以定制相应的命令。方式为：首选项内（Windows-->Preferences）Apusic -->Tools项目中，可以定制Open Terminal 和Show in Explorer的命令内容。如下图示： Figure 21. 配置命令

• 搜狐网站诚聘Java、PHP和C++工程师
• JavaEye问答大赛开始了！ 从6月23日 至 7月6日，奖品丰厚 ！
• 快来参加7月17日在成都举行的SOA中国技术论坛
• Oracle专区上线，有Oracle最新文章，重要下载及知识库等精彩内容，欢迎访问。
• 北京: 千橡集团暨校内网诚聘软件研发工程师

• JavaEye问答大赛开始了！ 从6月23日 至 7月6日，奖品丰厚 ！
• 北京: 千橡集团暨校内网诚聘软件研发工程师
• 快来参加7月17日在成都举行的SOA中国技术论坛
• 搜狐网站诚聘Java、PHP和C++工程师
• Oracle专区上线，有Oracle最新文章，重要下载及知识库等精彩内容，欢迎访问。

• Oracle专区上线，有Oracle最新文章，重要下载及知识库等精彩内容，欢迎访问。
• JavaEye问答大赛开始了！ 从6月23日 至 7月6日，奖品丰厚 ！
• 快来参加7月17日在成都举行的SOA中国技术论坛
• 搜狐网站诚聘Java、PHP和C++工程师
• 北京: 千橡集团暨校内网诚聘软件研发工程师