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\script\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\script\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\struts-forms.xml。
5.web层面的脚本，跟业务逻辑一样，页面逻辑也是千变万化的，所以web层的脚本非常有用，下面是示例程序中的dynafuse\script\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\struts-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。
