Objects类的介绍及具体方法详解
概述:
此类包含static实用程序方法,用于操作对象或在检查某些条件。这些实用程序包括null或者非null方法,用于计算对象的哈希代码,返回对象的字符串,比较两个对象,以及检查索引或子范围值是否超出范围。
- checkFromIndexSize(int fromInedex,int size,int length):检查是否在子范围从 fromIndex(包括)到 fromIndex + size(不包括)是范围界限内0(包括)到length(不包括)
作用:判断fromIndex到fromIndex+size这个子范围是否在0到length这个范围之间,如果在并返回fromIndex的值,如果不在报IndexOutOfBoundsException
public static int checkFromIndexSize(int fromIndex, int size, int length) {
return Preconditions.checkFromIndexSize(fromIndex, size, length, null);
}
int i = Objects.checkFromIndexSize(0, 5,10);//i=0
- checkFromToIndex:
public static int checkFromToIndex(int fromIndex,int toIndex,int length):检查是否在子范围从fromIndex(包括)到toIndex(不包括)是范围界限内0(包括)到length(不包括)。
作用:和checkFromIndexSize方法的作用相同(不过是把fromIndex到fromIndex+size换成了fromIndex到toIndex)
public static int checkFromToIndex(int fromIndex, int toIndex, int length) {
return Preconditions.checkFromToIndex(fromIndex, toIndex, length, null);
}
- checkIndex:
public static int checkIndex(int index,int length)检查index(包含)是否在0到length(不包含)范围内。public static int checkIndex(int index, int length) { return Preconditions.checkIndex(index, length, null); }
- requireNonNull:
public static T requireNonNull(T obj)
public static T requireNonNull(T obj, String message)
public static T requireNonNull(T obj, SuppliermessageSupplier)
messageSupplier - 如果抛出 NullPointerException ,将使用详细消息的供应商 (可以描述具体哪个对象发生了空指针)
作用:检查指定的对象引用是否为null,如果是,则抛出自定义的NullPointerException
public static <T> T requireNonNull(T obj) {
if (obj == null)
throw new NullPointerException();
return obj;
}
public static <T> T requireNonNull(T obj, String message) {
if (obj == null)
throw new NullPointerException(message);
return obj;
}
public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier) {
if (obj == null)
throw new NullPointerException(messageSupplier == null ?
null : messageSupplier.get());
return obj;
}
方法的演示:
4. requireNonNullElseGet
public static T requireNonNullElseGet(T obj, Supplier<? extends T> supplier)
作用:如果传入的obj是非null,则返回obj,否则返回非null值supplier.get()
场景:可以用来判断一个对象是否为空,如果为空,可以设置一个默认值。
public static <T> T requireNonNullElseGet(T obj, Supplier<? extends T> supplier) {
return (obj != null) ? obj
: requireNonNull(requireNonNull(supplier, "supplier").get(), "supplier.get()");
}
- requireNonNullElse
public static T requireNonNullElse(T obj,T defultobj)
作用:如果他是非null,则返回第一个参数,否则返回第二个参数。
public static <T> T requireNonNullElse(T obj, T defaultObj) {
return (obj != null) ? obj : requireNonNull(defaultObj, "defaultObj");
}
- nonNull
public static boolean nonNull(Object obj)
作用:判断一个一个对象是否为非空,如果这个对象非空返回true,如果为空返回false;public static boolean nonNull(Object obj) { return obj != null; }
- isNull
public static boolean isNull(Object obj)
作用:判断一个对象是否为空,如果为空返回true,否则返回false;public static boolean isNull(Object obj) { return obj == null; }
- requireNonNull
public static T requireNonNull(T obj)
public static T requireNonNull(T obj,String message)
message:在抛出NullpointerException的情况下使用的详细信息
作用:检查对象是否为null,如果是则抛出自定义的NullPointerException,此方法主要用于在具有多个参数的方法和构造函数中进行参数验证。public static <T> T requireNonNull(T obj, String message) { if (obj == null) throw new NullPointerException(message); return obj; }
- compare
public static int compare(T a,T b,Comparator<? super T> c)
作用:如果参数相同则返回0,否则返回c.compare(a,b)。因此,如果两个参数都是null则返回0;请注意,如果其中一个参数为null , NullPointerException可能会或可能不会抛出null ,具体取决于订购策略(如果有), Comparator选择具有null值。public static <T> int compare(T a, T b, Comparator<? super T> c) { return (a == b) ? 0 : c.compare(a, b); }
- toString
public static String toString (Object o,String nullDefault)
public static String toString (Object o)
作用:如果第一个参数不是null,则返回在第一个参数上调用toString方法,否则返回第二个参数。
public static String toString(Object o, String nullDefault) {
return (o != null) ? o.toString() : nullDefault;
}
- hash
public static int hash(Object… values)
作用:为一系列输入值生成哈希码,生成哈希码,好像所有输入值都在放在一个数组中,并通过调用Arrays.hashCode(Object[])对该数组进行哈希处理public static int hash(Object... values) { return Arrays.hashCode(values); }
- hashCode
public static int hashCode(Object o)
作用:返回非null对象的哈希码值。public static int hashCode(Object o) { return o != null ? o.hashCode() : 0; }
- deepEquals
public static boolean deepEquals(Object a,Object b)
作用:如果两个参数的引用地址相同,则返回true,其中一个为空,返回false。如果两个参数都是数组,则使用Arrays.deepEquals中的算法来确定相等性。 否则,通过使用第一个参数的equals方法确定相等性。public static boolean deepEquals(Object a, Object b) { if (a == b) return true; else if (a == null || b == null) return false; else return Arrays.deepEquals0(a, b); }
- equals
public static boolean equals(Object a,Object b)
作用 :如果参数相等返回true,否则返回false。 因此,如果这两个参数是null , true返回,如果只有一个参数为null , false返回。 否则,通过使用第一个参数的equals方法确定相等性。public static boolean equals(Object a, Object b) { return (a == b) || (a != null && a.equals(b)); }