# com.eos.foundation.database.DatabaseUtil

# 构件包说明

本工具类实现了基本的数据库操作。

# 运算逻辑构件使用说明

该构件包包含以下构件：

注意

下列方法中的参数dsName，是指当前构件包中的contribution.eosinf文件中在module name="DataSource"的节点下配置的构件包引用数据源名称。如：

<module name="DataSource">
    <group name="Reference">
        <configValue key="default">default</configValue>
    </group>
</module>

这是每个构件包默认就会有的配置，表示构件包中有个别名为default（这个default是<configValue>中的key的属性值）的数据源，它引用的是user-config.xml中配置的default（这个default是<configValue>的节点值）的数据源。下面所列的运算逻辑中的参数dsName，应该传入的是<configValue>中的key的属性值，而不是在user-config.xml中配置的数据源的名字。

下面所列的运算逻辑源代码演示示例时，涉及到数据库中的CUST表。因此请确认数据库中是否存在CUST表，如果不存在，请先通过数据模型com.primeton.eos.foundation.example.data.datasetx生成CUST表，再做示例演示。

序号	方法	功能描述
1	count(String dsName, DataObject criteriaEntity)	根据查询实体条件统计记录数
2	countByTemplate(String dsName, DataObject template)	根据SDO数据模板条件统计记录数
3	deleteByCriteriaEntity(String dsName, DataObject criteriaEntity)	根据查询条件实体删除记录，查询条件不能为空，如果为空将返回异常
4	deleteByTemplate(String dsName, DataObject template)	根据SDO数据模板查询条件删除记录，查询条件不能为空，如果为空将返回异常
5	deleteEntity(String dsName, DataObject dataObject)	根据主键删除一条记录
6	deleteEntityBatch(String dsName, DataObject[] dataObjects)	根据主键批量删除多条记录
7	expandEntitiesRelation(String dsName, DataObject[] dataObjects, String property)	扩展一个数据实体数组中每个实体对象的一个关联属性（如对一个懒加载的属性），会进行数据库的查询
8	expandEntity(String dsName, DataObject dataObject)	根据主键扩展查询一条记录，如果dataobject中有非主键的属性值，将根据主键查询出来覆盖原来的属性
9	expandEntityByCriteriaEntity(String dsName, DataObject criteria, DataObject dataObject)	根据查询条件实体的查询结果扩展一个实体
10	expandEntityByTemplate(String dsName, DataObject template, DataObject dataObject)	根据查询模板的查询结果扩展一个实体
11	expandEntityWithLock(String dsName, DataObject dataObject)	根据主键扩展记录，并且将当前记录锁定，如果dataobject中有非主键的属性值，将根据主键查询出来覆盖原来的属性
12	expandLobProperty(String dsName, DataObject entity, String lobPropertyNames)	获取实体的lob属性对应的值
13	expandRelation(String dsName, DataObject dataObject, String property)	扩展一个数据实体对象的一个关联属性（如对一个懒加载的属性），会进行数据库的查询
14	getRelationEntities(String dsName, DataObject dataObject, String property)	根据数据实体对象的关联属性获得关联实体对象数组，返回关联实体对象如果是多对一或一对一关联关系时，将关联的实体对象构造为数组返回；如果是一对多关联关系时，返回关联的实体对象数组
15	getRelationEntity(String dsName, DataObject dataObject, String property)	根据数据实体对象的关联属性获得关联实体对象，返回关联实体对象如果是多对一或一对一关联关系时，返回关联的实体对象；如果是一对多关联关系时，返回关联的实体对象的第一个对象值
16	insertEntity(String dsName, DataObject dataObject)	插入一条记录
17	insertEntityBatch(String dsName, DataObject[] dataObjects)	批量插入记录
18	queryEntitiesByCriteriaEntity(String dsName, DataObject criteriaEntity)	根据查询条件实体查询所有记录，根据查询条件实体指定查询Entity的字段
19	queryEntitiesByCriteriaEntity(String dsName, DataObject criteriaEntity, int begin, int length)	根据查询条件实体查询部分记录，根据查询条件实体指定查询Entity的字段
20	queryEntitiesByTemplate(String dsName, DataObject template)	根据SDO数据模板查询条件查询所有记录，会查询Entity的所有字段
21	queryEntitiesByTemplate(String dsName, DataObject template, int begin, int length)	根据SDO数据模板查询条件查询部分记录，会查询Entity的部分字段
22	saveEntities(String dsName, DataObject[] dataObjects)	保存多条记录
23	saveEntity(String dsName, DataObject dataObject)	保存一条记录
24	updateEntity(String dsName, DataObject dataObject)	更新一条记录
25	updateEntityBatch(String dsName, DataObject[] dataObjects)	批量更新记录
26	updateEntityByCriteriaEntity(String dsName, DataObject value, DataObject criteriaEntity)	根据criteria entity查询条件更新记录
27	updateEntityByTemplate(String dsName, DataObject value, DataObject template)	根据SDO数据模板查询条件更新记录

# count：根据查询条件实体条件统计记录数

# 【功能说明】

根据查询条件实体条件统计记录数。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.count，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	criteriaEntity	DataObject	查询条件实体
返回值	out0	int	记录数

抛出异常说明统计记录出错时抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明关于查询条件实体的说明请参考《EOS基础参考手册》中的"数据服务\CriteriaEntity"。

# 【参考案例】

示例：根据CUST表查询条件统计查询结果总记录数。

场景描述用户维护CUST表，在通过查询条件实体对CUST查询操作时，根据条件进行统计CUST记录。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	criteriaEntity	DataObject	criteria	变量	传引用
返回值	out0	int	count	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是查询实体criteriaEntity
- 返回值是根据查询条件实体条件统计的记录数
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteria __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __id="2" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __id="3" __index="0" __type="sdo:com.primeton.das.criteria.exprType">
                    <_op __type="java:java.lang.String">in</_op>
                    <_min/>
                    <_max/>
                    <_likeRule/>
                    <_dateRule/>
                    <_pattern/>
                    <_year/>
                    <_quarter/>
                    <_month/>
                    <_opProperty/>
                    <_ref/>
                    <_processNullValue/>
                    <CUSTID __type="java:java.lang.String">2,3</CUSTID>
                </__entry>
            </_expr>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteria>
    </__root>
</bizContext>

等效的SQL语句

select count(*)  from CUST where CUSTID in (2,3)

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <count __type="java:java.lang.Integer">2</count>
        <criteria __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __id="2" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __id="3" __index="0" __type="sdo:com.primeton.das.criteria.exprType">
                    <_op __type="java:java.lang.String">in</_op>
                    <_min/>
                    <_max/>
                    <_likeRule/>
                    <_dateRule/>
                    <_pattern/>
                    <_year/>
                    <_quarter/>
                    <_month/>
                    <_opProperty/>
                    <_ref/>
                    <_processNullValue/>
                    <CUSTID __type="java:java.lang.String">2,3</CUSTID>
                </__entry>
            </_expr>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteria>
    </__root>
</bizContext>

# countByTemplate：根据SDO数据模板查询条件统计记录数

# 【功能说明】

根据SDO数据模板查询条件统计记录数。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.countByTemplate，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	template	DataObject	SDO数据模板查询条件
返回值	out0	int	记录数

