RFR: 8209038: Clarify the javadoc of Cipher.getParameters()

[Valerie Peng]

On Wed, 6 Apr 2022 19:48:04 GMT, Valerie Peng <valeriep at openjdk.org> wrote:

>> src/java.base/share/classes/javax/crypto/Cipher.java line 1053:
>> 
>>> 1051:      * <p>If this cipher has been previously initialized with parameters,
>>> 1052:      * this method returns the same parameters. Otherwise, this method may
>>> 1053:      * return a combination of user-supplied, default and randomly generated
>> 
>>> ... a combination of user-supplied, default and randomly generated parameter values ...
>> 
>> Other than init(), which APIs could impact the user-supplied parameters?  Is it the getInstance()?
>> 
>> Is it OK to just use the provider-specific default values instead, by replacing the "a combination of user-supplied, default and randomly generated ..."?
>
> I am thinking just init() as it takes parameters.
> Let me take a second look at various Cipher algorithm implementations and see if this can be further pared down.

Please see the updated wording in earlier comment above.

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

PR: https://git.openjdk.java.net/jdk/pull/8117