java.util.Objects
描述:
此类包含static实用程序方法,用于操作对象或在操作前检查某些条件。 这些实用程序包括null或null方法,用于计算对象的哈希代码,返回对象的字符串,比较两个对象,以及检查索引或子范围值是否超出范围。
1.检查两个值是否相等
equals(Object a ,Object b);
public class person{
private String name;
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
person person = (person) o;
return Objects.equals(name, person.name);
}
@Override
public int hashCode() {
return Objects.hash(name);
}
}
2.检查一个下标是否越界
①public static int checkFromIndexSize(int fromIndex, int size, int length);
检查是否在子范围从fromIndex (包括)到fromIndex + size (不包括)是范围界限内0 (包括)到length (不包括)。
如果以下任何不等式为真,则子范围被定义为超出界限:
fromIndex < 0
size < 0
fromIndex + size > length ,考虑到整数溢出
length < 0 ,这是前者的不平等所暗示的
参数:
fromIndex - 子间隔的下限(包括)
size - 子范围的大小
length - 范围的上限(不包括)
结果:
fromIndex如果子范围在范围的范围内
异常:
IndexOutOfBoundsException - 如果子范围超出范围
②public static int checkFromToIndex(int fromIndex, int toIndex, int length);
检查是否在子范围从fromIndex (包括)到toIndex (不包括)是范围界限内0 (包括)到length (不包括)。
如果以下任何不等式为真,则子范围被定义为超出界限:
fromIndex < 0
fromIndex > toIndex
toIndex > length
length < 0 ,这是前者的不平等所暗示的
参数:
fromIndex - 子范围的下限(包括)
toIndex - 子范围的上限(不包括)
length - 上限(不包括)范围
结果:
fromIndex如果子范围内的范围内
异常:
IndexOutOfBoundsException - 如果子范围超出范围
2.检查下标是否在长度范围内
public static int checkIndex(int index, int length);
检查index是否在0 (含)到length (不包括)范围内。
如果以下任何不等式为真,则定义index超出范围:
index < 0
index >= length
length < 0 ,这是前者的不平等所暗示的
参数:
index - 该指数
length - 范围的上限(不包括)
结果:
index如果它在范围的范围内
异常:
IndexOutOfBoundsException - 如果 index超出界限
3.检查对比两个对象参数是否相同
public static int compare(T a, T b, Comparator<? super T> c);
如果参数相同则返回0,否则返回c.compare(a, b) 。 因此,如果两个参数都是null则返回0。
请注意,如果其中一个参数为null , NullPointerException可能会或可能不会抛出null ,具体取决于订购策略(如果有), Comparator选择具有null值。
参数类型:
T - 要比较的对象的类型
参数:
a - 一个对象
b - 要与 a进行比较的对象
c - 比较前两个参数的 Comparator
结果:
如果参数相同 c.compare(a, b) 0,否则为 c.compare(a, b) 。
4.比较两个参数是否深层相等
public static boolean deepEquals(Object a, Object b);
返回true如果参数是深层相等,则false其他。 两个null值不相等。 如果两个参数都是数组,则使用Arrays.deepEquals中的算法来确定相等性。 否则,通过使用第一个参数的equals方法确定相等性。
参数:
a - 一个物体
b - 与 a进行比较的对象,用于深度相等
结果:
true;如果参数彼此不相等, false
5.生成哈希码值
public static int hash(Object… values);
为一系列输入值生成哈希码。 生成哈希码,好像所有输入值都放在一个数组中,并通过调用Arrays.hashCode(Object[])对该数组进行哈希处理 。
此方法对于在包含多个字段的对象上实现Object.hashCode()非常有用。 例如,如果有三个字段,对象x , y ,和z ,一个可以这样写:
@Override public int hashCode() {
return Objects.hash(x, y, z);
}
警告:提供单个对象引用时,返回的值不等于该对象引用的哈希码。 可以通过调用hashCode(Object)来计算此值。
参数
values - 要散列的值
结果
输入值序列的哈希值
6.判断是否为哈希码值
public static int hashCode(Object o);
返回不是哈希码的值为 null参数,0为 null的值。
参数
o - 一个对象
结果
非的哈希码 null参数,0为 null参数
7.判断是否为空值
public static boolean isNull(Object obj);
返回 true如果提供的参考是 null ,否则返回 false 。
API Note:
这种方法存在着用作Predicate , filter(Objects::isNull)
参数
obj - 针对 null进行检查的参考
结果
true如果提供的参考是 null否则 false
8.判断是否为非空值
public static boolean nonNull(Object obj);
如果提供的参考是非 null则返回true,否则返回 false 。
参数
obj - 要对照 null进行检查的参考
结果
如果提供的参考是非 null返回true,否则 false
9.检查指定的对象T引用的是不是非空值
public static T requireNonNull(T obj);
检查指定的对象引用是不是NonNull 。 此方法主要用于在方法和构造函数中进行参数验证,如下所示:
public Foo(Bar bar) {
this.bar = Objects.requireNonNull(bar);
}
参数类型
T - 引用的类型
参数
obj - 检查无效的对象引用
结果
obj如果不是 null
异常
NullPointerException - 如果 obj是 null
9.检查指定的对象T引用的是不是空值
①
public static T requireNonNull(T obj, String message);
检查指定的对象引用是否为null ,如果是,则抛出自定义的NullPointerException 。 此方法主要用于在具有多个参数的方法和构造函数中进行参数验证,如下所示:
public Foo(Bar bar, Baz baz) {
this.bar = Objects.requireNonNull(bar, "bar must not be null");
this.baz = Objects.requireNonNull(baz, "baz must not be null");
}
参数类型
T - 引用的类型
参数
obj - 检查无效的对象引用
message - 在抛出 NullPointerException的情况下使用的详细消息
结果
obj若不是 null
异常
NullPointerException - 如果 obj是 null
②
public static T requireNonNull(T obj, Supplier messageSupplier);
检查指定的对象引用是否为null ,如果是,则抛出自定义的NullPointerException 。
与方法requireNonNull(Object, String)不同,此方法允许创建要延迟的消息,直到进行空检查。 虽然这可以在非空情况下赋予性能优势,但在决定调用此方法时,应注意创建消息提供者的成本小于仅直接创建字符串消息的成本。
参数类型
T - 引用的类型
参数
obj - 检查无效的对象引用
messageSupplier - 如果抛出 NullPointerException ,将使用详细消息的引用数据
结果
obj如果不是 null
异常
NullPointerException - 如果 obj是 null
10.判断空值输出参数
public static T requireNonNullElse(T obj, T defaultObj);
如果它是非 null ,则返回第一个参数,否则返回非 null第二个参数。
参数类型
T - 引用的类型
参数
obj - 一个物体
defaultObj - 如果第一个参数为 null ,则返回非 null对象
结果
第一个参数,如果它是非 null ,否则第二个参数,如果它是非 null
异常
NullPointerException - 如果两者都是 obj为空且 defaultObj为 null
**11.判断是否为空值,输出参数或方法
如果它是非 null ,则返回第一个参数,否则返回非 null值 supplier.get() 。
参数类型
T - 第一个参数和返回类型的类型
参数
obj - 一个物体
supplier - 如果第一个参数是 null ,则返回非 null对象
结果
第一个参数,如果它是非 null ,否则值为 supplier.get()如果它是非 null
异常
NullPointerException - 如果两者 obj均为空且 supplier为 null或 supplier.get()值为 null
12.对于非空参数返回调用的结果
toString对于非空参数返回调用的结果。“null”为空值。
参数
o - 一个对象
结果
toString对于非空参数返回调用的结果。“null”为空值。
13.
public static String toString(Object o, String nullDefault);
如果第一个参数是非空值 ,则返回在第一个参数上调用 toString的结果,否则返回第二个参数。
参数
o - 一个对象
nullDefault - 如果第一个参数是 null ,则返回的是字符串“null”
结果
如果它不是 null ,则在第一个参数上调用 toString ,否则调用第二个参数。