cn.nxtools.common

类 StringUtil

java.lang.Object

cn.nxtools.common.StringUtil

所有已实现的接口:

StringPool

public class StringUtil
extends java.lang.Object
implements StringPool

字段概要

从接口继承的字段 cn.nxtools.common.text.StringPool

AT, COLON, COMMA, DASHED, EMPTY, EMPTY_ARRAY, EMPTY_JSON, NULL, SPACE, UNDER_LINE

方法概要

限定符和类型	方法和说明
static <T extends java.lang.CharSequence> T	defaultIfEmpty(T string, T defaultString) 为null或""返回默认值,否则返回目标参数 StringUtil.defaultIfEmpty(null, "默认值") = "默认值" StringUtil.defaultIfEmpty("", "默认值") = "默认值" StringUtil.defaultIfEmpty(" ", "默认值") = " " StringUtil.defaultIfEmpty("abc", "默认值")= "abc"
static <T extends java.lang.CharSequence> T	defaultIfNull(T string, T defaultString) 为null返回默认值,否则返回目标参数值 StringUtil.defaultIfNull(null, "默认值") = "默认值" StringUtil.defaultIfNull("", "默认值") = "" StringUtil.defaultIfNull(" ", "默认值") = " " StringUtil.defaultIfNull("abc", "默认值")= "abc"
static java.lang.String	format(java.lang.String template, java.lang.Object... params) 格式化文本, {} 表示占位符 如果自定义占位符请调用 formatWith(String, String, Object...)
static java.lang.String	formatWith(java.lang.String template, java.lang.String placeholder, java.lang.Object... params) 格式化文本 输入占位符 template参数为null时, 返回"null"字符串 占位符(placeholder)为null时, 抛出 IllegalArgumentException异常 占位符(placeholder)为""字符串时, 直接返回template字符串 若参数多于占位符数量, 自动拼接到模版末尾处
static boolean	isEmpty(java.lang.CharSequence charSequence) 判断字符串是否为null或者"" null = true; "" = true; " " = false;
static boolean	isNotEmpty(java.lang.CharSequence charSequence) 判断字符串不是null或"" null = false; "" = false; " " = true;
static boolean	isNotNull(java.lang.CharSequence charSequence) 判断字符串不是null null = false; "" = true; " " = true;
static boolean	isNull(java.lang.CharSequence charSequence) 判断字符串是否为null null = true; "" = false; " " = false;
static java.lang.String	leftAppend(java.lang.String str, int size, char appendChar) 字符串左填充 StringUtil.leftAppend(null, 5, 'a') = null StringUtil.leftAppend("bc", -1, 'a')= "bc" StringUtil.leftAppend("bc", 5, 'a') = "aaabc" StringUtil.leftAppend("bc", 2, 'a') = "bc"
static java.lang.String	leftAppend(java.lang.String str, int size, java.lang.String appendStr) 字符串左填充 待填充字符串为null,填充后结果也为null StringUtil.leftAppend(null, 5, "0") = null StringUtil.leftAppend("bc", -1, "aa") = "bc" StringUtil.leftAppend("bc", 5, "aa") = "aaabc" StringUtil.leftAppend("bc", 2, "aa") = "bc" StringUtil.leftAppend("bc", 5, "") = "bc"
static int	length(java.lang.CharSequence charSequence) 字符串长度 参数为null 返回长度为0 StringUtil.length(null) = 0 StringUtil.length("") = 0
static java.lang.String	objToString(java.lang.Object o) Object转String 调用 Object.toString() o为null 返回 "null" 字符串
static java.lang.String	rightAppend(java.lang.String str, int size, char appendChar) 字符串右填充 StringUtil.rightAppend(null, 5, 'a') = null StringUtil.rightAppend("bc", -1, 'a')= "bc" StringUtil.rightAppend("bc", 5, 'a') = "bcaaa" StringUtil.rightAppend("bc", 2, 'a') = "bc"
static java.lang.String	rightAppend(java.lang.String str, int size, java.lang.String appendStr) 字符串左填充 待填充字符串为null,填充后结果也为null StringUtil.rightAppend(null, 5, "0") = null StringUtil.rightAppend("bc", -1, "aa") = "bc" StringUtil.rightAppend("bc", 5, "aa") = "bcaaa" StringUtil.rightAppend("bc", 2, "aa") = "bc" StringUtil.rightAppend("bc", 5, "") = "bc"

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

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

方法详细资料

isNull

public static boolean isNull(java.lang.CharSequence charSequence)

判断字符串是否为null

 null = true;
 "" = false;
 " " = false;
 

参数:

charSequence - 字符串

返回:

是否为空

isEmpty

public static boolean isEmpty(java.lang.CharSequence charSequence)

判断字符串是否为null或者""

 null = true;
 "" = true;
 " " = false;
 

参数:

charSequence - 校验参数

返回:

true或者false

isNotNull

public static boolean isNotNull(java.lang.CharSequence charSequence)

判断字符串不是null

 null = false;
 "" = true;
 " " = true;
 

参数:

charSequence - 校验参数

返回:

true或者false

isNotEmpty

public static boolean isNotEmpty(java.lang.CharSequence charSequence)

判断字符串不是null或""

 null = false;
 "" = false;
 " " = true;
 

参数:

