# hello-util
**Repository Path**: dkbnull/hello-util
## Basic Information
- **Project Name**: hello-util
- **Description**: HelloUtil
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-01-10
- **Last Updated**: 2025-03-11
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Hello Util 通用工具类 v1.0.15
GitHub:[https://github.com/dkbnull/HelloUtil](https://github.com/dkbnull/HelloUtil)
Gitee:[https://gitee.com/dkbnull/HelloUtil](https://gitee.com/dkbnull/HelloUtil)
## 开发环境
* JDK:1.8
## StringUtils String 工具类
### 方法摘要
| 返回值 | 摘要 |
| ------- | ------------------------------------------------------------ |
| boolean | isEmpty(String value)
检查指定字符串是否为空 |
| boolean | areNotEmpty(String... values)
检查指定字符串列表是否不为空 |
| boolean | isNumeric(String value)
检查String是否为数值型字符串,包含整数、小数 |
| boolean | isInteger(String value)
检查String是否是int型字符串 |
| String | substringValue(String value, int beginIndex, int endIndex)
按要求截取指定长度字符串 |
| String | substringValue(String value, int length, String tag)
按要求截取指定长度字符串,不足则返回完整字符串 |
| String | random(int length)
获取指定长度随机字符串 |
| String | randomNonce(int length)
获取指定长度随机字符串(数字、字母) |
| int | toInt(String value, int defaultValue)
String转int,格式不正确则返回默认值 |
| long | toLong(String value, long defaultValue)
String转long,格式不正确则返回默认值 |
| double | toDouble(String value, double defaultValue)
String转double,格式不正确则返回默认值 |
| String | toHex(String value)
获取16进制字符串 |
| String | byteToHex(byte[] data)
获取16进制字符串 |
| String | hexToString(String value)
16进制字符串转String |
| byte[] | hexToByte(String value)
16进制字符串转byte |
| String | toCharsetString(String value, String fromCharset, String toCharset)
获取指定编码格式字符串 |
| String | toUTF8String(String value, String fromCharset)
获取UTF-8编码格式字符串 |
| String | toUTF8String(String value)
获取UTF-8编码格式字符串 |
| String | stringPadding(String value, int length, String tag, String charset)
字符串补空格,字符串长度大于补全后长度则截取字符串 |
| String | stringPadding(String value, int length, String fill, String tag, String charset)
字符串补全,字符串长度大于补全后长度则截取字符串 |
| String | changeF2Y(String value)
分转元 |
| String | changeY2F(String value)
元转分 |
| String | changeG2Kg(String value)
克转千克 |
| String | changeKg2G(String value)
千克转克 |
### 方法详细信息
#### isEmpty
```java
boolean isEmpty(String value)
/**
* 检查指定字符串是否为空
* StringUtils.isEmpty(null) = true
* StringUtils.isEmpty("") = true
* StringUtils.isEmpty(" ") = true
* StringUtils.isEmpty("abc") = false
*
* @param value 待检查字符串
* @return true/false
*/
```
---
#### areNotEmpty
```java
boolean areNotEmpty(String... values)
/**
* 检查指定字符串列表是否不为空
*
* @param values 待检查字符串列表
* @return true/false
*/
```
---
#### isNumeric
```java
boolean isNumeric(String value)
/**
* 检查String是否为数值型字符串,包含整数、小数
*
* @param value 待检查字符串
* @return true/false
*/
```
---
#### isInteger
```java
boolean isInteger(String value)
/**
* 检查String是否是int型字符串
*
* @param value 待检查字符串
* @return true/false
*/
```
---
#### substringValue
```java
String substringValue(String value, int beginIndex, int endIndex)
/**
* 按要求截取指定长度字符串
*
* @param value 待截取字符串
* @param beginIndex 起始位置
* @param endIndex 结束位置
* @return 截取后字符串
*/
```
---
#### substringValue
```java
String substringValue(String value, int length, String tag)
/**
* 按要求截取指定长度字符串,不足则返回完整字符串
*
* @param value 待截取字符串
* @param length 截取长度
* @param tag R 右截取 L 左截取
* @return 截取后字符串
*/
```
---
#### random
```java
String random(int length)
/**
* 获取指定长度随机字符串
*
* @param length 随机字符串长度
* @return 随机字符串
*/
```
---
#### randomNonce
~~~java
String randomNonce(int length)
/**
* 获取指定长度随机字符串(数字、字母)
*
* @param length 随机字符串长度
* @return
*/
~~~
---
#### toInt
```java
int toInt(String value, int defaultValue)
/**
* String转int,格式不正确则返回默认值
*
* @param value 字符串
* @param defaultValue 默认值
* @return 数值
*/
```
---
#### toLong
```java
long toLong(String value, long defaultValue)
/**
* String转long,格式不正确则返回默认值
*
* @param value 字符串
* @param defaultValue 默认值
* @return 数值
*/
```
---
#### toDouble
```java
double toDouble(String value, double defaultValue)
/**
* String转double,格式不正确则返回默认值
*
* @param value 字符串
* @param defaultValue 默认值
* @return 数值
*/
```
---
#### toHex
```java
String toHex(String value)
/**
* 获取16进制字符串
*
* @param value 待转化数据
* @return 16进制字符串
*/
```
---
#### byteToHex
```java
String byteToHex(byte[] data)
/**
* 获取16进制字符串
*
* @param data 待转化数据
* @return 16进制字符串
*/
```
---
#### hexToString
```java
String hexToString(String value)
/**
* 16进制字符串转String
*
* @param value 16进制字符串
* @return 转换后字符串
*/
```
---
#### hexToByte
```java
byte[] hexToByte(String value)
/**
* 16进制字符串转byte
*
* @param value 16进制字符串
* @return byte
*/
```
---
#### toCharsetString
```java
String toCharsetString(String value, String fromCharset, String toCharset) throws Exception
/**
* 获取指定编码格式字符串
*
* @param value 待转化字符串
* @param fromCharset 待转化字符串字符集
* @param toCharset 转化后字符串字符集
* @return 转换后字符串
* @throws Exception
*/
```
---
#### toUTF8String
```java
String toUTF8String(String value, String fromCharset) throws Exception
/**
* 获取UTF-8编码格式字符串
*
* @param value 待转化字符串
* @param fromCharset 待转化字符串字符集
* @return 转换后字符串
* @throws Exception
*/
```
---
#### toUTF8String
```java
String toUTF8String(String value) throws Exception
/**
* 获取UTF-8编码格式字符串
*
* @param value 待转化字符串
* @return UTF-8编码格式字符串
* @throws Exception
*/
```
---
#### stringPadding
```java
String stringPadding(String value, int length, String tag, String charset)
/**
* 字符串补空格,字符串长度大于补全后长度则截取字符串
*
* @param value 待补全字符串
* @param length 补全后长度
* @param tag R 右补全 L 左补全
* @param charset 字符集
* @return 补全后字符串
*/
```
---
#### stringPadding
```java
String stringPadding(String value, int length, String fill, String tag, String charset)
/**
* 字符串补全,字符串长度大于补全后长度则截取字符串
*
* @param value 待补全字符串
* @param length 补全后长度
* @param fill 填充字符
* @param tag R 右补全 L 左补全
* @param charset 字符集
* @return 补全后字符串
*/
```
---
#### changeF2Y
~~~java
String changeF2Y(String value)
/**
* 分转元
*
* @param value 金额,分
* @return 金额,元
*/
~~~
---
#### changeY2F
~~~java
String changeY2F(String value)
/**
* 元转分
*
* @param value 金额,元
* @return 金额,分
*/
~~~
---
#### changeG2Kg
~~~java
String changeG2Kg(String value)
/**
* 克转千克
*
* @param value 重量,克
* @return 重量,千克
*/
~~~
---
#### changeKg2G
~~~java
String changeKg2G(String value)
/**
* 千克转克
*
* @param value 重量,千克
* @return 重量,克
*/
~~~
---
## BigDecimalUtils BigDecimal工具类
### 方法摘要
| 返回值 | 摘要 |
| ------ | ------------------------------------------------------------ |
| int | add(int value1, int value2)
加 |
| double | add(double value1, double value2)
加 |
| String | add(String value1, String value2)
加 |
| int | subtract(int value1, int value2)
减 |
| double | subtract(double value1, double value2)
减 |
| String | subtract(String value1, String value2)
减 |
| int | multiply(int value1, int value2)
乘 |
| double | multiply(double value1, double value2)
乘 |
| String | multiply(String value1, String value2)
乘 |
| double | multiply(double value1, double value2, int scale, int roundingMode)
乘 |
| String | multiply(String value1, String value2, int scale, int roundingMode)
乘 |
| double | divide(int value1, int value2, int roundingMode)
除 |
| double | divide(double value1, double value2, int roundingMode)
除 |
| String | divide(String value1, String value2, int roundingMode)
除 |
| double | divide(int value1, int value2, int scale, int roundingMode)
除 |
| double | divide(double value1, double value2, int scale, int roundingMode)
除 |
| String | divide(String value1, String value2, int scale, int roundingMode)
除 |
| double | format(double value)
数值格式化 |
| String | format(String value)
数值格式化 |
| int | compareTo(double value1, double value2)
比较大小 |
| int | compareTo(String value1, String value2)
比较大小 |
### 方法详细信息
#### add
```java
int add(int value1, int value2)
/**
* 加
*
* @param value1 加数
* @param value2 加数
* @return 和
*/
```
---
#### add
~~~java
double add(double value1, double value2)
/**
* 加
*
* @param value1 加数
* @param value2 加数
* @return 和
*/
~~~
---
#### add
~~~java
String add(String value1, String value2)
/**
* 加
*
* @param value1 加数
* @param value2 加数
* @return 和
*/
~~~
---
#### subtract
~~~java
int subtract(int value1, int value2)
/**
* 减
*
* @param value1 被减数
* @param value2 减数
* @return 差
*/
~~~
---
#### subtract
~~~java
double subtract(double value1, double value2)
/**
* 减
*
* @param value1 被减数
* @param value2 减数
* @return 差
*/
~~~
---
#### subtract
~~~java
String subtract(String value1, String value2)
/**
* 减
*
* @param value1 被减数
* @param value2 减数
* @return 差
*/
~~~
---
#### multiply
~~~java
int multiply(int value1, int value2)
/**
* 乘
*
* @param value1 乘数
* @param value2 乘数
* @return 积
*/
~~~
---
#### multiply
~~~java
double multiply(double value1, double value2)
/**
* 乘
*
* @param value1 乘数
* @param value2 乘数
* @return 积
*/
~~~
---
#### multiply
~~~java
String multiply(String value1, String value2)
/**
* 乘
*
* @param value1 乘数
* @param value2 乘数
* @return 积
*/
~~~
---
#### multiply
~~~java
double multiply(double value1, double value2, int scale, int roundingMode)
/**
* 乘
*
* @param value1 乘数
* @param value2 乘数
* @param scale 精度
* @param roundingMode 舍入模式
* @return 积
*/
~~~
---
#### multiply
~~~java
String multiply(String value1, String value2, int scale, int roundingMode)
/**
* 乘
*
* @param value1 乘数
* @param value2 乘数
* @param scale 精度
* @param roundingMode 舍入模式
* @return 积
*/
~~~
---
#### divide
~~~java
double divide(int value1, int value2, int roundingMode)
/**
* 除
*
* @param value1 被除数
* @param value2 除数
* @param roundingMode 舍入模式
* @return 商
*/
~~~
---
#### divide
~~~java
double divide(double value1, double value2, int roundingMode)
/**
* 除
*
* @param value1 被除数
* @param value2 除数
* @param roundingMode 舍入模式
* @return 商
*/
~~~
---
#### divide
~~~java
String divide(String value1, String value2, int roundingMode)
/**
* 除
*
* @param value1 被除数
* @param value2 除数
* @param roundingMode 舍入模式
* @return 商
*/
~~~
---
#### divide
~~~java
double divide(int value1, int value2, int scale, int roundingMode)
/**
* 除
*
* @param value1 被除数
* @param value2 除数
* @param scale 精度
* @param roundingMode 舍入模式
* @return 商
*/
~~~
---
#### divide
~~~java
double divide(double value1, double value2, int scale, int roundingMode)
/**
* 除
*
* @param value1 被除数
* @param value2 除数
* @param scale 精度
* @param roundingMode 舍入模式
* @return 商
*/
~~~
---
#### divide
~~~java
String divide(String value1, String value2, int scale, int roundingMode)
/**
* 除
*
* @param value1 被除数
* @param value2 除数
* @param scale 精度
* @param roundingMode 舍入模式
* @return 商
*/
~~~
---
#### format
~~~java
double format(double value)
/**
* 数值格式化
*
* @param value 待格式化数值
* @return 格式化后数值
*/
~~~
---
#### format
~~~java
String format(String value)
/**
* 数值格式化
*
* @param value 待格式化数值
* @return 格式化后数值
*/
~~~
---
#### compareTo
~~~java
int compareTo(double value1, double value2)
/**
* 比较大小
*
* @param value1
* @param value2
* @return -1:<, 0:=, 1:>
*/
~~~
---
#### compareTo
~~~java
int compareTo(String value1, String value2)
/**
* 比较大小
*
* @param value1
* @param value2
* @return -1:<, 0:=, 1:>
*/
~~~
---
## ListUtils List 工具类
### 方法摘要
| 返回值 | 摘要 |
| ------- | ------------------------------------------------------------ |
| boolean | isEmpty(List list)
检查List是否为空 |
### 方法详细信息
#### isEmpty
```java
boolean isEmpty(List list)
/**
* 检查List是否为空
*
* @param list 待检查List
* @return true/false
*/
```
---
## MapUtils Map 工具类
### 方法摘要
| 返回值 | 摘要 |
| ------------------- | ------------------------------------------------------------ |
| boolean | isEmpty(Map map)
检查Map是否为空 |
| String | getMapString(Map map, String key)
String型获取Map value值 |
| int | getMapInt(Map map, String key)
int型获取Map value值 |
| int | getMapInt(Map map, String key, int defaultValue)
int型获取Map value值,无法转化则返回默认值 |
| double | getMapDouble(Map map, String key)
double型获取Map value值 |
| double | getMapDouble(Map map, String key, double defaultValue)
double型获取Map value值,无法转化则返回默认值 |
| Map | javaBeanToMap(Object object)
Java Bean 转Map |
| T | mapToJavaBean(Map map, Class clazz)
Map转 Java Bean |
### 方法详细信息
#### isEmpty
```java
boolean isEmpty(Map map)
/**
* 检查Map是否为空
*
* @param map 待检查Map
* @return true/false
*/
```
---
#### getMapString
```java
String getMapString(Map map, String key)
/**
* String型获取Map value值
*
* @param map Map
* @param key key值
* @return value值
*/
```
---
#### getMapInt
```java
int getMapInt(Map map, String key)
/**
* int型获取Map value值
*
* @param map Map
* @param key key值
* @return value值
*/
```
---
#### getMapInt
```java
int getMapInt(Map map, String key, int defaultValue)
/**
* int型获取Map value值,无法转化则返回默认值
*
* @param map Map
* @param key key值
* @param defaultValue 默认值
* @return value值
*/
```
---
#### getMapDouble
```java
double getMapDouble(Map map, String key)
/**
* double型获取Map value值
*
* @param map Map
* @param key key值
* @return value值
*/
```
---
#### getMapDouble
```java
double getMapDouble(Map map, String key, double defaultValue)
/**
* double型获取Map value值,无法转化则返回默认值
*
* @param map Map
* @param key key值
* @param defaultValue 默认值
* @return value值
*/
```
---
#### javaBeanToMap
```java
Map javaBeanToMap(Object object)
/**
* Java Bean 转Map
*
* @param object 待转化Java Bean
* @return Map
*/
```
---
#### mapToJavaBean
~~~java
T mapToJavaBean(Map map, Class clazz)
/**
* Map转 Java Bean
*
* @param map Map
* @return Java Bean
*/
~~~
---
## JSONUtils JSON 工具类
### 方法摘要
| 返回值 | 摘要 |
| ------------------- | ------------------------------------------------------------ |
| boolean | isEmpty(JSONObject json)
检查JSON是否为空 |
| boolean | isEmpty(JSONArray jsonArray)
检查JSONArray是否为空 |
| String | getJSONString(JSONObject json, String key)
String型获取JSON value值 |
| int | getJSONInt(JSONObject json, String key)
int型获取JSON value值 |
| int | getJSONInt(JSONObject json, String key, int defaultValue)
int型获取JSON value值,无法转化则返回默认值 |
| double | getJSONDouble(JSONObject json, String key)
double型获取JSON value值 |
| double | getJSONDouble(JSONObject json, String key, double defaultValue)
double型获取JSON value值,无法转化则返回默认值 |
| JSONObject | javaBeanToJSON(Object object)
Java Bean 转JSON |
| JSONArray | javaBeanToJSONArray(Object object)
Java Bean 转JSONArray |
| Map | JSONToMap(JSONObject json)
JSON 转 Map |
| String | JSONFormat(String value)
格式化JSON字符串,不校验JSON格式合法性 |
### 方法详细信息
#### isEmpty
```java
boolean isEmpty(JSONObject json)
/**
* 检查JSON是否为空
*
* @param json 待检查JSON
* @return true/false
*/
```
---
#### isEmpty
~~~java
boolean isEmpty(JSONArray jsonArray)
/**
* 检查JSONArray是否为空
*
* @param jsonArray 待检查JSONArray
* @return true/false
*/
~~~
---
#### getJSONString
```java
String getJSONString(JSONObject json, String key)
/**
* String型获取JSON value值
*
* @param json JSON
* @param key key值
* @return value值
*/
```
---
#### getJSONInt
```java
int getJSONInt(JSONObject json, String key)
/**
* int型获取JSON value值
*
* @param json JSON
* @param key key值
* @return value值
*/
```
---
#### getJSONInt
```java
int getJSONInt(JSONObject json, String key, int defaultValue)
/**
* int型获取JSON value值,无法转化则返回默认值
*
* @param json JSON
* @param key key值
* @param defaultValue 默认值
* @return value值
*/
```
---
#### getJSONDouble
```java
double getJSONDouble(JSONObject json, String key)
/**
* double型获取JSON value值
*
* @param json JSON
* @param key key值
* @return value值
*/
```
---
#### getJSONDouble
```java
double getJSONDouble(JSONObject json, String key, double defaultValue)
/**
* double型获取JSON value值,无法转化则返回默认值
*
* @param json JSON
* @param key key值
* @param defaultValue 默认值
* @return value值
*/
```
---
#### javaBeanToJSON
```java
JSONObject javaBeanToJSON(Object object)
/**
* Java Bean 转JSON
*
* @param object 待转化Java Bean
* @return JSONObject
*/
```
---
#### javaBeanToJSONArray
~~~java
JSONArray javaBeanToJSONArray(Object object)
/**
* Java Bean 转JSONArray
*
* @param object 待转化Java Bean
* @return JSONArray
*/
~~~
---
#### JSONToMap
```java
Map JSONToMap(JSONObject json)
/**
* JSON 转 Map
*
* @param json 待转化JSON
* @return Map
*/
```
---
#### JSONFormat
```java
String JSONFormat(String value)
/**
* 格式化JSON字符串,不校验JSON格式合法性
*
* @param value 待格式化JSON字符串
* @return 格式化后JSON字符串
*/
```
---
## XmlUtils XML 工具类
### 方法摘要
| 返回值 | 摘要 |
| ---------- | ------------------------------------------------------------ |
| boolean | isXml(String value)
检查String是否为XML格式 |
| String | mapToXml(Map map, String root)
Map转XML,支持fastjson |
| String | javaBeanToXml(Object object, String root)
Java Bean转XML |
| String | mapsToXml(List