JDBC (ymate-platform-v2-码云(gitee.com))

java.lang.Object
- net.ymate.platform.persistence.jdbc.JDBC

All Implemented Interfaces:

AutoCloseable, IModule, IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>, IDestroyable, IInitialization<IApplication>, IDatabase
```
public final class JDBC
extends Object
implements IModule, IDatabase
```
Author:

刘镇 (suninformation@163.com) on 2011-9-10 下午11:45:25

Field Summary

Fields
Modifier and Type	Field and Description
`static Map<String,Class<? extends IDialect>>`	`DB_DIALECTS` 提供的已知数据库方言
`static Map<String,String>`	`DB_DRIVERS` 框架提供的已知数据库连接驱动
`static Map<String,String>`	`DS_ADAPTERS` 框架提供的已知数据源适配器名称映射

Fields inherited from interface net.ymate.platform.persistence.jdbc.IDatabase
MODULE_NAME

Constructor Summary

Constructors
Constructor and Description

JDBC()

JDBC(IDatabaseConfig config)

Constructors
Constructor and Description
`JDBC()`
`JDBC(IDatabaseConfig config)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`close()`
`static IDatabase`	`get()`
`IDatabaseConfig`	`getConfig()` 获取持久化配置对象
`IDatabaseConnectionHolder`	`getConnectionHolder(String dataSourceName)` 获取由dataSourceName指定的数据源连接持有者对象
`IDatabaseDataSourceAdapter`	`getDataSourceAdapter(String dataSourceName)` 获取指定源数据源适配器
`IDatabaseConnectionHolder`	`getDefaultConnectionHolder()` 获取默认数据源连接持有者对象
`IDatabaseDataSourceAdapter`	`getDefaultDataSourceAdapter()` 获取默认数据源适配器
`String`	`getName()` 获取模块名称
`IApplication`	`getOwner()` 获取所属应用容器
`void`	`initialize(IApplication owner)` 初始化
`boolean`	`isInitialized()` 是否已初始化
`IDatabaseSession`	`openSession()` 开启数据库连接会话(注意一定记得关闭会话)
`IDatabaseSession`	`openSession(IDatabaseConnectionHolder connectionHolder)` 开启数据库连接会话(注意一定记得关闭会话)
`<T> T`	`openSession(IDatabaseConnectionHolder connectionHolder, IDatabaseSessionExecutor<T> executor)` 开启会话并执行会话执行器接口逻辑(执行完毕会话将自动关闭)
`<T> T`	`openSession(IDatabaseSessionExecutor<T> executor)` 开启会话并执行会话执行器接口逻辑(执行完毕会话将自动关闭)
`IDatabaseSession`	`openSession(IDataSourceRouter dataSourceRouter)` 开启数据库连接会话(注意一定记得关闭会话)
`<T> T`	`openSession(IDataSourceRouter dataSourceRouter, IDatabaseSessionExecutor<T> executor)` 开启会话并执行会话执行器接口逻辑(执行完毕会话将自动关闭)
`IDatabaseSession`	`openSession(String dataSourceName)` 开启数据库连接会话(注意一定记得关闭会话)
`<T> T`	`openSession(String dataSourceName, IDatabaseSessionExecutor<T> executor)` 开启会话并执行会话执行器接口逻辑(执行完毕会话将自动关闭)
`void`	`releaseConnectionHolder(IDatabaseConnectionHolder connectionHolder)` 安全关闭数据源的连接持有者(确保非事务状态下执行关闭)

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DS_ADAPTERS
```
public static final Map<String,String> DS_ADAPTERS
```
    框架提供的已知数据源适配器名称映射
  - DB_DRIVERS
```
public static final Map<String,String> DB_DRIVERS
```
    框架提供的已知数据库连接驱动
  - DB_DIALECTS
```
public static final Map<String,Class<? extends IDialect>> DB_DIALECTS
```
    提供的已知数据库方言
- Constructor Detail
  - JDBC
```
public JDBC()
```
  - JDBC
```
public JDBC(IDatabaseConfig config)
```
- Method Detail
  - get
```
public static IDatabase get()
```
  - getName
```
public String getName()
```
    Description copied from interface: IModule
    
    获取模块名称
    
    Specified by:
    
    getName in interface IModule
    
    Returns:
    
    返回模块名称
  - initialize
```
public void initialize(IApplication owner)
                throws Exception
