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

作者:

Aolai

构造器概要

构造器

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

方法概要

限定符和类型	方法和说明
<T> String	arr2Str(T[] strArr) 已过时。 这个方法已被弃用，并且在未来版本用join()替换。
boolean	availParams(Map<?,?> map, String key) 已过时。 这个方法已被弃用，并且在未来版本不再支持。
boolean	availParams(Map<?,?> map, String[] keys) 检查请求（输入）参数是否有效存在
String	buildUri(Map<String,String> map) 构建URI参数
boolean	checkParams(Map<?,?> map, String[] keys) 检查必须携带的参数
void	clearCookies(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse rsp) 清除全部Cookie的键值
void	close(Closeable closeable) 关闭对象
void	close(Closeable[] closeables) 关闭对象
void	close(Closeable closeable1, Closeable closeable2) 关闭对象
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, Object str) 找出List列表中是否存在指定字符串
boolean	findIn(String[] arr, Object str) 字符串数组中是否存在指定的字符串
boolean	findIn(String str, String regex) 字符串中是否包含指定的字符串，如："\\d+"
<T> String[]	getArr(List<Map<String,T>> list, String key) 获取list中某一列的值，list中某列的数值转换为数组并去重
String	getClientIp(javax.servlet.http.HttpServletRequest req) 获取用户请求者的IP地址
String	getCookie(javax.servlet.http.HttpServletRequest req, String key) 获取指定的Cookie
Map<String,String>	getCookies(javax.servlet.http.HttpServletRequest req) 获取所有Cookie键值对
int	getInt(Map<String,?> map, String key) 从对象中获取整数值
String	getLocale(javax.servlet.http.HttpServletRequest req) 浏览器请求的默认语言（国家CN）
String	getLocalIp() 获取服务端本地的IP地址
long	getLong(Map<String,?> map, String key) 从对象中获取整数值
Map<String,String>	getParams(javax.servlet.http.HttpServletRequest req) 获取HTTP请求从前端传递来的参数
String	getRequestURI(javax.servlet.http.HttpServletRequest req) 获取请求URI参数，返回值带了斜线，如：uri="/wsSaveTest1"
String	idCode(Object pId, int id, int bitW) 根据父节点新建一个新节点，如ID：0102 (bitW=2)
String	initCap(Object str) 将字符串的首字母转大写 用字母的ascii编码前移，效率要高于截取字符串进行转换的操作
Map<String,String>	invalidParams() 请求参数为无效参数
boolean	isBlank(Object obj) 判断字符串是否为空
boolean	isDatetime(String dateStr, String pat) 判断是否为时间格式
<T> boolean	isEmpty(Map<String,T> map) 判断对象是否为空
boolean	isEmpty(Object obj) 判断字符串是否为空
<T> boolean	isFailed(Map<String,T> result)
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	isNil(Object obj) 判断字符串是否为“0”
boolean	isNumeric(String str) 判断是否为浮点数：包含整数、小数、负数
<T> boolean	isSuccess(Map<String,T> result)
<T> String	join(T[] strArr) 数组合并拼接为字符串
<T> String	join(T[] strArr, String joint) 数组合并拼接为字符串
<T> List<T>	json2List(Object str) 把json字符串转换成为list对象
<T> Map<String,T>	json2Map(Object str) 把jsonStr转换成为Map对象
String	jsonExt(String field, Object key) 拼接json格式的SQL语句
String	jsonExt(String field, Object key, String opr) 拼接json格式的SQL语句
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,?> map) Map对象数据互转
<T> Map<String,T>	mapParser(Map<String,?> parser, Map<String,T> map) 已过时。 这个方法已被弃用，并且在未来版本用parse()替换。
<T> List<Map<String,T>>	mapParser(Map<String,String> parser, List<Map<String,T>> list) 已过时。 这个方法已被弃用，并且在未来版本用parse()替换。
Map<String,Object>	newCond(Map<String,?> params) 新检索条件
String	newLeafId(Object pid, List<Map<String,String>> list, String key, int bitW) 生成树形结构的叶子项目编号
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<T>	obj2List(Object data) 对象转换为List对象
Map<String,String>	obj2Map(Map<String,?> obj) Map对象数据互转化，含对象拷贝
<T> Map<String,T>	obj2Map(Object data) 对象转换为Map对象
String	obj2Str(Object obj) 把对象（Map、List）转为jsonStr字符串
<T> Map<String,T>	parse(Map<String,?> parser, Map<String,T> map) 通过参数映射解析器，进行参数主键转换 转换：newMap.put(parser.getKey(), oldMap.get(parser.getValue())); 映射示例：parser={empUid=userId, empComp=userComp, empName=userName}
<T> List<Map<String,T>>	parse(Map<String,String> parser, List<Map<String,T>> list) 通过参数映射解析器，进行参数主键转换 转换：newMap.put(parser.getKey(), oldMap.get(parser.getValue())); 映射示例：parser={empUid=userId, empComp=userComp, empName=userName}
String	pHolder(Object key, String opr) 占位符处理：placeHolder
String	prevMonth(String month) 获得上个月期间
String	prevMonth(String month, int m) 获得上个月期间，可以用替代方法：nextMonth(month, -m)
String	quote(Object key, String ch) 引用"key"
void	resetState(Map<String,Object> cond, String key) 默认查询条件为状态为“1” 用于重新设置查询条件的数据状态：一般默认设置为“0”“1”的情况
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) 返回状态结果
Map<String,Object>	sameId(Map<String,?> cond, String key) 检索条件转换
Map<String,Object>	sameIf(Map<String,?> cond, int offset, String[] keys) 检索条件转换
Map<String,Object>	sameIf(Map<String,?> cond, String[] keys) 拼装检查数据重复的条件，默认“第一个”值是主键，首先要排除主键
Map<String,Object>	sameNo(Map<String,?> cond, String key) 检索条件转换
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
String	sqlOr(String[] fields) 拼接SQL字符串的单引号'val'值
String	sqlVal(Object val) 拼接SQL字符串的单引号'val'值
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 str, String pat0, String pat1) 时间（日期）格式转变
String	toCent(String money) 带千分位格式的金额（元）变成分，四舍五入
String	toCent(String money, String def) 带千分位格式的金额（元）变成分，四舍五入
String	today(String pattern) 根据日期格式，获取当前日期时间：pattern格式
Map<String,String>	toMap(List<Map<String,String>> list, String key, String val) list转换为键值对格式的map对象
<T> Map<String,Map<String,T>>	toMap(List<Map<String,T>> list, String key) list转换为键值对格式的map对象
String	toRmb(long num) 人民币汉字大写，传入数值可大于1万亿元
String	toRmb(String money) 人民币汉字大写，传入数值要小于1万亿元
<T> Set<String>	toSet(List<Map<String,T>> list, String key) 获取list中某一列的值，list中某列的数值转换为Set并去重
int	toStep(int min, int max, int step) 数字步进，按step累加
String	toYuan(String money) 分变成带千分位格式的金额（元），四舍五入
String	toYuan(String money, String def) 分变成带千分位格式的金额（元），四舍五入
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()