抛出异常说明统计记录出错时抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：根据CUST模板统计查询结果总记录数。

场景描述用户维护CUST表，根据CUST数据模板作为查询条件进行统计操作，如果模板中的对象都为空条件，则统计所有记录。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	template	DataObject	template	变量	传引用
返回值	out0	int	count	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是查询实体criteriaEntity
- 返回值是根据SDO数据模板查询条件统计的记录数
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <template __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

等效的SQL语句

select count(*) from CUST where BIRTH=to_date('2009-09-09','yyyy-MM-dd')

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <count __type="java:java.lang.Integer">2</count>
        <template __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

# deleteByCriteriaEntity：根据查询条件实体删除记录

# 【功能说明】

根据查询条件实体删除记录，查询条件不能为空，如果为空将返回异常。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.deleteByCriteriaEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	criteriaEntity	DataObject	SDO查询条件实体
返回值	out0	int	删除记录条数

抛出异常说明删除出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明关于查询条件实体的说明请参考《EOS基础参考手册》中的"数据服务\CriteriaEntity"。

# 【参考案例】

示例：根据查询条件实体删除CUST表的数据。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	criteriaEntity	DataObject	criteriaEntity	变量	传引用
返回值	out0	int	result	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是查询实体criteriaEntity
- 返回值是被修改记录返回值
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteriaEntity __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __collection="list"/>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteriaEntity>
    </__root>
</bizContext>

等效的SQL语句

delete from CUST

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteriaEntity __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __collection="list"/>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteriaEntity>
        <result __type="java:java.lang.Integer">2</result>
    </__root>
</bizContext>

# deleteByTemplate：根据SDO数据模板查询条件删除记录

# 【功能说明】

根据SDO数据模板查询条件删除记录，查询条件不能为空，如果为空将返回异常。与deleteEntity不同的是，它可一次删除多条满足条件的记录。所有操作隶属于一个原子事务。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.deleteByTemplate，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	template	DataObject	SDO数据模板（不一定需要主键字段，该构件可以删除所有满足条件的记录）
返回值	out0	int	删除的记录条数

抛出异常说明删除出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：根据查询模板从CUST表中删除记录。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	template	DataObject	template	变量	传引用
返回值	out0	int	result	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO数据模板，这里作为删除条件的数据模板
- 返回值是根据数据模板条件删除的记录数
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <template __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">4</CUSTID>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

等效的SQL语句

delete from CUST where CUSTID=4;

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <result __type="java:java.lang.Integer">0</result>
        <template __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">4</CUSTID>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

# deleteEntity：根据主键删除一条记录

# 【功能说明】

根据主键删除一条记录，不支持级联操作。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.deleteEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObject	DataObject	SDO对象（必须包含主键字段）

抛出异常说明删除出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：从CUST表中删除一条记录。

场景描述用户维护CUST表，选择一条CUST记录根据主键执行删除操作。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObject	DataObject	cust	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO对象cust
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">1</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
            <CUSTNAME/>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </cust>
    </__root>
</bizContext>

等效的SQL语句

delete from CUST where CUSTID=1 and CUSTCODE='cust_1'

调用后的bizContext 同调用前。

# deleteEntityBatch：删除多条记录

# 【功能说明】

用来删除多条记录，所有操作隶属于一个原子事务。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.deleteEntityBatch，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObjects	DataObject[]	SDO对象数组

抛出异常说明删除出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：在CUST表中删除多条记录。

场景描述用户维护CUST表，根据记录主键批量删除多条CUST记录，并保证删除操作在一个事务里完成。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObjects	DataObject[]	custes	变量	传引用

参数描述
- 第一个参数为数据源名称，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO对象数组custes
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
             __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">2</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
                <CUSTNAME/>
                <BIRTH/>
                <SEX/>
                <ADDRESS/>
                <PHOTO/>
            </__entry>
            <__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">3</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
                <CUSTNAME/>
                <BIRTH/>
                <SEX/>
                <ADDRESS/>
                <PHOTO/>
            </__entry>
        </custes>
    </__root>
</bizContext>

等效的SQL语句

delete from CUST where CUSTID=2 and CUSTCODE='cust_2'
delete from CUST where CUSTID=3 and CUSTCODE='cust_3'

调用后的bizContext 同调用前。

# expandEntitiesRelation：扩展一个数据实体数组中每个实体对象的一个关联属性

# 【功能说明】

扩展一个数据实体数组中每个实体对象的一个关联属性（如对一个懒加载的属性），会进行数据库的查询。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.expandEntitesRelation，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObjects	DataObject[]	SDO对象
参数	property	String	属性名

抛出异常说明如果属性名对应的不是一个关联属性，则抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：对O_OPERATOR表的多条记录的O_OPERATORS关联属性进行扩展查询。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObjects	DataObject[]	expandOrgs	变量	传引用
参数	property	String	O_OPERATORS	常量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是一个扩展的查询实体数组
- 第三个参数是扩展实体中的一个属性
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <expandOrgs __id="1" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
             __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
                <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
                <PARENT_ORG_ID/>
                <ORG_NAME/>
                <ORG_CODE/>
                <ORG_ADDRESS/>
                <ORG_SEQ/>
                <O_OPERATORS __collection="list"/>
            </__entry>
            <__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
                <ORG_ID __type="java:java.lang.Long">2</ORG_ID>
                <PARENT_ORG_ID/>
                <ORG_NAME/>
                <ORG_CODE/>
                <ORG_ADDRESS/>
                <ORG_SEQ/>
                <O_OPERATORS __collection="list"/>
            </__entry>
        </expandOrgs>
    </__root>
</bizContext>

等效的SQL语句

select ORG_ID, OPERATOR_ID, USER_ID, USER_NAME, BIRTHDAY, GENDER, POSTCODE, ADDRESS, PHONE, EMAIL, MEMO
 from O_OPERATOR where ORG_ID=1
