cn.ps1.aolai.service

类 UtilsService

java.lang.Object

cn.ps1.aolai.service.UtilsService

@Service
public class UtilsService
extends Object

全局通用的公共方法Utils类

从以下版本开始:

1.7 $Date: 2017.6.17

版本:

1.0

作者:

Fulin

构造器概要

构造器

构造器和说明
UtilsService() 构造函数

方法概要

限定符和类型	方法和说明
String	arr2Str(String[] arr) 数组合并拼接为字符串
boolean	availParams(Map<?,?> map, String key) 校验request请求参数是否存在
boolean	availParams(Map<?,?> params, String[] keys) 检查请求（输入）参数无效
String	buildUri(Map<String,String> params) 构建URI参数
void	clearCookies(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse rsp) 清除全部Cookie的键值
void	close(Closeable... closeables) 关闭对象
void	delCookie(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse rsp, String key) 已过时。
long	diffMsec(String begin, String end) 两个时间之间的毫秒间隔
Map<String,String>	failed(String info) 返回失败消息
Map<String,String>	findIn(List<Map<String,String>> list, String key, String val) 找出List列表中匹配的指定字符串
boolean	findIn(List<String> list, String str) 找出List列表中是否存在指定字符串
boolean	findIn(String[] arr, String str) 字符串数组中是否存在指定的字符串
boolean	findIn(String str, String regex) 字符串中是否包含指定的字符串，如："\\d+"
String	getArgs(String key) 已过时。
String	getClientIp(javax.servlet.http.HttpServletRequest req) 获取用户请求者的IP地址
String	getConf(String key) 已过时。
String	getCookie(javax.servlet.http.HttpServletRequest req, String key) 获取指定的Cookie
Map<String,String>	getCookies(javax.servlet.http.HttpServletRequest req) 获取所有Cookie键值对
<T> String	getFilePath(Map<String,T> map, String[] keys) 拼接文件路径，如：aolai/1036/20220925/
<T> int	getInt(Map<String,T> map, String key) 从对象中获取整数值
String	getLocale(javax.servlet.http.HttpServletRequest req) 浏览器请求的默认语言（国家CN）
String	getLocalIp() 获取服务端本地的IP地址
Map<String,String>	getParams(javax.servlet.http.HttpServletRequest req) 获取HTTP请求从前端传递来的参数
String	getRequestURI(javax.servlet.http.HttpServletRequest req) 获取请求URI参数，返回值带了斜线，如：uri="/wsSaveTest1"
String	getValid(String key) 已过时。
String	initCap(Object str) 将字符串的首字母转大写 用字母的ascii编码前移，效率要高于截取字符串进行转换的操作
boolean	isDatetime(String str, String pat) 判断是否为时间格式
<T> boolean	isEmpty(Map<String,T> map) 判断对象是否为空
boolean	isEmpty(Object obj) 判断字符串是否为空
boolean	isIdcard(String str) 判断是否为身份证号码："^\\d{17}[\\dXx]$"
boolean	isInteger(String str) 判断是否为整数、负数
boolean	isMatch(String input, String regex) 字符串中是否有完全匹配：匹配字符或数字
boolean	isMobile(String str) 判断是否为手机号码："^1[3-9]\\d{9}"
boolean	isNumeric(String str) 判断是否为浮点数：包含整数、小数、负数
<T> List<Map<String,T>>	json2List(Object obj) 把Object对象转换成为list对象
<T> List<Map<String,T>>	json2List(String str) 把json字符串转换成为list对象
<T> Map<String,T>	json2Map(String str) 把jsonStr转换成为Map对象
Map<String,Object>	jsonParams(javax.servlet.http.HttpServletRequest req) 获取从前端HTTP请求传递来的参数：梳理功能已移到ThirdService.setReqAttr()
Map<String,String>	list2Map(List<Map<String,String>> list, String key, String val) list转换为键值对格式的map对象
<T> Map<String,Map<String,T>>	list2Map(List<Map<String,T>> list, String key) list转换为键值对格式的map对象
Map<String,Object>	map2Obj(Map<String,String> obj) Map对象数据互转
String	nextMonth(String month) 获得下个月期间
String	nextMonth(String month, int m) 获得下个月期间
String	nextYear(String pattern, int n) 当前时间节点向后（或向前）推迟n年
Map<String,Object>	node2Obj(com.fasterxml.jackson.databind.JsonNode jsonNode) Json对象转换为Map对象
Map<String,Object>	node2Obj(String jsonStr) Json对象字符串转换为Map对象
Map<String,Object>	node2Obj(String jsonStr, String path) 从Json字符串中找出Map对象节点
boolean	notEmpty(String... values) 判断字符数组，不为空
int[]	num2Arr(String numStr) 把数串逐级累计（科目层级转换）
<T> List<Map<String,T>>	obj2List(Object data) 对象转换为List对象
Map<String,String>	obj2Map(Map<String,Object> obj) Map对象数据互转
<T> Map<String,T>	obj2Map(Object data) 对象转换为Map对象
String	obj2Str(Object obj) 把对象（Map、List）转为jsonStr字符串
boolean	overSize(long kiloByte, String limit) 文件尺寸（默认千字节KB）超限额，如：limit=“100M”
String	prevMonth(String month) 获得上个月期间
String	prevMonth(String month, int m) 已过时。
Map<String,String>	result(boolean status) 返回状态结果：false-失败、true-成功
<T> Object	result(Map<String,T> map)
Map<String,String>	result(String status) 返回状态结果
Map<String,String>	result(String status, String info) 返回状态结果
void	setCookies(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse rsp, Map<String,String> map) 设置cookies
String	setUserComp(javax.servlet.http.HttpServletRequest req, Map<String,Object> params, String key) 设置当前操作用户的公司ID后返回公司ID
int[]	str2num(String numStr) 字符串分割为整数数组
Map<String,String>	success()
Map<String,Object>	success(Object obj) 返回数据对象
Map<String,String>	success(Object obj, javax.servlet.http.HttpServletRequest req) 返回前台加密后的信息（注意：应用场景比较少，可能在个别地方单独使用）
Map<String,String>	success(String info) 返回成功
long	timeDiff(Date begin, Date end) 计算两个日期之间的差数多少（毫秒数）：begin开始时间，end结束时间
long	timeDiff(String begin, String end) 计算两个日期之间的差数多少（毫秒数）：begin开始时间，end结束时间
String	timeFormat(String strTime, String pat0, String pat1) 时间（日期）格式转变
String	toCent(String money) 带千分位格式的金额（元）变成分，四舍五入
String	toCent(String money, String blank) 带千分位格式的金额（元）变成分，四舍五入
String	today(String pattern) 根据日期格式，获取当前日期时间：pattern格式
String	toRmb(long n) 人民币汉字大写，传入数值可大于1万亿元
String	toRmb(String money) 人民币汉字大写，传入数值要小于1万亿元
int	toStep(int min, int max, int step) 数字步进
String	toYuan(String money) 分变成带千分位格式的金额（元），四舍五入
String	toYuan(String money, String blank) 分变成带千分位格式的金额（元），四舍五入
Map<String,String>	userSelf(javax.servlet.http.HttpServletRequest req) 当前操作用户自己，相当于getSession()

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

