ConnectionSource (sql-core 3.12.2-RELEASE API)

所有已知实现类:

ConditionalConnectionSource, DefaultConnectionSource
```
public interface ConnectionSource
```
Beetlsql 使用ConnectionSource管理数据库连接。这有点类似DataSource 主要区别在于getConnection方法，ConnectionSource更加灵活，可以依据ExecuteContext来动态判断应该返回一个什么样的Connection，从而实现分库，主从库。需要注意的是，与ConditionalSQLManager 不同，ConditionalSQLManager 可以管理多个SQLManager类，而SQLManager可以管理多个ConnectionSource更加灵活以下是一些常见场景
有主从库，因此只需要一个SQLManager，然后使用DefaultConnectionSource即可，DefaultConnectionSource可以代理主从库
有俩个库，一个库存业务数据，一个库存查询分析数据，那需要俩个SQLManager，对应各自库，为了方便操作，可以使用ConditionalSQLManager 动态决定使用哪个库
我的业务数据需要分库，比如订单分到不同库，我可以使用一个SQLManager，然后使用ConditionalConnectionSource来根据业务信息返回不同的数据库连接
更复杂情况是以上综合，业务库是分库，但业务的查询报表是另外一个NOSQL或者查询引擎，因此需要综合ConditionalSQLManager和ConditionalConnectionSource，从而实现对业务层来说，就是一个SQLManger（或者衍生出来的Mapper）

作者:: xiandafu
另请参阅:: ConnectionSourceHelper, DefaultConnectionSource, ConditionalConnectionSource

字段概要

字段
限定符和类型字段和说明

static ThreadLocal<DataSource> forceDs

字段
限定符和类型	字段和说明
`static ThreadLocal<DataSource>`	`forceDs`

方法概要

所有方法实例方法抽象方法默认方法
限定符和类型	方法和说明
`default void`	`applyConnectionSetting(ExecuteContext ctx, Connection conn)`
`default void`	`applyStatementSetting(ExecuteContext ctx, Connection conn, Statement statement)`
`default void`	`closeConnection(Connection conn, ExecuteContext ctx, boolean isUpdate)`
`default void`	`forceBegin(DataSource dataSource)`
`default void`	`forceEnd()`
`Connection`	`getConn(ExecuteContext ctx, boolean isUpdate)` 根据条件得到链接
`default DataSource`	`getForceDataSource()`
`Connection`	`getMasterConn()` 得到一个主库连接
`default DataSource`	`getMasterSource()`
`Connection`	`getMetaData()` 得到一个获取数据库metadata，如果是分库分表，或者主从，需要给出一个能获得数据库信息的链接通常这是主库。
`default DataSource[]`	`getSlaves()`
`boolean`	`isTransaction()` 是否是事务环境，这个是与web框架整合的框架，通常web框架都有api可以得到是否还在事务环境。

字段详细资料

forceDs

static final ThreadLocal<DataSource> forceDs

方法详细资料

getMasterConn
```
Connection getMasterConn()
```
得到一个主库连接

返回:

getMetaData
```
Connection getMetaData()
```
得到一个获取数据库metadata，如果是分库分表，或者主从，需要给出一个能获得数据库信息的链接通常这是主库。如果你只有一个数据，那就同#getMaster

返回:

getConn
```
Connection getConn(ExecuteContext ctx,
                   boolean isUpdate)
```
根据条件得到链接

参数:

ctx - 执行上下文

isUpdate - 是否更新数据

返回:

isTransaction
```
boolean isTransaction()
```
是否是事务环境，这个是与web框架整合的框架，通常web框架都有api可以得到是否还在事务环境。如果不是，则beetlsql可以自主管理事务，否则，交给web框架管理。通常web框架集成，这个返还true，则beetlsql不在，做提交事务的事情，交给web框架统一管理

返回:

applyStatementSetting

default void applyStatementSetting(ExecuteContext ctx,
                                   Connection conn,
                                   Statement statement)
                            throws SQLException

抛出:: SQLException

applyConnectionSetting

default void applyConnectionSetting(ExecuteContext ctx,
                                    Connection conn)

closeConnection

default void closeConnection(Connection conn,
                             ExecuteContext ctx,
                             boolean isUpdate)

getMasterSource
```
default DataSource getMasterSource()
```

getSlaves
```
default DataSource[] getSlaves()
```

forceBegin

default void forceBegin(DataSource dataSource)

forceEnd
```
default void forceEnd()
```

getForceDataSource

default DataSource getForceDataSource()

接口 ConnectionSource

字段概要

方法概要

字段详细资料

forceDs

方法详细资料

getMasterConn

getMetaData

getConn

isTransaction

applyStatementSetting

applyConnectionSetting

closeConnection

getMasterSource

getSlaves

forceBegin

forceEnd

getForceDataSource