select ORG_ID, OPERATOR_ID, USER_ID, USER_NAME, BIRTHDAY, GENDER, POSTCODE, ADDRESS, PHONE, EMAIL, MEMO
 from O_OPERATOR where ORG_ID=2

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <expandOrgs __id="1" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
             __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
                <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
                <PARENT_ORG_ID/>
                <ORG_NAME/>
                <ORG_CODE/>
                <ORG_ADDRESS/>
                <ORG_SEQ/>
                <O_OPERATORS __id="4" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                    <__entry __id="6" __index="0" __type="sdo:com.primeton.eos.foundation.example.data
                      .O_OPERATOR">
                        <OPERATOR_ID __type="java:java.lang.Long">1</OPERATOR_ID>
                        <USER_ID __isNullOrEmpty="null"/>
                        <USER_NAME __type="java:java.lang.String">opeartor_1</USER_NAME>
                        <BIRTHDAY __isNullOrEmpty="null"/>
                        <GENDER __isNullOrEmpty="null"/>
                        <POSTCODE __isNullOrEmpty="null"/>
                        <ADDRESS __isNullOrEmpty="null"/>
                        <PHONE __isNullOrEmpty="null"/>
                        <EMAIL __isNullOrEmpty="null"/>
                        <MEMO __isNullOrEmpty="null"/>
                        <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
                    </__entry>
                    <__entry __id="7" __index="1" __type="sdo:com.primeton.eos.foundation.example.data
                      .O_OPERATOR">
                        <OPERATOR_ID __type="java:java.lang.Long">2</OPERATOR_ID>
                        <USER_ID __isNullOrEmpty="null"/>
                        <USER_NAME __type="java:java.lang.String">opeartor_2</USER_NAME>
                        <BIRTHDAY __isNullOrEmpty="null"/>
                        <GENDER __isNullOrEmpty="null"/>
                        <POSTCODE __isNullOrEmpty="null"/>
                        <ADDRESS __isNullOrEmpty="null"/>
                        <PHONE __isNullOrEmpty="null"/>
                        <EMAIL __isNullOrEmpty="null"/>
                        <MEMO __isNullOrEmpty="null"/>
                        <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
                    </__entry>
                </O_OPERATORS>
            </__entry>
            <__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
                <ORG_ID __type="java:java.lang.Long">2</ORG_ID>
                <PARENT_ORG_ID/>
                <ORG_NAME/>
                <ORG_CODE/>
                <ORG_ADDRESS/>
                <ORG_SEQ/>
                <O_OPERATORS __id="5" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                    <__entry __id="8" __index="0" __type="sdo:com.primeton.eos.foundation.example.data
                      .O_OPERATOR">
                        <OPERATOR_ID __type="java:java.lang.Long">3</OPERATOR_ID>
                        <USER_ID __isNullOrEmpty="null"/>
                        <USER_NAME __type="java:java.lang.String">opeartor_3</USER_NAME>
                        <BIRTHDAY __isNullOrEmpty="null"/>
                        <GENDER __isNullOrEmpty="null"/>
                        <POSTCODE __isNullOrEmpty="null"/>
                        <ADDRESS __isNullOrEmpty="null"/>
                        <PHONE __isNullOrEmpty="null"/>
                        <EMAIL __isNullOrEmpty="null"/>
                        <MEMO __isNullOrEmpty="null"/>
                        <ORG_ID __type="java:java.lang.Long">2</ORG_ID>
                    </__entry>
                </O_OPERATORS>
            </__entry>
        </expandOrgs>
    </__root>
</bizContext>

# expandEntity：根据主键扩展查询一条记录

# 【功能说明】

根据主键扩展查询一条记录，如果dataobject中有非主键的属性值，将根据主键查询出来覆盖原来的属性。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.expandEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObject	DataObject	SDO对象
返回值	out0	int	0：无记录；1：有记录

抛出异常说明查询出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明如果要查询的entity中的主键没有赋值，在单主键下抛异常，多主键下返回空结果。

# 【参考案例】

示例：根据主键对CUST表进行扩展查询。

场景描述用户根据查询条件实体进行查询CUST表，查询操作根据主键进行查询，查询出的结果覆盖其他非主键属性。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObject	DataObject	expandCust	变量	传引用
返回值	out0	int	result	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是查询数据实体
- 返回值是否查到记录
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <expandCust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">1</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
            <CUSTNAME/>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </expandCust>
    </__root>
</bizContext>

等效的SQL语句

select CUSTID, CUSTCODE, CUSTNAME, BIRTH, SEX, ADDRESS from CUST where CUSTID=1 and CUSTCODE='cust_1';

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <expandCust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">1</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
            <CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
            <BIRTH __type="java:java.sql.Date">2009-09-12</BIRTH>
            <SEX __type="java:java.lang.String">1</SEX>
            <ADDRESS __isNullOrEmpty="null"/>
            <PHOTO __isNullOrEmpty="null"/>
        </expandCust>
        <result __type="java:java.lang.Integer">1</result>
    </__root>
</bizContext>

# expandEntityByCriteriaEntity：根据查询条件实体的查询结果扩展一个实体

# 【功能说明】

如果查询出来有一条记录，返回1，并使用查询出来的结果扩展要扩展的实体；如果没有查询出来记录，返回0，不操作要扩展的实体；如果查询出来多条记录，返回-1，并使用查询出来的第一个结果扩展要扩展的实体。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.expandEntityByCriteriaEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	criteriaEntity	DataObject	查询条件实体
参数	dataObject	DataObject	要扩展的实体
返回值	out0	int	满足查询条件的记录数

抛出异常说明插入出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：根据条件扩展一个CUST实体。

场景描述根据条件扩展一个CUST实体。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	criteriaEntity	DataObject	criteria	变量	传引用
参数	dataObject	DataObject	entity	变量	传引用
返回值	out0	int	count	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是第二个参数是查询实体criteria
- 第三个参数是要扩展的实体
- 第四个参数是满足查询模板条件的记录数
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteria __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity
__type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
            <_expr __collection="list" __collectionid="3" __id="4" __index="0"
__type="sdo:com.primeton.das.criteria.exprType">
                <_op/>
                <_min/>
                <_max/>
                <_likeRule/>
                <_dateRule/>
                <_pattern/>
                <_year/>
                <_quarter/>
                <_month/>
                <_opProperty/>
                <_ref/>
                <_processNullValue/>
                <_property/>
                <_value/>
                <CUSTID __type="java:java.lang.Integer">2</CUSTID>
            </_expr>
        </criteria>
        <entity __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </entity>
    </__root>
</bizContext>

等效的SQL语句

select * from CUST where CUSTID = 2

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <count __type="java:java.lang.Integer">1</count>
        <criteria __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity
__type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
            <_expr __collection="list" __collectionid="3" __id="4" __index="0"
__type="sdo:com.primeton.das.criteria.exprType">
                <_op/>
                <_min/>
                <_max/>
                <_likeRule/>
                <_dateRule/>
                <_pattern/>
                <_year/>
                <_quarter/>
                <_month/>
                <_opProperty/>
                <_ref/>
                <_processNullValue/>
                <_property/>
                <_value/>
                <CUSTID __type="java:java.lang.Integer">2</CUSTID>
            </_expr>
        </criteria>
        <entity __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">2</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
            <CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
            <BIRTH __type="java:java.sql.Date">2009-09-09</BIRTH>
            <SEX __isNullOrEmpty="null"/>
            <ADDRESS __isNullOrEmpty="null"/>
            <PHOTO __isNullOrEmpty="null"/>
        </entity>
    </__root>
</bizContext>

# expandEntityByTemplate：根据查询模板的查询结果扩展一个实体

# 【功能说明】

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.expandEntityByTemplate，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	template	DataObject	查询模板
参数	dataObject	DataObject	要扩展的实体
返回值	out0	int	满足查询模板条件的记录数

抛出异常说明插入出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：根据条件扩展一个CUST实体。

场景描述根据条件扩展一个CUST实体。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	template	DataObject	template	变量	传引用
参数	dataObject	DataObject	entity	变量	传引用
返回值	out0	int	count	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO数据模板，这里作为查询条件的数据模板
- 第三个参数是要扩展的实体
- 第四个参数是满足查询模板条件的记录数
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <entity __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </entity>
        <template __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">2</CUSTID>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

等效的SQL语句

select * from CUST where CUSTID = 2

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <count __type="java:java.lang.Integer">1</count>
        <entity __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">2</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
            <CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
            <BIRTH __type="java:java.sql.Date">2009-09-09</BIRTH>
            <SEX __isNullOrEmpty="null"/>
            <ADDRESS __isNullOrEmpty="null"/>
            <PHOTO __isNullOrEmpty="null"/>
        </entity>
        <template __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">2</CUSTID>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

