Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8209038

Clarify the javadoc of Cipher.getParameters()

    XMLWordPrintable

    Details

    • Type: Enhancement
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 19
    • Component/s: security-libs
    • Labels:
      None

      Description

      Existing javadoc of Cipher.getParameters()/CipherSpi.engineGetParameters() can use some update:
      1) syntax-wise: see JDK-8206171 changes in Signature.getParameters/SignatureSpi.engineGetParameters()
      2) meaning of null: consider to allow null to be returned if providers cannot generate default parameters. Just as the changes of JDK-8206171.
      3) accommodate algorithm-specific/provider-specific implementation on how parameters is handled. For example, in PBE-based Cipher, one can only include salt and iteration count in the init params, and init() will add in a random IV, and then parameters is retrieved with getParameters().

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              valeriep Valerie Peng
              Reporter:
              valeriep Valerie Peng
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: