appfuse快速开发应用程序指导手册

本文提供如果利用appfuse快速建立一个简单应用程序的简明操作手册。

      [1]建立一个新的应用程序

      [2]利用appgen建立简单的CURD程序

建立一个应用程序[#1]

1.      选择需要的WebFramework
如果使用struts，这一步可省略
切换到新建的应用目录，跟appfuse同一级别运行。
ant install-webwork

2.       建立自己的应用
运行ant任务创建新的应用。
ant new –Dapp.name=myApp –Ddb.name=myDb

      3.      修改 user.java 中E-mail的doc @hibernate.column 部分，增加 长度限制 length=“166”
        原因参考appfuse实践一

4.      启动 mysql (字符集采用urf8)

5.      安装发布应用，建立数据库
运行 ant setup

6.      打开浏览器测试
打开浏览器输入[http://127.0.0.1:8080/myApp进行测试，即可正常登陆使用。

利用appgen添加简单的CURD功能[#2]

1.      备份
最好结合版本控制工具增加ant任务自动备份，为了能够在利用appgen产生代码后恢复程序。

2.      创建POJO
在src/dao/org/appfuse/model目录下创建新的实体对象，需要继承BaseObject对象。

3.      添加需要的属性
在对象中添加属性，利用eclipse生成对应的get/set方法。并添加合适的hibernate标签。

4.      实现BaseObject接口方法
利用commoneclipse添加tostring(),hashcode(),compareto()方法。

5.      修改Hibernate配置文件中
修改applicationContext-hibernate.xml文件加入新的POJO对象的hibernate配置文件。

6.      使用appgen生成这个新的POJO的CURD程序
切换到extra/appgen目录下运行
ant install-detailed -Dmodel.name=<model.name> -Dmodel.name.lowercase=<model.lowercaseName> 这样可以自动生成CURD部分的源代码并且自动发布到相应的源程序目录中去。 注意：model.lowercaseName只有小写只需要第一个字符，其他跟model.name相同

7.      增加中文描述是界面能正确显示中文信息
切换到应用程序目录app下，修改ApplicationResources_zh_CN.properties文件增加对应的中文描述。

8.      发布新的程序
运行ant undeploy卸载原来的应用；
运行 ant setup-db创建表填充测试数据；
运行 ant deploy发布新的应用。

9.      打开浏览器测试
打开浏览器输入http://127.0.0.1:8080/myApp进行测试，登陆后可以看到新的菜单项，可以进行测试各个功能是否正常。

10.  如不成功,恢复到前面备份的版本，重复上述步骤