# expandEntityWithLock：根据主键扩展记录并锁定

# 【功能说明】

根据主键扩展记录，并为当前记录添加事务锁。如果dataobject中有非主键的属性值，将根据主键查询出来覆盖原来的属性。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.expandEntityWithLock，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObject	DataObject	SDO对象

抛出异常说明查询出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：扩展查询CUST表并添加行锁。

场景描述用户维护CUST表，根据主键CUSTID查询一个记录并为该记录添加事务锁。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObject	DataObject	expandCust	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是查询实体对象，查询条件中必须包含主键属性
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <expandCust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">1</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
            <CUSTNAME/>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </expandCust>
    </__root>
</bizContext>

等效的SQL语句

select CUSTID, CUSTCODE, CUSTNAME, BIRTH, SEX, ADDRESS from CUST where CUSTID=1 and CUSTCODE='cust_1'
 for update;

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <expandCust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">1</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
            <CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
            <BIRTH __type="java:java.sql.Date">2009-09-12</BIRTH>
            <SEX __type="java:java.lang.String">1</SEX>
            <ADDRESS __isNullOrEmpty="null"/>
            <PHOTO __isNullOrEmpty="null"/>
        </expandCust>
    </__root>
</bizContext>

# expandLobProperty：获取实体的lob属性对应的值

# 【功能说明】

从数据库中查询取得的实体，如果有lob字段，而且是懒加载模式，则lob字段的值是不可见的，调用此方法，可以获取实体的lob属性对应的值。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.expandLobProperty，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	entity	DataObject	实体
参数	lobPropertyNames	String	lob属性的名称，多个名称之间用","分割。

规则说明无。

# 【参考案例】

示例：取得FIFE表的FILE（BLOB类型）属性值。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	entity	DataObject	fileList[1]	变量	传引用
参数	lobPropertyNames	String	FILE	常量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是取得一个数据实体
- 第三个参数是lob属性的名称
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <file __id="1" __type="sdo:foundation.database.DatabaseUtil.lob.FILE">
            <ID/>
            <NAME/>
            <FILE/>
        </file>
        <fileList __id="2" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="3" __index="0" __type="sdo:foundation
              .database.DatabaseUtil.lob.FILE">
                <ID __type="java:java.math.BigDecimal">123</ID>
                <NAME __type="java:java.lang.String">公司</NAME>
                <FILE/>
            </__entry>
        </fileList>
    </__root>
</bizContext>

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <file __id="1" __type="sdo:foundation.database.DatabaseUtil.lob.FILE">
            <ID/>
            <NAME/>
            <FILE/>
        </file>
        <fileList __id="2" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="3" __index="0" __type="sdo:foundation
              .database.DatabaseUtil.lob.FILE">
                <ID __type="java:java.math.BigDecimal">123</ID>
                <NAME __type="java:java.lang.String">公司</NAME>
                <FILE __collection="array" __hexString="true" __id="4" __type="java:byte">C4E3BAC3A3A1</FILE>
            </__entry>
        </fileList>
    </__root>
</bizContext>

# expandRelation：扩展一个数据实体对象的一个关联属性

# 【功能说明】

扩展一个数据实体对象的一个关联属性（如对一个懒加载的属性），会进行数据库的查询。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.expandRelation，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObject	DataObject	SDO对象
参数	property	String	关联属性名

抛出异常说明如果属性名对应的不是一个关联属性，则抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：由于实际业务中有可能根据性能要求，考虑把某个实体的复杂属性进行延时加载。此时就可以使用expandRelation进行二次扩展查询。数据实体之间是单向1：n关联关系。实体关系如下图所示。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObject	DataObject	expandOrg	变量	传引用
参数	property	String	O_OPERATORS	常量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是查询实体对象
- 第三个参数是查询数据实体扩展的一个属性实体对象
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <expandOrg __id="1" __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
            <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
            <PARENT_ORG_ID/>
            <ORG_NAME/>
            <ORG_CODE/>
            <ORG_ADDRESS/>
            <ORG_SEQ/>
            <O_OPERATORS __collection="list"/>
        </expandOrg>
    </__root>
</bizContext>

等效的SQL语句

select ORG_ID, OPERATOR_ID, USER_ID, USER_NAME, BIRTHDAY, GENDER, POSTCODE, ADDRESS, PHONE, EMAIL, MEMO
 from O_OPERATOR where ORG_ID=1

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <expandOrg __id="1" __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
            <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
            <PARENT_ORG_ID/>
            <ORG_NAME/>
            <ORG_CODE/>
            <ORG_ADDRESS/>
            <ORG_SEQ/>
            <O_OPERATORS __id="2" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __id="3" __index="0" __type="sdo:com.primeton.eos.foundation.example.data.O_OPERATOR">
                    <OPERATOR_ID __type="java:java.lang.Long">1</OPERATOR_ID>
                    <USER_ID __isNullOrEmpty="null"/>
                    <USER_NAME __type="java:java.lang.String">opeartor_1</USER_NAME>
                    <BIRTHDAY __isNullOrEmpty="null"/>
                    <GENDER __isNullOrEmpty="null"/>
                    <POSTCODE __isNullOrEmpty="null"/>
                    <ADDRESS __isNullOrEmpty="null"/>
                    <PHONE __isNullOrEmpty="null"/>
                    <EMAIL __isNullOrEmpty="null"/>
                    <MEMO __isNullOrEmpty="null"/>
                    <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
                </__entry>
                <__entry __id="4" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.O_OPERATOR">
                    <OPERATOR_ID __type="java:java.lang.Long">2</OPERATOR_ID>
                    <USER_ID __isNullOrEmpty="null"/>
                    <USER_NAME __type="java:java.lang.String">opeartor_2</USER_NAME>
                    <BIRTHDAY __isNullOrEmpty="null"/>
                    <GENDER __isNullOrEmpty="null"/>
                    <POSTCODE __isNullOrEmpty="null"/>
                    <ADDRESS __isNullOrEmpty="null"/>
                    <PHONE __isNullOrEmpty="null"/>
                    <EMAIL __isNullOrEmpty="null"/>
                    <MEMO __isNullOrEmpty="null"/>
                    <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
                </__entry>
            </O_OPERATORS>
        </expandOrg>
    </__root>
</bizContext>

# getRelationEntities：根据数据实体对象的关联属性获得关联实体对象数组

# 【功能说明】

根据数据实体对象的关联属性获得关联实体对象数组，返回关联实体对象如果是多对一或一对一关联关系时，将关联的实体对象构造为数组返回；如果是一对多关联关系时，返回关联的实体对象数组。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.getRelationEntities，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObject	DataObject	SDO对象
参数	property	String	属性名
返回值	out0	DataObject[]	关联实体对象数组

抛出异常说明如果属性名对应的不是一个关联属性，则抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：根据组织信息查询属于该组织的所有操作员信息。实体关系图如下：

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObject	DataObject	org	变量	传引用
参数	property	String	O_OPERATORS	变量	传引用
返回值	out0	DataObject[]	result	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是查询实体对象
- 第三个参数是扩展实体中的一个属性名称
- 返回值是查询实体关联查询结果实体对象数组
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <org __id="1" __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
            <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
            <PARENT_ORG_ID/>
            <ORG_NAME/>
            <ORG_CODE/>
            <ORG_ADDRESS/>
            <ORG_SEQ/>
            <O_OPERATORS __collection="list"/>
        </org>
    </__root>
