1.前言
首先,感谢您使用easysql。
easysql是一款完全由中国人自主开发的基于JDBC的数据库连接框架。该框架支持多版本数据库,使用方便。开发人员只需要通过一条SQL语句即可实现对数据库的增删改查,完全实现了代码的可重用性和对象的持久化。当然,由于作者的水平有限,该套框架目前还处于开发阶段,目前发布的是第一个版本( 1.0.1 )。该套框架是开源的,作者希望有能力,有水平的国人能在这套框架的基础上继续完善,给作者提出意见和建议。使这套框架能够拥有强大的生命力和持久力(就像当初的mysql一样,才出来的时候被人鄙视为一个玩具。但是经过开发人员和广大开源爱好者的共同努力,现在已经不亚于sqlserver了)。作者的邮箱是:zttsky@qq.com,希望各位国人能踊跃修改源代码,给作者提意见。(国货当自强)
2.声明
easysql是一套开源框架,任何人都可以用这套框架来学习和开发。如果是盈利性质的商业开发,请在源码中注明框架的作者。本框架严禁用来开发非法,反动,暴力,色情网站和系统。对于使用本框架而产生的任何后果,本框架作者概不负责。
3.目录
(1)框架简介
(2)easysql.xml的配置
(3)easysql.jar的使用
(4)EasySql.java和User.java的编写
(5)一个小例子
一.框架简介
该套框架基于JDBC。框架里包含了4个文件:
1. easysql.jar
2. easysql.xml
3. EasySql.java
4. User.java
每个文件的使用我们将在下面的文章里详细介绍。
二.easysql.xml的配置
easysql.xml主要是用来配置数据库连接信息。具体结构如下图:
DB-Driver:这个是填写连接字符串,即Class.forName()里面的内容。
DB-URL:这个是填写数据库连接URL,即DriverManager.getConnection(url,user,pwd)
DB-User:这个是填写数据库登录名。
DB-PassWord:这个是填写数据库登录密码
DB-Encoding:这个是填写你所用到的字符集,要和数据库的字符集统一。
用法:
将该xml放在你工程的根目录下。
例如:你新建了一个工程,取名叫Demo。
Demo下面有WEB-INF文件夹和index.jsp,那么你的easysql.xml就放在Demo下面,和WEB-INF,index.jap是同级目录。有的朋友认为只要是xml文件就一定是放在WEB-INF下面,这种理解是不正确的。
三.easysql.jar的使用
easysql.jar主要是读取easysql.xml。将该jia包直接导入到你的工程里面即可,以后引用该jar包的时候,只需要在你的java文件里写上:
import org.easysql.readXML;
该jar包只包含了一个类readXML,在使用该类的时候,只需要按照如下方法即可:
1.实例化该类 readXML rx=new readXML();
2.调用xmlMessage()方法 rx.xmlMessage();
3.获得easysql.xml的5个节点
(1)获得DB-Driver rx.getDriver();
(2)获得DB-URL rx. getUrl();
(3)获得DB-User rx. getUser();
(4)获得DB-PassWord rx. getPassword();
(5)获得DB-Encoding rx.getEncoding()
四.EasySql.java和User.java的编写
(1)User.java
User.java是由一组变量,以及这些变量get和set方法组成的,这个类要由代码设计人员自己编写。类变量的数据类型要和对应的数据库里面的数据类型要吻合。
例如:在数据库种有一张表,表中有2个字段,分别是
Username varchar(20),
Userage int,
那么,我们在User.java这个类中就可以这样编写
Public class User{
Private String name;
Private int age;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
}
我们可以把程序中数据库所涉及到的所有表的字段全部在这个类中定义,以后在进行数据库操作的时候,我们只需要把要存储的值通过User类的set()方法来放到类中,在EasySql.java这个类中对数据库进行操作时,我们只需要通过User类的get()方法来取出值,就可以直接存储到数据库中去了。这样可以避免重复定义变量。
(2) EasySql.java
这个类是整个框架的核心部分。对于用户来说,你不需要编写这个类,只需要把这个类直接拷贝到你的工程中即可。
在这个类中,有三个方法,分别是:query(),update(),updateBlob()。下面我们来详细的介绍这三个方法。
1. query(String sql,User u)
这个方法是对数据库进行查询的时候所用到的方法
该方法的返回值类型是boolean型
同时该方法把返回的结果集赋给类变量rs
这个方法需要传递2个参数,sql是你所要查询的sql语句,u是User这个类的对象变量,用户可以User这个类的get()方法来得到传过来的参数。
2. update(String sql,User u)
这个方法是对数据库进行插入,修改,删除的时候所使用的方法
该方法的返回值类型为boolean型
这个方法需要传递2个参数,sql是你所要查询的sql语句,u是User这个类的对象变量,用户可以User这个类的get()方法来得到传过来的参数。
3.updateBlob(String sql,User u)
这个方法是对数据库的流文件(如图片)进行插入,修改,删除的时候所使用的方法
该方法的返回值类型为boolean型
对于这三个方法,用户可以根据自己的实际需要来选择。例如你需要对流文件进行操作,你可以把注释中的updateBlob(String sql,User u)方法拷贝过来,把方法名修改为自己的方法名如:updateBlobExcel(String sql,User u),然后根据实际情况来添加pstat.setString()或pstat.setBinaryStream()等等
四.一个小例子
这个小例子位于demo文件夹下面,工程名就叫demo
这是该套框架的作者为大家写的一个小例子,目的在于让大家更好的学习这套框架。这个小例子用的数据库是mysql5.0,数据库名就叫easysql.数据库的sql代码已经放在mysql.txt中,mysql用的到数据库连接jar包也已经放到工程下面了。
--------作者:张挺挺
easysql1.0.1大家可以去我的资源里面下载。