On Tue, 20 Aug 2024 10:24:25 GMT, Eirik Bjørsnøs <eir...@openjdk.org> wrote:

> Please review this PR which suggests to deprecate the unused class 
> `java.util.zip.ZipError` for removal.
> 
> The class has been unsed by OpenJDK since  the ZIP API was rewritten from 
> native to Java in JDK 9.
> 
> I opted to not explain the reason for the deprecation in detail, but instead 
> simply point to `ZipException` as an alternative. Should more explanation be 
> desired, I could prepend that with a note saying that the class is unused 
> since JDK 9.
> 
> A CSR for this API update has been drafted, I'll update the Specification 
> section there once we reach a concensus on the deprecation note in this PR.
> 
> This deprecation was initially suggested here: 
> https://mail.openjdk.org/pipermail/core-libs-dev/2024-June/125720.html

How about this:

/**
 * A legacy error for invalid input ZIP format.
 *
 * @deprecated
 * Use {@link ZipException} instead. Code catching this error from the JDK 8 
and earlier should update
 * to catch {@code InternalError} instead.
 */

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

PR Comment: https://git.openjdk.org/jdk/pull/20642#issuecomment-2310500577

Reply via email to