</bizContext>

等效的SQL语句

select ORG_ID, OPERATOR_ID, USER_ID, USER_NAME, BIRTHDAY, GENDER, POSTCODE, ADDRESS, PHONE, EMAIL, MEMO
 from O_OPERATOR where ORG_ID=1

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <org __id="1" __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
            <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
            <PARENT_ORG_ID/>
            <ORG_NAME/>
            <ORG_CODE/>
            <ORG_ADDRESS/>
            <ORG_SEQ/>
            <O_OPERATORS __id="3" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __index="0" __refid="4"/>
                <__entry __index="1" __refid="5"/>
            </O_OPERATORS>
        </org>
        <result __id="2" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="4" __index="0"
             __type="sdo:com.primeton.eos.foundation.example.data.O_OPERATOR">
                <OPERATOR_ID __type="java:java.lang.Long">1</OPERATOR_ID>
                <USER_ID __isNullOrEmpty="null"/>
                <USER_NAME __type="java:java.lang.String">opeartor_1</USER_NAME>
                <BIRTHDAY __isNullOrEmpty="null"/>
                <GENDER __isNullOrEmpty="null"/>
                <POSTCODE __isNullOrEmpty="null"/>
                <ADDRESS __isNullOrEmpty="null"/>
                <PHONE __isNullOrEmpty="null"/>
                <EMAIL __isNullOrEmpty="null"/>
                <MEMO __isNullOrEmpty="null"/>
                <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
            </__entry>
            <__entry __id="5" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.O_OPERATOR">
                <OPERATOR_ID __type="java:java.lang.Long">2</OPERATOR_ID>
                <USER_ID __isNullOrEmpty="null"/>
                <USER_NAME __type="java:java.lang.String">opeartor_2</USER_NAME>
                <BIRTHDAY __isNullOrEmpty="null"/>
                <GENDER __isNullOrEmpty="null"/>
                <POSTCODE __isNullOrEmpty="null"/>
                <ADDRESS __isNullOrEmpty="null"/>
                <PHONE __isNullOrEmpty="null"/>
                <EMAIL __isNullOrEmpty="null"/>
                <MEMO __isNullOrEmpty="null"/>
                <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
            </__entry>
        </result>
    </__root>
</bizContext>

# getRelationEntity：根据数据实体对象的关联属性获得关联实体对象

# 【功能说明】

根据数据实体对象的关联属性获得关联实体对象，返回关联实体对象如果是多对一或一对一关联关系时，返回关联的实体对象；如果是一对多关联关系时，返回关联的实体对象的第一个对象值。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.getRelationEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObject	DataObject	SDO对象
参数	property	String	关联属性名
返回值	out0	DataObject	关联实体对象

抛出异常说明如果属性名对应的不是一个关联属性，则抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：本案例用来根据某一ORG信息获取对应的第一个OPERATOR的信息。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObject	DataObject	org	变量	传引用
参数	property	String	O_OPERATORS	变量	传引用
返回值	out0	DataObject	result	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是一个扩展的查询实体
- 第三个参数是扩展实体中的一个属性
- 返回值是查询实体关联查询结果实体
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <org __id="1" __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
            <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
            <PARENT_ORG_ID/>
            <ORG_NAME/>
            <ORG_CODE/>
            <ORG_ADDRESS/>
            <ORG_SEQ/>
            <O_OPERATORS __collection="list"/>
        </org>
    </__root>
</bizContext>

等效的SQL语句

select ORG_ID, OPERATOR_ID, USER_ID, USER_NAME, BIRTHDAY, GENDER, POSTCODE, ADDRESS, PHONE, EMAIL, MEMO
 from O_OPERATOR where ORG_ID=1

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <org __id="1" __type="sdo:com.primeton.eos.foundation.example.data.O_ORG">
            <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
            <PARENT_ORG_ID/>
            <ORG_NAME/>
            <ORG_CODE/>
            <ORG_ADDRESS/>
            <ORG_SEQ/>
            <O_OPERATORS __id="3" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __index="0" __refid="2"/>
                <__entry __id="4" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.O_OPERATOR">
                    <OPERATOR_ID __type="java:java.lang.Long">2</OPERATOR_ID>
                    <USER_ID __isNullOrEmpty="null"/>
                    <USER_NAME __type="java:java.lang.String">opeartor_2</USER_NAME>
                    <BIRTHDAY __isNullOrEmpty="null"/>
                    <GENDER __isNullOrEmpty="null"/>
                    <POSTCODE __isNullOrEmpty="null"/>
                    <ADDRESS __isNullOrEmpty="null"/>
                    <PHONE __isNullOrEmpty="null"/>
                    <EMAIL __isNullOrEmpty="null"/>
                    <MEMO __isNullOrEmpty="null"/>
                    <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
                </__entry>
            </O_OPERATORS>
        </org>
        <result __id="2" __type="sdo:com.primeton.eos.foundation.example.data.O_OPERATOR">
            <OPERATOR_ID __type="java:java.lang.Long">1</OPERATOR_ID>
            <USER_ID __isNullOrEmpty="null"/>
            <USER_NAME __type="java:java.lang.String">opeartor_1</USER_NAME>
            <BIRTHDAY __isNullOrEmpty="null"/>
            <GENDER __isNullOrEmpty="null"/>
            <POSTCODE __isNullOrEmpty="null"/>
            <ADDRESS __isNullOrEmpty="null"/>
            <PHONE __isNullOrEmpty="null"/>
            <EMAIL __isNullOrEmpty="null"/>
            <MEMO __isNullOrEmpty="null"/>
            <ORG_ID __type="java:java.lang.Long">1</ORG_ID>
        </result>
    </__root>
</bizContext>

# insertEntity：插入一条记录

# 【功能说明】

用来把一个SDO对象的值保存到数据库相应的实体表中。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.insertEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObject	DataObject	SDO对象

抛出异常说明插入出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：在CUST表中新增一条记录。

场景描述用户新增一条CUST记录。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObject	DataObject	cust	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO对象数据实体cust
其他说明

无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">1</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
            <CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
            <BIRTH __type="java:java.util.Date">2009-09-12 00:00:00</BIRTH>
            <SEX __type="java:java.lang.String">1</SEX>
            <ADDRESS/>
            <PHOTO/>
        </cust>
    </__root>
</bizContext>

等效的SQL语句

insert into CUST (CUSTNAME, BIRTH, SEX, CUSTID, CUSTCODE) values ('cust_1', to_date('2009-09-12','yyyy-MM-dd'),
                                                                  '1', 1, 'cust_1')

调用后的bizContext 同调用前。

# insertEntityBatch：插入多条记录

# 【功能说明】

用来把一个SDO对象数组的值保存到数据库相应的实体表中，所有操作隶属于一个原子事务。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.insertEntityBatch，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObjects	DataObject[]	SDO数组

抛出异常说明插入出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：在CUST表中新增多条记录。

