数据源工厂-DsFactory

    每一个开源JDBC连接池都有对DataSource的实现，比如Druid为DruidDataSource，Hikari为HikariDataSource。但是各大连接池配置各不相同，配置文件也不一样，Hutool的针对常用的连接池做了封装，最大限度简化和提供一致性配置。

    Hutool的解决方案是：在ClassPath中使用一个配置文件，配置所有种类连接池的数据源，然后使用DsFactory.get()方法自动识别数据源以及自动注入配置文件中的连接池配置（包括数据库连接配置）。DsFactory通过try的方式按照顺序检测项目中引入的jar包来甄别用户使用的是哪种连接池，从而自动构建相应的数据源。

    Hutool支持以下连接池，并按照其顺序检测存在与否：

    • HikariCP
    • Druid
    • Dbcp
    • C3p0在没有引入任何连接池的情况下，Hutool会使用其内置的连接池：Hutool Pooled（简易连接池，不推荐在线上环境使用）。

    Hutool不会强依赖于任何第三方库，在Hutool支持的连接池范围内，用户需自行选择自己喜欢的连接池并引入。

    2. 编写配置文件

    Maven项目中，在src/main/resources/config下创建文件db.setting，编写配置文件即可。这个配置文件位置就是Hutool与用户间的一个约定（符合约定大于配置的原则）：

    配置文件分为两部分

    1. 基本连接信息

    2. 连接池特有配置信息

    我们以HikariCP为例：

    1. # 自动提交
    2. autoCommit = true
    3. # 等待连接池分配连接的最大时长（毫秒），超过这个时长还没可用的连接则发生SQLException， 缺省:30秒
    4. connectionTimeout = 30000
    5. # 一个连接idle状态的最大时长（毫秒），超时则被释放（retired），缺省:10分钟
    6. idleTimeout = 600000
    7. # 一个连接的生命时长（毫秒），超时而且没被使用则被释放（retired），缺省:30分钟，建议设置比数据库超时时长少30秒，参考MySQL wait_timeout参数（show variables like '%timeout%';）
    8. maxLifetime = 1800000
    10. connectionTestQuery = SELECT 1
    11. # 最小闲置连接数
    12. minimumIdle = 10
    13. # 连接池中允许的最大连接数。缺省值：10；推荐的公式：((core_count * 2) + effective_spindle_count)
    14. maximumPoolSize = 10
    15. # 连接只读数据库时配置为true， 保证安全
    16. readOnly = false
    1. DataSource ds = DSFactory.get()

    是滴，就是这么简单，一个简单的方法，可以识别数据源并读取默认路径(config/db.setting)下信息从而获取数据源。

    4. 直接创建数据源

    当然你依旧可以按照连接池本身的方式获取数据源对象。我们以Druid为例：

    有时候我们的操作非常简单，亦或者只是测试下远程数据库是否畅通，我们可以使用Hutool提供的SimpleDataSource:

    1. DataSource ds = new SimpleDataSource("jdbc:mysql://localhost:3306/dbName", "root", "123456");

    SimpleDataSource只是DriverManager.getConnection的简单包装，本身并不支持池化功能，此类特别适合少量数据库连接的操作。

    同样的，SimpleDataSource也支持默认配置文件：

    1. DataSource ds = new SimpleDataSource();

    1. 自定义连接池

    有时候当项目引入多种数据源时，我们希望自定义需要的连接池，此时可以：

    有时候由于项目规划的问题，我们希望自定义数据库配置Setting的位置，甚至是动态加载Setting对象，此时我们可以使用以下方法从其它的Setting对象中获取数据库连接信息：

    1. //自定义数据库Setting，更多实用请参阅Hutool-Setting章节
    2. Setting setting = new Setting("otherPath/other.setting");
    3. //获取指定配置，第二个参数为分组，用于多数据源，无分组情况下传null
    4. DataSource ds = DSFactory.get(setting, null);

    3. 多数据源

    有的时候我们需要操作不同的数据库，也有可能我们需要针对线上、开发和测试分别操作其数据库，无论哪种情况，Hutool都针对多数据源做了很棒的支持。

    多数据源有两种方式可以实现：

    1. 多个配置文件分别获得数据源

    就是按照自定义配置文件的方式读取多个配置文件即可。

    2. 在同一配置文件中使用分组隔离不同的数据源配置：

    1. [group_db1]
    2. url = jdbc:mysql://<host>:<port>/<database_name>
    3. username = 用户名
    4. password = 密码
    6. [group_db2]
    7. url = jdbc:mysql://<host2>:<port>/<database_name>
    8. username = 用户名
    9. password = 密码

    我们按照上面的方式编写db.setting文件，然后：

    这样我们就可以在一个配置文件中实现多数据源的配置。

    Hutool通过多种方式获取DataSource对象，获取后除了可以在Hutool自身应用外，还可以将此对象传入不同的框架以实现无缝结合。

    • 自动识别优于用户定义
    • 便捷性与灵活性并存