构造函数

方法详细资料

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()

invalidParams

public Map<String,String> invalidParams()

请求参数为无效参数

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

resetState

public void resetState(Map<String,Object> cond,
                       String key)

默认查询条件为状态为“1”
用于重新设置查询条件的数据状态：一般默认设置为“0”“1”的情况

idCode

public String idCode(Object pId,
                     int id,
                     int bitW)

根据父节点新建一个新节点，如ID：0102 (bitW=2)

参数:

pId - 父级编码

id - 子级编号

bitW - 编号层级的宽度，如：bitW=3

返回:

String

sameIf

public Map<String,Object> sameIf(Map<String,?> cond,
                                 String[] keys)

拼装检查数据重复的条件，默认“第一个”值是主键，首先要排除主键

sameIf

public Map<String,Object> sameIf(Map<String,?> cond,
                                 int offset,
                                 String[] keys)

检索条件转换

newCond

public Map<String,Object> newCond(Map<String,?> params)

新检索条件

sameId

public Map<String,Object> sameId(Map<String,?> cond,
                                 String key)

检索条件转换

sameNo

public Map<String,Object> sameNo(Map<String,?> cond,
                                 String key)

检索条件转换

checkParams

public boolean checkParams(Map<?,?> map,
                           String[] keys)

检查必须携带的参数

availParams

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

已过时。 这个方法已被弃用，并且在未来版本不再支持。

校验request请求参数是否存在

availParams

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

检查请求（输入）参数是否有效存在

num2Arr

public int[] num2Arr(String numStr)

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

参数:

numStr - 数字的字符串

返回:

Array 累计数组

str2num

public int[] str2num(String numStr)

字符串分割为整数数组

arr2Str

public <T> String arr2Str(T[] strArr)

已过时。 这个方法已被弃用，并且在未来版本用join()替换。

