cn.hutool.db.ds

Class AbstractDSFactory

java.lang.Object

cn.hutool.db.ds.DSFactory

cn.hutool.db.ds.AbstractDSFactory

All Implemented Interfaces:

Closeable, Serializable, AutoCloseable

Direct Known Subclasses:

BeeDSFactory, C3p0DSFactory, DbcpDSFactory, DruidDSFactory, HikariDSFactory, JndiDSFactory, PooledDSFactory, SimpleDSFactory, TomcatDSFactory

public abstract class AbstractDSFactory
extends DSFactory

抽象数据源工厂
此工厂抽象类用于实现数据源的缓存，当用户多次调用getDataSource(String) 时，工厂只需创建一次即可。
数据源是与配置文件中的分组相关的，每个分组的数据源相互独立，也就是每个分组的数据源是单例存在的。

Author:

looly

See Also:

Serialized Form

Field Summary

Fields inherited from class cn.hutool.db.ds.DSFactory

dataSourceName, KEY_ALIAS_DRIVER, KEY_ALIAS_PASSWORD, KEY_ALIAS_URL, KEY_ALIAS_USER, KEY_CONN_PROPS

Constructor Summary

Constructors

Constructor and Description
AbstractDSFactory(String dataSourceName, Class<? extends DataSource> dataSourceClass, Setting setting) 构造

Method Summary

Modifier and Type	Method and Description
void	close(String group) 关闭对应数据源
protected abstract DataSource	createDataSource(String jdbcUrl, String driver, String user, String pass, Setting poolSetting) 创建新的DataSource
void	destroy() 销毁工厂类，关闭所有数据源
boolean	equals(Object obj)
DataSource	getDataSource(String group) 获得分组对应数据源
Setting	getSetting() 获取配置，用于自定义添加配置项
int	hashCode()

Methods inherited from class cn.hutool.db.ds.DSFactory

close, create, get, get, getDataSource, setCurrentDSFactory

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractDSFactory

public AbstractDSFactory(String dataSourceName,
                         Class<? extends DataSource> dataSourceClass,
                         Setting setting)

构造

Parameters:

dataSourceName - 数据源名称

dataSourceClass - 数据库连接池实现类，用于检测所提供的DataSource类是否存在，当传入的DataSource类不存在时抛出ClassNotFoundException
此参数的作用是在detectDSFactory方法自动检测所用连接池时，如果实现类不存在，调用此方法会自动抛出异常，从而切换到下一种连接池的检测。

setting - 数据库连接配置，如果为null，则读取全局自定义或默认配置

Method Detail

getSetting

public Setting getSetting()

获取配置，用于自定义添加配置项

Returns:

Setting

Since:

4.0.3

getDataSource

public DataSource getDataSource(String group)

Description copied from class: DSFactory

获得分组对应数据源

Specified by:

getDataSource in class DSFactory

Parameters:

group - 分组名

Returns:

数据源

createDataSource

protected abstract DataSource createDataSource(String jdbcUrl,
                                               String driver,
                                               String user,
                                               String pass,
                                               Setting poolSetting)

创建新的DataSource

Parameters:

jdbcUrl - JDBC连接字符串

driver - 数据库驱动类名

user - 用户名

pass - 密码

poolSetting - 分组下的连接池配置文件

Returns:

DataSource

close

public void close(String group)

Description copied from class: DSFactory

关闭对应数据源

Specified by:

close in class DSFactory

Parameters:

group - 分组

destroy

public void destroy()

Description copied from class: DSFactory

销毁工厂类，关闭所有数据源

Specified by:

destroy in class DSFactory

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object