场景描述用户使用Datacell维护CUST表的内容。用户操作新增多条CUST数据。该场景下可以用insertEntityBatch实现多条记录的插入。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObjects	DataObject[]	custes	变量	传引用

参数描述
- 第一个参数为数据源名称，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO对象数组custes
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
             __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">2</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
                <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
                <SEX/>
                <ADDRESS/>
                <PHOTO/>
            </__entry>
            <__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">3</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_3</CUSTNAME>
                <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
                <SEX/>
                <ADDRESS/>
                <PHOTO/>
            </__entry>
        </custes>
    </__root>
</bizContext>

等效的SQL语句

insert into CUST (CUSTNAME, BIRTH, CUSTID, CUSTCODE) values ('cust_2', to_date('2009-09-09','yyyy-MM-dd'),
                                                                   2, 'cust_2');
insert into CUST (CUSTNAME, BIRTH, CUSTID, CUSTCODE) values ('cust_3', to_date('2009-09-09','yyyy-MM-dd'),
                                                                   3, 'cust_3');

调用后的bizContext 同调用前。

# queryEntitiesByCriteriaEntity：根据查询条件实体查询所有记录

# 【功能说明】

根据查询条件实体查询所有记录，根据查询条件实体指定查询Entity的字段。如果实体包含关联实体，并且关联关系连线上没有设置为延时加载，那么同时也会把关联实体的数据查询出来。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.queryEntitiesByCriteriaEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	criteriaEntity	DataObject	查询条件实体
返回值	out0	DataObject[]	符合查询条件的所有结果

抛出异常说明查询出错时抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明关于查询条件实体的说明请参考《EOS基础参考手册》中的"数据服务\CriteriaEntity"。

# 【参考案例】

示例：利用查询实体查询CUST表所有数据。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	criteriaEntity	DataObject	criteria	变量	传引用
返回值	out0	DataObject[]	result	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是查询实体criteria
- 返回值是根据查询实体查询得到的结果数组对象
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteria __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __id="2" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __id="3" __index="0" __type="sdo:com.primeton.das.criteria.exprType">
                    <_op __type="java:java.lang.String">in</_op>
                    <_min/>
                    <_max/>
                    <_likeRule/>
                    <_dateRule/>
                    <_pattern/>
                    <_year/>
                    <_quarter/>
                    <_month/>
                    <_opProperty/>
                    <_ref/>
                    <_processNullValue/>
                    <CUSTID __type="java:java.lang.String">2,3</CUSTID>
                </__entry>
            </_expr>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteria>
    </__root>
</bizContext>

等效的SQL语句

select CUSTID, CUSTCODE, CUSTNAME, BIRTH, SEX, ADDRESS from CUST where CUSTID in (2,3)

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteria __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __id="3" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __id="6" __index="0" __type="sdo:com.primeton.das.criteria.exprType">
                    <_op __type="java:java.lang.String">in</_op>
                    <_min/>
                    <_max/>
                    <_likeRule/>
                    <_dateRule/>
                    <_pattern/>
                    <_year/>
                    <_quarter/>
                    <_month/>
                    <_opProperty/>
                    <_ref/>
                    <_processNullValue/>
                    <CUSTID __type="java:java.lang.String">2,3</CUSTID>
                </__entry>
            </_expr>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteria>
        <result __id="2" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="4" __index="0" __type="sdo:com
              .primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">2</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
                <BIRTH __type="java:java.sql.Date">2009-09-09</BIRTH>
                <SEX __isNullOrEmpty="null"/>
                <ADDRESS __isNullOrEmpty="null"/>
                <PHOTO/>
            </__entry>
            <__entry __id="5" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">3</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_3</CUSTNAME>
                <BIRTH __type="java:java.sql.Date">2009-09-09</BIRTH>
                <SEX __isNullOrEmpty="null"/>
                <ADDRESS __isNullOrEmpty="null"/>
                <PHOTO/>
            </__entry>
        </result>
    </__root>
</bizContext>

# queryEntitiesByCriteriaEntity：根据查询条件实体查询部分记录

# 【功能说明】

根据查询条件实体查询指定起始行、指定长度的记录，根据查询条件实体指定查询Entity的字段。如果实体包含关联实体，并且关联关系连线上没有设置为延时加载，那么同时也会把关联实体的数据查询出来。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.queryEntitiesByCriteriaEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	criteriaEntity	DataObject	查询条件实体
参数	begin	int	开始记录编号（从0开始）
参数	length	int	查询记录数量
返回值	out0	DataObject[]	符合查询条件的所有结果

抛出异常说明查询出错时抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明关于查询条件实体的说明请参考《EOS基础参考手册》中的"数据服务\CriteriaEntity"。

# 【参考案例】

示例：从第1行开始查询CUST表一条记录。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	criteriaEntity	DataObject	criteria	变量	传引用
参数	begin	int	1	常量	传引用
参数	length	int	1	常量	传引用
返回值	out0	DataObject[]	result	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是查询实体criteria
- 第三个参数是查询起始行标志
- 第四个参数是查询记录的长度（记录数）
- 返回值是根据查询实体查询得到的结果数组对象
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteria __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __id="2" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __id="3" __index="0" __type="sdo:com.primeton.das.criteria.exprType">
                    <_op __type="java:java.lang.String">in</_op>
                    <_min/>
                    <_max/>
                    <_likeRule/>
                    <_dateRule/>
                    <_pattern/>
                    <_year/>
                    <_quarter/>
                    <_month/>
                    <_opProperty/>
                    <_ref/>
                    <_processNullValue/>
                    <CUSTID __type="java:java.lang.String">2,3</CUSTID>
                </__entry>
            </_expr>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteria>
    </__root>
</bizContext>

等效的SQL语句

select * from
  ( select row_.*, rownum rownum_ from
      ( select CUSTID, CUSTCODE, CUSTNAME, BIRTH, SEX, ADDRESS from CUST where CUSTID in (2,3) ) row_
    where rownum <= 2
  )
where rownum_ > 1

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteria __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __id="3" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __id="5" __index="0" __type="sdo:com.primeton.das.criteria.exprType">
                    <_op __type="java:java.lang.String">in</_op>
                    <_min/>
                    <_max/>
                    <_likeRule/>
                    <_dateRule/>
                    <_pattern/>
                    <_year/>
                    <_quarter/>
                    <_month/>
                    <_opProperty/>
                    <_ref/>
                    <_processNullValue/>
                    <CUSTID __type="java:java.lang.String">2,3</CUSTID>
                </__entry>
            </_expr>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteria>
        <result __id="2" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="4" __index="0" __type="sdo:com
              .primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">3</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_3</CUSTNAME>
                <BIRTH __type="java:java.sql.Date">2009-09-09</BIRTH>
                <SEX __isNullOrEmpty="null"/>
                <ADDRESS __isNullOrEmpty="null"/>
                <PHOTO/>
            </__entry>
        </result>
    </__root>
</bizContext>

# queryEntitiesByTemplate：根据SDO数据模板查询条件查询所有记录

# 【功能说明】

根据SDO数据模板查询条件查询所有记录，会查询Entity的所有字段。如果实体包含关联实体，并且关联关系连线上没有设置为延时加载，那么同时也会把关联实体的数据查询出来。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.queryEntitiesByTemplate，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	template	DataObject	SDO数据模板查询条件
返回值	out0	DataObject[]	查询结果SDO数组

