RFR: 8331008: Implement JEP 478: Key Derivation Function API (Preview) [v33]

[Kevin Driver]

On Tue, 17 Sep 2024 20:34:17 GMT, Sean Mullan <mullan at openjdk.org> wrote:

>> I can see your point; however, we are not saying "_L_ist of values", so we are discussing it in an abstract manner. Let's leave it "as-is", since it can be interpreted either way.
>
> The usage of "list" in specification could imply the `List` API, so it is best to avoid it as this could be interpreted as a requirement of the implementation. See for example the methods in the [`Collections` ](https://docs.oracle.com/en/java/javase/23/docs/api/java.base/java/util/Collections.html) API that operate on `List` objects but use "list" in the specification when referencing it.
> 
> If you want to be more abstract but still imply some sort of aggregation, I would suggest something like:
> 
> "The `ikms()` method of the `Extract` or `ExtractThenExpand` object that is subsequently built returns the assembled input keying material as a list of `SecretKey` objects."

@seanjmullan: See: https://github.com/openjdk/jdk/pull/20301/commits/b0e1110d0b051355249c854c9be5adc5ec703175.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/20301#discussion_r1764059543