Easy Web Development Framework for Java

eweb4j - Easy Web Development Framework For Java - Google Project Hosting

Easy Web Development Framework for Java

eweb4j 是一款基于servlet/jdbc构建的轻量级web开发框架，它不仅融合了SSH的核心优点（全栈式），而且提供诸如模块化、热加载、多数据源、RESTful等非常吸引人的特性。
它小巧灵活，并且遵守约定优于配置的原则。使用它进行java web开发将让您品尝到轻松快乐的编程感受。

• 项目已经迁移到GitHub上 https://github.com/laiweiwei/eweb4j-framework
• 目前最新稳定版本1.9，下个版本是1.9.1

特性列表

• 超级轻量级，纯POJO式开发，无继承、无接口绑定
• 约定优于配置,配置覆盖约定
• Full-Stack
• RESTful (兼容JAX-RS 部分实现)
• MVC (URI-Mapping/上传下载/验证器/拦截器/JSP、Json、Xml、FreeMarker 视图 ...)
• Simple IOC (setter注入，构造器注入，@Ioc注解注入)
• ActiveRecord支持
• ORM (部分兼容JPA注解/生成建表脚本文件）也支持XML配置
• DAO (DAOFactory->InsertDAO/UpdateDAO/DeleteDAO/DivPageDAO/SearchDAO/DAO)
• JDBC模板
• 事务模板，可以嵌套事务
• 配置文件支持 (key-value)
• 国际化支持
• 日志支持
• MVC\ORM\IOC支持灵活开闭
• 同步发布一个在线演示项目SolidBase
• 有关SolidBase项目可以到此了解
• 最新的SolidBase项目源码在这里
• SolidBase会不断的修补bug，也会添加一些新特性，请关注

Quick Start

• 如果使用Maven的话，请在pom.xml添加下面这段依赖

<dependency>
  <groupId>org.eweb4j</groupId>
  <artifactId>eweb4j-all</artifactId>
  <version>1.9</version>
</dependency>

• 在${WebRoot}/WEB-INF/web.xml中添加一个filter

<filter>
    <filter-name>eweb4j-filter</filter-name>
    <filter-class>org.eweb4j.mvc.EWebFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>eweb4j-filter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

• 注意,这个filter里面启动了框架，如果不需要用到mvc，也就是说不需要做web这块的话，只想使用orm和ioc，可以把mvc关闭，然后在代码里通过下面这段来启动框架：

/*
  完全可以到处start，呵呵，不会重复启动的。
  不过决定于你的配置。在start.xml里配置
*/
String err = EWeb4JConfig.start();
if (err == null){
    //框架启动成功
    DAOFactory.getXXXDAO.doXXX//可以做数据库操作
    IOC.getBean("BEAN_ID")//可以通过IOC取出对象
    Map message = Props.getMap("PROP_ID")//可以获取某个properties文件的键值对配置信息
    message.get("key");//自动识别支持国际化
    String val = Props.get("key")//全局的配置
}else{
    //框架启动失败，失败原因是：err
}

• 新建一个包：org.eweb4j.hello
• 在该包新建一个 HelloWorldAction.java

package org.eweb4j.hello;

public class HelloWorldAction {

        public String doHelloWorld(){
                
                return "Hello World !";
        }

}

• 然后编译，部署到tomcat中，接着启动tomcat，打开浏览器输入：

http://localhost:{port}/{your_context}/hello-world

• 第一次打开的时候，框架因为需要初始化配置文件，因此会提醒一个错误，该错误会在页面显示出来，不需要担心，这时候，您所需要做的就是按一下刷新键，接下来便能看到传说中的：

Hello World !

社区支持

• QQ群：216125802
• 论坛：http://bbs.eweb4j.org

关于作者

• iteye博客：http://laiweiweihi.iteye.com
• 新浪微博: http://weibo.com/weiweimiss
• 邮箱：l.weiwei@163.com
• QQ: 493781187

开发指南

请移步wiki

---

版本记录

版本 1.9

• MVC控制器增加文件上传下载的支持，只需要声明File对象即可完成。
• ORM增加生成建表Sql文件的支持。无需额外配置工作。
• 几个DAO增加对Map的支持，使用map可以不需要写model类
• MVC增加8个默认action，约定视图和URI-Mapping
• 控制器属性若提供getter方法，则会作为视图渲染的一个数据模型。类似Struts2的ModelDriven但不需要继承来获得。
• 除了使用属性getter方法作为视图模型数据外，还可以在Action方法参数里声明一个没有任何注解的Map model，它可可以作为视图模型数据，往里面放数据就相当于request.setAttribute一样的效果。
• 改善Action跳转：return "action:xxx"，之前是使用response.sendRedirect来实现的，但是这样的方式使得HTTP请求只能是GET方式的，如果要重定向到一个HTTP方法为POST或者PUT或者DELETE话，显然这样是无法满足需求的。于是，对 return "action:xxx"的处理方式改成：

return "action:xxx@PUT?name=weiwei&age=5";
//符号@只能出现一次，框架不再采用response.sendRedirect的方式来处理，而是构建一个form表单：

<form id="form_id" action="xxx" method="post">
  <input type="hidden" name="_method" value="PUT" />
  <input name="name" value="weiwei" />
  <input name="age" value="5" />
  <input type="submit" />
</form>

<script>document.getElementById('form_id').submit();</script>

//然后使用response.getWriter().print打印上面这段内容，从而实现模拟客户端的请求，这样就支持GET之外的请求了，还可以带参数。

PS:如果指定的Action依然是GET的，则会采用redirect的方式执行，而不是表单的形式

• 将所有Sql的 "select ※" 修改为 "select xxx,xxx,xxx"
• Action方法名支持新的约定格式：

doUri1BindIdAndNameJoinUri2AtPostOrGetOrPutOrDelete