DataSourceMonitor (anyline-data 8.7.2-20250212 API)

```
public interface DataSourceMonitor
```

方法概要

All Methods Instance Methods Default Methods
限定符和类型	方法和说明
`default DriverAdapter`	`adapter(DataRuntime runtime, Object datasource)` 根据数据源定位adapter,如果实现了这个方法就不需要实现feature
`default DriverAdapter`	`after(DataRuntime runtime, Object datasource, DriverAdapter adapter)` 上层方法完成adapter定位后调用,可以在这里缓存,下一次定位提供给adapter(Object datasource)
`default int`	`destroy(DataRuntime runtime, String key, Object datasource)` 注销数据源之前会调用
`default String`	`feature(DataRuntime runtime, Object datasource)` 数据源特征默认不需要实现由上层方法自动提取一般会通过 driver_产品名_url 合成
`default boolean`	`keepAdapter(DataRuntime runtime, Object datasource)` 同一个数据源是否保持同一个adapter 这里通常根据类型判断如HikariDataSource DruidDataSource 针对同一个数据源对应多个不同类型数据库时才需要返回false(如一些动态数据源类型)
`default String`	`key(DataRuntime runtime, Object datasource)` 数据源唯一标识如果不实现则默认feature
`default boolean`	`using(DataRuntime runtime, String key, Object datasource)` 数据源是否正被使用注意有些动态数源中可能连接多个数据源需要遍历检测需要在项目中实现,在注销和覆盖数据源时会调用当前方法，如果数据源正在使用会根据情况抛出异常或忽略注销通常情况下是检测活动中的连接数量

- 方法详细资料
  - using
```
default boolean using(DataRuntime runtime,
                      String key,
                      Object datasource)
```
    数据源是否正被使用
    注意有些动态数源中可能连接多个数据源需要遍历检测
    需要在项目中实现,在注销和覆盖数据源时会调用当前方法，如果数据源正在使用会根据情况抛出异常或忽略注销
    通常情况下是检测活动中的连接数量
    
    参数:
    
    key - 数据源名称
    
    datasource - 数据源一般会是一个连接池实例
    如 HikariDataSource.getHikariPoolMXBean().getActiveConnections()
    DruidDataSource.getActiveCount()
    其他类型参考相应DataRuntime.getProcessor()的返回值如ElasticSearchRuntime.client(org.elasticsearch.client.RestClient)
    
    返回:
    
    true:使用中
  - destroy
```
default int destroy(DataRuntime runtime,
                    String key,
                    Object datasource)
             throws DataSourceUsingException
```
    注销数据源之前会调用
    
    参数:
    
    key - 数据源名称
    
    datasource - 数据源
    
    返回:
    
    0:当前方法内未释放需要上层继续操作,如调用datasource.close() 1:当前方法内已释放不需要上层继续操作
    
    抛出:
    
    DataSourceUsingException - 如果抛出异常，上层方法会抛出异常并中断注销
  - feature
```
default String feature(DataRuntime runtime,
                       Object datasource)
```
    数据源特征默认不需要实现由上层方法自动提取一般会通过 driver_产品名_url 合成
    
    参数:
    
    datasource - 数据源
    
    返回:
    
    String 返回null由上层自动提取
  - key
```
default String key(DataRuntime runtime,
                   Object datasource)
```
    数据源唯一标识如果不实现则默认feature
    
    参数:
    
    datasource - 数据源
    
    返回:
    
    String 返回null由上层自动提取
  - adapter
```
default DriverAdapter adapter(DataRuntime runtime,
                              Object datasource)
```
    根据数据源定位adapter,如果实现了这个方法就不需要实现feature
    
    参数:
    
    datasource - 数据源
    
    返回:
    
    String 返回null由上层自动提取
  - after
```
default DriverAdapter after(DataRuntime runtime,
                            Object datasource,
                            DriverAdapter adapter)
```
    上层方法完成adapter定位后调用,可以在这里缓存,下一次定位提供给adapter(Object datasource)
    
    参数:
    
    datasource - 数据源
    
    adapter - DriverAdapter
    
    返回:
    
    DriverAdapter 如果没有问题原样返回，如果有问题可以修正或返回null, 如果返回null上层方法会抛出adapter定位失败的异常
  - keepAdapter
```
default boolean keepAdapter(DataRuntime runtime,
                            Object datasource)
```
    同一个数据源是否保持同一个adapter
    这里通常根据类型判断如HikariDataSource DruidDataSource
    针对同一个数据源对应多个不同类型数据库时才需要返回false(如一些动态数据源类型)
    
    参数:
    
    datasource - 数据源
    
    返回:
    
    boolean false:每次操作都会检测一次adapter true:同一数据源使用同一个adapter

接口 DataSourceMonitor

方法概要

方法详细资料

using

destroy

feature

key

adapter

after

keepAdapter