charSequence - 校验参数

返回:

true或者false

format

public static java.lang.String format(java.lang.String template,
                                      java.lang.Object... params)

格式化文本, {} 表示占位符
如果自定义占位符请调用 formatWith(String, String, Object...)

 若参数多于占位符数量, 自动拼接到模版末尾处
 

参数:

template - 文本模版

params - 文本参数值

返回:

如果template参为null,返回"null"字符串

从以下版本开始:

1.0.2

formatWith

public static java.lang.String formatWith(java.lang.String template,
                                          java.lang.String placeholder,
                                          java.lang.Object... params)

格式化文本
输入占位符

 template参数为null时, 返回"null"字符串
 占位符(placeholder)为null时, 抛出 IllegalArgumentException异常
 占位符(placeholder)为""字符串时, 直接返回template字符串
 若参数多于占位符数量, 自动拼接到模版末尾处

 

参数:

template - 文本模版

placeholder - 占位符

params - 文本参数值

返回:

如果template参为null,返回"null"字符串

从以下版本开始:

1.0.2

objToString

public static java.lang.String objToString(java.lang.Object o)

Object转String
调用 Object.toString()
o为null 返回 "null" 字符串

参数:

o - 待转String字符串

返回:

结果字符串

length

public static int length(java.lang.CharSequence charSequence)

字符串长度
参数为null 返回长度为0

 StringUtil.length(null) = 0
 StringUtil.length("")   = 0
 

参数:

charSequence - 参数字符串

返回:

字符串长度

defaultIfNull

public static <T extends java.lang.CharSequence> T defaultIfNull(T string,
                                                                 T defaultString)

为null返回默认值,否则返回目标参数值

 StringUtil.defaultIfNull(null, "默认值") = "默认值"
 StringUtil.defaultIfNull("", "默认值")   = ""
 StringUtil.defaultIfNull(" ", "默认值")  = " "
 StringUtil.defaultIfNull("abc", "默认值")= "abc"
 

类型参数:

T - T

参数:

string - 目标参数

defaultString - 目标参数为null返回defaultString

返回:

string为null返回defaultString, 否则返回string

defaultIfEmpty

public static <T extends java.lang.CharSequence> T defaultIfEmpty(T string,
                                                                  T defaultString)

为null或""返回默认值,否则返回目标参数

 StringUtil.defaultIfEmpty(null, "默认值") = "默认值"
 StringUtil.defaultIfEmpty("", "默认值")   = "默认值"
 StringUtil.defaultIfEmpty(" ", "默认值")  = " "
 StringUtil.defaultIfEmpty("abc", "默认值")= "abc"
 

类型参数:

T - T

参数:

string - 目标参数

defaultString - 目标参数为null或""返回defaultString

返回:

string为null或""返回defaultString, 否则返回string

leftAppend

public static java.lang.String leftAppend(java.lang.String str,
                                          int size,
                                          char appendChar)

字符串左填充

 StringUtil.leftAppend(null, 5, 'a') = null
 StringUtil.leftAppend("bc", -1, 'a')= "bc"
 StringUtil.leftAppend("bc", 5, 'a') = "aaabc"
 StringUtil.leftAppend("bc", 2, 'a') = "bc"
 

参数:

str - 待填充字符串

size - 填充后字符串总长度

appendChar - 填充的字符

返回:

填充后的字符串

leftAppend

public static java.lang.String leftAppend(java.lang.String str,
                                          int size,
                                          java.lang.String appendStr)

字符串左填充
待填充字符串为null,填充后结果也为null

 StringUtil.leftAppend(null, 5, "0")   = null
 StringUtil.leftAppend("bc", -1, "aa") = "bc"
 StringUtil.leftAppend("bc", 5, "aa")  = "aaabc"
 StringUtil.leftAppend("bc", 2, "aa")  = "bc"
 StringUtil.leftAppend("bc", 5, "")    = "bc"
 

参数:

str - 待填充字符串

size - 填充后字符串总长度

appendStr - 填充字符串,不能为空

返回:

填充后的字符串

rightAppend

public static java.lang.String rightAppend(java.lang.String str,
                                           int size,
                                           char appendChar)

字符串右填充

 StringUtil.rightAppend(null, 5, 'a') = null
 StringUtil.rightAppend("bc", -1, 'a')= "bc"
 StringUtil.rightAppend("bc", 5, 'a') = "bcaaa"
 StringUtil.rightAppend("bc", 2, 'a') = "bc"
 

参数:

str - 待填充字符串

size - 填充后字符串总长度

appendChar - 填充的字符

返回:

填充后的字符串

rightAppend

public static java.lang.String rightAppend(java.lang.String str,
                                           int size,
                                           java.lang.String appendStr)

字符串左填充
待填充字符串为null,填充后结果也为null

 StringUtil.rightAppend(null, 5, "0")   = null
 StringUtil.rightAppend("bc", -1, "aa") = "bc"
 StringUtil.rightAppend("bc", 5, "aa")  = "bcaaa"
 StringUtil.rightAppend("bc", 2, "aa")  = "bc"
 StringUtil.rightAppend("bc", 5, "")    = "bc"
 

参数:

str - 待填充字符串

size - 填充后字符串总长度

appendStr - 填充字符串,不能为空

返回:

填充后的字符串