StringUtil (xnx3-util 1.0.0 API)

java.lang.Object
- com.xnx3.StringUtil

```
public class StringUtil
extends Object
```
字符串相关常用工具类

作者:

管雷鸣

字段概要

字段
限定符和类型	字段和说明
`static char[]`	`AZ09CHAR_36` 0-9 、 a-z 一共36个字符
`static char[]`	`AZCHAR_26` 26个字母
`static Object[][]`	`UTF8UNICODE` UTF8编码，16进制区间

构造器概要

构造器
构造器和说明

StringUtil()

构造器
构造器和说明
`StringUtil()`

方法概要

所有方法静态方法具体方法已过时的方法
限定符和类型	方法和说明
`static int`	`_36ToInt(String string)`
`static String`	`encrypt(String text, int shiftNum)` 对某个字符串进行位移操作，利用位移来进行简单的加密、解密
`static String`	`filterChineseSpecialSymbol(String text)` 过滤中文特殊字符，如叹号、百分号、星号、叹号、逗号、句号、引号等等等等
`static String`	`filterEnglishSpecialSymbol(String text)` 过滤英文特殊字符，如叹号、百分号、星号、叹号、逗号、句号、引号等等等等
`static String`	`filterHtmlTag(String text)` 过滤HTML标签，返回文本内容
`static String`	`filterXss(String text)` 过滤XSS攻击有关的字符。
`static String`	`firstCharToLowerCase(String s)` 字符串中 1.首先，若首字母是大写，则转小写 2.然后将字符串中出现的大写字母转为下划线加小写（相当于JPA实体类，会自动将数据表的名字转换成数据库名一般）
`static String`	`getRandom09AZ(int length)` 生成随机长度的英文+数字（0-9 10个数字、a－z，26个英文字母）
`static String`	`getRandomAZ(int length)` 生成随机长度的英文（a－z，26个英文字母）
`static String`	`getStringLanguage(String text)` 获取制定的utf-8文字编码是哪国什么语言，中文、英语、阿拉伯语、.....
`static String`	`halfToFullChar(String str)` 半角字符串转成全角字符串
`static String`	`inputStreamToString(InputStream in, String encode)` 将输入流 `InputStream` 转化为 `String`
`static String`	`insert(String sourceString, String insertString, int place)` 再字符串的某个位置，插入一个新的字符串比如原始字符串为 abcd ，在位置1插入，插入一个@符，则会变为 a@bcd
`static String`	`intTo36(int num)` 将十进制的int数，转化为 0-9 + a-z 的36进制字符串，从而所见其长度
`static void`	`main(String[] args)`
`static String`	`removeBlank(String str)` 将当前字符串内的空格、换行、tab缩进等空白符号移除若传入null，会原样返回
`static String`	`replaceAll(String text, String regex, String replacement)` 正则替换
`static List<String>`	`split(String content, String regex)` split 根据指定的字符分割字符串为List输出
`static boolean`	`StringEqual(String S1, String S2)` 两个String字符串比较是否相等。
`static boolean`	`StringEqual(String S1, String S2, boolean removeBlank)` 两个String字符串比较是否相等。
`static boolean`	`StringEqual(String S1, String S2, boolean removeBlank, boolean ignoreNull)` 两个String字符串比较是否相等。
`static InputStream`	`stringToInputStream(String text, String encode)` 将 `String` 字符串转化为 `InputStream`输入流
`static String`	`stringToUrl(String content)` UTF-8格式汉字转换为%E4%BD%A0形式
`static String`	`StringToUtf8(String text)` 字符串转UTF8编码字符串
`static String`	`subString(String sourceString, String startString, String endString)` 从给定的字符串中截取想要的指定字符。
`static String`	`subString(String sourceString, String startString, String endString, int matchType)` 从给定的字符串中截取想要的指定字符
`static String`	`subStringReplace(String text, String startString, String endString, String replaceNewString)` 对一个原始字符串内，指定两个字符串中间的区域文字进行替换操作，将中间的这段文字替换为另一段如:要将字符串1234567890内的3456789替换为abc，最终得到字符串12abc0,则这样写 subStringReplace("1234567890","34","789","abc");
`static String`	`urlToString(String content)` 将%E4%BD%A0转换为UTF-8格式汉字
`static int`	`Utf8ToInt(String text)` 字符转UTF8的16进制编码，只支持单个文字转换!
`static String`	`utf8ToString(String text)` 将UTF-8编码的字符串转换为正常字符串
`static String`	`Utf8ToString(String text)` 已过时。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - AZ09CHAR_36
```
public static final char[] AZ09CHAR_36
```
    0-9 、 a-z 一共36个字符
  - AZCHAR_26