UtilsService

public UtilsService()

构造函数

方法详细资料

getConf

@Deprecated
public String getConf(String key)

已过时。

系统配置参数，未定义返回空，建议直接用ConfUtil.getConf

getArgs

@Deprecated
public String getArgs(String key)

已过时。

系统配置参数，未定义返回空，建议直接用ConfUtil.getParam

getValid

@Deprecated
public String getValid(String key)

已过时。

系统配置参数，未定义返回空，建议直接用ConfUtil.getValid

getParams

public Map<String,String> getParams(javax.servlet.http.HttpServletRequest req)

获取HTTP请求从前端传递来的参数

jsonParams

public Map<String,Object> jsonParams(javax.servlet.http.HttpServletRequest req)

获取从前端HTTP请求传递来的参数：梳理功能已移到ThirdService.setReqAttr()

userSelf

public Map<String,String> userSelf(javax.servlet.http.HttpServletRequest req)

当前操作用户自己，相当于getSession()

setUserComp

public String setUserComp(javax.servlet.http.HttpServletRequest req,
                          Map<String,Object> params,
                          String key)

设置当前操作用户的公司ID后返回公司ID

availParams

public boolean availParams(Map<?,?> map,
                           String key)

校验request请求参数是否存在

availParams

public boolean availParams(Map<?,?> params,
                           String[] keys)

