apache commons组件学习系列记录之lang3

索引 说明
org.apache.commons.lang3

ArrayUtils,BooleanUtils,,StringUtils

RandomUtils,RandomStringUtils,

ClassUtils

SerializationUtils

StringEscapeUtils字符串转义,SystemUtils获取各种目录,

NumberUtils用于判断字符是否可以转换为数字很有帮组

org.apache.commons.lang3.builder

ComparaToBuilder,ToStringBuilder,HashCodeBuilder,EqualsBuilder

org.apache.commons.lang3.event EventListenerSupport支持addListener等,EventUtils
org.apache.commons.lang3.time 1.DateFormatUtils格式化Date或Calender;DateUtils
org.apache.commons.lang3.tuple 一对键值对对象的操作MutablePair; ImmutablePair
   



一.org.apache.commons.lang3包

1. ArrayUtils

2.BooleanUtils:能优雅地处理null值等方便转换。

3.RandomUtils自从commons lang3.3发布之后便有了这个类:用于产生一个范围内的随机数。

4.RandomStringUtils,可以用于产生数字,字符及其组合等随机数

5.SerializationUtils增强的功能:深拷贝,方便的反序列化,序列化等。

7.SystemUtils:如果无法取得,不会抛出异常,返回null:用于取得系统环境的相关特殊目录路径。

8.NumberUtils:它的所有操作都不会抛出异常,如果转换不成功返回0,0.0d,0.0f等形式。转换操作也可以指定默认值     


用于从字符串解析并创建对应包装类

用于判断字符串是否为数字形式

用于转换字符串为对应基本类型。

从数组或一组值中判断最小值最大值min(),max()                                  


9.ClassUtils:可以不用反射就可以操作java类。

10:StringEscapeUtils:字符串转义工具: xml,html特殊字符转义等



  1. 1. ArrayUtils

ArrayUtils能优雅地处理数组中的null值输入。它不会抛出异常。

内有很多静态方法用于创建数组,及数组操作。当插入null值时也不会抛出异常

比如向数组添加元素,元素为null则不会抛出异常,而是什么都不做:

ArrayUtils.add([true,false],null)=[true,false]

  1. 2.BooleanUtils:能优雅地处理null值等方便转换。

static Boolean toBooleanObject(String str)

static boolean toBoolean(String str)

static boolean isTrue(Boolean bool)

static boolean isFalse(Boolean bool)

static boolean isNotTrue(Boolean bool)

注意区别:

BooleanUtils.isNotTrue(null)          = true

 BooleanUtils.isFalse(null)          = false

  1. 3.RandomUtils自从commons lang3.3发布之后便有了这个类:用于产生一个范围内的随机数。

RandomUtils帮助我们产生随机数,不止是整数类型。

// 注意这里传入的参数不是随机种子,而是在0~1000之间产生一位随机数

RandomUtils.nextInt(0,1000);

此外还有nextBytes/Double/Float/Long等
  1. 4.RandomStringUtils,可以用于产生数字,字符及其组合等随机数

/产生5位长度的随机字符串,中文环境下是乱码

RandomStringUtils.random(5);

//使用指定的字符生成5位长度的随机字符串

RandomStringUtils.random(5, new char[]{'a','b','c','d','e','f', '1', '2', '3'});

//生成指定长度的字母和数字的随机组合字符串

RandomStringUtils.randomAlphanumeric(5);

//生成随机数字字符串

RandomStringUtils.randomNumeric(5);

//生成随机[a-z]字符串,包含大小写

RandomStringUtils.randomAlphabetic(5);

//生成从ASCII 32到126组成的随机字符串

RandomStringUtils.randomAscii(4)



  1.   5.SerializationUtils

增强的功能:深拷贝,方便的反序列化,序列化等。

  •    Deep clone using serialization
  •    Serialize managing finally and IOException
  •    Deserialize managing finally and IOException

clone(T obj): deep clone

deseralize(byte[] objData);

deserialize(InputStream inputStream,[OutputStream out])反序列化

  1. 6.StringUtils:包含判断是否为空,trim及查找字符,分割,联合,子集,取得索引,切换大小写,替换,删除等功能

及其判断是否为数字,是否为字符等

特性:


   IsEmpty/IsBlank - checks if a String contains text

   Trim/Strip - removes leading and trailing whitespace

   Equals - compares two strings null-safe

   startsWith - check if a String starts with a prefix null-safe

   endsWith - check if a String ends with a suffix null-safe

   IndexOf/LastIndexOf/Contains - null-safe index-of checks

       Substring/Left/Right/Mid - null-safe substring extractions

       SubstringBefore/SubstringAfter/SubstringBetween - substring extraction relative to other strings

       Split/Join - splits a String into an array of substrings and vice versa

       Remove/Delete - removes part of a String

       Replace/Overlay - Searches a String and replaces one String with another

   UpperCase/LowerCase/SwapCase/Capitalize/Uncapitalize - changes the case of a String          

   DefaultString - protects against a null input String

   Reverse/ReverseDelimited - reverses a String

最常用:

static boolean isEmpty(CharSequence cs)

static boolean isNumeric(CharSequence cs)



  1. 7.SystemUtils:如果无法取得,不会抛出异常,返回null:用于取得系统环境的相关特殊目录路径。


getJavaHome(),getJavaIoTmpDir;getUserDir(); getUserHome(),


  1. 8.NumberUtils:它的所有操作都不会抛出异常,如果转换不成功返回0,0.0d,0.0f等形式。转换操作也可以指定默认值


