BlogJava-上善若水-文章分类-Code Engine

Code Engine使用手册V1.3

段氏 — Mon, 10 Sep 2007 06:47:00 GMT

Version 1.3

1. 基本组成：

a) 运行入口CodeEngineRunner的main（）；里面注册所有的Generator；主要有：IbatisGenerator，ControllerGenerator，JSPGenerator三个；任意一个可以单独运行多次；

b) 代码结构：*Generator,用于生成domain，manager和sqlmap，controller等文件，在生成之后为了保持系统的完整性，通常会调用一些Modifier去修改配置文件；由于每个Generator会单独再次访问配置文件，所以可以单独和重复生成；

c) 主要的配置文件有2个，位于code_engine目录下，分别为：code-engine-config.xml，code-engine-gears.xml，但在实际使用中，我们经常要配置的是code-engine-gears.xml，前者一般在项目开始的时候设定，后者用来生成和修改domain，manager和sqlmap, controller，jsp和相关的一些配置文件；

d) 模板文件位于template文件夹下面；可以任意添加和调用；语法为freemarker，但是，通常只需参照其他模板文件，一般都可以写出新模板；

e) 每次运行codeengine都会在backup目录下面生成备份文件，以备再次生成和修改；

f) 生成日志在logs目录下；

g) Framework目录是框架目录，可重用部分，在生成新项目时候拷贝用；

h) Reference目录是一些开发组件，主要是写js组件；

2. code-engine-config.xml 配置简介：

true

org.gjt.mm.mysql.Driver

jdbc:mysql://localhost:3306/wiczone

root

domain

web

manager

service

WEB-INF"applicationContext-manager.xml

WEB-INF"applicationContext-lucene.xml

WEB-INF"action-servlet.xml

WEB-INF"applicationContext-acegi.xml

WEB-INF"sql-map-config.xml

WEB-INF"classes"messages.properties

WEB-INF"defs

WEB-INF"jdbc.properties

1）如上所示，< database > 用于配置数据库的连接，注意要保证driver能访问到；

2）负责生成各种代码使用，

3）用于指定一些配置文件；

4）以上文件通常在项目开始的时候设定；

详解

a）

true

distDir@path指目标项目的路径，‘build’是相对路径； @java指java source code的根目录；

@web指web application的根目录；

templateDir@path指freemarker template所在的目录，这里设定的是$Code_Engin$"template; 此目录下放置用于生成controller和jsp的模板文件（以ftl为文件后缀）；

template /lib/下面放置的一个common.ftl为通用的functions，已经用auto imports引入，要调用common.ftl的function，通常类似：<@ce.dosth param=paramObj />, ce是namespace，用于限定引用；具体代码见（BaseGenerator.java）

5） i18nSupport是指定jsp是否支持多语言；一般设定为支持的；

domain

web

manager

service

用于设定java code的package；

WEB-INF"applicationContext-manager.xml

WEB-INF"jbcc-servlet.xml

WEB-INF"applicationContext-acegi.xml

WEB-INF"sql-map-config.xml

WEB-INF"classes"messages.properties

WEB-INF"defs

6）

3.code-engine-gears.xml配置详解：

extends="biz.web.framework.domain.BaseEntity" keyProperty="id"/>

CityMgr

extends="City" overwrite="true">

main_layout_4

1）等节点用于生成domain，manager，controller和jsp，可配置0-n个；次序随意; 且每个节点都有可选属性 overwrite （true、false）；

overwrite指定当目标controller文件存在时，是否要覆写该文件，否则就生成.generated为后缀的文件；overwrite属性是可选的，默认为true；

2）

extends="City" overwrite="true">

CityMgr

这个配置看上去有些复杂，是为了提供更好的灵活性；name用于在code engine中标识controller，同时用于生成的controller.java的命名；在配置文件中应该是唯一的；

springBeanDef用于指出是否在相关的配置文件中添加spring bean的定义，比如xxx-servlet.xml等；否则只是生成controller的java；

template指定freemarker模板；

managers指定要注入manager定义；如果有多个用逗号分割；可选；

services指定要注入service定义；如果有多个用逗号分割；@support用于指定framework下的common service，比如mail，compass等；可选；

defaultMethods里面用于指定生成的controller里面的方法；refModel 指参照的model定义， method@name用于指定方法名，比如list，而且list方法是预定义写在模板里面的; method@style指定代码风格，可选有form，ajax两种；这个风格会同时影响cotroller部分和jsp部分；

method@view指方法返回的tiles定义视图，当然这个属性在style是form的时候有效；可选；

e）

Description

main_layout_1

Jsp的name用于生成的jsp页面的文件名，同时还是tiles的定义，在生成controller时候也是有用的；

refController就是指明jsp所参照的controller定义；通过这个refController，jsp可以找到default_methods的style，refModel等信息；

Template指明所使用的freemarker模板；

这里省略了overwrite属性，overwrite属性是可选的，默认为true；

