org.apache.commons.lang.StringUtil(StringUtil工具类的常用方法)

StringUtils 的详细 API 请参见官方网站: http://commons.apache.org/lang/api/org/apache/commons/lang/StringUtils.html

—————————————————————————————————————————
StringUtils 方法的操作对象是 java.lang.String 类型的对象,是 JDK 提供的 String 类型操作方法的补充,并且是 null 安全的(即如果输入参数 String 为 null 则不会抛出  NullPointerException ,而是做了相应处理,例如,如果输入为 null 则返回也是 null 等,具体可以查看源代码)。

除了构造器,StringUtils 中一共有130多个方法,并且都是 static 的,所以我们可以这样调用 StringUtils.xxx()

下面分别对一些常用方法做简要介绍:

1. public static boolean isEmpty(String str)
   判断某字符串是否为空,为空的标准是 str==null 或 str.length()==0
   下面是 StringUtils 判断是否为空的示例:

StringUtils.isEmpty(null) = true
StringUtils.isEmpty("") = true
StringUtils.isEmpty(" ") = false //注意在 StringUtils 中空格作非空处理
StringUtils.isEmpty("   ") = false
StringUtils.isEmpty("bob") = false
StringUtils.isEmpty(" bob ") = false



2. public static boolean isNotEmpty(String str)
   判断某字符串是否非空,等于 !isEmpty(String str)
   下面是示例:

      StringUtils.isNotEmpty(null) = false
      StringUtils.isNotEmpty("") = false
      StringUtils.isNotEmpty(" ") = true
      StringUtils.isNotEmpty("         ") = true
      StringUtils.isNotEmpty("bob") = true
      StringUtils.isNotEmpty(" bob ") = true

3. public static boolean isBlank(String str)
   判断某字符串是否为空或长度为0或由空白符(whitespace) 构成
   下面是示例:
      StringUtils.isBlank(null) = true
      StringUtils.isBlank("") = true
      StringUtils.isBlank(" ") = true
      StringUtils.isBlank("        ") = true
      StringUtils.isBlank("\t \n \f \r") = true   //对于制表符、换行符、换页符和回车符

      StringUtils.isBlank()   //均识为空白符
      StringUtils.isBlank("\b") = false   //"\b"为单词边界符
      StringUtils.isBlank("bob") = false
      StringUtils.isBlank(" bob ") = false

4. public static boolean isNotBlank(String str)
   判断某字符串是否不为空且长度不为0且不由空白符(whitespace) 构成,等于 !isBlank(String str)
   下面是示例:

      StringUtils.isNotBlank(null) = false
      StringUtils.isNotBlank("") = false
      StringUtils.isNotBlank(" ") = false
      StringUtils.isNotBlank("         ") = false
      StringUtils.isNotBlank("\t \n \f \r") = false
      StringUtils.isNotBlank("\b") = true
      StringUtils.isNotBlank("bob") = true
      StringUtils.isNotBlank(" bob ") = true

5. public static String trim(String str)
   去掉字符串两端的控制符(control characters, char <= 32) , 如果输入为 null 则返回null
   下面是示例:
      StringUtils.trim(null) = null
      StringUtils.trim("") = ""
      StringUtils.trim(" ") = ""
      StringUtils.trim("  \b \t \n \f \r    ") = ""
      StringUtils.trim("     \n\tss   \b") = "ss"
      StringUtils.trim(" d   d dd     ") = "d   d dd"
      StringUtils.trim("dd     ") = "dd"
      StringUtils.trim("     dd       ") = "dd"

6. public static String trimToNull(String str)
   去掉字符串两端的控制符(control characters, char <= 32) ,如果变为 null 或"",则返回 null
   下面是示例:
      StringUtils.trimToNull(null) = null
      StringUtils.trimToNull("") = null
      StringUtils.trimToNull(" ") = null
      StringUtils.trimToNull("     \b \t \n \f \r    ") = null
      StringUtils.trimToNull("     \n\tss   \b") = "ss"
      StringUtils.trimToNull(" d   d dd     ") = "d   d dd"
      StringUtils.trimToNull("dd     ") = "dd"
      StringUtils.trimToNull("     dd       ") = "dd"