抛出异常说明查询出错时抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：利用查询模板查询所有的客户信息。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	template	DataObject	template	变量	传引用
返回值	out0	DataObject[]	result	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO数据模板，这里作为查询条件的数据模板
- 返回值是根据数据模板查询条件查询出的记录
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <template __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

等效的SQL语句

select CUSTID, CUSTCODE, CUSTNAME, BIRTH, SEX, ADDRESS from CUST where BIRTH=
  to_date('2009-09-09','yyyy-MM-dd')

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <result __id="1" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="3" __index="0"
             __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">2</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
                <BIRTH __type="java:java.sql.Date">2009-09-09</BIRTH>
                <SEX __isNullOrEmpty="null"/>
                <ADDRESS __isNullOrEmpty="null"/>
                <PHOTO/>
            </__entry>
            <__entry __id="4" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">3</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_3</CUSTNAME>
                <BIRTH __type="java:java.sql.Date">2009-09-09</BIRTH>
                <SEX __isNullOrEmpty="null"/>
                <ADDRESS __isNullOrEmpty="null"/>
                <PHOTO/>
            </__entry>
        </result>
        <template __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

# queryEntitiesByTemplate：根据SDO数据模板查询条件查询部分记录

# 【功能说明】

根据SDO数据模板查询指定起始行、指定长度的记录。如果实体包含关联实体，并且关联关系连线上没有设置为延时加载，那么同时也会把关联实体的数据查询出来。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.queryEntitiesByTemplate，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	template	DataObject	SDO数据模板查询条件
参数	begin	int	开始记录编号（从0开始）
参数	length	Int	length查询记录数量
返回值	out0	DataObject[]	符合查询模板的所有结果

抛出异常说明查询出错时抛出异常com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：从第1行开始查询CUST表1条记录。

参数设置

类型	名称	数据类型	值	值类	传递方式
参数	dsName	String	default	常量	传引用
参数	template	DataObject	cust	变量	传引用
参数	begin	int	1	常量	传引用
参数	length	Int	1	常量	传引用
返回值	out0	DataObject[]	custs	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO数据模板，这里作为查询条件的数据模板
- 第三个参数是查询条件起始行
- 第四个参数是查询条件的查询长度（记录数）
- 返回值是根据数据模板查询条件查询出的对象数组
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <template __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

等效的SQL语句以oracle为例：

select *
  from (select row_.*, rownum rownum_
          from (select CUSTID, CUSTCODE, CUSTNAME, BIRTH, SEX, ADDRESS
                  from CUST
                 where BIRTH = to_date('2009-09-09', 'yyyy-MM-dd')) row_
         where rownum <= 2)
 where rownum_ > 1

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <result __id="1" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="3" __index="0"
             __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">3</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_3</CUSTNAME>
                <BIRTH __type="java:java.sql.Date">2009-09-09</BIRTH>
                <SEX __isNullOrEmpty="null"/>
                <ADDRESS __isNullOrEmpty="null"/>
                <PHOTO/>
            </__entry>
        </result>
        <template __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
    </__root>
</bizContext>

# saveEntities：保存多条记录

# 【功能说明】

用来把一组SDO对象保存到数据库中，所有操作隶属于一个原子事务。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.saveEntities，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObjects	DataObject[]	SDO对象数组

抛出异常说明保存出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：保存CUST表的多条记录。

场景描述用户保存多条CUST记录，若被添加记录主键在表中存在则执行更新操作，若不存在则执行新增操作。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObjects	DataObject[]	custes	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO对象数组custes
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
             __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">5</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_5</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_5</CUSTNAME>
                <BIRTH __type="java:java.util.Date">2009-10-02 00:00:00</BIRTH>
                <SEX/>
                <ADDRESS/>
                <PHOTO/>
            </__entry>
            <__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">6</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_6</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">cust_6</CUSTNAME>
                <BIRTH __type="java:java.util.Date">2009-10-13 00:00:00</BIRTH>
                <SEX/>
                <ADDRESS/>
                <PHOTO/>
            </__entry>
        </custes>
    </__root>
</bizContext>

等效的SQL语句

此处只列出同时存在和同时不存在的sql。
- 同时存在：

update CUST set CUSTNAME='cust_5', BIRTH=to_date('2009-10-12','yyyy-MM-dd')
where CUSTID=5 and CUSTCODE='cust_5'
update CUST set CUSTNAME='cust_6', BIRTH=to_date('2009-10-13','yyyy-MM-dd')
where CUSTID=6 and CUSTCODE='cust_6'

同时不存在：

insert into CUST (CUSTNAME, BIRTH, CUSTID, CUSTCODE) values ('cust_5',
                         to_date('2009-10-12','yyyy-MM-dd'), 5, 'cust_5')
insert into CUST (CUSTNAME, BIRTH, CUSTID, CUSTCODE) values ('cust_6',
                         to_date('2009-10-13','yyyy-MM-dd'), 6, 'cust_6')

调用后的bizContext 同调用前。

# saveEntity：保存一条记录

# 【功能说明】

用来保存一条记录到数据库。该构件与inserEntity有所不同：如果数据库没有相同主键的记录则直接插入到数据库对应的表中，否则只是修改已经存在的相同主键的记录的数据。可以简单理解为，它既可用于insert场景，也可用于update场景。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.saveEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObject	DataObject	SDO对象

抛出异常说明保存出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：保存CUST表的一条记录。

场景描述用户保存一条CUST记录，如果新增记录主键在表中存在则执行修改操作，如果不存在则执行新增操作。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObject	DataObject	cust	变量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO对象cust
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">4</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_4</CUSTCODE>
            <CUSTNAME __type="java:java.lang.String">cust_4</CUSTNAME>
            <BIRTH __type="java:java.util.Date">2009-10-01 00:00:00</BIRTH>
            <SEX __type="java:java.lang.String">1</SEX>
            <ADDRESS/>
            <PHOTO/>
        </cust>
    </__root>
</bizContext>

等效的SQL语句
- 存在CUSTID=4并且CUSTCODE='cust_4'的记录时：

update CUST set CUSTNAME='cust_4', SEX='1', BIRTH=to_date('2009-10-01','yyyy-MM-dd')
where CUSTID=4 and CUSTCODE='cust_4'

不存在存在CUSTID=4并且CUSTCODE='cust_4'的记录时：

insert into CUST (CUSTNAME, BIRTH, SEX, CUSTID, CUSTCODE) values ('cust_4',
                         to_date('2009-10-01','yyyy-MM-dd'), '1', 4, 'cust_4')

调用后的bizContext 同调用前。

# updateEntity：更新一条记录

# 【功能说明】

用来更新一条数据库记录，更新时根据实体定义的主键属性的值更新。没有主键不能更新。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.updateEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObject	DataObject	SDO对象

抛出异常说明更新出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：更新CUST表中的一条记录。

场景描述用户更新一条CUST记录。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObject	DataObject	cust	变量	传引用

参数描述
- 第一个参数为数据源名称，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO对象实体cust
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <cust __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID __type="java:java.lang.Integer">1</CUSTID>
            <CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
            <CUSTNAME __type="java:java.lang.String">update_cust_1</CUSTNAME>
            <BIRTH/>
            <SEX __type="java:java.lang.String">0</SEX>
            <ADDRESS/>
            <PHOTO/>
        </cust>
    </__root>