tinyMCE指定要加入tinyMCE支持，同时，所管理的属性为‘Description’；可选属性；

tiles属性定义了，此jsp所extend的layout，可选属性；

extends="biz.web.framework.domain.BaseEntity" keyProperty="id"/>

用于生成domain，manager，和sqlmap，可以配置多个；

luceneSupport可选，如为true代表将在domain和manager以及配置文件中加入lucene的支持；

4.创建新项目

A.从codeEngineRunner开始执行createNewProject（“distProject”）；（将copy必需的框架文件到目标目录，同时修改jdbc.properties等文件，同时将初始化abator-config.xml；）

B．分别用到了JDBCPropertiesModifier和CodeEngineInitModifier；

C．执行目标工程project目录下的initdb.bat;初始化数据库，加载初始系统表和数据；当然执行此步骤之前要先创建数据库；

D．利用codeEngineRunner的从数据库表，生成相应的文件后，使用project目录下build.bat编译文件；

段氏 2007-09-10 14:47 发表评论

Code Engine基本技术demo2

段氏 — Mon, 03 Sep 2007 09:12:00 GMT

关于如何生成字段的编辑页面；

1. 首先应该读取domain对象，从而获取field列表；

/**

* getDomainFields via jsp name, and should remove the super fields, like lastUpdatedBy, lastUpdatedDate

* @param name of jsp

* @return list of field

public static List getDomainFields(String name) {

List ret = new ArrayList();

try {

Class clz = Class.forName(CodeEngineConfig.getDomainPackage() + "." +

CodeEngineConfig.getControllerDomain(CodeEngineConfig.getJspRef(name)));

for (Field field : clz.getDeclaredFields()) {

if(!"lastUpdateDate".equalsIgnoreCase(field.getName())

&& !"lastUpdateBy".equalsIgnoreCase(field.getName())){

ret.add(field);

// System.out.println("field.getName() + field.getType() = " + (field.getName() + field.getType()));

}

} catch (Exception e) {

e.printStackTrace();

}

return ret;

}

2. 将Field List传递给freemarker模板；之所以要传递field而不仅仅是name的原因是，因为希望在模板里根据field的type，从而生成不同的html，比如date可以生成使用js calendar的，boolean生成radio，或checkbox，其他的生成text；

a) 定义macro；

<#macro getHtml field>

<#if field.type?ends_with('Boolean')>

<#elseif field.type?ends_with('Date')>

<#elseif field.type?ends_with('Text')>

${'$'}{${domain?uncap_first + '.' + field.name}}

<#else>

b）调用macro生成html；

<#list fields! as field>

<@getHtml field=field/>

段氏 2007-09-03 17:12 发表评论

Code Engine基本技术demo

段氏 — Fri, 31 Aug 2007 03:38:00 GMT

Code Engine 主要用来生成web相关的代码，可以把orm的部分集成进来，形成一条完整的生产线；

利用xpath，freemarker等技术，使得用户通过xml配置文件，模板等简单的方式，快速开发代码和根据需求调整模板；

Dom4j对实现了xpath 1.0，非常的好用；

所需jar ：dom4j-1.6.1.jar， jaxen-1.1-beta-7.jar

Code：

import junit.framework.TestCase;

import org.dom4j.*;

import org.dom4j.io.SAXReader;

import java.util.List;

import java.util.Iterator;

import java.io.File;

/**

* Created by IntelliJ IDEA.

* User: duanbin

* Date: 2007-8-15

* Time: 9:47:17

* To change this template use File | Settings | File Templates.

public class XPathTest extends TestCase {

public void testXPathViaDom4jXpathV1() {

printSelectedNodeValue("D:""xpath""src""test.xml");

}

/**

* 利用XPath操作XML文件，打印指定节点或者属性的值, using xpath 1.0

* @param filename String 待操作的XML文件（相对路径或者绝对路径）

public void printSelectedNodeValue(String filename) {

try {

SAXReader saxReader = new SAXReader();

Document document = saxReader.read(new File(filename));

List list;

list = document.selectNodes("//qn1:college/@leader[.!='leader1']");

for (Object aList : list) {

Attribute attribute = (Attribute) aList;

System.out.println("//qn1:college/@leader: " + attribute.getValue());

}

//打印所有student节点的属性age值，如果有的话

// list = document.selectNodes("/students/student/@age");

// for (Object aList : list) {

// Attribute attribute = (Attribute) aList;

// System.out.println("/students/student/@age：" + attribute.getValue());

// }

//打印所有college节点值，如果有的话

// list = document.selectNodes("/students/student");

// for (Object aList1 : list) {

// Element bookElement = (Element) aList1;

// Iterator iterator = bookElement.elementIterator("college");

// while (iterator.hasNext()) {

// Element titleElement = (Element) iterator.next();

// System.out.println("/students/student/college：" + titleElement.getText());

// }

//测试节点的一些方法

// list = document.selectNodes("//city");

// for (Object aList2 : list) {

// Element titleElement = (Element) aList2;

// System.out.print("//telephone：getName:" + titleElement.getName());

// System.out.print(" ##getNodeType:" + titleElement.getNodeType());

// System.out.print(" ##getTextTrim:" + titleElement.getTextTrim());

// System.out.print(" ##getNamespaceURI:" + titleElement.getNamespaceURI());

// System.out.print(" ##getNodeTypeName:" + titleElement.getNodeTypeName());

// System.out.print(" ##getQualifiedName:" + titleElement.getQualifiedName());

// System.out.print(" ##getUniquePath:" + titleElement.getUniquePath());

// System.out.println(" ##getPath:" + titleElement.getPath());

// }

//打印所有name节点值，如果有的话，与上面college的取法不一样

// list = document.selectNodes("/students/student/name");

// Iterator iter = list.iterator();

// for (Object aList3 : list) {

// Element titleElement = (Element) aList3;

// System.out.println("/students/student/name：" + titleElement.getText());

// }

} catch (Exception ex) {

ex.printStackTrace();

}

Test.xml:

崔卫兵

PC学院

62354666

男,1982年生,硕士，现就读于北京邮电大学

Beijing

cwb

学院领导">PC学院

62358888

男,1987年生,硕士，现就读于中国农业大学

xxxxx

xxx学院

66666666

注视中，注释中

yyyyyy

yyyy学院

88888888

注视中111，注释中222

Freemarker基本示例：

import freemarker.template.Configuration;

import freemarker.template.DefaultObjectWrapper;

import freemarker.template.Template;

import java.io.File;

import java.io.Writer;

import java.io.OutputStreamWriter;

import java.io.FileOutputStream;

import java.util.Map;

import java.util.HashMap;

import org.apache.log4j.Logger;

/**

* Created by IntelliJ IDEA.

* User: duanbin

* Date: 2007-8-21

* Time: 22:30:13

* To change this template use File | Settings | File Templates.

public abstract class BaseGenerator {

protected Configuration cfg;

protected final Logger logger = Logger.getLogger(this.getClass());

public BaseGenerator() {

try {

cfg = getConfiguration(CodeEngineConfig.getTemplateDir());

} catch (Exception e) {

e.printStackTrace();

}

public abstract void generate();

protected void generateFile(String template, Map root, String fileName){

try {

File dist = new File(fileName);

FileOutputStream fos = new FileOutputStream(dist);

Writer out = new OutputStreamWriter(fos);

// Writer out2 = new OutputStreamWriter(System.out);

cfg.getTemplate(template).process(root, out);

out.flush();

out.close();

logger.info("Generated File: " + fileName);

} catch (Exception e) {

e.printStackTrace();

}

protected Configuration getConfiguration(String tempDir) throws Exception {

Configuration cfg = new Configuration();

// Specify the data source where the template files come from.

// Here I set a file directory for it:

cfg.setDirectoryForTemplateLoading(

new File(tempDir));

// Specify how templates will see the data model. This is an advanced topic...

// but just use this:

cfg.setObjectWrapper(new DefaultObjectWrapper());

return cfg;

}

模板文件示例：

package ${package}.application.web;

import biz.web.framework.web.BaseController;

<#list managers! as mgr>

import ${package}.application.manager.${mgr};

<#list services! as svc>

import ${package}.application.service.${svc};

/**

* Created by IntelliJ IDEA.

* User: ${author!'admin'} "${r"${build.dir}"} "${'$'}{cfg.startDate}

* Date: Sep 1, 2006

* Time: 9:19:17 AM

* To change this template use File | Settings | File Templates.

public class ${name}Controller extends BaseController {

<#list managers! as mgr>

protected ${mgr} ${mgr?uncap_first};

<#list services! as svc>

protected ${svc} ${svc?uncap_first};

<#list managers! as mgr>

public void set${mgr}(${mgr} ${mgr?uncap_first}) {

this.${mgr?uncap_first} = ${mgr?uncap_first};

}

<#list services! as svc>

public void set${svc}(${svc} ${svc?uncap_first}) {

this.${svc?uncap_first} = ${svc?uncap_first};

}

public ModelAndView list${name}(HttpServletRequest request, HttpServletResponse response) throws Exception {

ModelAndView mav = new ModelAndView("update_${name?uncap_first}");

Long user = getUserId();

mav.addObject("userId", user);

return mav;

}

段氏 2007-08-31 11:38 发表评论

用 Selenium 测试 Ajax 项目

段氏 — Thu, 30 Aug 2007 15:06:00 GMT

Selenium
是一个由ThoughtWorks做的专门为web应用所做的非常有效的功能测试工具。Selenium
的 tests
直接在浏览器里跑，就像用户真的在操作一样。Selenium
可运行 Windows, Linux, 和 Macintosh 的各种浏览器，如
Internet Explorer, Mozilla 和 Firefox。
.......

访问链接：
http://forum.springside.org.cn/viewthread.php?tid=195&extra=page%3D1

段氏 2007-08-30 23:06 发表评论