LocalDate.format（DateTimeFormatter 格式化程序）未在方法签名中声明“抛出”[重复]

Question

我正在浏览 LocalDate API 的 java 源代码，发现这些方法缺少 throws 声明。但是 javadoc 清楚地提到该方法可能会抛出 DateTimeException。以下是来自 Java 8 的 LocalDate API 的源代码。

/**
 * Formats this date using the specified formatter.
 * <p>
 * This date will be passed to the formatter to produce a string.
 *
 * @param formatter  the formatter to use, not null
 * @return the formatted date string, not null
 * @throws DateTimeException if an error occurs during printing
 */
@Override  // override for Javadoc and performance
public String format(DateTimeFormatter formatter) {
    Objects.requireNonNull(formatter, "formatter");
    return formatter.format(this);
}

1. 这是否是声明抛出异常的方法的正确方法（我希望 throws 在方法签名中使客户端能够正确处理异常，但这并没有给客户端关于除非正在读取 javadoc，否则异常）？

如果我遗漏了什么以正确理解这一点，请告诉我？

Answer 1

DateTimeException 是未经检查的异常，因此不必声明为方法。

为什么LocalDate#format 声明它？因为它可以被它自己委托执行的方法抛出。在调用链之后，我们看到DateTimeFormatter.formatTo(TemporalAccessor, Appendable) 是执行实际工作的方法，它正在抛出异常；并且没有一个中间方法正在捕获/处理它。

public void formatTo(TemporalAccessor temporal, Appendable appendable) {
    ...
    try {
        ...
    } catch (IOException ex) {
        throw new DateTimeException(ex.getMessage(), ex);
    }
}

我相信这确实是一个很好的异常文档示例（记录应该预期的异常，无论是否检查，即使您没有明确地将它们抛出到相关方法中）