Some methods in the java.time.chrono interfaces—ChronoLocalDate, 
ChronoLocalDateTime, and ChronoZonedDateTime—override methods from the 
java.time.temporal.Temporal interface that are documented to throw 
UnsupportedTemporalTypeException when given unsupported fields or units.

These overridden methods include:

with(TemporalField, long)

plus(long, TemporalUnit)

minus(long, TemporalUnit)

However, their Javadoc in the chrono interfaces does not mention the 
possibility of this exception, resulting in incomplete or inconsistent 
documentation. This contrasts with the parent Temporal interface, which 
explicitly documents the exception.

-------------

Commit messages:
 - Documenting missing UnsupportedTemporalTypeException

Changes: https://git.openjdk.org/jdk/pull/25836/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=25836&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8294226
  Stats: 10 lines in 3 files changed: 8 ins; 0 del; 2 mod
  Patch: https://git.openjdk.org/jdk/pull/25836.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/25836/head:pull/25836

PR: https://git.openjdk.org/jdk/pull/25836

Reply via email to