1. 概述 DynaFuse类似Appfuse，是一套整合目前主流J2EE技术的新构架，使用到的技术有struts，springframework，hibernate，groovy等，提出了Evertything be Dynamic的理念，从DAO到WEB层提供了全新的动态建模，动态编程的方案。2. 运行例子
下载并安装mysql-4.0，建立数据库dynafuse，建立用户username/password为admin/admin。
下载并解压dynafuse-xx.zip，在mysql中执行data/create-tables.sql中的语句。
下载jakarta-tomcat-5.0.28，将dynafuse\lib\mysql-connector-java-3.0.14-production\mysql-connector-java-3.0.14-production-bin.jar和dynafuse\lib\jta-1.0\jta.jar拷贝到jakarta-tomcat-5.0.28\common\lib下，将dynafuse\dynafuse.xml拷贝到jakarta-tomcat-5.0.28\conf\Catalina\localhost下，
下载dynafuse.war拷贝到jakarta-tomcat-5.0.28\webapps下。
启动tomcat，打开浏览器http://localhost:8080/dynafuse进入例子程序。 3. 包结构说明
下载并解压dynafuse包，会得到如下的目录结构：
build:编译后文件
config:配置文件
data:试验数据
dist:打包后的发布文件
docs:文档
lib:使用到的jar文件
metadata:xdoclet需要的配置文件片断
script:groovy脚本
src:源码
test:测试源码
web:例子程序的jsp等文件
4. 构架说明 dynafuse最主要的特征是提倡Everything be Dynamic，从dao到service到web三个层面，每个层面都提供了对groovy新型server端srcipt语言的整合，使得web应用中基本所有的逻辑代码都能够以动态的形式编写，维护，构架分为三层： DAO层 - 这个层面中，dynafuse提供了两个interface:DAO 和 DynaDAO ，DAO是一个通用的数据访问(增、删、改、查)接口，DynaDAO在DAO的基础上提供了对DAO层面脚本的调用功能。这两个interface目前只提供了hibernate的实现。 DAO和DynaDAO分别作为springframewok中的bean在IOC容器中进行配置，详细请参考config\applicationContext-hibernate.xml。 Service层 - 这个层面中,dynafuse提供了两个interface:Manager 和 DynaManager，完成对DAO的封装并提供对service层面中业务逻辑脚本的调用功能，调用service层面脚本有两个方法，一是在事务环境中执行脚本（invokeScriptInTransaction），一个是不需要事务（invokeScript）。Manager和DynaManager分别作为springframewok中的bean在IOC容器中进行配置，详细请参考config\applicationContext-service.xml。 Web层 - 这个层面中，dynafuse提供了DynaAction，完成对web层面脚本的调用。
5. 构架使用
下面的文字将描述如何利用dynafuse进行web应用程序的开发。
1.构建hibernate的动态模型
hibernate在正式发布的3.0版本中，提供了动态模型，关于动态模型，可以查阅hibernate的相关资料，下面给出的是dynafuse示例程序的动态模型，文件参见dynafuse\model\Example.hbm.xml
<?xml version="1.0"?> <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> <hibernate-mapping default-lazy="false"> <class entity-name="Dept" table="t_dept"> <id name="id" column="dept_id" type="java.lang.Integer" unsaved-value="null" > <generator class="native"> </generator> </id> <property name="name" type="java.lang.String" update="true" insert="true" column="dept_name" not-null="true" unique="false" /> <property name="description" type="java.lang.String" update="true" insert="true" column="dept_description" not-null="false" unique="false" /> <bag name="persons" lazy="true" inverse="true" cascade="delete" > <key column="deptid" > </key> <one-to-many class="Person" /> </bag> </class> <class entity-name="Person" table="t_person"> <id name="id" column="person_id" type="java.lang.Integer" unsaved-value="null" > <generator class="native"> </generator> </id> <property name="name" type="java.lang.String" update="true" insert="true" column="person_name" not-null="true" unique="false" /> <property name="age" type="java.lang.Integer" update="true" insert="true" column="person_age" not-null="true" unique="false" /> <property name="description" type="java.lang.String" update="true" insert="true" column="person_description" not-null="false" unique="false" /> <many-to-one name="dept" class="Dept" cascade="none" update="true" insert="true" column="deptId" /> </class>
</hibernate-mapping>
这里没有静态的POJO持久类，所有的持久数据都通过Map结构来存放。
2.DAO层面的脚本，如果DAO接口中提供的方法不能满足需要，那么可以在DAO层面加入脚本，然后在service层通过DynaDAO完成对DAO脚本的调用，下面是示例程序中的dynafuse cript\PersonDAO.groovy
import org.hibernate.Session; import org.hibernate.Query; public class PersonDAO {
public Session session; public Object getAvgAgeOfDept(Integer deptId) { String hsql = "select avg(t.age) from Person t where t.dept.id=:deptId"; Query query = session.createQuery(hsql); query.setInteger("deptId", deptId.intValue()); return query.uniqueResult(); } }
这里需要说明的是session这个成员变量，它是必须要在DAO层面的脚本中申明的，在dao层面的脚本被执行的时候，dynafuse将会自动对这个session赋值，在脚本中，你不用关心session是怎么得到，你只管放心使用。
3.service层面的脚本，在实际的应用中，业务逻辑是千变万化的，所以service层面加入脚本支持是非常有用的，service层的脚本将在web层通过DynaManager被调用，下面是示例程序中的dynafuse cript\DeptManager.groovy
import org.robusta.dynafuse.dao.DynaDAO; import java.util.List; public class DeptManager {
public DynaDAO dynaDao; public List getDepts() { return dynaDao.getObjects("Dept", null, null, null); } public Object getAvgAgeOfDept(Integer deptId) { return dynaDao.invokeScript("PersonDAO.groovy", "getAvgAgeOfDept", new Object[]{deptId}); } }
这里需要说明的是dynaDao这个类成员变量，和dao层面脚本中的session一样，是在service层面的脚本中执行的时候，由dynafuse自动赋值，你只管放心使用它。
还需要注意的是，在service层面的脚本中可以利用dynaDao去调用DAO层面的脚本，如上面的getAvgAgeOfDept。
4.构建web层的动态模型，struts提供了DynaValidatorActionForm这种构造动态模型的机制，请参考示例中的dynafuse\metadata\web truts-forms.xml。
5.web层面的脚本，跟业务逻辑一样，页面逻辑也是千变万化的，所以web层的脚本非常有用，下面是示例程序中的dynafuse cript\DeptAction.groovy
public class DeptAction extends BaseAction {
....
public DynaManager dynaManager;
....
public ActionForward editDept(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) { if (log.isDebugEnabled()) { log.debug("Entering 'editDept' method"); } String deptId = request.getParameter("deptId"); if (deptId != null && !"".equals(deptId)) { Map data = dynaManager.getObject("Dept", new Integer(deptId)); Long avgAge = (Long) dynaManager.invokeScript("DeptManager.groovy", "getAvgAgeOfDept", new Object[]{new Integer(deptId)}); DynaValidatorActionForm deptForm = (DynaValidatorActionForm) form; deptForm.set("id", data.get("id")); deptForm.set("name", data.get("name")); deptForm.set("description", data.get("description")); deptForm.set("avgAge", avgAge); updateFormBean(mapping, request, deptForm); } return mapping.findForward("edit"); }
....
和servcie和dao层的脚本一样，web层脚本中有一个dynaManager成员变量。
6.将web层的脚本配置到action中，可以参考dynafuse\metadata\web truts-actions.xml
....
<action path="/depts" type="org.robusta.dynafuse.web.action.DynaAction" parameter="DeptAction.groovy/listDepts" unknown="false" validate="false" > <forward name="list" path="/WEB-INF/pages/deptList.jsp" redirect="false" /> </action>
....
需要注意的是这里的parameter，指定了web层某个脚本中的某个method。
