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

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

Commit messages:
 - 8349946:Cipher javadoc could describe AEAD reuse better
 - 8349946:Cipher javadoc could describe AEAD reuse better
 - 8349946:Cipher javadoc could describe AEAD reuse better
 - 8349946:Cipher javadoc could describe AEAD reuse better
 - 8349946:Cipher javadoc could describe AEAD reuse better
 - 8349946: Initial draft changes for cipher java doc updates
 - 8349946:Cipher javadoc could describe AEAD reuse better
 - 8349946:Cipher javadoc could describe AEAD reuse better

Changes: https://git.openjdk.org/jdk/pull/25399/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=25399&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8349946
  Stats: 104 lines in 1 file changed: 0 ins; 86 del; 18 mod
  Patch: https://git.openjdk.org/jdk/pull/25399.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/25399/head:pull/25399

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

Reply via email to