使用 AppFuse 快速构建 J2EE 应用

图 11. 修改后的 myapp 用户管理页面
 

其他功能

    一个系统除了包含核心逻辑之外，还有其他一些辅助功能，它们也是非常重要的。下面，让我们来看看如何在 AppFuse 中开发这些功能。

语言国际化

    如果你的系统不仅仅支持一种语言，那么就需要考虑这个问题。在 AppFuse 中，Resource Bundle 文件是位于 web\WEB-INF\classes 目录下的以 ApplicationResources 开头的 properties 文件。Tapestry 有自己的国际化文本机制。但是在 AppFuse 中，并不全是 Tapestry 页面，仍有些地方使用 jsp，而这些页面使用 JSTL 的 fmt 标签显示国际化文本。不过，AppFuse 已经将这二者的“源头”进行了整合，因此，对用户而言，只需要在 ApplicationResources*.properties 中定义需要国际化的文本。

     但是，在 Eclipse 中可以看到，AppFuse 的 properties 文件默认的编码不是 UTF-8，而是 ISO-8859-1，这样会导致最后通过 native2ascii 转换后的文件都是 “???”，所以用户需要自己把这些文件转成 UTF-8。转换的方法很简单：在 properties 文件上点右键，在右键菜单上选择 Properties，打开属性窗口后，更改 “Text file encoding” 为 UTF-8。在修改编码前，最好先把已有的文字拷贝出来，转换好之后再粘贴回去，否则会导致原先翻译好的文字变成乱码。

图 12. ApplicationResources_zh_CN.properties 的属性窗口
 

    AppFuse 在发布项目的时候，会自动用 native2ascii 转换这些资源文件。如果你想使用其他资源文件名，可以修改 web\WEB-INF\web.xml 中的 “javax.servlet.jsp.jstl.fmt.localizationContext” 的参数值。

页面布局和样式

    使用 AppFuse，能够很方便的修改系统的整体布局和样式，因为 AppFuse 使用了一种强大的 “CSS框架”。项目创建好之后，在 web\styles 目录下，有三个目录：andreas01，puzzlewithstyle 和 simplicity。这些是 AppFuse 自带的三种主题，目录名即 CSS 框架的主题名。属于“管理员”角色的用户可以在登录后通过在 url 后面添加形如 "?theme=andreas01" 的参数更改系统使用的主题。如下图：

图 13. 应用了 “puzzlewithstyle” 的 myapp
 

    系统默认使用的主题由 web\WEB-INF\web.xml 中的 “theme” 参数指定，AppFuse 默认使用的主题是 “simplicity”。更改或创建新的主题也很简单，只要在 web\styles 目录下，新建一个自己的目录，并参照已有主题的编写规范定义自己的主题。本文中，拷贝了 simplicity 目录，更名为 “mytheme”，然后将里面的字体颜色从“蓝色”基调改成了“绿色”基调，并修改 web.xml 中的 theme 参数值为 “mytheme”，这样 myapp 默认使用的就是 mytheme 的主题了，如图 8所示。你也可以从 http://css.appfuse.org/themes/ 得到更多关于 “CSS框架” 的信息。
系统安全

    AppFuse 使用 Acegi 进行安全管理。Acegi 的配置信息位于 web\WEB-INF\classes\security.xml。事实上，Acegi 是被集成到 Spring 当中的，因此这个文件是 Spring 的配置文件格式。在 web\WEB-INF\web.xml 中，该文件被指定在应用启动前会被加载：

清单 5. web.xml 关于 Spring 配置文件的定义
    ...
<!-- Context Configuration locations for Spring XML files -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext-*.xml,/WEB-INF/security.xml</param-value>
    </context-param>
                  ...
 

本文关于系统安全的实现如下：

在数据库中增加新的角色“hr”：编辑 myapp\metadata\sample-data.xml 文件，增加如下黑体的部分：

清单 6. sample-data.xml 中角色 “hr” 的记录
      ...
<table name='role'>
    <column>id</column>
    <column>name</column>
    <column>description</column>
    <row>
      <value>1</value>
      <value>admin</value>
      <value><![CDATA[Administrator role (can edit Users)]]></value>
    </row>
    <row>
      <value>2</value>
      <value>user</value>
      <value><![CDATA[Default role for all Users]]></value>
    </row>
    <row>
      <value>3</value>
      <value>hr</value>
      <value><![CDATA[Role for employee mangement]]></value>
    </row> 
</table>
                  ...
 

AppFuse 使用 dbunit 加载样本数据到数据库中，sample-data.xml 为 dbunit 提供样本数据定义。修改完 sample-data.xml，在 c:\opt\myapp\ 下运行 “ant db-load”，样本数据被重新加载。这样，我们就在数据库中定义了一个新的角色记录 “hr”。
定义角色名称的中文显示文本：在 myapp/sr/web/webapp/action/UserForm.java 的方法 pageBeginRender 中找到如下代码： // initialize drop-downs
if (getAvailableRoles() == null) {
List roles =   (List) getServletContext().getAttribute(Constants.AVAILABLE_ROLES);
    setAvailableRoles(new RoleModel(roles));
                  }
 讨论 http://bbs.pc51.net