```
    Description copied from interface: IInitialization
    
    初始化
    
    Specified by:
    
    initialize in interface IInitialization<IApplication>
    
    Parameters:
    
    owner - 指定所属容器参数对象
    
    Throws:
    
    Exception - 初始过程中产生的任何异常
  - isInitialized
```
public boolean isInitialized()
```
    Description copied from interface: IInitialization
    
    是否已初始化
    
    Specified by:
    
    isInitialized in interface IInitialization<IApplication>
    
    Returns:
    
    返回true表示已初始化
  - close
```
public void close()
           throws Exception
```
    Specified by:
    
    close in interface AutoCloseable
    
    Throws:
    
    Exception
  - getOwner
```
public IApplication getOwner()
```
    Description copied from interface: IPersistence
    
    获取所属应用容器
    
    Specified by:
    
    getOwner in interface IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>
    
    Returns:
    
    返回所属应用容器实例
  - getConfig
```
public IDatabaseConfig getConfig()
```
    Description copied from interface: IPersistence
    
    获取持久化配置对象
    
    Specified by:
    
    getConfig in interface IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>
    
    Returns:
    
    返回持久化配置对象
  - getDefaultConnectionHolder
```
public IDatabaseConnectionHolder getDefaultConnectionHolder()
                                                     throws Exception
```
    Description copied from interface: IPersistence
    
    获取默认数据源连接持有者对象
    
    Specified by:
    
    getDefaultConnectionHolder in interface IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>
    
    Returns:
    
    返回默认数据源连接持有者对象
    
    Throws:
    
    Exception - 可能产生的异常
  - getConnectionHolder
```
public IDatabaseConnectionHolder getConnectionHolder(String dataSourceName)
                                              throws Exception
```
    Description copied from interface: IPersistence
    
    获取由dataSourceName指定的数据源连接持有者对象
    
    Specified by:
    
    getConnectionHolder in interface IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>
    
    Parameters:
    
    dataSourceName - 数据源名称
    
    Returns:
    
    获取由指定的数据源连接持有者对象
    
    Throws:
    
    Exception - 可能产生的异常
  - releaseConnectionHolder
```
public void releaseConnectionHolder(IDatabaseConnectionHolder connectionHolder)
                             throws Exception
```
    Description copied from interface: IPersistence
    
    安全关闭数据源的连接持有者(确保非事务状态下执行关闭)
    
    Specified by:
    
    releaseConnectionHolder in interface IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>
    
    Parameters:
    
    connectionHolder - 数据源的连接持有者对象
    
    Throws:
    
    Exception - 可能产生的异常
  - getDefaultDataSourceAdapter
```
public IDatabaseDataSourceAdapter getDefaultDataSourceAdapter()
```
    Description copied from interface: IDatabase
    
    获取默认数据源适配器
    
    Specified by:
    
    getDefaultDataSourceAdapter in interface IDatabase
    
    Returns:
    
    返回数据源适配器对象
  - getDataSourceAdapter
```
public IDatabaseDataSourceAdapter getDataSourceAdapter(String dataSourceName)
```
    Description copied from interface: IDatabase
    
    获取指定源数据源适配器
    
    Specified by:
    
    getDataSourceAdapter in interface IDatabase
    
    Parameters:
    
    dataSourceName - 数据源名称
    
    Returns:
    
    返回数据源适配器对象
  - openSession
```
public <T> T openSession(IDatabaseSessionExecutor<T> executor)
                  throws Exception
```
    Description copied from interface: IDatabase
    
    开启会话并执行会话执行器接口逻辑(执行完毕会话将自动关闭)
    
    Specified by:
    
    openSession in interface IDatabase
    
    Type Parameters:
    
    T - 执行结果对象类型
    
    Parameters:
    
    executor - 会话执行器
    
    Returns:
    
    返回执行结果
    
    Throws:
    
    Exception - 可能产生的任何异常
  - openSession
```
public <T> T openSession(String dataSourceName,
                         IDatabaseSessionExecutor<T> executor)
                  throws Exception