```
public static final char[] AZCHAR_26
```
    26个字母
  - UTF8UNICODE
```
public static Object[][] UTF8UNICODE
```
    UTF8编码，16进制区间
- 构造器详细资料
  - StringUtil
```
public StringUtil()
```
- 方法详细资料
  - intTo36
```
public static String intTo36(int num)
```
    将十进制的int数，转化为 0-9 + a-z 的36进制字符串，从而所见其长度
    
    参数:
    
    num - 要转换的十进制数
    
    返回:
    
    转换好的36进制字符串
  - _36ToInt
```
public static int _36ToInt(String string)
```
  - Utf8ToString
```
public static String Utf8ToString(String text)
```
    已过时。
    
    字符串转UTF8编码(16进制如管雷鸣)
    建议使用 StringToUtf8
    
    参数:
    
    text - 要转成utf8的文字
    
    返回:
    
    16进制编码，如管雷鸣
  - StringToUtf8
```
public static String StringToUtf8(String text)
```
    字符串转UTF8编码字符串
    
    参数:
    
    text - 要转化你的字符串，如“管雷鸣”
    
    返回:
    
    UTF8编码字符串，如“管雷鸣”
  - utf8ToString
```
public static String utf8ToString(String text)
```
    将UTF-8编码的字符串转换为正常字符串
    
    参数:
    
    text - UTF-8的字符串，如管雷鸣
    
    返回:
    
    正常字符，如管雷鸣
  - getStringLanguage
```
public static String getStringLanguage(String text)
```
    获取制定的utf-8文字编码是哪国什么语言，中文、英语、阿拉伯语、.....
    参数:
    text - 要检测的UTF8编码，可传入：
    
    16进制字符串，如 "管"
    
    单个字符,如 "管"
    
    16进制编码,如 "7ba1"
    返回:
    
    哪国语言，若是返回null，则出错失败
  - Utf8ToInt
```
public static int Utf8ToInt(String text)
```
    字符转UTF8的16进制编码，只支持单个文字转换!若多个只转换第一个
    
    参数:
    
    text - 要转成utf8的文字
    
    返回:
    
    16进制编码，如7ba1 ，若是返回0则是失败
  - filterHtmlTag
```
public static String filterHtmlTag(String text)
```
    过滤HTML标签，返回文本内容
    
    参数:
    
    text - 要过滤的字符串
    
    返回:
    
    过滤掉HTML标签的内容
  - split
```
public static List<String> split(String content,
                                 String regex)
```
    split 根据指定的字符分割字符串为List输出
    
    参数:
    
    content - 要分隔的目标字符串
    
    regex - 分隔符，split的传入值
    
    返回:
    
    分割好的List
  - insert
```
public static String insert(String sourceString,
                            String insertString,
                            int place)
```
    再字符串的某个位置，插入一个新的字符串
    比如原始字符串为 abcd ，在位置1插入，插入一个@符，则会变为 a@bcd
    参数:
    
    sourceString - 原始字符串，要将插入的字符串插入到这里
    
    insertString - 要插入的字符串。若为null或者空字符穿""，则不做任何改动sourceString原样返回
    place - 要插入的字符串，要插入到原始字符串sourceString的位置，其之前有多少个字符，使用indexOf所获得
    
    若传入 -1 ，则不做任何改动sourceString原样返回
    返回:
    
    新的字符串
  - subStringReplace
```
public static String subStringReplace(String text,
                                      String startString,
                                      String endString,
                                      String replaceNewString)
```
    对一个原始字符串内，指定两个字符串中间的区域文字进行替换操作，将中间的这段文字替换为另一段
    如:要将字符串1234567890内的3456789替换为abc，最终得到字符串12abc0,则这样写