7. public static String trimToEmpty(String str)
   去掉字符串两端的控制符(control characters, char <= 32) ,如果变为 null 或 "" ,则返回 ""
   下面是示例:
      StringUtils.trimToEmpty(null) = ""
      StringUtils.trimToEmpty("") = ""
      StringUtils.trimToEmpty(" ") = ""
      StringUtils.trimToEmpty("     \b \t \n \f \r    ") = ""
      StringUtils.trimToEmpty("     \n\tss   \b") = "ss"
      StringUtils.trimToEmpty(" d   d dd     ") = "d   d dd"
      StringUtils.trimToEmpty("dd     ") = "dd"
      StringUtils.trimToEmpty("     dd       ") = "dd"

8. public static String strip(String str)
   去掉字符串两端的空白符(whitespace) ,如果输入为 null 则返回 null
   下面是示例(注意和 trim() 的区别):
      StringUtils.strip(null) = null
      StringUtils.strip("") = ""
      StringUtils.strip(" ") = ""
      StringUtils.strip("     \b \t \n \f \r    ") = "\b"
      StringUtils.strip("     \n\tss   \b") = "ss   \b"
      StringUtils.strip(" d   d dd     ") = "d   d dd"
      StringUtils.strip("dd     ") = "dd"
      StringUtils.strip("     dd       ") = "dd"

9. public static String stripToNull(String str)
   去掉字符串两端的空白符(whitespace) ,如果变为 null 或"",则返回 null
   下面是示例(注意和 trimToNull() 的区别):
      StringUtils.stripToNull(null) = null
      StringUtils.stripToNull("") = null
      StringUtils.stripToNull(" ") = null
      StringUtils.stripToNull("     \b \t \n \f \r    ") = "\b"
      StringUtils.stripToNull("     \n\tss   \b") = "ss   \b"
      StringUtils.stripToNull(" d   d dd     ") = "d   d dd"
      StringUtils.stripToNull("dd     ") = "dd"
      StringUtils.stripToNull("     dd       ") = "dd"

10. public static String stripToEmpty(String str)
    去掉字符串两端的空白符(whitespace) ,如果变为 null 或"" ,则返回""
    下面是示例(注意和 trimToEmpty() 的区别):
      StringUtils.stripToNull(null) = ""
      StringUtils.stripToNull("") = ""
      StringUtils.stripToNull(" ") = ""
      StringUtils.stripToNull("     \b \t \n \f \r    ") = "\b"
      StringUtils.stripToNull("     \n\tss   \b") = "ss   \b"
      StringUtils.stripToNull(" d   d dd     ") = "d   d dd"
      StringUtils.stripToNull("dd     ") = "dd"
      StringUtils.stripToNull("     dd       ") = "dd"

以下方法只介绍其功能,不再举例:
11. public static String strip(String str, String stripChars)
   去掉 str 两端的在 stripChars 中的字符。
   如果 str 为 null 或等于"" ,则返回它本身;
   如果 stripChars 为 null 或"" ,则返回 strip(String str) 。

12. public static String stripStart(String str, String stripChars)
    和11相似,去掉 str 前端的在 stripChars 中的字符。

13. public static String stripEnd(String str, String stripChars)
    和11相似,去掉 str 末端的在 stripChars 中的字符。

14. public static String[] stripAll(String[] strs)
    对字符串数组中的每个字符串进行 strip(String str) ,然后返回。
    如果 strs 为 null 或 strs 长度为0,则返回 strs 本身

15. public static String[] stripAll(String[] strs, String stripChars)
    对字符串数组中的每个字符串进行 strip(String str, String stripChars) ,然后返回。
    如果 strs 为 null 或 strs 长度为0,则返回 strs 本身

16. public static boolean equals(String str1, String str2)
    比较两个字符串是否相等,如果两个均为空则也认为相等。

