Summary

Cipher javadoc could describe AEAD reuse better

Problem

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.

Solution

See Spec

Specification

The doc should state that reset() may not be possible with some algorithms or providers and that an IllegalStateException is thrown.