```
subStringReplace("1234567890","34","789","abc");
```
    参数:
    
    text - 原始字符串
    
    startString - 要替换的这段区域的文字的开始字符串，替换后会包含这段一块被替换
    
    endString - 要替换的这段区域的文字的结束，替换后会包含这段一块被替换
    
    replaceNewString - 这是要替换成新的字符串
    
    返回:
    
    返回替换好的。若是替换时，找不到替换的
  - getRandomAZ
```
public static String getRandomAZ(int length)
```
    生成随机长度的英文（a－z，26个英文字母）
    
    参数:
    
    length - 生成字符串的长度
    
    返回:
    
    字符串
  - getRandom09AZ
```
public static String getRandom09AZ(int length)
```
    生成随机长度的英文+数字（0-9 10个数字、a－z，26个英文字母）
    
    参数:
    
    length - 生成字符串的长度
    
    返回:
    
    字符串
  - filterXss
```
public static String filterXss(String text)
```
    过滤XSS攻击有关的字符。将其转化为无效标签。过滤script、frame、;、等
    
    参数:
    
    text - 要过滤的原始字符
    
    返回:
    
    生成的无XSS的安全字符
  - inputStreamToString
```
public static String inputStreamToString(InputStream in,
                                         String encode)
                                  throws IOException
```
    将输入流 InputStream 转化为 String
    
    参数:
    
    in - 要转化的输入流 InputStream
    
    encode - 编码，如 UTF-8
    
    返回:
    
    转换好的String字符串
    
    抛出:
    
    IOException - 异常
  - stringToInputStream
```
public static InputStream stringToInputStream(String text,
                                              String encode)
                                       throws UnsupportedEncodingException
```
    将 String 字符串转化为 InputStream输入流
    
    参数:
    
    text - 要转换的字符串
    
    encode - 编码，如UTF-8
    
    返回:
    
    转换好的输入流
    
    抛出:
    
    UnsupportedEncodingException - 异常
  - removeBlank
```
public static String removeBlank(String str)
```
    将当前字符串内的空格、换行、tab缩进等空白符号移除
    若传入null，会原样返回
    
    参数:
    
    str - 要移除空白符号的字符串
    
    返回:
    
    移除空白字符后的字符串
  - StringEqual
```
public static boolean StringEqual(String S1,
                                  String S2)
```
    两个String字符串比较是否相等。可一个为null、一个不为null进行对比
    
    参数:
    
    S1 - 要比较的第一个字符串
    
    S2 - 要比较的第二个字符串
    
    返回:
    
    true:相等
  - StringEqual
```
public static boolean StringEqual(String S1,
                                  String S2,
                                  boolean removeBlank)
```
    两个String字符串比较是否相等。可一个为null、一个不为null进行对比
    
    参数:
    
    S1 - 要比较的第一个字符串
    
    S2 - 要比较的第二个字符串
    
    removeBlank - 是否移除空格、换行、tab缩进等空白符号，true为自动将两个字符串的空符移除掉后在进行比较
    
    返回:
    
    true:相等
  - StringEqual
```
public static boolean StringEqual(String S1,
                                  String S2,
                                  boolean removeBlank,
                                  boolean ignoreNull)
```
    两个String字符串比较是否相等。可一个为null、一个不为null进行对比
    
    参数:
    
    S1 - 要比较的第一个字符串
    
    S2 - 要比较的第二个字符串
    
    removeBlank - 是否移除空格、换行、tab缩进等空白符号，true为自动将两个字符串的空符移除掉后在进行比较
    
    ignoreNull - 忽略空，若为true，即 null 跟空字符串"" 视为相等的。若是字符串为"null"，也会自动视为空字符串
    
    返回:
    
    true:相等
  - firstCharToLowerCase
```
public static String firstCharToLowerCase(String s)
```
    字符串中
    1.首先，若首字母是大写，则转小写
    
    2.然后将字符串中出现的大写字母转为下划线加小写
    
    （相当于JPA实体类，会自动将数据表的名字转换成数据库名一般）
    
    参数:
    
    s - 要转换的字符串
    
    返回:
    
    转换好的字符串
  - encrypt
```
public static String encrypt(String text,
                             int shiftNum)
```
    对某个字符串进行位移操作，利用位移来进行简单的加密、解密
    
    参数:
    
    text - 要加密或者解密的字符串
    
    shiftNum - 位移的值
    
    返回:
    
    加密或者解密的字符串
  - stringToUrl
