$ (bus-core 5.8.9 API)

java.lang.Object
- org.aoju.bus.core.utils.$

```
public class $
extends Object
```
工具包集合,工具类快捷方式

Since:

JDK 1.8+

Version:

5.8.9

Author:

Kimi Liu

Constructor Summary

Constructors
Constructor and Description

$()

Constructors
Constructor and Description
`$()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`cleanIdentifier(String param)` 获取标识符,用于参数清理
`static String`	`cleanText(String txt)` 清理字符串,清理出某些不可见字符和一些sql特殊字符
`static String[]`	`concat(String[] one, String[] other)` 连接两个数组
`static <T> T[]`	`concat(T[] one, T[] other, Class<T> clazz)` 连接两个数组
`static boolean`	`contains(Enumeration<?> enumeration, Object element)` 判断枚举是否包含该元素
`static boolean`	`contains(Iterator<?> iterator, Object element)` 判断迭代器中是否包含元素
`static <T> boolean`	`contains(T[] array, T element)` 判断数组中是否包含元素
`static Object`	`defaultIfNull(Object object, Object defaultValue)` 如果对象为null,返回默认值
`static boolean`	`equals(Object o1, Object o2)` 对象 equals
`static boolean`	`equalsSafe(Object o1, Object o2)` 安全的 equals
`static String`	`firstCharToLower(String str)` 首字母变小写
`static String`	`firstCharToUpper(String str)` 首字母变大写
`static String`	`format(String message, Map<String,Object> params)` 将字符串中特定模式的字符转换成map中对应的值
`static String`	`format(String message, Object... arguments)` 同 log 格式的 format 规则
`static int`	`hashCode(Object obj)` 返回对象的 hashCode
`static boolean`	`isAnyBlank(CharSequence... cs)` 判断是否有任意一个空字符串
`static boolean`	`isArray(Object obj)` 判断对象是数组
`static boolean`	`isBlank(CharSequence cs)` 判断是否为空字符串 $.isBlank(null) = true $.isBlank("") = true $.isBlank(" ") = true $.isBlank("12345") = false $.isBlank(" 12345 ") = false
`static boolean`	`isEmpty(Object obj)` 判断空对象 object、map、list、set、字符串、数组
`static boolean`	`isEmpty(Object[] array)` 判断数组为空
`static boolean`	`isFalse(Boolean object)` 判断对象为false
`static boolean`	`isNotBlank(CharSequence cs)` 判断不为空字符串
`static boolean`	`isNotEmpty(Object obj)` 对象不为空 object、map、list、set、字符串、数组
`static boolean`	`isNotEmpty(Object[] array)` 判断数组不为空
`static boolean`	`isNotEqual(Object o1, Object o2)` 比较两个对象是否不相等
`static boolean`	`isNotNull(Object obj)` 判断对象是否 not null
`static boolean`	`isNull(Object obj)` 判断对象是否为null
`static boolean`	`isTrue(Boolean object)` 判断对象为true
`static <E> List<E>`	`ofImmutableList(E... es)` 不可变 List
`static <E> Set<E>`	`ofImmutableSet(E... es)` 不可变 Set
`static <T> T`	`requireNotNull(T obj)` 断言,必须不能为 null
`static <T> T`	`requireNotNull(T obj, String message)` 断言,必须不能为 null
`static <T> T`	`requireNotNull(T obj, Supplier<String> messageSupplier)` 断言,必须不能为 null

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - $
```
public $()
```
- Method Detail
  - requireNotNull
```
public static <T> T requireNotNull(T obj)
```
    断言,必须不能为 null
    
    Type Parameters:
    
    T - 引用的类型
    
    Parameters:
    
    obj - 检查无效的对象引用
    
    Returns:
    
    obj 是否为 null
    
    Throws:
    
    NullPointerException - 如果 obj 为 null
  - requireNotNull
```
public static <T> T requireNotNull(T obj,
                                   String message)
```
    断言,必须不能为 null
    
    Type Parameters:
    
    T - 引用的类型
    
    Parameters:
    
    obj - 检查是否为空的对象引用
    
    message - 在抛出NullPointerException时使用的详细信息
    
    Returns:
    
    obj 如果不为 null
    
    Throws:
    
    NullPointerException - 如果 obj 为 null
  - requireNotNull
```
public static <T> T requireNotNull(T obj,
                                   Supplier<String> messageSupplier)
