DaoService (emap_pub 1.9.54.B254 API)

java.lang.Object
- com.wisedu.emap.dao.DaoService

```
@Service
public class DaoService
extends Object
```
数据库操作相关的服务。
如执行查询/更新，根据数据源编号获取数据库连接等。

从以下版本开始:

1.4.30

字段概要

字段
限定符和类型	字段和说明
`static String`	`ATTR_DS_NAME` 实体的属性中放置数据源id的名称。
`static String`	`EC_DB_OTHER` 错误码, 其他数据库问题。
`static String`	`EC_NONE_DB` 错误码, 不存在默认数据源，无法开启集群的定时任务

构造器概要

构造器
构造器和说明

DaoService()

构造器
构造器和说明
`DaoService()`

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`boolean`	`beginTrans(String dsId)` 已过时。请使用`getConnection(String, boolean)`
`self.micromagic.eterna.dao.ResultIterator`	`doQuery(self.micromagic.eterna.dao.Query query, self.micromagic.eterna.model.AppData appData)` 执行一个query，并获取其返回结果。
`self.micromagic.eterna.dao.ResultIterator`	`doQueryWithEnv(DaoParam param, self.micromagic.eterna.dao.Query query, self.micromagic.eterna.model.AppData appData)` 执行查询，在需要获取所有行时根据配置带上环境。
`int`	`doUpdate(self.micromagic.eterna.dao.Update update, self.micromagic.eterna.model.AppData appData)` 执行一个update，并获取其返回受影响的记录数。
`void`	`endTrans(self.micromagic.eterna.model.AppData appData, boolean success)` 结束一个事务。
`void`	`endTrans(boolean success)` 结束一个事务。
`Connection`	`getConnection(boolean needTrans)` 获取一个当前应用的数据库连接。
`Connection`	`getConnection(String dsId)` 获取一个数据库连接。
`Connection`	`getConnection(String dsId, boolean needTrans)` 获取一个数据库连接。
`long`	`getDataBaseTime()` 获取数据库的时间。
`long`	`getDataBaseTime(String dsId)` 获取数据库的时间。
`static DataSource`	`getDataSource(String dsId)` 获取一个数据源。
`String`	`getDataSourceId(self.micromagic.eterna.share.EternaFactory factory)` 获取设置的数据源id。
`static String`	`getDefaultDataSourceId()` 获取默认的数据源id。
`void`	`lock(String name)` 加数据库锁。
`void`	`lock(String name, String dsId)` 加数据库锁。
`<T> T`	`lockAndInvoke(String name, String dsId, Callable<T> callback)` 加上数据库锁并执行回调。
`static SubScript`	`makeRowPermissionSub(IUser user, DataInfo key, int type)` 根据当前的登录用户及数据信息的键值, 获取权限子句.
`static <T> T`	`newTransInvoke(Callable<T> callback)` 强制开始一个新的事务并执行回调函数。
`static <T> T`	`newTransInvoke(String dsId, Callable<T> callback)` 强制开始一个新的事务并执行回调函数。
`void`	`setParams(self.micromagic.eterna.dao.Dao dao, Map<String,?> params, self.micromagic.eterna.model.AppData appData)` 根据一个map设置参数。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - EC_NONE_DB
```
public static final String EC_NONE_DB
```
    错误码, 不存在默认数据源，无法开启集群的定时任务
    
    另请参阅:
    
    常量字段值
  - EC_DB_OTHER
```
public static final String EC_DB_OTHER
```
    错误码, 其他数据库问题。
    
    另请参阅:
    
    常量字段值
  - ATTR_DS_NAME
```
public static final String ATTR_DS_NAME
```
    实体的属性中放置数据源id的名称。
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - DaoService
```
public DaoService()
```
- 方法详细资料
  - lock
```
public void lock(String name,
                 String dsId)
```
    加数据库锁。
    如果是第一次调用此方法会提交之前的事务，因为会先创建表。
    
    参数:
    
    name - 锁的名称
    
    dsId - 数据源
  - lock
```
public void lock(String name)
```
    加数据库锁。
    使用当前应用的数据源加数据库锁。如果是第一次调用此方法会提交之前的事务，因为会先创建表。
    
    参数:
    
    name - 锁的名称
    
    从以下版本开始:
    
    1.7.58
  - lockAndInvoke
```
public <T> T lockAndInvoke(String name,
                           String dsId,
                           Callable<T> callback)
```
    加上数据库锁并执行回调。
    这里使用了新的事务，不会影响之前的事务。如果之后的操作使用的数据源与加锁的数据源相同，那么这些操作将会在新的事务上执行。
    
    类型参数:
    
    T - 返回类型
    
    参数:
    
    name - 锁的名称
    
    dsId - 数据源
    
    callback - 回调函数
    
    返回:
    
    返回值
    
    从以下版本开始:
    
    1.9.7.B207
  - getDataBaseTime
```
public long getDataBaseTime(String dsId)
```
    获取数据库的时间。
    
    参数:
    
    dsId - 数据源
    
    返回:
    
    long
  - getDataBaseTime
```
public long getDataBaseTime()
```
    获取数据库的时间。
    使用当前应用的数据源获取数据库的时间。
    
    返回:
    
    long
  - doQuery
