easyjweb入门手册

《easyjweb入门手册》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

·EasyJWeb入门手册作者：本站会员　来源：easyjf　发布时间：2007-10-1216:04:00· 一、简介EasyJWeb是基于java技术，应用于WEB应用程序快速开发的MVC框架，框架设计构思来源于国内众多项目实践，充分借签了当前主流的开源Web框架（Struts、JSF、Tapestry、Webwork），吸取了其优点及精华，利用Velocity作为模板页面引擎，是一个实现了页面及代码完全分离的MVC开发框架，是一个旨在为中小型Web应用系统提供快速开发实践的简易Web框架。（为了能让用户快速地掌握并使用EasyJweb框架，在开发EasyJWeb的同时开发了EasyJWebTools。）通过EasyJWebTools提供的配套开发工具，可以实现基于EasyJWeb框架的Web应用项目快速开发，包括常用应用软件的代码自动生成、数据库添删改查（CRUD）代码生成、自动页面模版生成、配置文件管理等。框架特点：1、零配置文件支持。以前我们每接触一个框架，开始总是被他的配置文件折腾一番。EasyJWeb实现零配置支持，可以不写一句配置文件就在框架基础上构建你的应用。（适合小型网站系统）。2、简易的模板页面设计支持。放弃使用jsp，使用简单Velocity脚本语言作为页面模板。3、页面程序完全分离。实现显示页面与程序逻辑的完全分离，克服了传统jsp页面难于维护的问题。4、基于页面组件的框架。灵活的页面组件配置，可以直接通过配置文件设置字段及表属性的事件等。5、快速开发支持。通过EasyJWebTools，可以自动生成应用软件模板代码，定制并管理自己的J2EE代码模板，代码生成模板扩展支持最流行的实用Java开发框架（如hibernate、Spring等），实现快速开发。  EasyJWeb的MVC框架简单流程图二、环境需求三、安装配置EasyJWeb获取EasyJWebSDKEasyJWeb是一个开源项目，你可以从EasyJF官方网站下载。下载地址：http://www.easyjf.com/easyjweb/download.htm。其中，EasyJWebX_src.zip为源代码，EasyJWebX_lib.zip为编译后的jar包及运行EasyJWeb所需要的基本包。安装EasyJWeb只是一个Web应用程序MVC框架，其主要作为一般应用程序的基础框架，是以一个jar文件的形式伴随在用户的JavaWeb程序中执行，不需要进行专门的安装操作。只需要把easyjweb.jar文件及附属文件(lib中的所有jar文件)拷到javaweb应用程序类路径中即可。我们一般是放到Web应用程序目录的Web-inflib目录下，也可以拷到TomcatCommonlib目录下，这样使得所有TomcatWeb应用程序都可以使用EasyJWeb。我们推荐放到web-inflib目录下，这样可以使得你不用理会具体的Web应用服务器．当开发EasyJWeb应用的时候，只要把EasyJWeb.jar包导入到工程中即可执行应用程序的调试及测试等工作。配置web.xml文件EasyJWeb是一个Web应用程序的核心骨架，为了能在浏览器中访问EasyJWeb应用程序，需要配置应用程序中的web.xml文件，使得用户的Web应用程序知道何时使用EasyJWeb应用程序处理用户请求。 只有通过配置Web应用程序中的web.xml文件，才能使得EasyJWeb能正常的使用。EasyJWeb应用程序默认以.ejf为扩展名，在用户地址栏中输入与.ejf结尾URL路径的时候，为了使得EasyJWeb能处理用户的请求，需要在web.xml文件中加如下的配置信息：easyjfservlet-name>com.easyjf.web.ActionServletservlet-class>1load-on-startup>servlet>easyjfservlet-name>*.ejfurl-pattern>servlet-mapping>由于Java是外国人发明的，其以unicode为默认编码，并且很多JavaWeb应用服务器也是泊来之品。因此我们在进行JavaWeb应用开发的时候经常会遇到中文字符处理的问题。比如显示在页码上的中文信息成乱码、或者保存到数据库的变成乱码等。因此，为了让JavaWeb应用能更好的处理中文，EasyJWeb默认情况下使用utf-8作为标准编码。这样需要通过在web.xml文件加入下面的设置，使得转码程序能正确运行，显示正确的文字字符。CharsetFilterfilter-name>com.easyjf.web.CharsetFilterfilter-class>encodingparam-name>UTF-8param-value>init-param> ignoreparam-name>trueparam-value>init-param>filter>CharsetFilterfilter-name>/*url-pattern>filter-mapping>这样，一个基于EasyJWeb的JavaWeb应用程序的web.xml文件全部内容如下：xmlversion="1.0"encoding="UTF-8"?>easyjfservlet-name>com.easyjf.web.ActionServletservlet-class>1load-on-startup>servlet>easyjfservlet-name>*.ejfurl-pattern>servlet-mapping>easyjfservlet-name> /ejf/*url-pattern>servlet-mapping>CharsetFilterfilter-name>com.easyjf.web.CharsetFilterfilter-class>encodingparam-name>UTF-8param-value>init-param>ignoreparam-name>trueparam-value>init-param>filter>CharsetFilterfilter-name>/*url-pattern>filter-mapping>web-app>若web.xml文件配置成功，并把EasyJWeb.jar文件及相关jar文件拷到了web-inflib目录下，启动Web用户服务器。在地址栏中随便输入http://localhost:8080/hello.ejf类似以.ejf为扩展名的地址。则会得到一个如下的EasyJWeb错误反馈提示信息:友情提示!frameworkException:没有找到处理模板的类:com.easyjweb.action.HelloAction详细请查询http://www.easyjf.com 如下图所示：虽然提示框架错误，但既然有了EasyJWeb字眼，这即表示您的EasyJWeb应用程序已经配置成功，下一步就是开始激动人心的EasyJWeb应用开发了。若没能正确的配置Web.xml，当用户在地址栏中输入EasyJWeb应用程序扩展名的*.ejf时候，将会产生404的错误提示。如下图所示：四、快速入门与示例4.1、EasyJWeb版的HelloWorld！ 下面，我们以一个老掉牙的示例"HelloWorld!"来开始EasyJWeb的应用程序，我们这里把"HelloWorld!"改成"喂，您好，EasyJWeb1.0发布了，请支持国产开源项目！"，另外还将显示一个系统当前的时间。第一步，建立java代码程序目录：在您的源代码目录下，建一个如下的目录comeasyjwebaction。第二步，写EasyJWebActionhelloAction.java：在comeasyjwebaction目录下建一个名为helloAction.java的文件。内容如下：packagecom.easyjweb.action;importjava.util.Date;importcom.easyjf.web.IWebAction;importcom.easyjf.web.Module;importcom.easyjf.web.Page;importcom.easyjf.web.WebForm;publicclassHelloActionimplementsIWebAction{publicPageexecute(WebFormform,Modulemodule)throwsException{form.addResult("msg","喂，您好，EasyJWeb1.0发布了，请支持国产开源项目！");//设置VO对象msg的值。form.addResult("time",newDate());//设置VO对象time的值为当前时间returnnewPage("hello","/hello.html");}}写完后通过使用命令行的javac或者编译工具编译helloAction.java。若对java的编译不熟悉，请先跳到后面的《EasyJWeb 应用开发指南》章有关工具使用的介绍，或者直接执行EasyJWeb的示例程序中的helloAction.class拷到您的web-infclassescomeasyjwebaction目录下即可。第三步，建立EasyJWeb显示页面模板文件用记事本在/web-inf/easyjweb/建一个名为hello.html的文件，注意保存的时候请选择utf-8编码,helllo.html文件的全部内容如下：