# appendObject：在数组或List最后添加一个元素
# 【功能说明】
向当前DataContext中的数组对象或者list对象添加SDO对象。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.appendObject，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | SDO数组或者list所在xpath。 |
| 参数 | dataObject | DataObject | 需要添加的SDO对象。 |
| 参数 | isCheckEntityType | boolean | 缺省false：不检查将要添加的SDO对象实体名称和SDO数组或者list中的已有元素的实体名称是否匹配； true：检查是否匹配。 如果是向SDO数组或list添加第一个元素，则自动忽略检查。 |
抛出异常说明 当第三个输入参数为true，而添加的SDO对象实体名称和SDO数组或者list中的已有元素实体名称不匹配时，将抛出类型不兼容的异常。
规则说明 无。
# 【参考案例】
示例：向数组中添加一个元素。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | custes | 常量 | 传引用 |
| 参数 | dataObject | DataObject | cust | 变量 | 传引用 |
| 参数 | isCheckEntityType | boolean | false | 常量 | 传引用 |
参数描述
- 第一个输入参数：数据上下文中存在的对象数组custes的xpath。
- 第二个输入参数：类型为com.primeton.eos.foundation.example.data.CUST的对象cust。
- 第三个输入参数：不做custes中已有元素的实体名称是否一致以及新增的对象是否和custes中元素的实体名称是否一致的校验。
其它说明 当第三个输入参数为true，将检查cust实体名称（com.primeton.eos.foundation.example.data.CUST）和custes中已有元素的实体名称是否匹配。如果匹配，cust添加到custes对象数组中；如果不匹配，会抛出对象类型不兼容的异常。如果custes中的已有元素实体名称不匹配的话，也会抛出对象类型不兼容的异常。
调用前的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">3</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<custes __id="2" __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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="4" __index="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/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的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">3</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<custes __id="2" __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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="4" __index="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/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __index="2" __refid="1"/>
</custes>
</__root>
</bizContext>
# deleteObject：删除数据
# 【功能说明】
用来从数据上下文中删除多个xpath对应的SDO对象。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.deleteObject，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpaths | String... | 待删除数据的xpath值。可通过运算逻辑属性窗口增加多个xpath，因为该参数为变参。 |
抛出异常说明 无。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：从数据上下文中删除CUST对象。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpaths | String... | custes[1] | 常量 | 传引用 |
参数描述 输入参数：数据上下文中CUST对象的xpath。
其它说明 如果数据上下文中不存在CUST，也不会报错。
调用前的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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</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">2</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的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>
</custes>
</__root>
</bizContext>
# get：获取xpath对应的Object值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Object值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getObject，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | Object | xpath对应的变量值 |
抛出异常说明 无。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTNAME | 常量 | 传引用 |
| 返回值 | out0 | Object | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：xpath对应的值
调用前的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/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.String">cust_1</result>
</__root>
</bizContext>
# getBigDecimal：获取xpath对应的BigDecimal值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个BigDecimal值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getBigDecimal，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | BigDecimal | 把xpath对应的变量值转成java.math.BigDecimal类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.math.BigDecimal，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.math.BigDecimal类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTCODE | 常量 | 传引用 |
| 返回值 | out0 | BigDecimal | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.math.BigDecimal类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.math.BigDecimal">99</result>
</__root>
</bizContext>
# getBigInteger：获取xpath对应的BigInteger值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个BigInteger值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getBigInteger，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | BigInteger | 把xpath对应的变量值转成java.math.BigInteger类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.math.BigInteger，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.math.BigInteger类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTCODE | 常量 | 传引用 |
| 返回值 | out0 | Object | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.math.BigInteger类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.math.BigInteger">99</result>
</__root>
</bizContext>
# getBoolean：获取xpath对应的Boolean值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Boolean值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getBoolean，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | boolean | 把xpath对应的变量值转成java.lang.Boolean类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.lang.Boolean，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个boolean类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | text | 常量 | 传引用 |
| 返回值 | out0 | boolean | result | 变量 | 传引用 |
参数描述
输入参数：要取值的xpath
返回值：把xpath对应的值转成java.lang.Boolean类型的值
说明
字符串true,false可以转换为java.lang.Boolean类型，其余字符串无法转换，会抛异常。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<text __type="java:java.lang.String">true</text>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __type="java:java.lang.Boolean">true</result>
<text __type="java:java.lang.String">true</text>
</__root>
</bizContext>
# getByte：获取xpath对应的Byte值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Byte值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getByte，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | byte | 把xpath对应的变量值转成java.lang.Byte类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.lang.Byte，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个byte类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | path | String | cust/CUSTID | 常量 | 传引用 |
| 返回值 | out0 | byte | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.lang.Byte类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.Byte">1</result>
</__root>
</bizContext>
# getBytes：获取xpath对应的Byte数组值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Byte数组值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getBytes，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | byte[] | 把xpath对应的变量值转成byte[]类型的值 |
抛出异常说明 如果xpath对应的值无法转成byte[]，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个byte数组类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTNAME | 常量 | 传引用 |
| 返回值 | out0 | byte[] | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成byte[]类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __collection="array" __hexString="true" __id="2" __type="java:byte">637573745F31</result>
</__root>
</bizContext>
说明
序列化的xml中用16进制的数字表示byte[]
# getChar：获取xpath对应的Character值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Character值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getChar，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | char | 把xpath对应的变量值转成java.lang.Character类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.lang.Character，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个char类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTNAME | 常量 | 传引用 |
| 返回值 | out0 | char | result | 变量 | 传引用 |
参数描述
输入参数：要取值的xpath
返回值：把xpath对应的值转成java.lang.Character类型的值
说明
返回值是java.lang.Character类型，如果xpath对应的值是长度大于1的字符串，比如AB，会返回第一个字符A。
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.Character">c</result>
</__root>
</bizContext>
# getDataObject：获取xpath对应的DataObject值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个DataObject值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getDataObject，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | DataObject | 把xpath对应的变量值转成commonj.sdo.DataObject类型的值 |
抛出异常说明 如果xpath对应的值无法转成commonj.sdo.DataObject，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个commonj.sdo.DataObject类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | custes[2] | 常量 | 传引用 |
| 返回值 | out0 | DataObject | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成commonj.sdo.DataObject类型的值
调用前的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/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的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="3" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __index="1" __refid="2"/>
</custes>
<result __id="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</result>
</__root>
</bizContext>
# getDate：获取xpath对应的Date值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Date值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getDate，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | Date | 把xpath对应的变量值转成java.util.Date类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.util.Date，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.util.Date类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/BIRTH | 常量 | 传引用 |
| 返回值 | out0 | Date | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.util.Date类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH __type="java:java.util.Date">2009-09-09 00:00:00</BIRTH>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.util.Date">2009-09-09 00:00:00</result>
</__root>
</bizContext>
# getDouble：获取xpath对应的Double值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个double值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getDouble，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | double | 把xpath对应的变量值转成java.lang.Double类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.lang.Double，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.lang.Double类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTCODE | 常量 | 传引用 |
| 返回值 | out0 | double | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.lang.Double类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.Double">99.0</result>
</__root>
</bizContext>
# getFloat：获取xpath对应的Float值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Float值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getFloat，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | float | 把xpath对应的变量值转成java.lang.Float类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.lang.Float，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.lang.Float类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTCODE | 常量 | 传引用 |
| 返回值 | out0 | float | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.lang.Float类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.Float">99.0</result>
</__root>
</bizContext>
# getInt：获取xpath对应的Integer值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Integer值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getInt，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | int | 把xpath对应的变量值转成java.lang.Integer类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.lang.Integer，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.lang.Integer类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTCODE | 常量 | 传引用 |
| 返回值 | out0 | int | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.lang.Integer类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.Integer">99</result>
</__root>
</bizContext>
# getList：获取xpath对应的List值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个List值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getList，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | List | 把xpath对应的变量值转成java.util.List类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.util.List，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.util.List类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | custes | 常量 | 传引用 |
| 返回值 | out0 | List | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.util.List类型的值
调用前的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/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="3" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的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="3" __index="0"
__type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="4" __index="1" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID/>
<CUSTCODE/>
<CUSTNAME __type="java:java.lang.String">cust_2</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
<result __id="2" __type="java:java.util.ArrayList">
<__entry __index="0" __refid="3"/>
<__entry __index="1" __refid="4"/>
</result>
</__root>
</bizContext>
# getLong：获取xpath对应的Long值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Long值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getLong，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | long | 把xpath对应的变量值转成java.lang.Long类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.lang.Long，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.lang.Long类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTCODE | 常量 | 传引用 |
| 返回值 | out0 | long | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.lang.Long类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.Long">99</result>
</__root>
</bizContext>
# getShort：获取xpath对应的Short值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个Short值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getShort，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | short | 把xpath对应的变量值转成java.lang.Short类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.lang.Short，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.lang.Short类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTCODE | 常量 | 传引用 |
| 返回值 | out0 | short | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.lang.Short类型的值
调用前的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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">99</CUSTCODE>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.Short">99</result>
</__root>
</bizContext>
# getString：获取xpath对应的String值
# 【功能说明】
根据xpath指定的位置从数据上下文中获取一个String值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.getString，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | 变量xpath |
| 返回值 | out0 | String | 把xpath对应的变量值转成java.lang.String类型的值 |
抛出异常说明 如果xpath对应的值无法转成java.lang.String，将会抛出类型无法转换的异常。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：根据xpath获取一个java.lang.String类型的值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | cust/CUSTID | 常量 | 传引用 |
| 返回值 | out0 | String | result | 变量 | 传引用 |
参数描述
- 输入参数：要取值的xpath
- 返回值：把xpath对应的值转成java.lang.String类型的值
调用前的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/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
</__root>
</bizContext>
- 调用后的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/>
<CUSTNAME __type="java:java.lang.String">cust_1</CUSTNAME>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<result __type="java:java.lang.String">1</result>
</__root>
</bizContext>
# insertObject：向数组或List插入一个元素
# 【功能说明】
向当前DataContext中的数组对象或者list对象的指定位置插入SDO对象。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.insertObject，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | SDO数组或者list所在xpath。 |
| 参数 | dataObject | DataObject | 需要插入的SDO对象。 |
| 参数 | index | int | 需要插入的位置。 |
| 参数 | isCheckEntityType | boolean | 见appendObject中参数isCheckEntityType (opens new window)的说明 |
抛出异常说明 指定的插入位置不能大于数组或list的长度，否则会抛出下标越界的异常。
规则说明 无。
# 【参考案例】
示例：在数组的第1个位置添加一个元素。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | custes | 常量 | 传引用 |
| 参数 | dataObject | DataObject | cust | 变量 | 传引用 |
| 参数 | index | int | 1 | 常量 | 传引用 |
| 参数 | isCheckEntityType | boolean | false | 常量 | 传引用 |
参数描述
- 第一个输入参数：数据上下文中对象数组custes的xpath
- 第二个输入参数：需要在custes中插入的对象cust
- 第三个输入参数：需要插入在index=1的位置上
- 第四个输入参数：不检查cust的实体名称（com.primeton.eos.foundation.example.data.CUST）是否和custes中对象的实体名称是否匹配
其它说明 当第四个输入参数为true，将检查cust实体名称（com.primeton.eos.foundation.example.data.CUST）和custes中已有元素的实体名称是否匹配。如果匹配，cust添加到custes对象数组中；如果不匹配，会抛出对象类型不兼容的异常。如果custes中的已有元素实体名称不匹配的话，也会抛出对象类型不兼容的异常。
调用前的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">3</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<custes __id="2" __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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="4" __index="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/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的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">3</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</cust>
<custes __id="2" __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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __index="1" __refid="1"/>
<__entry __id="4" __index="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/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
# removeObjectByPropertyValues：按属性值从数组或List中删除元素
# 【功能说明】
将当前DataContext中的数组对象或者list对象根据属性值删除SDO对象。指定的属性值支持变长参数。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.removeObjectByPropertyValue，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | SDO数组或者list所在xpath。 |
| 参数 | property | String | SDO的属性名。 |
| 参数 | values | Object... | 属性值（支持变长参数）。 |
抛出异常说明 无。
规则说明 无。
# 【参考案例】
示例：删除数组中CUSTCODE='cust_2'的元素。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | custes | 常量 | 传引用 |
| 参数 | property | String | CUSTCODE | 常量 | 传引用 |
| 参数 | values | Object... | cust_2 | 常量 | 传引用 |
| 参数 | param1 | Object... | cust_1 | 常量 | 传引用 |
参数描述
- 第一个输入参数：类型为com.primeton.eos.foundation.example.data.CUST的对象数组custes的xpath
- 第二个输入参数：com.primeton.eos.foundation.example.data.CUST的CUSTCODE属性
- 第三个输入参数：CUSTCODE的属性值，即在custes中需要删除CUSTCODE=cust_2的对象
- 第四个输入参数：手动增加的输入参数，也是CUSTCODE的属性值，即在custes中还需要删除CUSTCODE=cust_1的对象
调用前的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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</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">2</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<custes __id="1" __isNullOrEmpty="empty" __type="java:[Lcommonj.sdo.DataObject;"/>
</__root>
</bizContext>
# setObjectBatch：批量的为指定变量赋值
# 【功能说明】
批量的为指定变量赋值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.setObjectBatch，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | destXpath | String | 待赋值变量xpath。 |
| 参数 | value | Object... | 值。设计为变参，可以成对添加输入参数，以便进行批量赋值。奇数参是待赋值参数，相连的偶数参是赋给待赋值参数的值。赋值后的数据会保存在运算逻辑运行时当前的数据上下文中。 |
抛出异常说明 无。
规则说明 xpath规则请参考《EOS基础参考手册》中的"数据上下文"。
# 【参考案例】
示例：创建2个CUST放入数组，批量设置第2个元素的属性值。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | destXpath | String | custes[2]/BIRTH | 常量 | 传引用 |
| 参数 | value | Object... | 2009-12-31 | 常量 | 传引用 |
| 参数 | param1 | Object... | "custes[2]/ADDRESS" | 表达式 | 传引用 |
| 参数 | param2 | Object... | 上海 浦东 | 常量 | 传引用 |
参数描述
- 第一个输入参数：cust数组中第2个CUST的BIRTH属性在数据上下文中的xpath
- 第二个输入参数：给BIRTH属性设置的值
- 第三个输入参数：手工增加的一个参数，表达式"custes[2]/ADDRESS"表示的是cust数组中第2个CUST的ADDRESS属性
- 第四个输入参数：手工增加的一个参数，给ADDRESS属性设置的值
其它说明 无
调用前的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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</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">2</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</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">2</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
<CUSTNAME/>
<BIRTH __type="java:java.util.Date">2009-12-31 00:00:00</BIRTH>
<SEX/>
<ADDRESS __type="java:java.lang.String">上海 浦东</ADDRESS>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
# setValueByProperty：为数组或List的每个元素特定属性赋值
# 【功能说明】
设置当前DataContext中的数组对象或者list对象中的SDO属性的值。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.setValueByProperty，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | SDO数组或者list所在xpath。 |
| 参数 | property | String | SDO的属性名。 |
| 参数 | value | Object | 属性值。 |
抛出异常说明 无。
规则说明 无。
# 【参考案例】
示例：把数组里的CUST的CUSTCODE属性值都改成cust。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | custes | 常量 | 传引用 |
| 参数 | property | String | CUSTCODE | 常量 | 传引用 |
| 参数 | value | Object | cust | 常量 | 传引用 |
参数描述
- 第一个输入参数：数组custes（类型为com.primeton.eos.foundation.example.data.CUST）的xpath
- 第二个输入参数：com.primeton.eos.foundation.example.data.CUST的CUSTCODE属性
- 第三个输入参数：设置CUSTCODE的属性值为cust
其它说明 如果第二个输入参数不是CUSTCODE的属性，比如写为CUST_CODE，如果com.primeton.eos.foundation.example.data.CUST是支持动态扩展属性的DataObject,那么custes的每个CUST中都会增加一个值为cust的CUST_CODE属性。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<cust __id="1" __type="java:java.util.HashMap">
<CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
<CUSTID __type="java:java.lang.String">3</CUSTID>
</cust>
<custes __id="2" __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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="4" __index="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/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<cust __id="1" __type="java:java.util.HashMap">
<CUSTCODE __type="java:java.lang.String">cust_3</CUSTCODE>
<CUSTID __type="java:java.lang.String">3</CUSTID>
</cust>
<custes __id="2" __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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="4" __index="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</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
# sort：为数组或List排序
# 【功能说明】
将当前DataContext中的数组对象或者list对象中SDO属性的值进行排序。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.data.DataContextUtil.sort，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | xpath | String | SDO数组或者list所在xpath。 |
| 参数 | property | String | SDO属性名称。 |
| 参数 | isAsc | boolean | 是否升序。true：升序；false：降序 |
抛出异常说明 无。
规则说明 无。
# 【参考案例】
示例：为数组排序。
- 参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | xpath | String | custes | 常量 | 传引用 |
| 参数 | property | String | CUSTID | 常量 | 传引用 |
| 参数 | isAsc | boolean | false | 常量 | 传引用 |
参数描述
- 第一个输入参数：数据上下文中类型为com.primeton.eos.foundation.example.data.CUST的对象数组custes的xpath
- 第二个输入参数：CUST对象中的一个属性名称CUSTID
- 第三个输入参数：按照CUSTID的值对custes进行升序排序
其它说明 如果数据上下文中不存在对象数组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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</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">2</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_2</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="4" __index="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">0</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_0</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>
- 调用后的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">1</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_1</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
<__entry __id="4" __index="2" __type="sdo:com.primeton.eos.foundation.example.data.CUST">
<CUSTID __type="java:java.lang.Integer">0</CUSTID>
<CUSTCODE __type="java:java.lang.String">cust_0</CUSTCODE>
<CUSTNAME/>
<BIRTH/>
<SEX/>
<ADDRESS/>
<PHOTO/>
</__entry>
</custes>
</__root>
</bizContext>