17. public static boolean equalsIgnoreCase(String str1, String str2)
    比较两个字符串是否相等,不区分大小写,如果两个均为空则也认为相等。

18. public static int indexOf(String str, char searchChar)
    返回字符 searchChar 在字符串 str 中第一次出现的位置。
    如果 searchChar 没有在 str 中出现则返回-1,
    如果 str 为 null 或 "" ,则也返回-1

19. public static int indexOf(String str, char searchChar, int startPos)
    返回字符 searchChar 从 startPos 开始在字符串 str 中第一次出现的位置。
    如果从 startPos 开始 searchChar 没有在 str 中出现则返回-1,
    如果 str 为 null 或 "" ,则也返回-1

20. public static int indexOf(String str, String searchStr)
    返回字符串 searchStr 在字符串 str 中第一次出现的位置。
    如果 str 为 null 或 searchStr 为 null 则返回-1,
    如果 searchStr 为 "" ,且 str 为不为 null ,则返回0,
    如果 searchStr 不在 str 中,则返回-1

21. public static int ordinalIndexOf(String str, String searchStr, int ordinal)
    返回字符串 searchStr 在字符串 str 中第 ordinal 次出现的位置。
    如果 str=null 或 searchStr=null 或 ordinal<=0 则返回-1
    举例(*代表任意字符串):
      StringUtils.ordinalIndexOf(null, *, *) = -1
      StringUtils.ordinalIndexOf(*, null, *) = -1
      StringUtils.ordinalIndexOf("", "", *) = 0
      StringUtils.ordinalIndexOf("aabaabaa", "a", 1) = 0
      StringUtils.ordinalIndexOf("aabaabaa", "a", 2) = 1
      StringUtils.ordinalIndexOf("aabaabaa", "b", 1) = 2
      StringUtils.ordinalIndexOf("aabaabaa", "b", 2) = 5
      StringUtils.ordinalIndexOf("aabaabaa", "ab", 1) = 1
      StringUtils.ordinalIndexOf("aabaabaa", "ab", 2) = 4
      StringUtils.ordinalIndexOf("aabaabaa", "bc", 1) = -1
      StringUtils.ordinalIndexOf("aabaabaa", "", 1) = 0
      StringUtils.ordinalIndexOf("aabaabaa", "", 2) = 0

22. public static int indexOf(String str, String searchStr, int startPos)
    返回字符串 searchStr 从 startPos 开始在字符串 str 中第一次出现的位置。
    举例(*代表任意字符串):
      StringUtils.indexOf(null, *, *) = -1
      StringUtils.indexOf(*, null, *) = -1
      StringUtils.indexOf("", "", 0) = 0
      StringUtils.indexOf("aabaabaa", "a", 0) = 0
      StringUtils.indexOf("aabaabaa", "b", 0) = 2
      StringUtils.indexOf("aabaabaa", "ab", 0) = 1
      StringUtils.indexOf("aabaabaa", "b", 3) = 5
      StringUtils.indexOf("aabaabaa", "b", 9) = -1
      StringUtils.indexOf("aabaabaa", "b", -1) = 2
      StringUtils.indexOf("aabaabaa", "", 2) = 2
      StringUtils.indexOf("abc", "", 9) = 3

23. public static int lastIndexOf(String str, char searchChar)
    基本原理同18

24. public static int lastIndexOf(String str, char searchChar, int startPos)
    基本原理同19

25. public static int lastIndexOf(String str, String searchStr)
    基本原理同20

26. public static int lastIndexOf(String str, String searchStr, int startPos)
    基本原理同22

另附:

String 的 split(String regex)   方法的用法
如果我们需要把某个字符串拆分为字符串数组,则通常用 split(String regex) 来实现。

例如:


Java代码