数组合并拼接为字符串

join

public <T> String join(T[] strArr)

数组合并拼接为字符串

join

public <T> String join(T[] strArr,
                       String joint)

数组合并拼接为字符串

getInt

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

从对象中获取整数值

getLong

public long getLong(Map<String,?> map,
                    String key)

从对象中获取整数值

initCap

public String initCap(Object str)

将字符串的首字母转大写

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

map2Obj

public Map<String,Object> map2Obj(Map<String,?> map)

Map对象数据互转

parse

public <T> List<Map<String,T>> parse(Map<String,String> parser,
                                     List<Map<String,T>> list)

通过参数映射解析器，进行参数主键转换
转换：newMap.put(parser.getKey(), oldMap.get(parser.getValue()));
映射示例：parser={empUid=userId, empComp=userComp, empName=userName}

parse

public <T> Map<String,T> parse(Map<String,?> parser,
                               Map<String,T> map)

通过参数映射解析器，进行参数主键转换
转换：newMap.put(parser.getKey(), oldMap.get(parser.getValue()));
映射示例：parser={empUid=userId, empComp=userComp, empName=userName}

mapParser

public <T> Map<String,T> mapParser(Map<String,?> parser,
                                   Map<String,T> map)

已过时。 这个方法已被弃用，并且在未来版本用parse()替换。

通过参数映射解析器，进行参数主键转换

mapParser

public <T> List<Map<String,T>> mapParser(Map<String,String> parser,
                                         List<Map<String,T>> list)

已过时。 这个方法已被弃用，并且在未来版本用parse()替换。

通过参数映射解析器，进行参数主键转换

obj2Map

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

对象转换为Map对象

obj2List

public <T> List<T> obj2List(Object data)

对象转换为List对象

obj2Map

public Map<String,String> obj2Map(Map<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

sqlOr

public String sqlOr(String[] fields)

拼接SQL字符串的单引号'val'值

sqlVal

public String sqlVal(Object val)

拼接SQL字符串的单引号'val'值

jsonExt

public String jsonExt(String field,
                      Object key)

拼接json格式的SQL语句

jsonExt

public String jsonExt(String field,
                      Object key,
                      String opr)

拼接json格式的SQL语句

json2Map

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

把jsonStr转换成为Map对象

参数:

str -

返回:

Map

json2List

public <T> List<T> json2List(Object str)

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

getArr

public <T> String[] getArr(List<Map<String,T>> list,
                           String key)

获取list中某一列的值，list中某列的数值转换为数组并去重

toSet

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

获取list中某一列的值，list中某列的数值转换为Set并去重

toMap

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

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

toMap

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

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

list2Map

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

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

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)

返回失败消息

isFailed

public <T> boolean isFailed(Map<String,T> result)

isSuccess

public <T> boolean isSuccess(Map<String,T> result)

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,
                      Object str)

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

findIn

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

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

findIn

public boolean findIn(String str,
                      String regex)

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

isNil

public boolean isNil(Object obj)

判断字符串是否为“0”

isBlank

public boolean isBlank(Object obj)

判断字符串是否为空

isEmpty

public boolean isEmpty(Object obj)

判断字符串是否为空

isEmpty

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

判断对象是否为空

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 dateStr,
                          String pat)

判断是否为时间格式

timeFormat

public String timeFormat(String str,
                         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

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

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）

buildUri

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

构建URI参数

notEmpty

public boolean notEmpty(String[] values)

判断字符数组，不为空

参数:

values - 字符数组

返回:

true or false

toStep

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

数字步进，按step累加

close

public void close(Closeable[] closeables)

关闭对象

close

public void close(Closeable closeable1,
                  Closeable closeable2)

关闭对象

close

public void close(Closeable closeable)

关闭对象

toYuan

public String toYuan(String money)

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

toYuan

public String toYuan(String money,
                     String def)

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

toCent

public String toCent(String money)

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

toCent

public String toCent(String money,
                     String def)

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

toRmb

public String toRmb(String money)

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

toRmb

public String toRmb(long num)

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

newLeafId

public String newLeafId(Object pid,
                        List<Map<String,String>> list,
                        String key,
                        int bitW)

生成树形结构的叶子项目编号

参数:

list - 已有的叶子项目列表

key - 项目主键

pid - 父级项目编号

bitW - 单层项目编号的位数

pHolder

public String pHolder(Object key,
                      String opr)

占位符处理：placeHolder

参数:

opr - 运算符号

quote

public String quote(Object key,
                    String ch)

引用"key"