```
    断言,必须不能为 null
    
    Type Parameters:
    
    T - 引用的类型
    
    Parameters:
    
    obj - 检查是否为空的对象引用
    
    messageSupplier - 在抛出NullPointerException时使用的详细信息的提供者
    
    Returns:
    
    obj 如果不为 null
    
    Throws:
    
    NullPointerException - 如果 obj 为 null
  - isTrue
```
public static boolean isTrue(Boolean object)
```
    判断对象为true
    
    Parameters:
    
    object - 对象
    
    Returns:
    
    对象是否为true
  - isFalse
```
public static boolean isFalse(Boolean object)
```
    判断对象为false
    
    Parameters:
    
    object - 对象
    
    Returns:
    
    对象是否为false
  - isNull
```
public static boolean isNull(Object obj)
```
    判断对象是否为null
    
    Parameters:
    
    obj - 要根据null检查的引用
    
    Returns:
    
    如果提供的引用是null，则为true;否则为false
    
    See Also:
    
    Predicate
  - isNotNull
```
public static boolean isNotNull(Object obj)
```
    判断对象是否 not null
    
    Parameters:
    
    obj - 要根据null检查的引用
    
    Returns:
    
    如果提供的引用是null，则为true;否则为false
    
    See Also:
    
    Predicate
  - firstCharToLower
```
public static String firstCharToLower(String str)
```
    首字母变小写
    
    Parameters:
    
    str - 字符串
    
    Returns:
    
    {String}
  - firstCharToUpper
```
public static String firstCharToUpper(String str)
```
    首字母变大写
    
    Parameters:
    
    str - 字符串
    
    Returns:
    
    {String}
  - isBlank
```
public static boolean isBlank(CharSequence cs)
```
    判断是否为空字符串
```
 $.isBlank(null)                   = true
 $.isBlank("")             = true
 $.isBlank(" ")            = true
 $.isBlank("12345")        = false
 $.isBlank(" 12345 ")      = false
 
```
    Parameters:
    
    cs - 要检查的CharSequence 可以是null
    
    Returns:
    
    如果CharSequence不是null，那么它的长度大于0，并且不包含空格
    
    See Also:
    
    Character.isWhitespace(char)
  - isNotBlank
```
public static boolean isNotBlank(CharSequence cs)
```
    判断不为空字符串
```
 $.isNotBlank(null)        = false
 $.isNotBlank("")                  = false
 $.isNotBlank(" ")         = false
 $.isNotBlank("bob")       = true
 $.isNotBlank("  bob  ") = true
 
```
    Parameters:
    
    cs - 要检查的CharSequence可能为空
    
    Returns:
    
    如果CharSequence不为空，不为空白，则为true
    
    See Also:
    
    Character.isWhitespace(char)
  - isAnyBlank
```
public static boolean isAnyBlank(CharSequence... cs)
```
    判断是否有任意一个空字符串
    
    Parameters:
    
    cs - 要检查的CharSequence可能为空
    
    Returns:
    
    如果CharSequence不为空，不为空白，则为true
  - isArray
```
public static boolean isArray(Object obj)
```
    判断对象是数组
    
    Parameters:
    
    obj - 要检查的对象可能为空
    
    Returns:
    
    是否数组
  - isEmpty
```
public static boolean isEmpty(Object obj)
```
    判断空对象 object、map、list、set、字符串、数组
    
    Parameters:
    
    obj - 要检查的对象可能为空
    
    Returns:
    
    数组是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(Object obj)
```
    对象不为空 object、map、list、set、字符串、数组
    
    Parameters:
    
    obj - 要检查的对象可能为空
    
    Returns:
    
    是否不为空
  - isEmpty
```
public static boolean isEmpty(Object[] array)
```
    判断数组为空
    
    Parameters:
    
    array - 要检查的数组可能为空
    
    Returns:
    
    数组是否为空
  - isNotEmpty
```
public static boolean isNotEmpty(Object[] array)
```
    判断数组不为空
    
    Parameters:
    
    array - 数组
    
    Returns:
    
    数组是否不为空
  - format
```
public static String format(String message,
                            Map<String,Object> params)
```
    将字符串中特定模式的字符转换成map中对应的值
    use: format("my name is ${name}, and i like ${like}!", {"name":"L.cm", "like": "Java"})
    
    Parameters:
    
    message - 需要转换的字符串
    
    params - 转换所需的键值对集合
    
    Returns:
    
    转换后的字符串
  - format
