EasyJWeb-1.0 m3发布

Posted 2021-05-15 大峡

我们非常荣幸的宣布，经过EasyJF团队成员几个月的努力和付出，EasyJWeb-1.0 m3今日正式对外发布，该版本作了非常多的调整和功能的改善，以求对开发人员带来更多帮助和和方便。

EasyJWeb-1.0 m3版本新增功能

1．  框架核心日志及提示信息支持国际化。

2．  提供了三个简单但能反映Java Web开发的完整入门示例。

3．  提供多种模板引擎支持，率先支持了由国人开发的模板引擎 CommonTemplate。

 

EasyJWeb-1.0 m3所做的改进

1．  改进了项目的发布目录结构

2．  开源版权许可改为了Apache License2.0

3．  规范了EasyJWeb Tools的使用，可以快速生成EJS的应用，并对生成模板进行了调整

4．  修正了这两个月来大家提出的Bug及调整了一些功能，详情见jira.easyjf.com

5．  完善了入门文档，详情见wiki.easyjf.com

 

EasyJWeb-1.0 m3的获取

easyjweb-1.0-m3.zip(22.9M)

easyjweb-1.0-m3-without-dependencies.zip(无依赖包，6.35M)

三个示例程序下载(FTP 22.5M)

或者进入EasyJF官网的下载频道下载

一、EasyJWeb 项目目录结构

 

lib－发布目录，EasyJWeb应用所用到的相关jar库文件。

samples－应用示例目录，收录了一些比较经典的EasyJWeb示例，通过这些示例你可以快速了解EasyJWeb的应用。

docs－文档目录，包括EasyJWeb新手入门、开发指南及api文档等。

bin－实用工具目录，该目录存放的是一些批处理命令文件，是EasyJWeb Tools的一部分，可以通过执行这些命令文件快速生成Web应用骨架等。

src－EasyJWeb框的源代码，源代码目录下分成了core、ext、generator三个子项目，每一个子项目都是单独的maven工程项目。

pom.xml－EasyJWeb项目的maven配置文件，如果你机器安装了maven，则可以使用maven来管理EasyJWeb项目。

license.txt－EasyJWeb的版权许可声明。

这里重点看看lib目录，该目录是EasyJWeb的jar及相关jar文件。目录结构如下所示：

easyjweb-core-1.0-m3.jar　这是EasyJWeb框架的主要核心程序，一般应用中我们只需要该文件就能使用EasyJWeb。

easyjweb-ext-1.0-m3.jar　这是EasyJWeb框架的扩展程序，提供了非常实用工具类，通用业务逻辑封装，基于Spring2及JPA的泛型DAO实现及支持，另外还包括了对spring容器、guice容器的集成，commontemplate及freemaker等模板引擎集成等。要使用EasyJWeb快速开发基于EJS(EasyJWeb+JPA+Spring)构架的Java EE应用程序，需要使用到该包。

easyjweb-generator-1.0-m3.jar 这是EasyJWeb的代码生成引擎，包括代码生成模板，实用模板等，主要用于在开发过程中实现快速开发。

required－目录中存放的是运行EasyJWeb程序的最小依赖包。包括下面几个文件：

commons-fileupload-1.2.jar用于处理文件上传；

commons-logging-1.0.4.jar用于通用日志处理；

dom4j-1.6.1.jar用于解析xml配置文件信息；

easydbo-0.9.1.jar简单的ORM映射及Bean处理；

jaxen-1.1-beta-12.jar dom4j的依赖包，支持xpath查询xml文件内容；

log4j-1.2.14.jar　EasyJWeb中的主要日志文件；

velocity-dep-1.4.jar　EasyJWeb的首选模板引擎；

 

spring－该目录存放Spring的相关jar文件；

jpa－该目录存放jpa及实现及其它相关jar包；

other－其它模板引擎、实用工具的相关jar包。

 

二、开源版权许可改为了Apache License2.0

详见项目中的license.txt及各个代码中包含的版权声明。

 

三、框架核心日志及提示信息支持国际化。

