如何创建 DataSource
Dec 19, 2018 811 PM
何为DataSource
先看看JDK中对DataSource的描述:
- 作为 DriverManager 工具的替代项,DataSource 对象是获取连接的首选方法。
- 基本实现 - 生成标准的 Connection 对象
- 连接池实现 - 生成自动参与连接池的 Connection 对象。此实现与中间层连接池管理器一起使用。
简单来说,就是获取数据库连接的一个通用接口, 常见的dbcp,c3p0,druid都是DataSource的实现.
NutDao也选用DataSource作为获取数据库连接的方式, 且只调用其无参数的getConnection()方法,也是大部分数据库连接池唯一支持的方法.
提醒一下, DataSource只是接口,不等于连接池
NutDao不挑剔任何连接池/DataSource实现,只要实现了DataSource接口就行,不存在是否支持"XXXX连接池"的问题
这篇文档该怎么用?
直接书写 Java 代码
- 请使用DaoUp类
通过 Nutz.Ioc 的 JSON 配置文件
- Nutz项目中最常见的配置方式, 由NutIoc来管理DataSource和NutDao实例
- 特别强调, NutDao与NutIoc没有任何依赖关系, NutDao在NutIoc看来,只是普通的bean
- 严禁new NutIoc然后单单为了获取一个Dao实例!!
通过 Nutz.Ioc 的 XML 配置文件
- 满足XML强迫症的程序猿, 功能与JSON配置文件类似
再特别特别强调
- NutDao几乎不需要任何配置文件(只有一个nutz_jdbc_experts.js 绝大部分时间你不会遇到它!)
- 本文说到的js/xml文件,都是NutIoc的文件,不是NutDao的配置文件!!
- 不要重复创建DataSource,不要重复创建NutDao!!!!!!!
- 务必参考本小节末尾的提醒!!
内置的SimpleDataSource
Nutz内置,无需额外下载其他连接池/DataSource实现,方便尝试NutDao的功能.
- 不要生产环境中使用这个DataSource!!
- 不要用它来测试NutDao的性能!!
- 自动加载NutDao所支持的数据库的驱动(说白了就是我们认识那几款,不就Class.forName一下嘛)
- 无额外依赖,适合新手试用
- 非连接池,配置简单
- Oracle数据库不能使用,原因是Oracle的数据库连接是重量级的,必须用连接池才不会崩
完整的NutDao配置js文件
var ioc = {
dao : {
type : "org.nutz.dao.impl.NutDao",
args : [{refer:"dataSource"}]
},
dataSource : {
type : "org.nutz.dao.impl.SimpleDataSource",
fields : {
jdbcUrl : 'jdbc:postgresql://localhost:5432/mydatabase',
username : 'demo',
password : '123456'
}
}
}
如何使用这些配置? 请看文章末尾.
Druid(推荐)
国产精品连接池,淘宝温少诚意出品,带强大的监控功能哦, 推荐1.0.25+
druid : 通过 Nutz.Ioc 的 JSON 配置文件
{
dataSource : {
type : "com.alibaba.druid.pool.DruidDataSource",
events : {
depose : 'close'
},
fields : {
url : "jdbc:postgresql://localhost:5432/mydatabase",
username : "enzozhong",
password : "123",
maxWait: 15000, // 若不配置此项,如果数据库未启动,druid会一直等可用连接,卡住启动过程
defaultAutoCommit : false // 提高fastInsert的性能
}
}
}
Apache DBCP
dbcp: 通过 Nutz.Ioc 的 JSON 配置文件
{
dataSource : {
type : "org.apache.commons.dbcp.BasicDataSource",
events : {
depose : 'close'
},
fields : {
driverClassName : 'org.postgresql.Driver',
url : 'jdbc:postgresql://localhost:5432/mydatabase',
username : 'demo',
password : '123456'
}
}
}
C3P0(不推荐)
c3p0: 通过 Nutz.Ioc 的 JSON 配置文件
{
dataSource : {
type : "com.mchange.v2.c3p0.ComboPooledDataSource",
events : {
depose : 'close'
},
fields : {
driverClass : 'org.postgresql.Driver',
jdbcUrl : 'jdbc:postgresql://localhost:5432/mydatabase',
user : 'demo',
password : '123456'
}
}
}
Proxool(严重不推荐)
proxool: 通过 Nutz.Ioc 的 JSON 配置文件
{
dataSource : {
type : "org.logicalcobwebs.proxool.ProxoolDataSource",
fields : {
driver : 'org.postgresql.Driver',
driverUrl : 'jdbc:postgresql://localhost:5432/mydatabase',
user : 'demo',
password : '123456'
}
}
}
容器提供的连接池(JNDI)
Java代码方式:
不写了,这个大家都懂,不懂的自己去google查. 别跟我说baidu没查到!!
由于是通过JNDI获取,所以不再是一个Ioc的bean, 我们只需要引用它就可以了,不需要再写dataSource的bean.例如:
{
dao : {
type : "org.nutz.dao.impl.NutDao",
args : [{jndi:"jdbc/dataSource"}]
}
}
遗留系统
指一些不能提供连接池或自定义获取Connection的项目,可以实现如下封装类,代理为DataSource
public class MyDataSource implements DataSource {
public Connection getConnection() throws SQLException {
// 调用遗留系统中获取数据库连接的方法即可
}
// 还有其他一些方法,全部默认实现就可以了,不会调用到.
}
配置
{
dao : {
type : "org.nutz.dao.impl.NutDao",
args : [{refer:"dataSource"}]
},
dataSource : {
type : "net.wendal.nutzbook.MyDataSource"
}
}
如何使用这些配置
推荐使用org.nutz.dao.util.DaoUp类,非Mvc环境下的全生命周期Dao工具.下面描述的是纯手工创建的代码.
Java代码的方式:
//创建dataSource, 代码仅供演示,实际使用的话必须单例或使用DaoUp类(推荐)
SimpleDataSource ds = new SimpleDataSource();
ds.setUrl("jdbc:postgresql://localhost:5432/mydatabase");
ds.setUsername("demo");
ds.setPassword("123456");
Dao dao = new NutDao(ds);//实际使用的话必须单例或使用DaoUp类(推荐)
dao.create(User.class, true);
dao.insert(User.create("wendal","123456"));
//.... ... ...
//所有操作都已经完成,关闭连接池,退出系统
ds.close();
return;
//额外提醒,NutDao是线程安全的,请不要多次创建NutDao,除非你有多个DataSource
通过 Nutz.Ioc 的 JSON 配置文件
//将配置信息保存到dao.js,并存放于src文件夹下. 代码仅供演示,实际使用的话必须单例
Ioc ioc = new NutIoc(new JsonLoader("dao.js"));
DataSource ds = ioc.get(DataSource.class);
Dao dao = new NutDao(ds); //如果已经定义了dao,那么改成dao = ioc.get(Dao.class);
dao.create(User.class, true);
dao.insert(User.create("wendal","123456"));
ioc.depose(); //关闭Ioc容器
通过 Nutz.Ioc 的 XML 配置文件
//将配置信息保存到dao.xml,并存放于src文件夹下. 代码仅供演示,实际使用的话必须单例
Ioc ioc = new NutIoc(new XmlIocLoader("dao.xml"));
DataSource ds = ioc.get(DataSource.class);
Dao dao = new NutDao(ds); //如果已经定义了dao,那么改成dao = ioc.get(Dao.class);
dao.create(User.class, true);
dao.insert(User.create("wendal","123456"));
ioc.depose(); //关闭Ioc容器
重要提醒
- 非Mvc环境建议用DaoUp类.
- Mvc环境下请使用IocBy.
- 上面提及的Java代码均为演示(main方法中的简单示例),实际用的时候, 必须将ioc容器本身单例化(例如存放到一个static属性)
- 重复创建DataSource(例如反复创建ioc容器, new NutIoc(…))会导致数据库连接数耗尽.
- ioc容器本身,应该尽可能作为单例, 不要创建一个ioc容器后,获取ioc对象,然后就抛弃, 例如:
绝对错误的用法
public Dao getDao() { // 无论改方法被调用一次还是N次, 均为错误!!
Ioc ioc = new NutIoc(new JsonLoader("ioc/dao.js")); // 反复创建ioc容器
return ioc.get(Dao.class); //方法返回后, ioc必然被gc, 从而触发ioc的depose事件,导致DataSource关闭!
}
不那么错误的用法,严重建议用DaoUp类
private static Ioc ioc;
public Dao getDao() { // 暂不考虑线程同步的问题
if (ioc == null)
ioc = new NutIoc(new JsonLoader("ioc/dao.js"));
return ioc.get(Dao.class);
}
Mvc中的正确用法,使用IocBy配置ioc,尽可能通过@Inject等方式获取ioc的bean.在无法直接获取Ioc容器的代码中,使用下列代码
// 在request作用域内
public Dao getDao() {
Mvcs.getIoc().get(Dao.class);
}
// 在request作用域之外
public Dao getDao() {
Mvcs.ctx().getDefaultIoc().get(Dao.class);
}
本页面的文字允许在知识共享 署名-相同方式共享 3.0协议和GNU自由文档许可证下修改和再使用。