用于从字符串解析并创建对应包装类

用于判断字符串是否为数字形式

用于转换字符串为对应基本类型。

从数组或一组值中判断最小值最大值min(),max()


NumberUtils.toDouble(null)   = 0.0d

  NumberUtils.toDouble("")     = 0.0d

  NumberUtils.toDouble("1.5")  = 1.5d


NumberUtils.toLong("", 1L)   = 1L

  NumberUtils.toLong("1", 0L)  = 1L

注意isNUmber与isDigits的区别。一般使用isDigits

/*1.NumberUtils.isNumber():判断字符串是否是数字*/

NumberUtils.isNumber("5.96");//结果是true

NumberUtils.isNumber("s5");//结果是false

NumberUtils.isNumber("0000000000596");//结果是true

/*2.NumberUtils.isDigits():判断字符串中是否全为数字*/

NumberUtils.isDigits("0000000000.596");//false

NumberUtils.isDigits("0000000000596");//true

/*5.NumberUtils.min():找出最小的一个*/

NumberUtils.min(newint[]{3,5,6});//结果是6

NumberUtils.min(3,1,7);//结果是7




  1. 9.ClassUtils:可以不用反射就可以操作java类。
  1. 10:StringEscapeUtils:字符串转义工具: xml,html特殊字符转义等


escapeHtml4(String input);

escapeXml(String input);

unescapeHtml4(String input)




二、org.apache.commons.lang3.builder

Assists in creating consistentequals(Object),toString(),hashCode(), andcompareTo(Object)methods.

1.CompareToBuilder:


使用举例:

Assists in implementing Comparable.compareTo(Object) methods. I

public int compareTo(Object o) {

    MyClass myClass = (MyClass) o;

    return new CompareToBuilder()

      .appendSuper(super.compareTo(o)

      .append(this.field1, myClass.field1)

      .append(this.field2, myClass.field2)

      .append(this.field3, myClass.field3)

      .toComparison();

  }

2.EqualsBuilder

Assists in implementing Object.equals(Object) methods.

Typical use for the code is as follows:

public boolean equals(Object obj) {

  if (obj == null) { return false; }

  if (obj == this) { return true; }

  if (obj.getClass() != getClass()) {

    return false;

  }

  MyClass rhs = (MyClass) obj;

  return new EqualsBuilder()

                .appendSuper(super.equals(obj))

                .append(field1, rhs.field1)

                .append(field2, rhs.field2)

                .append(field3, rhs.field3)

                .isEquals();

 }

3.HashCodeBuilder

Assists in implementing Object.hashCode() methods.

To use this class write code as follows:

public class Person {

  String name;

  int age;

  boolean smoker;

  ...

  public int hashCode() {

    // you pick a hard-coded, randomly chosen, non-zero, odd number

    // ideally different for each class

    return new HashCodeBuilder(17, 37).

      append(name).

      append(age).

      append(smoker).

      toHashCode();

  }

}

4.ToStringBuilder

Assists in implementing Object.toString() methods.

To use this class write code as follows:

public class Person {

  String name;

  int age;

  boolean smoker;

  ...

  public String toString() {

    return new ToStringBuilder(this).

      append("name", name).

      append("age", age).

      append("smoker", smoker).

      toString();

  }

}




三、org.apache.commons.lang3.concurrent


Provides support classes for multi-threaded programming.

TimedSemaphore



四、org.apache.commons.lang3.event


Provides some useful event-based utilities.

 EventListenerSupport:可以管理监听器列表,并可以以特定事件触发fire()所有监听器。

EvenUtils:可用于添加监听器到指定事件源。也可以绑定特定事件到相关方法。

1.EventListener:



public class MyActionEventSource

{

  private EventListenerSupport actionListeners =

      EventListenerSupport.create(ActionListener.class); //创建针对于特定监听器的对象。

  public void someMethodThatFiresAction()

  {//创建一个Event对象。

    ActionEvent e = new ActionEvent(this, ActionEvent.ACTION_PERFORMED, "somethingCool");

    actionListeners.fire().actionPerformed(e);//触发事件通知所有的listeners

  }

}

注意序列化EventListenerSupport并不会序列化它维护的listener list


2.EventUtils:


addEventListener(Object eventSource, Class listenerType,

                                L listener)

bindEventsToMethod(Object target, String methodName, Object eventSource, Class listenerType, String... eventTypes)

          Binds an event listener to a specific method on a specific object.



七、 org.apache.commons.lang3.reflect

九、org.apache.commons.lang3.time

时间或日期模式:

character duration element
y years
M months
d days
H hours
m minutes
s seconds
S milliseconds

DateFormatUtils:用于时间日期格式化。或将毫秒格式化为时间。format

DateUtils:用于操作时间或日期的加减。

1.DateFormatUtils:

static String format(long millis, String pattern)

static String format(Date date, String pattern)

2.DateUtils:

static Date addDays(Date date, int amount)

addYears(Date date, int amount)


十、org.apache.commons.lang3.tuple


用于处理一对键值的对象pair类似于Map.entry

commons lang3增加了可以处理3个值的Triple基类

此包下定义了Pair抽象基类,及MutablePair,MutableTriple,ImmutablePair,ImmutableTriple子类

一个线程非安全,另一个线程安全

接口:

Pair:封装一对键值对。

实现类:

    可变:MutablePair

    不可变:ImmutablePair

接口:

Triple:封装3个值的类。


本人博客小站原文:

实现类:

  ImmutableTriple; MuttableTriple


你可能感兴趣的:(JAVA)