检查请求（输入）参数无效

参数:

params -

keys -

返回:

boolean 成功与否

num2Arr

public int[] num2Arr(String numStr)

把数串逐级累计（科目层级转换）

参数:

numStr - 数字的字符串

返回:

Array 累计数组

str2num

public int[] str2num(String numStr)

字符串分割为整数数组

arr2Str

public String arr2Str(String[] arr)

数组合并拼接为字符串

getInt

public <T> int getInt(Map<String,T> map,
                      String key)

从对象中获取整数值

initCap

public String initCap(Object str)

将字符串的首字母转大写

用字母的ascii编码前移，效率要高于截取字符串进行转换的操作

obj2Map

public <T> Map<String,T> obj2Map(Object data)

对象转换为Map对象

obj2List

public <T> List<Map<String,T>> obj2List(Object data)

对象转换为List对象

obj2Map

public Map<String,String> obj2Map(Map<String,Object> obj)

Map对象数据互转

map2Obj

public Map<String,Object> map2Obj(Map<String,String> obj)

Map对象数据互转

obj2Str

public String obj2Str(Object obj)

把对象（Map、List）转为jsonStr字符串

参数:

obj -

返回:

jsonStr

node2Obj

public Map<String,Object> node2Obj(String jsonStr,
                                   String path)

从Json字符串中找出Map对象节点

node2Obj

public Map<String,Object> node2Obj(String jsonStr)

Json对象字符串转换为Map对象

参数:

jsonStr -

返回:

Map

node2Obj

public Map<String,Object> node2Obj(com.fasterxml.jackson.databind.JsonNode jsonNode)

Json对象转换为Map对象

参数:

jsonNode -

返回:

Map

json2Map

public <T> Map<String,T> json2Map(String str)

把jsonStr转换成为Map对象

参数:

str -

返回:

Map

json2List

public <T> List<Map<String,T>> json2List(Object obj)

把Object对象转换成为list对象

参数:

obj -

返回:

List

json2List

public <T> List<Map<String,T>> json2List(String str)

把json字符串转换成为list对象

list2Map

public <T> Map<String,Map<String,T>> list2Map(List<Map<String,T>> list,
                                              String key)

list转换为键值对格式的map对象

类型参数:

T -

list2Map

public Map<String,String> list2Map(List<Map<String,String>> list,
                                   String key,
                                   String val)

list转换为键值对格式的map对象

result

public Map<String,String> result(String status)

返回状态结果

参数:

status - "1".成功，"0".失败、"2".参数错误、"3".Token失效

返回:

Map

result

public Map<String,String> result(boolean status)

返回状态结果：false-失败、true-成功

result

public Map<String,String> result(String status,
                                 String info)

返回状态结果

参数:

status - "1".成功，"0".失败、"2".参数错误、"3".Token失效

info - 返回信息或数据

result

public <T> Object result(Map<String,T> map)

failed

public Map<String,String> failed(String info)

返回失败消息

success

public Map<String,String> success(String info)

返回成功

success

public Map<String,String> success()

success

public Map<String,Object> success(Object obj)

返回数据对象

success

public Map<String,String> success(Object obj,
                                  javax.servlet.http.HttpServletRequest req)

返回前台加密后的信息（注意：应用场景比较少，可能在个别地方单独使用）

findIn

public Map<String,String> findIn(List<Map<String,String>> list,
                                 String key,
                                 String val)

找出List列表中匹配的指定字符串

findIn

public boolean findIn(List<String> list,
                      String str)

找出List列表中是否存在指定字符串

findIn

public boolean findIn(String[] arr,
                      String str)

字符串数组中是否存在指定的字符串

findIn

public boolean findIn(String str,
                      String regex)

字符串中是否包含指定的字符串，如："\\d+"

isMatch

public boolean isMatch(String input,
                       String regex)

字符串中是否有完全匹配：匹配字符或数字

返回:

boolean 成功与否

isInteger

public boolean isInteger(String str)

判断是否为整数、负数

isNumeric