```
public static String stringToUrl(String content)
```
    UTF-8格式汉字转换为%E4%BD%A0形式
    
    参数:
    
    content - 要转换的字符串内容
    
    返回:
    
    String 转换好的字符串
  - urlToString
```
public static String urlToString(String content)
```
    将%E4%BD%A0转换为UTF-8格式汉字
    
    参数:
    
    content - 要转换的内容
    
    返回:
    
    String 转换好的内容
  - replaceAll
```
public static String replaceAll(String text,
                                String regex,
                                String replacement)
```
    正则替换
    
    参数:
    
    text - 操作的内容源，主体
    
    regex - 替换掉的
    
    replacement - 替换成新的，取而代之的
    
    返回:
    
    替换好的内容
  - filterEnglishSpecialSymbol
```
public static String filterEnglishSpecialSymbol(String text)
```
    过滤英文特殊字符，如叹号、百分号、星号、叹号、逗号、句号、引号等等等等
    
    参数:
    
    text - 要过滤得原始字符串
    
    返回:
    
    过滤完后得字符串
  - filterChineseSpecialSymbol
```
public static String filterChineseSpecialSymbol(String text)
```
    过滤中文特殊字符，如叹号、百分号、星号、叹号、逗号、句号、引号等等等等
    
    参数:
    
    text - 要过滤得原始字符串
    
    返回:
    
    过滤完后得字符串
  - halfToFullChar
```
public static String halfToFullChar(String str)
```
    半角字符串转成全角字符串
    
    参数:
    
    str - 要转换的半角字符串
    
    返回:
    
    转换好的全角字符串
  - subString
```
public static String subString(String sourceString,
                               String startString,
                               String endString,
                               int matchType)
```
    从给定的字符串中截取想要的指定字符
    参数:
    
    sourceString - 源字符串，要切割的字符串
    startString - 匹配的开始点字符
    
    若为null或者""表示从头开始匹配
    
    若是没找到开始点字符串，默认为从最开始匹配
    endString - 匹配的结束点字符
    
    若为null或者""表示匹配到末尾
    
    若是没找到结束点字符串，默认为匹配到最末尾
    matchType - 此项是针对结尾的匹配,可传入：
    
    1:开始匹配找到的第一个，结束匹配找到的最后一个。
    
    2:开始匹配找到的第一个，结束匹配：找到的开始位置往后的第一个。
    
    3.开始匹配找到的最后一个，结束匹配找到的最后一个。
    
    4:开始匹配找到的最后一个，结束匹配：找到的开始位置往后的第一个。
    返回:
    
    截取的字符串,若是传入了但是没找到开始或者结束字符则返回null
  - subString
```
public static String subString(String sourceString,
                               String startString,
                               String endString)
```
    从给定的字符串中截取想要的指定字符。
    注意：开始跟结束的两个字符串必须是这段字符中是唯一存在的(此为匹配开始字符串第一个到结束字符串最后一个)
    参数:
    
    sourceString - 源字符串，要切割的字符串
    startString - 匹配的开始点字符
    
    若为null或者""表示从头开始匹配
    
    若是没找到开始点字符串，默认为从最开始匹配
    endString - 匹配的结束点字符
    
    若为null或者""表示匹配到末尾
    
    若是没找到结束点字符串，默认为匹配到最末尾
    返回:
    
    截取的字符串,若是传入了但是没找到开始或者结束字符则返回null
    
    另请参阅:
    
    Lang.subString(String, String, String, int)
  - main
```
public static void main(String[] args)
```

类 StringUtil

字段概要

构造器概要

方法概要

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

字段详细资料

AZ09CHAR_36

AZCHAR_26

UTF8UNICODE

构造器详细资料

StringUtil

方法详细资料

intTo36

_36ToInt

Utf8ToString

StringToUtf8

utf8ToString

getStringLanguage

Utf8ToInt

filterHtmlTag

split

insert

subStringReplace

getRandomAZ

getRandom09AZ

filterXss

inputStreamToString

stringToInputStream

removeBlank

StringEqual

StringEqual

StringEqual

firstCharToLowerCase

encrypt

stringToUrl

urlToString

replaceAll

filterEnglishSpecialSymbol

filterChineseSpecialSymbol

halfToFullChar

subString

subString

main