类 ArrayUtils

java.lang.Object
com.alibaba.ageiport.common.utils.ArrayUtils

public final class ArrayUtils extends Object
Contains some methods to check array.
  • 字段概要

    字段
    修饰符和类型
    字段
    说明
    static final int
    数组中元素未找到的下标,值为-1
  • 构造器概要

    构造器
    构造器
    说明
     
  • 方法概要

    修饰符和类型
    方法
    说明
    static <T> T[]
    append(T[] buffer, T... newElements)
    将新元素添加到已有数组中
    添加新元素会生成一个新的数组,不影响原数组
    static boolean
    contains(char[] array, char value)
    数组中是否包含元素
    static <T> boolean
    contains(T[] array, T value)
    数组中是否包含元素
    static <T> T[]
    filter(T[] array, Filter<T> filter)
    过滤
    过滤过程通过传入的Filter实现来过滤返回需要的元素内容,这个Filter实现可以实现以下功能:
    static <T> boolean
    hasNull(T... array)
    是否包含null元素
    static int
    indexOf(char[] array, char value)
    返回数组中指定元素所在位置,未找到返回INDEX_NOT_FOUND
    static <T> int
    indexOf(T[] array, Object value)
    返回数组中指定元素所在位置,未找到返回INDEX_NOT_FOUND
    static <T> Object
    insert(Object array, int index, T... newElements)
    将新元素插入到到已有数组中的某个位置
    添加新元素会生成一个新的数组,不影响原数组
    如果插入位置为为负数,从原数组从后向前计数,若大于原数组长度,则空白处用null填充
    static <T> T[]
    insert(T[] buffer, int index, T... newElements)
    将新元素插入到到已有数组中的某个位置
    添加新元素会生成一个新的数组,不影响原数组
    如果插入位置为为负数,从原数组从后向前计数,若大于原数组长度,则空白处用null填充
    static boolean
    对象是否为数组对象
    static boolean
    isEmpty(Object array)
    数组是否为空
    此方法会匹配单一对象,如果此对象为null则返回true
    如果此对象为非数组,理解为此对象为数组的第一个元素,则返回false
    如果此对象为数组对象,数组长度大于0情况下返回false,否则返回true
    static boolean
    isNotEmpty(Object[] array)
    Checks if the array is not null or empty.
    static int
    length(Object array)
    获取数组长度
    如果参数为null,返回0
    static <T> T[]
    newArray(Class<?> componentType, int newSize)
    新建一个空数组
    static <T> boolean
    notHasNull(T... array)
    是否不包含null元素
    static <T> T[]
    of(T... values)
    Convert from variable arguments to array
    static String
    数组或集合转String

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

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • 字段详细资料

    • INDEX_NOT_FOUND

      public static final int INDEX_NOT_FOUND
      数组中元素未找到的下标,值为-1
      另请参阅:
  • 构造器详细资料

    • ArrayUtils

      public ArrayUtils()
  • 方法详细资料

    • isArray

      public static boolean isArray(Object obj)
      对象是否为数组对象
      参数:
      obj - 对象
      返回:
      是否为数组对象,如果为null 返回false
    • isEmpty

      public static boolean isEmpty(Object array)
      数组是否为空
      此方法会匹配单一对象,如果此对象为null则返回true
      如果此对象为非数组,理解为此对象为数组的第一个元素,则返回false
      如果此对象为数组对象,数组长度大于0情况下返回false,否则返回true
      参数:
      array - 数组
      返回:
      是否为空
    • isNotEmpty

      public static boolean isNotEmpty(Object[] array)

      Checks if the array is not null or empty.

      参数:
      array - th array to check
      返回:
      true if the array is not null or empty.
    • hasNull

      public static <T> boolean hasNull(T... array)
      是否包含null元素
      类型参数:
      T - 数组元素类型
      参数:
      array - 被检查的数组
      返回:
      是否包含null元素
    • notHasNull

      public static <T> boolean notHasNull(T... array)
      是否不包含null元素
      类型参数:
      T - 数组元素类型
      参数:
      array - 被检查的数组
      返回:
      是否包含null元素
    • of

      public static <T> T[] of(T... values)
      Convert from variable arguments to array
      类型参数:
      T - The class
      参数:
      values - variable arguments
      返回:
      array
    • newArray

      public static <T> T[] newArray(Class<?> componentType, int newSize)
      新建一个空数组
      类型参数:
      T - 数组元素类型
      参数:
      componentType - 元素类型
      newSize - 大小
      返回:
      空数组
    • filter

      public static <T> T[] filter(T[] array, Filter<T> filter)
      过滤
      过滤过程通过传入的Filter实现来过滤返回需要的元素内容,这个Filter实现可以实现以下功能:
       1、过滤出需要的对象,Filter.accept(Object)方法返回true的对象将被加入结果集合中
       
      类型参数:
      T - 数组元素类型
      参数:
      array - 数组
      filter - 过滤器接口,用于定义过滤规则,null表示不过滤,返回原数组
      返回:
      过滤后的数组
    • append

      @SafeVarargs public static <T> T[] append(T[] buffer, T... newElements)
      将新元素添加到已有数组中
      添加新元素会生成一个新的数组,不影响原数组
      类型参数:
      T - 数组元素类型
      参数:
      buffer - 已有数组
      newElements - 新元素
      返回:
      新数组
    • insert

      public static <T> T[] insert(T[] buffer, int index, T... newElements)
      将新元素插入到到已有数组中的某个位置
      添加新元素会生成一个新的数组,不影响原数组
      如果插入位置为为负数,从原数组从后向前计数,若大于原数组长度,则空白处用null填充
      类型参数:
      T - 数组元素类型
      参数:
      buffer - 已有数组
      index - 插入位置,此位置为对应此位置元素之前的空档
      newElements - 新元素
      返回:
      新数组
    • insert

      public static <T> Object insert(Object array, int index, T... newElements)
      将新元素插入到到已有数组中的某个位置
      添加新元素会生成一个新的数组,不影响原数组
      如果插入位置为为负数,从原数组从后向前计数,若大于原数组长度,则空白处用null填充
      类型参数:
      T - 数组元素类型
      参数:
      array - 已有数组
      index - 插入位置,此位置为对应此位置元素之前的空档
      newElements - 新元素
      返回:
      新数组
    • length

      public static int length(Object array)
      获取数组长度
      如果参数为null,返回0
       ArrayUtils.length(null)            = 0
       ArrayUtils.length([])              = 0
       ArrayUtils.length([null])          = 1
       ArrayUtils.length([true, false])   = 2
       ArrayUtils.length([1, 2, 3])       = 3
       ArrayUtils.length(["a", "b", "c"]) = 3
       
      参数:
      array - 数组对象
      返回:
      数组长度
      抛出:
      IllegalArgumentException - 如果参数不为数组,抛出此异常
      另请参阅:
    • contains

      public static boolean contains(char[] array, char value)
      数组中是否包含元素
      参数:
      array - 数组
      value - 被检查的元素
      返回:
      是否包含
    • indexOf

      public static int indexOf(char[] array, char value)
      返回数组中指定元素所在位置,未找到返回INDEX_NOT_FOUND
      参数:
      array - 数组
      value - 被检查的元素
      返回:
      数组中指定元素所在位置,未找到返回INDEX_NOT_FOUND
    • contains

      public static <T> boolean contains(T[] array, T value)
      数组中是否包含元素
      类型参数:
      T - 数组元素类型
      参数:
      array - 数组
      value - 被检查的元素
      返回:
      是否包含
    • indexOf

      public static <T> int indexOf(T[] array, Object value)
      返回数组中指定元素所在位置,未找到返回INDEX_NOT_FOUND
      类型参数:
      T - 数组类型
      参数:
      array - 数组
      value - 被检查的元素
      返回:
      数组中指定元素所在位置,未找到返回INDEX_NOT_FOUND
    • toString

      public static String toString(Object obj)
      数组或集合转String
      参数:
      obj - 集合或数组对象
      返回:
      数组字符串,与集合转字符串格式相同