```
public static String format(String message,
                            Object... arguments)
```
    同 log 格式的 format 规则
    use: format("my name is {}, and i like {}!", "L.cm", "Java")
    
    Parameters:
    
    message - 需要转换的字符串
    
    arguments - 需要替换的变量
    
    Returns:
    
    转换后的字符串
  - cleanText
```
public static String cleanText(String txt)
```
    清理字符串,清理出某些不可见字符和一些sql特殊字符
    
    Parameters:
    
    txt - 文本
    
    Returns:
    
    {String}
  - cleanIdentifier
```
public static String cleanIdentifier(String param)
```
    获取标识符,用于参数清理
    
    Parameters:
    
    param - 参数
    
    Returns:
    
    清理后的标识符
  - equalsSafe
```
public static boolean equalsSafe(Object o1,
                                 Object o2)
```
    安全的 equals
    
    Parameters:
    
    o1 - 第一个比较对象
    
    o2 - 第二个比较对象
    
    Returns:
    
    给定对象是否相等
    
    See Also:
    
    Object.equals(Object), Arrays.equals(long[], long[])
  - equals
```
public static boolean equals(Object o1,
                             Object o2)
```
    对象 equals
    
    Parameters:
    
    o1 - 第一个比较对象
    
    o2 - 第二个比较对象
    
    Returns:
    
    给定对象是否相等
  - isNotEqual
```
public static boolean isNotEqual(Object o1,
                                 Object o2)
```
    比较两个对象是否不相等
    
    Parameters:
    
    o1 - 第一个比较对象
    
    o2 - 第二个比较对象
    
    Returns:
    
    给定对象是否相等
  - hashCode
```
public static int hashCode(Object obj)
```
    返回对象的 hashCode
    
    Parameters:
    
    obj - Object
    
    Returns:
    
    hashCode
  - defaultIfNull
```
public static Object defaultIfNull(Object object,
                                   Object defaultValue)
```
    如果对象为null,返回默认值
    
    Parameters:
    
    object - Object
    
    defaultValue - 默认值
    
    Returns:
    
    Object
  - contains
```
public static <T> boolean contains(T[] array,
                                   T element)
```
    判断数组中是否包含元素
    
    Type Parameters:
    
    T - 引用的类型
    
    Parameters:
    
    array - 要检查的数组
    
    element - 要查找的元素
    
    Returns:
    
    如果找到 true,否则false
  - contains
```
public static boolean contains(Iterator<?> iterator,
                               Object element)
```
    判断迭代器中是否包含元素
    
    Parameters:
    
    iterator - 要检查的迭代器
    
    element - 要查找的元素
    
    Returns:
    
    如果找到 true,否则false
  - contains
```
public static boolean contains(Enumeration<?> enumeration,
                               Object element)
```
    判断枚举是否包含该元素
    
    Parameters:
    
    enumeration - 要检查的枚举
    
    element - 要查找的元素
    
    Returns:
    
    如果找到 true,否则false
  - concat
```
public static String[] concat(String[] one,
                              String[] other)
```
    连接两个数组
    
    Parameters:
    
    one - 第一个数组
    
    other - 第二个数组
    
    Returns:
    
    连接后的新数组
  - concat
```
public static <T> T[] concat(T[] one,
                             T[] other,
                             Class<T> clazz)
```
    连接两个数组
    
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    one - 第一个数组
    
    other - 第二个数组
    
    clazz - 数组类
    
    Returns:
    
    连接后的新数组
  - ofImmutableSet
```
public static <E> Set<E> ofImmutableSet(E... es)
```
    不可变 Set
    
    Type Parameters:
    
    E - 泛型
    
    Parameters:
    
    es - 对象
    
    Returns:
    
    集合
  - ofImmutableList
```
public static <E> List<E> ofImmutableList(E... es)
```
    不可变 List
    
    Type Parameters:
    
    E - 泛型
    
    Parameters:
    
    es - 对象
    
    Returns:
    
    集合

Class $

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

$

Method Detail

requireNotNull

requireNotNull

requireNotNull

isTrue

isFalse

isNull

isNotNull

firstCharToLower

firstCharToUpper

isBlank

isNotBlank

isAnyBlank

isArray

isEmpty

isNotEmpty

isEmpty

isNotEmpty

format

format

cleanText

cleanIdentifier

equalsSafe

equals

isNotEqual

hashCode

defaultIfNull

contains

contains

contains

concat

concat

ofImmutableSet

ofImmutableList