# com.eos.foundation.common.utils.StringUtil
# 构件包说明
本工具类实现了对字符串的操作处理。
# 运算逻辑构件使用说明
该构件包包含以下构件：
| 序号 | 方法 | 功能描述 |
|---|---|---|
| 1 | bytesToHexString(byte[] bytes) | byte数组转换成16进制字符串 |
| 2 | collectionToString(Object object, String joinString) | 把数组或集合转换成字符串 |
| 3 | concat(String joinString, String... strings) | 拼接字符串 |
| 4 | hexStringToBytes(String hex) | 16进制字符串转换成byte数组 |
| 5 | isBlank(String value) | 判断是否是空字符串 |
| 6 | isDouble(String text) | 判断是否是双精度数字 |
| 7 | leftPad(String originalText, String padString, int destLength) | 用指定的字符左补齐字符串 |
| 8 | rightPad(String originalText, String padString, int destLength) | 用指定的字符右补齐字符串 |
# bytesToHexString：byte数组转换成16进制字符串
# 【功能说明】
byte数组转换成16进制字符串。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.common.utils.StringUtil.bytesToHexString，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | bytes | Byte[] | byte数组 |
| 返回值 | result | String | 16进制字符串 |
抛出异常说明 无。
规则说明 无。
# 【参考案例】
示例：将数组byte_array转为16进制的字符串。
场景描述 需要处理字符串转换时可使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | bytes | Byte[] | byte_array | 变量 | 传引用 |
| 返回值 | out0 | String | result | 变量 | 传引用 |
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<byte_array __collection="array" __hexString="true" __id="1" __type="java:byte">5072696D65746F6E</byte_array>
<result __isNullOrEmpty="null"/>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<byte_array __collection="array" __hexString="true" __id="1" __type="java:byte">5072696D65746F6E</byte_array>
<result __type="java:java.lang.String">5072696D65746F6E</result>
</__root>
</bizContext>
# collectionToString：把数组或集合转换成字符串
# 【功能说明】
把数组或集合转换成字符串，对象只能是数组或集合，否则抛异常。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.common.utils.StringUtil.collectionToString，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | object | Collection | 集合或数组对象 |
| 参数 | joinString | String | 连接用的间隔符 |
| 返回值 | result | String | 连接后的结果 |
抛出异常说明 无。
规则说明 对象只能是数组或集合，否则抛异常。
# 【参考案例】
示例：将字符集合{"a","b","c"}用"*"拼接起来，请参考concat (opens new window)。
场景描述 需要处理字符串的拼接时使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | object | Collection | collection_obj | 变量 | 传引用 |
| 参数 | joinString | String | join_str | 变量 | 传引用 |
| 返回值 | out0 | String | result | 变量 | 传引用 |
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<collect_obj __id="1" __type="java:[Ljava.lang.String;">
<__entry __index="0" __type="java:java.lang.String">a</__entry>
<__entry __index="1" __type="java:java.lang.String">b</__entry>
<__entry __index="2" __type="java:java.lang.String">c</__entry>
</collect_obj>
<join_str __type="java:java.lang.String">*</join_str>
<result __isNullOrEmpty="null"/>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<collection_obj __id="1" __type="java:[Ljava.lang.String;">
<__entry __index="0" __type="java:java.lang.String">a</__entry>
<__entry __index="1" __type="java:java.lang.String">b</__entry>
<__entry __index="2" __type="java:java.lang.String">c</__entry>
</collection_obj>
<join_str __type="java:java.lang.String">*</join_str>
<result __type="java:java.lang.String">a*b*c</result>
</__root>
</bizContext>
# concat：拼接字符串
# 【功能说明】
用给定的连接间隔符将字符串数组拼成一个字符串输出。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.common.utils.StringUtil.concat，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | joinString | String | 连接间隔符 |
| 参数 | strings | String... | 可变长的字符串数组 |
| 返回值 | result | String | 拼接结果字符串 |
抛出异常说明 无。
规则说明 如果连接间隔符为null，则按''处理。
# 【参考案例】
# 示例1：将字符数组{"a","b","c"}用"-"拼接起来。
场景描述 需要处理字符串的拼接时使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | joinString | String | split_char | 变量 | 传引用 |
| 参数 | strings | String | a | 常量 | 传引用 |
| 参数 | param1 | String | b | 常量 | 传引用 |
| 参数 | param2 | String | c | 常量 | 传引用 |
| 返回值 | out0 | String | out1 | 变量 | 传引用 |
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<out1 __isNullOrEmpty="null"/>
<split_char __type="java:java.lang.String">-</split_char>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<out1 __type="java:java.lang.String">a-b-c</out1>
<split_char __type="java:java.lang.String">-</split_char>
</__root>
</bizContext>
- 源代码 参见示例工程： foundation\FoundationExample\com.primeton.eos.foundation.example\src\com\primeton\eos\foundation\example\StringUtil\concat.bizx
# 示例2：将字符数组{"a","b","c"}用""拼接起来。
场景描述 需要处理字符串的拼接时使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | joinString | String | split_char | 变量 | 传引用 |
| 参数 | strings | String | a | 常量 | 传引用 |
| 参数 | param1 | String | b | 常量 | 传引用 |
| 参数 | param2 | String | c | 常量 | 传引用 |
| 返回值 | out0 | String | out1 | 变量 | 传引用 |
参数配置 如下图所示：
其他说明 对于示例2，参数split_char要使用表达式的""，表示空字符串
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<out1 __isNullOrEmpty="null"/>
<split_char __isNullOrEmpty="empty" __type="java:java.lang.String"/>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<out1 __type="java:java.lang.String">abc</out1>
<split_char __isNullOrEmpty="empty" __type="java:java.lang.String"/>
</__root>
</bizContext>
# hexStringToBytes：16进制字符串转换成byte数组
# 【功能说明】
16进制字符串转换成byte数组。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.common.utils.StringUtil.hexStringToBytes，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | hex | String | 16进制字符串 |
| 返回值 | byte_array | Byte[] | byte数组 |
抛出异常说明 无。
规则说明 无。
# 【参考案例】
示例：将16进制字符串转换成byte数组。
场景描述 需要将字符串转换为byte数组时可使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | hex | String | ori_str | 变量 | 传引用 |
| 返回值 | out0 | Byte[] | byte_array | 变量 | 传引用 |
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<byte_array __collection="array" __id="1" __isNullOrEmpty="empty" __type="java:byte"/>
<ori_str __type="java:java.lang.String">5072696D65746F6E</ori_str>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<byte_array __collection="array" __hexString="true" __id="1" __type="java:byte">5072696D65746F6E</byte_array>
<ori_str __type="java:java.lang.String">5072696D65746F6E</ori_str>
</__root>
</bizContext>
# isBlank：判断是否是空字符串
# 【功能说明】
判断是否是空字符。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.common.utils.StringUtil.isBlank，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | value | String | 输入字符串 |
| 返回值 | result | Boolean | 判断结果 |
抛出异常说明 无。
规则说明 输入字符串为null、""、" " 时返回true。
# 【参考案例】
# 示例1：判断"EOS"是否是空字符串。
场景描述 遇到空字符串需要特殊处理。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | value | String | src_str | 变量 | 传引用 |
| 返回值 | out0 | Boolean | result | 变量 | 传引用 |
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __type="java:java.lang.Boolean">false</result>
<src_str __type="java:java.lang.String">EOS</src_str>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __type="java:java.lang.Boolean">false</result>
<src_str __type="java:java.lang.String">EOS</src_str>
</__root>
</bizContext>
- 源代码 参见示例工程： foundation\FoundationExample\com.primeton.eos.foundation.example\src\com\primeton\eos\foundation\example\StringUtil\isBlank.bizx
# 示例2：判断"null"是否是空字符串。
场景描述 遇到空字符串需要特殊处理。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | value | String | src_str | 变量 | 传引用 |
| 返回值 | out0 | Boolean | result | 变量 | 传引用 |
参数配置 如下图所示：
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __type="java:java.lang.Boolean">false</result>
<src_str __isNullOrEmpty="null"/>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __type="java:java.lang.Boolean">true</result>
<src_str __isNullOrEmpty="null"/>
</__root>
</bizContext>
# isDouble：判断是否是双精度数字
# 【功能说明】
判断是否是双精度数字。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.common.utils.StringUtil.isDouble，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | text | String | 输入字符串 |
| 返回值 | result | Boolean | 判断结果 |
抛出异常说明 无。
规则说明 无。
# 【参考案例】
# 示例1：判断"1.234"是否是双精度数字。
场景描述 需要处理数值型的字符串时使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | text | String | src_str | 变量 | 传引用 |
| 返回值 | out0 | Boolean | result | 变量 | 传引用 |
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __isNullOrEmpty="null"/>
<src_str __type="java:java.lang.String">1.234</src_str>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __type="java:java.lang.Boolean">true</result>
<src_str __type="java:java.lang.String">1.234</src_str>
</__root>
</bizContext>
- 源代码 参见示例工程： foundation\FoundationExample\com.primeton.eos.foundation.example\src\com\primeton\eos\foundation\example\StringUtil\isDouble.bizx
# 示例2：判断"abc"是否是双精度数字。
场景描述 需要处理数值型的字符串时使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
| 参数 | text | String | src_str | 变量 | 传引用 |
| 返回值 | out0 | Boolean | result | 变量 | 传引用 |
参数配置 如下图所示：
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __isNullOrEmpty="null"/>
<src_str __type="java:java.lang.String">abc </src_str>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<result __type="java:java.lang.Boolean">false</result>
<src_str __type="java:java.lang.String">abc </src_str>
</__root>
</bizContext>
# leftPad：用指定的字符左补齐字符串
# 【功能说明】
用指定的字符左补齐字符串，补齐后的字符串的长度等于目标长度，如果原始字符串的长度大于目标长度，直接返回。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.common.utils.StringUtil.leftPad，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 参数 | originalText | String | 原始的字符串 |
| 参数 | padString | String | 补齐用的字符串。如果为null，默认使用' '。 |
| 参数 | destLength | int | 目标长度 |
| 返回值 | out0 | String | 补齐后的字符串 |
抛出异常说明 无。
规则说明 补齐用的字符串如果为null，默认使用' '。
# 【参考案例】
# 示例1：字符串Primeton用EOS 6.0补齐到20个字符长度。
场景描述 需要处理字符串的拼接时使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | originalText | String | ori_str | 变量 | 传引用 |
| 参数 | padString | String | pad_str | 变量 | 传引用 |
| 参数 | destLength | int | length | 变量 | 传引用 |
| 返回值 | out0 | String | out1 | 变量 | 传引用 |
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<length __type="java:java.lang.Integer">20</length>
<ori_str __type="java:java.lang.String">Primeton</ori_str>
<pad_str __type="java:java.lang.String">EOS 6.0</pad_str>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<length __type="java:java.lang.Integer">20</length>
<ori_str __type="java:java.lang.String">Primeton</ori_str>
<out1 __type="java:java.lang.String">EOS 6.0EOS 6Primeton</out1>
<pad_str __type="java:java.lang.String">EOS 6.0</pad_str>
</__root>
</bizContext>
- 源代码 参见示例工程： foundation\FoundationExample\com.primeton.eos.foundation.example\src\com\primeton\eos\foundation\example\StringUtil\leftPad.bizx
# 示例2：字符串Primeton用SOA补齐到20个字符长度。
场景描述 需要处理字符串的拼接时使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | originalText | String | ori_str | 变量 | 传引用 |
| 参数 | padString | String | pad_str | 变量 | 传引用 |
| 参数 | destLength | int | length | 变量 | 传引用 |
| 返回值 | out0 | String | out1 | 变量 | 传引用 |
参数配置 如下图所示：
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<length __type="java:java.lang.Integer">20</length>
<ori_str __type="java:java.lang.String">Primeton</ori_str>
<pad_str __type="java:java.lang.String">SOA</pad_str>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<length __type="java:java.lang.Integer">20</length>
<ori_str __type="java:java.lang.String">Primeton</ori_str>
<out1 __type="java:java.lang.String">SOASOASOASOAPrimeton</out1>
<pad_str __type="java:java.lang.String">SOA</pad_str>
</__root>
</bizContext>
# rightPad：用指定的字符右补齐字符串
# 【功能说明】
用指定的字符右补齐字符串，补齐后的字符串的长度等于目标长度，如果原始字符串的长度大于目标长度，则直接返回。请参考leftPad (opens new window)。
# 【版本说明】
从EOS 6.0开始提供。
# 【引用路径】
- 本运算逻辑构件对应JAVA方法路径： com.eos.foundation.common.utils.StringUtil.rightPad，包含在com.eos.foundation.jar中。
- 运算逻辑定义在构件包com.eos.foundation中。
# 【使用说明】
- 参数说明
| 类型 | 名称 | 数据类型 | 参数描述 |
|---|---|---|---|
| 类型 | 名称 | 数据类型 | 参数描述 |
| 参数 | originalText | String | 原始的字符串 |
| 参数 | padString | String | 补齐用的字符串。如果为null，默认使用' '。 |
| 参数 | destLength | int | 目标长度 |
| 返回值 | out0 | String | 补齐后的字符串 |
抛出异常说明 无。
规则说明 补齐用的字符串如果为null，默认使用' '。 目标长度为空时，直接返回原字符串。
# 【参考案例】
示例：字符串Primeton用EOS 6.0补齐到20个字符长度，请参考leftPad (opens new window)。
场景描述 需要处理字符串的拼接时使用该方法。
参数设置
| 类型 | 名称 | 数据类型 | 值 | 值类别 | 传递方式 |
|---|---|---|---|---|---|
| 参数 | originalText | String | ori_str | 变量 | 传引用 |
| 参数 | padString | String | pad_str | 变量 | 传引用 |
| 参数 | destLength | int | length | 变量 | 传引用 |
| 返回值 | out0 | String | out1 | 变量 | 传引用 |
其他说明 无。
调用前的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<length __type="java:java.lang.Integer">20</length>
<ori_str __type="java:java.lang.String">Primeton</ori_str>
<pad_str __type="java:java.lang.String">EOS 6.0</pad_str>
</__root>
</bizContext>
- 调用后的bizContext
<bizContext>
<__root __id="0" __type="java:java.util.HashMap">
<length __type="java:java.lang.Integer">20</length>
<ori_str __type="java:java.lang.String">Primeton</ori_str>
<out1 __type="java:java.lang.String"> PrimetonEOS 6.0EOS 6</out1>
<pad_str __type="java:java.lang.String">EOS 6.0</pad_str>
</__root>
</bizContext>