Java中的 ValueRange checkValidValue() 方法及示例

在Java中，ValueRange类提供了一组用于表示值范围（包括边界）的静态工厂方法，也提供了检查给定值是否在范围内的方法。其中之一便是checkValidValue()方法。

ValueRange类概述

ValueRange类是Java 8中引入的一个专门用于表示值范围的类，它提供了一系列的工厂方法用于创建各种不同类型的值范围实例，如基本类型和日期类型的值范围。在ValueRange类中，有一个checkValidValue()方法用于检查给定值是否在范围内。

checkValidValue()方法的签名如下：

public void checkValidValue(long value, TemporalField field)

方法详解

参数

• value: 需要检查的值。
• field：指定了值的语义类型，如年、月和日等。

返回值

方法没有返回值，但如果给定值不在范围内，则会抛出DateTimeException异常。

异常

如果给定值不在范围内，则会抛出DateTimeException异常，该异常是Java 8中用于在处理日期和时间时抛出的通用异常。

示例

下面是一个使用checkValidValue()方法的示例：

import java.time.DateTimeException;
import java.time.temporal.ChronoField;
import java.time.temporal.ValueRange;

public class ValueRangeExample {

    public static void main(String[] args) {
        ValueRange yearRange = ValueRange.of(2000, 3000);
        try {
            yearRange.checkValidValue(1999L, ChronoField.YEAR);
        } catch (DateTimeException e) {
            System.out.println(e.getMessage());
        }
        try {
            yearRange.checkValidValue(3001L, ChronoField.YEAR);
        } catch (DateTimeException e) {
            System.out.println(e.getMessage());
        }
        try {
            yearRange.checkValidValue(2021L, ChronoField.YEAR);
            System.out.println("2021年是在范围内的");
        } catch (DateTimeException e) {
            System.out.println(e.getMessage());
        }
    }
}

在上面的示例中，我们首先创建了一个年份范围从2000至3000年。然后我们尝试检查1999和3001年是否在这个范围内，都是不在范围内。后面，我们检查了2021年是否在范围内，并打印了一条消息作为结果。

执行上述代码，输出结果如下：

Invalid value for Year (valid values 2000 - 3000): 1999
Invalid value for Year (valid values 2000 - 3000): 3001
2021年是在范围内的

从输出结果中可以看出，1999和3001年不在2000至3000年范围内，而2021年在范围内。

总结

在Java中，ValueRange类提供了一组用于表示值范围（包括边界）的静态工厂方法，也提供了检查给定值是否在范围内的方法。通过本文的介绍，我们了解到了checkValidValue()方法的使用方法和示例。