RFR: 8349946: Cipher javadoc could describe AEAD reuse better

Tue Jun 10 00:17:29 UTC 2025

On Thu, 22 May 2025 19:30:44 GMT, Koushik Muthukrishnan Thirupattur <duke at openjdk.org> wrote:

> The class documentation in javax.crypto.Cipher could better describe AEAD and reuse. The current class description example is outdated as GCM encryption does not allow resets. The doc should state that reset() may not be possible with some algorithms or providers and that an InvalidAlgorithmParameterException is thrown

Line 170 and 171 can be removed as the CC20/Poly1305 RFC isn't referenced anymore

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

PR Review: https://git.openjdk.org/jdk/pull/25399#pullrequestreview-2911656999