```
public self.micromagic.eterna.dao.ResultIterator doQuery(self.micromagic.eterna.dao.Query query,
                                                         self.micromagic.eterna.model.AppData appData)
```
    执行一个query，并获取其返回结果。
    
    参数:
    
    query - 查询对象
    
    appData - 线程变量
    
    返回:
    
    结果
  - doUpdate
```
public int doUpdate(self.micromagic.eterna.dao.Update update,
                    self.micromagic.eterna.model.AppData appData)
```
    执行一个update，并获取其返回受影响的记录数。
    
    参数:
    
    update - 更新对象
    
    appData - 线程变量
    
    返回:
    
    结果
  - newTransInvoke
```
public static <T> T newTransInvoke(Callable<T> callback)
```
    强制开始一个新的事务并执行回调函数。
    
    类型参数:
    
    T - 返回类型
    
    参数:
    
    callback - 回调对象
    
    返回:
    
    回调对象的返回值
    
    从以下版本开始:
    
    1.6.53
  - newTransInvoke
```
public static <T> T newTransInvoke(String dsId,
                                   Callable<T> callback)
```
    强制开始一个新的事务并执行回调函数。
    
    类型参数:
    
    T - 返回类型
    
    参数:
    
    dsId - 数据源的id
    
    callback - 回调对象
    
    返回:
    
    回调对象的返回值
    
    从以下版本开始:
    
    1.6.53
  - beginTrans
```
@Deprecated
public boolean beginTrans(String dsId)
```
    已过时。请使用getConnection(String, boolean)
    
    开启一个事务。
    
    参数:
    
    dsId - 数据源的id
    
    返回:
    
    是否开启成功，如果已有事务开启则返回false
  - endTrans
```
public void endTrans(self.micromagic.eterna.model.AppData appData,
                     boolean success)
```
    结束一个事务。
    
    参数:
    
    appData - 线程变量
    
    success - true则进行提交，false则进行回滚
    
    从以下版本开始:
    
    1.8.0.B74
  - endTrans
```
public void endTrans(boolean success)
```
    结束一个事务。
    
    参数:
    
    success - true则进行提交，false则进行回滚
  - getConnection
```
public Connection getConnection(boolean needTrans)
                         throws SQLException
```
    获取一个当前应用的数据库连接。
    
    参数:
    
    needTrans - 是否需要开启事务
    
    返回:
    
    conn
    
    抛出:
    
    SQLException - err
  - getConnection
```
public Connection getConnection(String dsId,
                                boolean needTrans)
                         throws SQLException
```
    获取一个数据库连接。
    
    参数:
    
    dsId - 数据源的id
    
    needTrans - 是否需要开启事务
    
    返回:
    
    conn
    
    抛出:
    
    SQLException - err
  - getConnection
```
public Connection getConnection(String dsId)
                         throws SQLException
```
    获取一个数据库连接。
    注：通过此方式创建的数据库连接默认是不带事务的，除非之前已创建了带事务的连接。
    
    参数:
    
    dsId - 数据源的id
    
    返回:
    
    conn
    
    抛出:
    
    SQLException - err
  - getDataSourceId
```
public String getDataSourceId(self.micromagic.eterna.share.EternaFactory factory)
```
    获取设置的数据源id。
    
    参数:
    
    factory - 工厂
    
    返回:
    
    string
  - getDataSource
```
public static DataSource getDataSource(String dsId)
```
    获取一个数据源。
    注：如果通过这个数据源创建的数据库连接需要自行关闭。
    
    参数:
    
    dsId - 数据源的id
    
    返回:
    
    ds
    
    从以下版本开始:
    
    1.8.2.B76
  - getDefaultDataSourceId
```
public static String getDefaultDataSourceId()
```
    获取默认的数据源id。
    
    返回:
    
    string
  - makeRowPermissionSub
```
public static SubScript makeRowPermissionSub(IUser user,
                                             DataInfo key,
                                             int type)
```
    根据当前的登录用户及数据信息的键值, 获取权限子句.
    如果用户没有权限则返回null.
    
    参数:
    
    user - 当前登录的用户
    
    key - 数据信息的键值
    
    type - 行权限因子的类型
    
    返回:
    
    子句对象, 没有任何行权限时返回null
    
    从以下版本开始:
    
    1.8.83.B159
  - setParams
```
public void setParams(self.micromagic.eterna.dao.Dao dao,
                      Map<String,?> params,
                      self.micromagic.eterna.model.AppData appData)
```
    根据一个map设置参数。
    
    参数:
    
    dao - 数据操作对象
    
    params - 参数
    
    appData - 线程变量
  - doQueryWithEnv
```
public self.micromagic.eterna.dao.ResultIterator doQueryWithEnv(DaoParam param,
                                                                self.micromagic.eterna.dao.Query query,
                                                                self.micromagic.eterna.model.AppData appData)
```
    执行查询，在需要获取所有行时根据配置带上环境。
    
    参数:
    
    param - 参数
    
    query - 查询对象
    
    appData - 线程变量
    
    返回:
    
    结果

类 DaoService

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

EC_NONE_DB

EC_DB_OTHER

ATTR_DS_NAME

构造器详细资料

DaoService

方法详细资料

lock

lock

lockAndInvoke

getDataBaseTime

getDataBaseTime

doQuery

doUpdate

newTransInvoke

newTransInvoke

beginTrans

endTrans

endTrans

getConnection

getConnection

getConnection

getDataSourceId

getDataSource

getDefaultDataSourceId

makeRowPermissionSub

setParams

doQueryWithEnv