创建框架-XWorker

创建框架的方法也是如何定义和实现框架的方法，下面是在XWorker中定义框架的基本方法和步骤。

下面以一个数据库简单查询操作为例，该框架可以根据框架配置生成一个select的sql语句。

创建框架是在事物管理里实现的，如果对事物管理器不了解，那么可以先看下事物管理器的文档。

1.定义框架配置的结构

在XWorker中框架编程是以框架配置为主的，第一步是要先定义框架配置。XWorker的框架配置最初是以XML为基础的，因此定义框架配置的过程也就是定义框架配置文件XML的过程，实际上就是定义框架配置的结构。

下面是在XWorker中用事物管理器定义框架的结构的过程。

1.1创建事物SqlSelector

首先在项目导航中选择一个合适的目录，在目录浏览中选择新建事物按钮，也可以在项目导航的目录上鼠标右键弹出菜单中选择新建事物。

在新建事物的窗口中输入框架事物名SQLSelector，选择框架事物的描述者为MetaDescriptor3，MetaDescriptor3是用于创建新框架的事物。

输入完毕后点击确定按钮创建SQLSelector框架配置的定义，并在编辑器中打开编辑它。

1.2定义框架配置的属性

一个框架配置通常有许多属性，可以在编辑器中通过属性事物来实现框架配置的属性定义。

在编辑界面中点击添加子节点按钮。

在添加子节点界面中选择属性子事物，输入属性的名称并点击添加按钮。

依次添加name、label、tableName和description等属性，其中tableName是生成查询SQL所需的表名，label和description则是编辑框架配置时的界面辅助属性。

1.3定义框架的子事物

框架的子事物和框架的属性一样也是配置信息，只是像SQLSelector中字段的配置个数是不固定的，且字段本身还可能有属于自己的配置属性，因此需要通过定义子事物来实现，此时子事物相当于XML的子节点。

第一步还是在编辑界面中选择添加子节点，在添加子节点界面中选择事物，并输入字段事物的名称。

添加了Filed子事物后，选中Field节点添加Field的属性，这里添加name、label、column和description等属性，过程略。

1.4定义框架配置结构总结

以上就是定义框架配置结构的基本方法，主要是定义框架配置的属性和子事物。

2.定义框架配置的解释代码

框架编程不仅需要定义框架配置，而且还要能够解释执行，在XWorker是通过配置框架结构的动作行为来实现的。

2.1添加actions（动作）子事物

在XWorker中一个事物（框架配置）的动作是通过添加actions子节点实现的。

在添加子节点的界面中选择动作，并点击添加按钮，其中name（属性）可以不用输入。

2.2在actions（动作）下添加解释框架的代码

在新建的actions（动作）节点下点击添加子节点按钮，可以看到有多种方法和多种语言来编写框架的解释代码，在这里我们使用GroovyAction来编写。

2.3编写框架的解释动作toSql的代码

toSql的代码实际上是框架引擎的解释代码，是传统框架编程的核心，这里是嵌入到框架配置中的，可以用多种方式实现，在这里使用Groovy脚本实现，代码如下。

def sql = "select ";

//self变量是框架配置，可以获取框架配置的属性和子事物
//self.getChilds("Field")是返回Field子节点的列表
int index = 0;
for(field in self.getChilds("Field")){
    if(index != 0){
        sql = sql + ", ";
    }
    //添加字段的column
    sql = sql + field.getString("column");
    index++;
}

//添加表名
sql = sql + " from " + self.getString("tableName");

//返回生成的SQL
return sql;

3.框架定义总结

到此生成查询SQL的框架就定义完了，步骤是定义框架配置的结构以及实现框架配置解释动作。

框架定义好后就可以立即使用了，请参看使用框架。