Servlet、JDBC简易封装框架-lovew
说明
个人所用的轻量级的servlet和orm框架，没什么技术而言，完全是因为在平常测试工作中经常需要写一些小型的web应用工具，既不想使用SSH这么庞大的框架，也不想直接使用servlet或者JDBC，写起来也是及其麻烦。
源码和Demo示例都放在了GitHub上，有兴趣的可以一起交流学习。
源码: https://github.com/xuwangcheng14/lovew
Demo: https://github.com/xuwangcheng14/lovewDemo
依赖Jar
除了lovew.jar，
以下jar包是必须的：
commons-beanutils.jar
commons-collections.jar
commons-lang.jar
ezmorph-1.0.6.jar
json-lib-2.2.3-jdk15.jar
以下jar可能你会用得上：
jackson-all-1.9.0.jar
commons-logging.jar
log4j-1.2.17.jar
配置文件
目前配置文件仅有一个：lovew.properties
#database configuration#
db.classname=org.sqlite.JDBC
db.url=jdbc:sqlite:info.db
db.username=
db.password=
db.autoCreateTable=true
#Bean Mapper#
Person.id=id
Person.name=name
Person.city=city
Person.age=age
#create Table SQL#
table.Person=create table if not exists person(id integer primary key autoincrement,name text,age integer)
table.User=create table if not exists person(id integer primary key autoincrement,name text,age integer)
db.autoCreateTable配置说明了是否需要在初始化时自动执行建表语句，默认为false，相应的建表语句也需要配置在配置文件中，对应key值必须为table开头，例如table.Person;
db前缀的配置了对应的数据库配置，如果用户不自行配置，默认使用sqlite(嵌入型文件数据库);
同时可以自行配置bean实体类与数据库表字段的对应关系，配置方式为：类名称.属性名=对应字段名,如果你没用配置，则默认字段名称与类中属性名相同.
ORM
说起来是orm，其实完全是将jdbc给做了个简单的包装而已。
自定义Mapper需要继承AbstractMapper
import bean.User;
import xuwangcheng.love.w.orm.AbstractMapper;
public class UserMapper extends AbstractMapper<User> {
public UserMapper() {
// TODO Auto-generated constructor stub
super();
}
}
然后在对应的Dao中直接使用Mapper即可
import bean.User;
import mapper.UserMapper;
public class UserDao {
public User get(String name) throws Exception {
String sql = "select * from user where name=?";
UserMapper mapper = new UserMapper();
mapper.execSQL(sql, name);
return mapper.getObject();
}
public int save(User user) throws Exception {
String sql = "insert into user values(?,?,?)";
UserMapper mapper = new UserMapper();
mapper.execSQL(sql, user.getName(), user.getCity(), user.getAge());
return mapper.getEffectRowCount();
}
}
在针对不同的SQL语句，通过execSQL方法传入SQL语句和替换参数(按照占位符的位置序号)，执行完毕之后，在通过mapper实例获取需要的结果，具体的返回获取方法可以参考AbstractMapper源码部分：
/**
* 获取返回的一个指定的对象实例<br>
* 多个只返回第一个
*
* @return
*/
public T getObject()
/**
* 返回对象集合,只有select * from才会用此接收<br>
* 要设置的属性必须要有set方法
* @return
*/
public List<T> getObjectList()
/**
* 影响到的记录行数<br>
* 默认为0
* @return
*/
public int getEffectRowCount()
/**
* 返回对象数组集合,除select * from之外其他的返回都用此接收
* @return
*/
public List<Object[]> getReturnObjects()
/**
* 通过查询语句查询到的记录数
* @return
*/
public int getQueryCount()
Servlet
目前servlet只能返回json字符串，主要于前后台分离时，交互方式为ajax的场景。
自定义servlet需要继承AbstractHttpServlet，同时在初始化时需要显式的调用AbstractHttpServlet的setServlet方法(自身作为方法参数)。
通过传入的具体requestUri来匹配servlet中对应的方法来做对应的处理，每个对应的处理方法上必须有@ExecuteRequest注解，默认请求的uri必须和方法名或者注解中自定义的value值相同，例如：@ExecuteRequest("save")public void insertUser() 该方法对应的uri为save
同时处理请求的方法上必须固定的两个参数Map<String, Object> ajaxMap, HttpServletRequest request，前者为返回给前台的ajaxMap(会自动转换成json字符串)，后者为对应请求的request对象，如果你需要框架为你自动注入请求参数，可以自行添加更多的方法参数，例如：public void insertUser(Map<String, Object> ajaxMap, HttpServletRequest request, @RequestBody("name") String name,@RequestBody("city") String city, @RequestBody("age") int age)
暂时不支持自动注入复杂对象参数。
下面是demo中的示例：
import java.util.Map;
import javax.servlet.http.HttpServletRequest;
import org.apache.commons.lang.StringUtils;
import bean.User;
import dao.UserDao;
import xuwangcheng.love.w.servlet.AbstractHttpServlet;
import xuwangcheng.love.w.servlet.annotation.ExecuteRequest;
import xuwangcheng.love.w.servlet.annotation.InjectDao;
import xuwangcheng.love.w.servlet.annotation.RequestBody;
import xuwangcheng.love.w.util.Constants;
public class TestServlet extends AbstractHttpServlet {
/**
*
*/
private static final long serialVersionUID = 1L;
public TestServlet() {
// TODO Auto-generated constructor stub
super.setServlet(this);
}
@InjectDao
private UserDao userDao;
@ExecuteRequest
public void getName(Map<String, Object> ajaxMap, HttpServletRequest request, @RequestBody("name") String name) {
if (StringUtils.isBlank(name)) {
ajaxMap.put("msg", "参数不正确");
ajaxMap.put("returnCode", 1);
return;
}
ajaxMap.put("msg", "Test:Hello " + name);
ajaxMap.put("returnCode", 0);
}
@ExecuteRequest("save")
public void insertUser(Map<String, Object> ajaxMap, HttpServletRequest request, @RequestBody("name") String name
,@RequestBody("city") String city, @RequestBody("age") int age) throws Exception {
User user = new User(name, city, age);
int ret = userDao.save(user);
ajaxMap.put(Constants.RETURN_CODE_ATTRIBUTE_NAME, Constants.CORRECT_RETURN_CODE);
ajaxMap.put(Constants.RETURN_MSG_ATTRIBUTE_NAME, ret);
}
@ExecuteRequest
public void get(Map<String, Object> ajaxMap, HttpServletRequest request, @RequestBody("name") String name) throws Exception {
ajaxMap.put(Constants.RETURN_CODE_ATTRIBUTE_NAME, Constants.CORRECT_RETURN_CODE);
ajaxMap.put("user", userDao.get(name));
}
/*****************************************************************************/
public UserDao getUserDao() {
return userDao;
}
public void setUserDao(UserDao userDao) {
this.userDao = userDao;
}
}
整合
servlet中自动注入Dao:
Dao属性加上InjectDao注解，同时在serlvet中提供对应的get/set方法。
具体参考上面的示例
web.xml
web.xml配置方式同原生的servlet配置，如果你需要自动建表的功能，加上指定的listener即可(自定义listener请继承此listener)
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
<display-name>TestProject</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
<listener>
<listener-class>xuwangcheng.love.w.servlet.listener.LovewInitListener</listener-class>
</listener>
<servlet>
<servlet-name>test</servlet-name>
<servlet-class>servlet.TestServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>test</servlet-name>
<url-pattern>/test/*</url-pattern>
</servlet-mapping>
</web-app>