Java代码 复制代码
  1. String str = "aa,bb,cc,dd";         
  2. String[] strArray = str.split(",");          
  3. System.out.println(strArray.length);         
  4.   for (int i = 0; i < strArray.length; i++) {         
  5.        System.out.println(strArray[i]);         
  6. }     
  7. String str = "aa,bb,cc,dd";      
  8. String[] strArray = str.split(",");       
  9. System.out.println(strArray.length);      
  10.   for (int i = 0; i < strArray.length; i++) {      
  11.        System.out.println(strArray[i]);      
  12. }    
String str = "aa,bb,cc,dd";      
String[] strArray = str.split(",");       
System.out.println(strArray.length);      
  for (int i = 0; i < strArray.length; i++) {      
       System.out.println(strArray[i]);      
}  
String str = "aa,bb,cc,dd";   
String[] strArray = str.split(",");    
System.out.println(strArray.length);   
  for (int i = 0; i < strArray.length; i++) {   
       System.out.println(strArray[i]);   
}  

结果为:
4
aa
bb
cc
dd

如果,
String str = "aa.bb.cc.dd";
String[] strArray = str.split(".");

则结果为:0

为什么结果不是我们所想的呢,原因是参数 String regex 是正则表达式 (regular expression) 而不是普通字符串,而 "." 在正则表达式中有特殊含义,表示匹配所有单个字符。如果要那样拆分,我们必须给 "." 进行转义,String[] strArray = str.split(".") 修改为 String[] strArray = str.split("\\.") 即可。

