EasyJWeb 上手指南.doc

1、EasyJWeb 入门手册简介EasyJWeb 是基于 java 技术，能实现企业级 Java Web 应用程序快速开发的 MVC 框架。框架设计构思来源于国内众多项目实践，框架的设计及实现借鉴当前主要流行的开源 Web框架（Rails、Struts、JSF、Tapestry） ，吸取其优点及精华，是一个完全由来自中国的开源爱好者开发、文档及注释全中文的开源框架。EasyJWeb 由四个部分组成：1、核心 MVC。EasyJWeb 的核心是一个基于模板技术实现的 MVC 框架；他能让你用非常简洁的代码写基于 Java 的 Web 应用。2、容器及通用业务逻辑封装。作为一个旨在让基于 Java

2、的 Web 应用程序开发变得直接、快速的框架，EasyJWeb 提供了一个超级 IoC 容器，并对一些企业级应用中通用的业务逻辑如分页、查询、DAO 等进行了封装，提供了一套可以直接操作、应用企业资源的组件及 API。3、代码生成引擎及工具。仅仅依靠一个灵活、简易的 MVC 核心引擎还不能最大、限度的提高开发速度，因此 EasyJWeb 提供了一个非常灵活、易用的代码生成引擎及工具，通过使用代码生成引擎，可以快速完成基于 JavaEE 平台的企业级应用程序生成。如数据库添删改查（CRUD ）代码生成、自动页面模版生成、配置文件管理等。4、EasyJWeb 插件体系，EasyJWeb 各种实用功

3、能的扩展，可以灵活地通过基于插件的形式安装到 EasyJWeb 中，提供各种针对性的功能。如 ajax 实用插件、代码生成插件等。EasyJWeb 的特点：1、快速开发支持EasyJWeb 是首要目标即实现基于 JavaEE 的 Web 应用程序快速开发。通过 EasyJWeb的核心 MVC、通用业务逻辑抽象、代码自动生成、插件体系等几个部分有机组合，能实现企业级的 Java Web 应用程序开发。2、零配置及约定配置通过配置可以让程序变得更加的灵活、易维护及扩展，配置的滥用会造成维护配置麻烦。因些，EasyJWeb 基于尽可能简化配置的原则，实现了零配置支持，同时为了保证系统的灵活性及可扩展

4、性，还提供了很多的约定配置支持。3、优雅的视图支持，页面及程序完全分离。EasyJWeb 提供了非常优雅的视图支持能力，不但实现了视图页面模板与程序逻辑的完全分离，克服了传统 jsp 页面难于维护的问题，而且还实现了对页面纯天然的支持能力，使得非常适用于企业级应用中的页面制作人员与程序的分工合作。4、超级 IoC 容器作为一个主要用于 Java 企业级应用程序开发的框架，EasyJWeb 实现了 IoC 容器，提供非常灵活的注入方式，并能支持 Spring、Guice 等异构容器实现。5、Ajax 支持EasyJWeb 内置了对远程 javascript 脚本调用功能，可以使用 javascr

5、ipt 直接访问服务端的业务组件。另外 EasyJWeb 通过使用 prototype.js 及其它一些来自开源社区 ajax 特效工具，提供了丰富的 Ajax 支持。环境需求安装配置 EasyJWeb获取 EasyJWeb SDKEasyJWeb 作为一个开源项目，我们首先来看看与其相关的资源：官方网站：http:/ 协同开发源码库 SVN：ttp:/ 源码 http 下载：http:/ 下载源码并解压;2、 在命令行执行 bineasyjweb crud d:myppp3、 切换到 d:myppbin 目录，执行 sample4、 通过 http:/localost:82/ejf/acco

6、unt/list 查看运行效果。快速入门与示例EasyJWeb 版的 Hello World！下面，我们以一个老掉牙的示例“Hello World!“来开始 EasyJWeb 的应用程序，我们这里把“Hello World!“改成“ 喂，您好， EasyJWeb1.0 发布了，请支持国产开源项目！“ ，另外还将显示一个系统当前的时间。第一步，建立项目：打开 eclipse，新建一个 tomcat 项目（我使用的 tomcat 插件，如果是其它插件，通常是建立一个 web 项目） ，这里我们将 context 名称设为“” ，字符集设置为 utf-8。项目目录结构如下：src 目录为源码目录，存