public boolean isNumeric(String str)

判断是否为浮点数：包含整数、小数、负数

isIdcard

public boolean isIdcard(String str)

判断是否为身份证号码："^\\d{17}[\\dXx]$"

isMobile

public boolean isMobile(String str)

判断是否为手机号码："^1[3-9]\\d{9}"

isDatetime

public boolean isDatetime(String str,
                          String pat)

判断是否为时间格式

timeFormat

public String timeFormat(String strTime,
                         String pat0,
                         String pat1)

时间（日期）格式转变

timeDiff

public long timeDiff(Date begin,
                     Date end)

计算两个日期之间的差数多少（毫秒数）：begin开始时间，end结束时间

timeDiff

public long timeDiff(String begin,
                     String end)

计算两个日期之间的差数多少（毫秒数）：begin开始时间，end结束时间

diffMsec

public long diffMsec(String begin,
                     String end)

两个时间之间的毫秒间隔

today

public String today(String pattern)

根据日期格式，获取当前日期时间：pattern格式

nextYear

public String nextYear(String pattern,
                       int n)

当前时间节点向后（或向前）推迟n年

nextMonth

public String nextMonth(String month,
                        int m)

获得下个月期间

nextMonth

public String nextMonth(String month)

获得下个月期间

prevMonth

@Deprecated
public String prevMonth(String month,
                                     int m)

已过时。

获得上个月期间，可以用替代方法：nextMonth(month, -m)

prevMonth

public String prevMonth(String month)

获得上个月期间

getRequestURI

public String getRequestURI(javax.servlet.http.HttpServletRequest req)

获取请求URI参数，返回值带了斜线，如：uri="/wsSaveTest1"

setCookies

public void setCookies(javax.servlet.http.HttpServletRequest req,
                       javax.servlet.http.HttpServletResponse rsp,
                       Map<String,String> map)

设置cookies

getCookies

public Map<String,String> getCookies(javax.servlet.http.HttpServletRequest req)

获取所有Cookie键值对

getCookie

public String getCookie(javax.servlet.http.HttpServletRequest req,
                        String key)

获取指定的Cookie

delCookie

@Deprecated
public void delCookie(javax.servlet.http.HttpServletRequest req,
                                   javax.servlet.http.HttpServletResponse rsp,
                                   String key)

已过时。

刪除指定的Cookie

clearCookies

public void clearCookies(javax.servlet.http.HttpServletRequest req,
                         javax.servlet.http.HttpServletResponse rsp)

清除全部Cookie的键值

getLocalIp

public String getLocalIp()

获取服务端本地的IP地址

getClientIp

public String getClientIp(javax.servlet.http.HttpServletRequest req)

获取用户请求者的IP地址

getLocale

public String getLocale(javax.servlet.http.HttpServletRequest req)

浏览器请求的默认语言（国家CN）

getFilePath

public <T> String getFilePath(Map<String,T> map,
                              String[] keys)

拼接文件路径，如：aolai/1036/20220925/

buildUri

public String buildUri(Map<String,String> params)

构建URI参数

notEmpty

public boolean notEmpty(String... values)

判断字符数组，不为空

参数:

values - 字符数组

返回:

true or false

isEmpty

public boolean isEmpty(Object obj)

判断字符串是否为空

isEmpty

public <T> boolean isEmpty(Map<String,T> map)

判断对象是否为空

toStep

public int toStep(int min,
                  int max,
                  int step)

数字步进

close

public void close(Closeable... closeables)

关闭对象

toYuan

public String toYuan(String money)

分变成带千分位格式的金额（元），四舍五入

toYuan

public String toYuan(String money,
                     String blank)

分变成带千分位格式的金额（元），四舍五入

toCent

public String toCent(String money)

带千分位格式的金额（元）变成分，四舍五入

toCent

public String toCent(String money,
                     String blank)

带千分位格式的金额（元）变成分，四舍五入

toRmb

public String toRmb(String money)

人民币汉字大写，传入数值要小于1万亿元

toRmb

public String toRmb(long n)

人民币汉字大写，传入数值可大于1万亿元

overSize

public boolean overSize(long kiloByte,
                        String limit)

文件尺寸（默认千字节KB）超限额，如：limit=“100M”