<think>我们正在讨论ApacheCommonsLang库中的DateFormatUtils类。根据引用[1]和[2]的上下文,我们知道org.apache.commons.langcommons-lang包的正确基础包名(注意引用[1]中特别指出不是org.apache.commons.lang.xwork)。引用[3]提到Lang模块提供了一些基础类库的扩展,其中包括时间相关的工具类,因此DateFormatUtils应该在这个包下。用户询问的是org.apache.commons.lang.time.DateFormatUtils的使用方法。首先,我们需要确认这个类的存在。在ApacheCommonsLang的文档中,确实有一个DateFormatUtils类,它位于org.apache.commons.lang.time包下。这个类提供了格式化日期和时间的方法,特别是不需要显式创建SimpleDateFormat实例(因此是线程安全的)。接下来,我将介绍DateFormatUtils的一些常用方法:1.**format(Datedate,Stringpattern)**:使用指定的模式格式化日期。2.**format(Calendarcalendar,Stringpattern)**:使用指定的模式格式化日历对象。3.**format(longmillis,Stringpattern)**:使用指定的模式格式化从1970-01-0100:00:00UTC开始的毫秒数。4.**formatUTC(Datedate,Stringpattern)**:使用UTC时区和指定的模式格式化日期。5.**formatUTC(longmillis,Stringpattern)**:使用UTC时区和指定的模式格式化毫秒数。这些方法都是静态的,可以直接通过类名调用。使用示例:```javaimportjava.util.Date;importorg.apache.commons.lang.time.DateFormatUtils;publicclassDateFormatExample{publicstaticvoidmain(String[]args){Datenow=newDate();//格式化为yyyy-MM-ddHH:mm:ssStringformattedDateTime=DateFormatUtils.format(now,"yyyy-MM-ddHH:mm:ss");System.out.println("当前时间:"+formattedDateTime);//使用UTC时区格式化StringutcDateTime=DateFormatUtils.formatUTC(now,"yyyy-MM-ddHH:mm:ss");System.out.println("当前时间(UTC):"+utcDateTime);}}```注意:模式字符串的格式与Java标准库中的SimpleDateFormat相同。另外,需要确保项目中已经正确引入了commons-lang库。如果使用Maven,可以在pom.xml中添加依赖(请根据实际需要选择版本,这里以2.6为例,但请注意,较新的项目可能使用3.x版本,包名改为org.apache.commons.lang3):```xml<dependency><groupId>commons-lang</groupId><artifactId>commons-lang</artifactId><version>2.6</version></dependency>```如果是使用较新的CommonsLang3.x,则包名变为org.apache.commons.lang3,并且DateFormatUtils类在org.apache.commons.lang3.time包下。因此,如果用户使用的是3.x版本,则导入语句应为:```javaimportorg.apache.commons.lang3.time.DateFormatUtils;```Maven依赖为:```xml<dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId><version>3.12.0</version><!--使用最新版本--></dependency>```因此,在回答中需要提醒用户注意版本差异。最后,我们还可以提供一些模式字符串的常见用法,例如:-"yyyy-MM-dd":年-月-日-"HH:mm:ss":时:分:秒(24小时制)-"yyyy-MM-dd'T'HH:mm:ssZ":带时区的格式,如2022-01-01T12:00:00+0800总结:DateFormatUtils是一个方便的工具类,用于安全地格式化日期和时间,避免了SimpleDateFormat的线程安全问题。§§相关问题§§1.DateFormatUtils与Java标准库中的SimpleDateFormat有什么区别?2.如何在多线程环境下安全地使用日期格式化?3.CommonsLang库中还有哪些与时间处理相关的工具类?4.如何将字符串解析为日期对象(使用CommonsLang)?</think>### 使用 `org.apache.commons.lang.time.DateFormatUtils` 的方法 `DateFormatUtils` 是 Apache Commons Lang 库中处理日期格式化的工具类,提供线程安全的日期格式化方法(无需创建 `SimpleDateFormat` 实例)。以下是核心用法: #### 1. **基础格式化** ```java import org.apache.commons.lang.time.DateFormatUtils; import java.util.Date; // 格式化为默认模式 String dateStr = DateFormatUtils.format(new Date(), "yyyy-MM-dd HH:mm:ss"); System.out.println(dateStr); // 输出: 2023-08-15 14:30:45 // 使用预定义模式(ISO8601标准) String isoDate = DateFormatUtils.ISO_DATETIME_FORMAT.format(new Date()); System.out.println(isoDate); // 输出: 2023-08-15T14:30:45 ``` #### 2. **指定时区格式化** ```java import java.util.TimeZone; // UTC时区格式化 String utcDate = DateFormatUtils.format( new Date(), "yyyy-MM-dd HH:mm:ss", TimeZone.getTimeZone("UTC") ); System.out.println(utcDate); // 输出UTC时间,如: 2023-08-15 06:30:45 ``` #### 3. **日历对象格式化** ```java import java.util.Calendar; Calendar calendar = Calendar.getInstance(); String calStr = DateFormatUtils.format(calendar, "yyyy年MM月dd日"); System.out.println(calStr); // 输出: 2023年08月15日 ``` #### 4. **毫秒时间戳格式化** ```java long timestamp = System.currentTimeMillis(); String timeStr = DateFormatUtils.format(timestamp, "HH:mm:ss.SSS"); System.out.println(timeStr); // 输出: 14:30:45.123 ``` ### 注意事项 1. **依赖配置**(Maven): ```xml <!-- Commons Lang 2.x --> <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> <version>2.6</version> </dependency> ``` > ⚠️ 若使用 Lang 3.x,包名改为 `org.apache.commons.lang3.time.DateFormatUtils`。 2. **模式语法**: 与 `SimpleDateFormat` 兼容,例如: - `yyyy`:4位年份 - `MM`:月份(01-12) - `dd`:日期(01-31) - `HH`:24小时制小时 3. **线程安全**: 所有方法均为静态且线程安全[^1][^3]。 ### 完整示例 ```java import org.apache.commons.lang.time.DateFormatUtils; import java.util.*; public class DateExample { public static void main(String[] args) { // 格式化当前日期 String date1 = DateFormatUtils.format(new Date(), "yyyy-MM-dd"); System.out.println("当前日期: " + date1); // 指定时区(GMT+8) String date2 = DateFormatUtils.format( new Date(), "yyyy-MM-dd HH:mm:ss z", TimeZone.getTimeZone("GMT+8") ); System.out.println("北京时间: " + date2); // 输出: 2023-08-15 14:30:45 GMT+08:00 } } ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值