```
    Description copied from interface: IDatabase
    
    开启会话并执行会话执行器接口逻辑(执行完毕会话将自动关闭)
    
    Specified by:
    
    openSession in interface IDatabase
    
    Type Parameters:
    
    T - 执行结果对象类型
    
    Parameters:
    
    dataSourceName - 数据源名称
    
    executor - 会话执行器
    
    Returns:
    
    返回执行结果
    
    Throws:
    
    Exception - 可能产生的任何异常
  - openSession
```
public <T> T openSession(IDatabaseConnectionHolder connectionHolder,
                         IDatabaseSessionExecutor<T> executor)
                  throws Exception
```
    Description copied from interface: IDatabase
    
    开启会话并执行会话执行器接口逻辑(执行完毕会话将自动关闭)
    
    Specified by:
    
    openSession in interface IDatabase
    
    Type Parameters:
    
    T - 执行结果对象类型
    
    Parameters:
    
    connectionHolder - 数据源连接持有者对象
    
    executor - 会话执行器
    
    Returns:
    
    返回执行结果
    
    Throws:
    
    Exception - 可能产生的任何异常
  - openSession
```
public <T> T openSession(IDataSourceRouter dataSourceRouter,
                         IDatabaseSessionExecutor<T> executor)
                  throws Exception
```
    Description copied from interface: IDatabase
    
    开启会话并执行会话执行器接口逻辑(执行完毕会话将自动关闭)
    
    Specified by:
    
    openSession in interface IDatabase
    
    Type Parameters:
    
    T - 执行结果对象类型
    
    Parameters:
    
    dataSourceRouter - 数据源路由对象
    
    executor - 会话执行器
    
    Returns:
    
    返回执行结果
    
    Throws:
    
    Exception - 可能产生的任何异常
  - openSession
```
public IDatabaseSession openSession()
                             throws Exception
```
    Description copied from interface: IPersistence
    
    开启数据库连接会话(注意一定记得关闭会话)
    
    Specified by:
    
    openSession in interface IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>
    
    Returns:
    
    返回会话对象
    
    Throws:
    
    Exception - 可能产生的异常
  - openSession
```
public IDatabaseSession openSession(String dataSourceName)
                             throws Exception
```
    Description copied from interface: IPersistence
    
    开启数据库连接会话(注意一定记得关闭会话)
    
    Specified by:
    
    openSession in interface IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>
    
    Parameters:
    
    dataSourceName - 数据源名称
    
    Returns:
    
    返回会话对象
    
    Throws:
    
    Exception - 可能产生的异常
  - openSession
```
public IDatabaseSession openSession(IDatabaseConnectionHolder connectionHolder)
                             throws Exception
```
    Description copied from interface: IPersistence
    
    开启数据库连接会话(注意一定记得关闭会话)
    
    Specified by:
    
    openSession in interface IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>
    
    Parameters:
    
    connectionHolder - 数据源连接持有者对象
    
    Returns:
    
    返回会话对象
    
    Throws:
    
    Exception - 可能产生的异常
  - openSession
```
public IDatabaseSession openSession(IDataSourceRouter dataSourceRouter)
                             throws Exception
```
    Description copied from interface: IPersistence
    
    开启数据库连接会话(注意一定记得关闭会话)
    
    Specified by:
    
    openSession in interface IPersistence<IDatabaseSession,IDatabaseConfig,IDatabaseConnectionHolder>
    
    Parameters:
    
    dataSourceRouter - 数据源路由对象
    
    Returns:
    
    返回会话对象
    
    Throws:
    
    Exception - 可能产生的异常

Class JDBC

Field Summary

Fields inherited from interface net.ymate.platform.persistence.jdbc.IDatabase

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DS_ADAPTERS

DB_DRIVERS

DB_DIALECTS

Constructor Detail

JDBC

JDBC

Method Detail

get

getName

initialize

isInitialized

close

getOwner

getConfig

getDefaultConnectionHolder

getConnectionHolder

releaseConnectionHolder

getDefaultDataSourceAdapter

getDataSourceAdapter

openSession

openSession

openSession

openSession

openSession

openSession

openSession

openSession