通过使用I18n工具类，把代码中的提示信息改为了支持多国语言提示。对于服务器端的日志及提示信息，改为与服务器本的语言；对于抛出给客户端的异常等信息，改为了根据访问者的国家或地区来选择使用提示语言。当前支持中文提示及英文提示（英文提示信息有待进一步完善），可以通过修改message.properties、message_zh_CN.properties文件的信息来调整提示信息。

 

四、EasyJWeb Tools 规范及快速开发体验

EasyJWeb Tools 的相关内容存放在 bin 目录，如下图所示：

本次改进规范了EasyJWeb Tools的发布结构，并提供了更加友好的快速体验及开发方式，主要包括以下几方面：

1、  用户可以自由定制代码生成模板，修改bin/templates中的内容；

2、  在EasyJWeb的bin目录中运行easyjweb project命令可以快速生成各种项目骨架（当前提供了一个最小EasyJWeb项目骨架及一个EJS企业级应用骨架）。

3、  如果您有一个JPA的Entity，这里假如名为 Customer.java(在myapp.domain包)，那么你可以通过按下面的操作快速完成一个针对Customer的添删改查示例。

(1)在bin目录执行easyjweb project e:/test/ejs -ejs

(2)把Customer.java拷到e:/test/ejs/src/main/java/myapp/domain目录。

(3)切换到e:/test/ejs/bin目录，执行easyjweb crud myapp.domain.Customer ../src/main/java/myapp/domain/Customer.java

(4)修改e:/test/ejs/src/main/resources/ db.properties，主要是数据库用户名及密码。

(5) e:/test/ejs/bin目录执行easyjweb war，完成后会在e:/test/ejs/target目录中生成一个ejs.war文件，把该文件拷到Web服务器的webapps目录。

(6)启动Web服务器，在浏览器中输入 http://localhost:8080/ejs/customer.ejf，你将会看到程序的应运效果，如下图所示：

关于EasyJWeb Tools，在EasyJF与Cownew两个开源合作的BlueFin项目（EasyJWEB快速开发的ECLIPSE插件）中，也将会涉及到对EasyJWeb Tools的一些改进，请大家关注，并欢迎参与到其中。

 

五、简单但能反映Java Web 开发的完整入门示例。

相对于前期EasyJWeb应用示例要么不完整，要么太复杂的问题，本次发布将伴随发布三个简单，但相对较为完整的示例。分别是 helloworld、 simple-crud、 customer-crud，另外examples目录中还将会发布一个大型的示例，您可以单独通过上面的连接下载这些示例单独运行。

 

六、多模板引擎支持

对视图渲染进一步加强，提供了对多模板引擎的支持，首先提供对CommonTemplate引擎的支持，该模板引擎是由国内的开源爱好者开发的，在易用性、语法特点上相对其它模板引擎有很多优点。只需要在容器中加入一个Bean配制，就能在EasyJWeb中使用CommonTemplate模板引擎来解析所有以ct为扩展名的视图，如下所示： 

<bean name="CommonTemplatePage" class="com.easyjf.web.core.support.CommonTemplatePageVender">
	<property name="suffix" value="ct"/>
    </bean>

七、Bug 修正及新Bug 的提交

在EasyJWeb-1.0 m1版本发布以来，我们收到了很多开源爱好者的反馈，提供了很多非常好的新功能建议以及提交了很多在使用过程中遇到的Bug，我们对已经发现的Bug都已经逐一修正，详情可以通过jira.easyjf.com浏览，同时也欢迎大家提交更多的Bug。

 

八、文档完善

本次发布的一个重点是对文档的完善，包括EasyJWeb项目的构建指南，入门指南等都作了比较大的改进，另外在官网上还增加了配置文件指南及一些其它上手示例。同时，在本次发布以后到春节前，我们都会把一个重点工作放在EasyJWeb项目的文档上。

 

九、致谢

感谢各位关心EASYJWEB的开源爱好者

感谢为EasyJWeb-1.0 m3的发布贡献力量的所有EasyJF成员

感谢 CommonTemplate、CowNew等开源 团队提供的帮助