</bizContext>

等效的SQL语句

update CUST set CUSTNAME='update_cust_1', SEX=0 where CUSTID=1 and CUSTCODE='cust_1'

调用后的bizContext 同调用前。

# updateEntityBatch：更新多条记录

# 【功能说明】

用来更新多条数据库记录，更新时根据实体定义的主键属性的值更新。没有主键不能更新。所有操作隶属于一个原子事务。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DatabaseUtil.updateEntityBatch，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	dataObjects	DataObject[]	SDO数组

抛出异常说明更新出错时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：更新CUST表中的多条记录。

场景描述用户使用Datacell维护CUST表的内容。用户操作更新多条CUST数据。该场景下可以用updateEntityBatch实现多条记录的插入。
参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	dataObjects	DataObject[]	custes	变量	传引用

参数描述
- 第一个参数为数据源名称，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO对象数组custes
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <custes __id="1" __type="java:[Lcommonj.sdo.DataObject;">
            <__entry __componentType="java:commonj.sdo.DataObject" __id="2" __index="0"
             __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">2</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">update_cust_2</CUSTNAME>
                <BIRTH/>
                <SEX/>
                <ADDRESS/>
                <PHOTO/>
            </__entry>
            <__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
                <CUSTID __type="java:java.lang.Integer">3</CUSTID>
                <CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
                <CUSTNAME __type="java:java.lang.String">update_cust_3</CUSTNAME>
                <BIRTH/>
                <SEX/>
                <ADDRESS/>
                <PHOTO/>
            </__entry>
        </custes>
    </__root>
</bizContext>

等效的SQL语句

update CUST set CUSTNAME='update_cust_2' where CUSTID=2 and CUSTCODE='cust_2'
update CUST set CUSTNAME='update_cust_3' where CUSTID=3 and CUSTCODE='cust_3'

调用后的bizContext 同调用前。

# updateEntityByCriteriaEntity：根据查询实体更新记录

# 【功能说明】

根据查询实体定义把一个指定的SDO对象更新到数据库中。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.updateEntityByCriteriaEntity，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	value	DataObject	数据实体值
参数	criteriaEntity	DataObject	查询条件定义对象
返回值	out0	int	更新记录数

抛出异常说明更新失败时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：根据查询条件更新CUST表中的一条记录。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	value	DataObject	updateData	变量	传引用
参数	criteriaEntity	DataObject	criteriaEntity	变量	传引用
返回值	out0	int	result	常量	传引用

参数描述
- 第一个参数为数据源，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO数据对象
- 第三个参数是查询实体criteriaEntity
- 第四个参数是被修改记录返回值
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteriaEntity __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __id="3" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __id="4" __index="0" __type="sdo:com.primeton.das.criteria.exprType">
                    <_op __type="java:java.lang.String">=</_op>
                    <_min/>
                    <_max/>
                    <_likeRule/>
                    <_dateRule/>
                    <_pattern/>
                    <_year/>
                    <_quarter/>
                    <_month/>
                    <_opProperty/>
                    <_ref/>
                    <_processNullValue/>
                    <CUSTID __type="java:java.lang.String">3</CUSTID>
                </__entry>
            </_expr>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteriaEntity>
        <updateData __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME __type="java:java.lang.String">updateByCriteria</CUSTNAME>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </updateData>
    </__root>
</bizContext>

等效的SQL语句

update CUST set CUSTNAME='updateByCriteria' where CUST.CUSTID=3

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <criteriaEntity __id="1" __type="sdo:com.primeton.das.criteria.criteriaType">
            <_entity __type="java:java.lang.String">com.primeton.eos.foundation.example.data.CUST</_entity>
            <_select/>
            <_expr __id="3" __type="java:com.primeton.ext.data.sdo.collection.ContainerAwareList">
                <__entry __id="4" __index="0" __type="sdo:com.primeton.das.criteria.exprType">
                    <_op __type="java:java.lang.String">=</_op>
                    <_min/>
                    <_max/>
                    <_likeRule/>
                    <_dateRule/>
                    <_pattern/>
                    <_year/>
                    <_quarter/>
                    <_month/>
                    <_opProperty/>
                    <_ref/>
                    <_processNullValue/>
                    <CUSTID __type="java:java.lang.String">3</CUSTID>
                </__entry>
            </_expr>
            <_and __collection="list"/>
            <_or __collection="list"/>
            <_not __collection="list"/>
            <_order __collection="list"/>
            <_orderby __collection="list"/>
            <_group/>
            <_distinct/>
            <_association __collection="list"/>
            <_ref __collection="list"/>
            <_lock/>
        </criteriaEntity>
        <result __type="java:java.lang.Integer">1</result>
        <updateData __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME __type="java:java.lang.String">updateByCriteria</CUSTNAME>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </updateData>
    </__root>
</bizContext>

# updateEntityByTemplate：根据SDO数据模板查询条件更新记录

# 【功能说明】

根据一个SDO查询模板的数据，相应的更新数据库中某条记录。

# 【版本说明】

从EOS 6.0开始提供。

# 【引用路径】

本运算逻辑构件对应JAVA方法路径： com.eos.foundation.database.DatabaseUtil.updateEntityByTemplate，包含在com.eos.foundation.jar中。
运算逻辑定义在构件包com.eos.foundation中。

# 【使用说明】

参数说明

类型	名称	数据类型	参数描述
参数	dsName	String	数据源名称
参数	value	DataObject	实体值
参数	template	DataObject	实体模板条件
返回值	out0	int	更新记录数

抛出异常说明更新失败时抛出com.eos.system.exception.EOSRuntimeException。
规则说明无。

# 【参考案例】

示例：根据查询模板更新CUST表中BIRTH='2009-09-09'的记录。

参数设置

类型	名称	数据类型	值	值类别	传递方式
参数	dsName	String	default	常量	传引用
参数	value	DataObject	updateData	变量	传引用
参数	template	DataObject	template	变量	传引用
返回值	out0	int	result	变量	传引用

参数描述
- 第一个参数为数据源名称，更多的说明参见基本操作类DatabaseUtil中的注意
- 第二个参数是操作的SDO对象updateData
- 第三个参数是SDO查询模板对象template
其他说明无。
调用前的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <template __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
        <updateData __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME __type="java:java.lang.String">updateByTemplate</CUSTNAME>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </updateData>
    </__root>
</bizContext>

等效的SQL语句

update CUST set CUSTNAME='updateByTemplate' where CUST.BIRTH=to_date('2009-09-09','yyyy-MM-dd')

调用后的bizContext

<bizContext>
    <__root __id="0" __type="java:java.util.HashMap">
        <result __type="java:java.lang.Integer">2</result>
        <template __id="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME/>
            <BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </template>
        <updateData __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
            <CUSTID/>
            <CUSTCODE/>
            <CUSTNAME __type="java:java.lang.String">updateByTemplate</CUSTNAME>
            <BIRTH/>
            <SEX/>
            <ADDRESS/>
            <PHOTO/>
        </updateData>
    </__root>
</bizContext>

← 密码处理扩展操作类DatabaseExt →