7、放源码文件，lib 目录为 jar 包目录，存放需要用到的 jar 包。接下来新建一个包 com.easyjweb.action，然后将 easyjweb-1.0.jar 以及EasyJWeb 的依赖包放到 lib 目录，并将它添加到 build path 中。第二步，配置 web.xml 文件：在 web-inf 目录下新建 web.xml 文件，输入一下内容：easyjfcom.easyjf.web.ActionServlet1easyjf*.ejfeasyjf/ejf/*CharsetFiltercom.easyjf.web.CharsetFilterencodingUTF-8ignor

8、etrueCharsetFilter/*第三步，写 EasyJWeb Action HelloAction.java：在包 com.easyjweb.action 下建一个名为 HelloAction.java 的文件。内容如下：package com.easyjweb.action;import java.util.Date;import com.easyjf.web.IWebAction;import com.easyjf.web.Module;import com.easyjf.web.Page;import com.easyjf.web.WebForm;public class Hel

9、loAction implements IWebAction public Page execute(WebForm form, Module module) throws Exception form.addResult(“msg“,“喂，您好，EasyJWeb1.0 发布了，请支持国产开源项目！“ );/设置VO对象msg的值。form.addResult(“time“,new Date();/设置VO 对象time 的值为当前时间return new Page(“hello“, “/hello.html“);第三步，建立 EasyJWeb 显示页面模板文件在/web-inf 目录下新建目

10、录 views，并在这个目录下新建一个名为 hello.html 的文件，注意保存的时候请选择 utf-8 编码，helllo.html 文件的全部内容如下：我的第一个EasyJWeb程序界面$!msg当前时间:$!time 至此，项目建立完毕，项目结构如下图：最后一步：启动 Tomcat 并运行 Hello EasyJWeb 应用程序启动 Tomcat，然后在地址栏中输入 http:/localhost:8080/hello.ejf 即可看到如下图所示的运行结果：我们来简单介绍一下这个简单的 EasyJWeb 应用。在上面这个应用中，我们可以看到，EasyJWeb 应用主要包括两个部分：用

11、Java 实现的 Action 以及业务逻辑和一个 Html 模板（这里并不是使用的单纯的 Html，还有 Velocity 脚本） 。这里我们简单介绍一下 Action 部分，Velocity 部分请参考EasyJWeb-Velocity 脚本简明教程 ，你可以通过这个地址下载该教程：http:/ 。在这个 Action 实现 IWebAction 接口，IWebAction 接口只有一个方法 execute。这个方法有两个参数：WebForm 和 Module，返回一个 Page 对象。WebForm 负责封装用于用户端显示的数据，程序对 WebForm 进行处理，并根据 Module 封

12、装的该模块的配置信息返回一个 Page 对象（本例中使用的是手动创建一个 Page 对象，也可以通过使用module.findPage(“)方法来获取一个配置好的 Page 对象） ，告诉框架返回哪个页面。在程序中用到了 WebForm 的 addResult 方法，这个方法主要是用来添加要在客户端显示的数据。以这个程序为例，在执行了 form.addResult(“time“,new Date();这一句之后，就可以在模板中使用$!time 来调用这个 Date 对象。一个简单的例子，相信大家对 EasyJWeb 有了大概了解。好的，我们再稍微深入一点，将这个例子改造一下，实现稍微复杂一些的

13、功能。我们在客户端增加一个文本框，输入用户名，提交到后台处理。我们先看看模板页：我的第一个EasyJWeb程序界面$!msg当前时间:$!time 现在我们看看修改后的 Action：public class HelloAction implements IWebAction public Page execute(WebForm form, Module module) throws Exception String userName = (String)form.get(“userName“);if(userName!=nullelseform.addResult(“msg“, “喂，您好

14、，EasyJWeb1.0 发布了，请支持国产开源项目！“);form.addResult(“time“, new Date();return new Page(“hello“, “/hello.html“);这里多了一句“String userName = (String)form.get(“userName“);”，这里的 form.get(“userName“)用来获取客户端表单域里的 userName 文本框的值。现在我们来运行一下这个例子。在客户端输入http:/localhost:8080/hello.ejf，界面如下：我们输入“friend”，然后提交，会出现下面的界面：到这里，相

15、信大家应该了解了在 EasyJWeb 应用中如何获取客户端数据和向客户端传递数据。接下来我们再深入一点，将这个例子改为用户登录并显示用户的用户名和密码的例子，进一步的了解在 EasyJWeb 中是如何将对象数据传递给客户端并显示出来的。在这个例子中我们首先创建一个 domainUser.java，代码如下：public class User private String name;private String password;public String getName() return “tianyi“;public void setName(String name) this.name =

16、 name;public String getPassword() return “123“;public void setPassword(String password) this.password = password;然后我们看看修改后的 Action，代码如下：public class HelloAction implements IWebAction public Page execute(WebForm form, Module module) throws Exception String userName = (String)form.get(“userName“);Stri

17、ng password = (String)form.get(“passsword“);User user = new User();if(userName!=nullform.addResult(“msg“, “登录成功！“);elseform.addResult(“msg“, “登录失败！“);form.addResult(“time“, new Date();return new Page(“hello“, “/hello.html“);这里有一条语句 form.addPo(user)，这天语句用来将对象 user 的每一个属性值都传递到客户端。执行了这条语句之后在模板中可以直接使用$!

18、name 来显示 user 的name 属性值。这里还可以这样写 form.addResult(“user“, user)，然后在模板中这样调用：$!user.name， $!user.password。具体的 Velocity 用法请参考EasyJF 官方网站上的教程。最后我们修改一下模板文件，代码如下：我的第一个EasyJWeb程序界面您的用户名为：$!name您的密码为 :$!password$!msg当前时间:$!time 在浏览器中输入 http:/localhost:8080/hello.ejf 访问，界面如下：在输入框中分别输入 tianyi 和 123，提交，返回界面如下：到这里相信大家对 EasyJWeb 的基本使用方法已经了解了，下面我们将介绍 EasyJWeb Tools 的用法。EasyJWeb CrudEasyJWeb Tools前面我们创建了一个最简单的应用 Hello World，现在我们来创建一个完整的EasyJWeb 应用。在这里我们将要用到 EasyJWeb Tools 这个包。EasyJWeb Tools 是EasyJWeb 的一个重要部分。通常在 Action 层我们需要对客户端提交的数据做判断，进行流程控制，因此会有大量的 if else 语句。通过 EasyJWeb Tools 的业务引擎基本模型，只要