Re: RFR: 8370688: java.util.jar.JarEntry.getCodeSigners() and getCertificates() should specify that they return a copy of the arrays [v2]

2025-12-04 Thread Sean Mullan
On Wed, 3 Dec 2025 18:46:40 GMT, Koushik Muthukrishnan Thirupattur 
 wrote:

>> The implementation of JarEntry.getCodeSigners() and getCertificates() both 
>> return a copy of the original array. However, the documentation of these 2 
>> methods currently doesn't specify this.
>
> Koushik Muthukrishnan Thirupattur has updated the pull request incrementally 
> with one additional commit since the last revision:
> 
>   8370688: Addressed review comments - add explicit note similar to 
> SSLParameters

src/java.base/share/classes/java/util/jar/JarEntry.java line 117:

> 115:  * to trust the entry signed by the signers.
> 116:  *
> 117:  * This method will return a new array each time it is invoked.

This sentence is not completely true, because the method may also return 
`null`. I suggest moving this sentence to the @return label (as the second 
sentence), and rephrasing it as "If non-null, this method returns a new array 
each time it is invoked". I removed "will" as I think present tense sounds 
better.

-

PR Review Comment: https://git.openjdk.org/jdk/pull/28615#discussion_r2589119626


Re: RFR: 8370688: java.util.jar.JarEntry.getCodeSigners() and getCertificates() should specify that they return a copy of the arrays [v2]

2025-12-03 Thread Jaikiran Pai
On Wed, 3 Dec 2025 18:46:40 GMT, Koushik Muthukrishnan Thirupattur 
 wrote:

>> The implementation of JarEntry.getCodeSigners() and getCertificates() both 
>> return a copy of the original array. However, the documentation of these 2 
>> methods currently doesn't specify this.
>
> Koushik Muthukrishnan Thirupattur has updated the pull request incrementally 
> with one additional commit since the last revision:
> 
>   8370688: Addressed review comments - add explicit note similar to 
> SSLParameters

Looks good to me.

-

Marked as reviewed by jpai (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/28615#pullrequestreview-3538474729


Re: RFR: 8370688: java.util.jar.JarEntry.getCodeSigners() and getCertificates() should specify that they return a copy of the arrays [v2]

2025-12-03 Thread Koushik Muthukrishnan Thirupattur
> The implementation of JarEntry.getCodeSigners() and getCertificates() both 
> return a copy of the original array. However, the documentation of these 2 
> methods currently doesn't specify this.

Koushik Muthukrishnan Thirupattur has updated the pull request incrementally 
with one additional commit since the last revision:

  8370688: Addressed review comments - add explicit note similar to 
SSLParameters

-

Changes:
  - all: https://git.openjdk.org/jdk/pull/28615/files
  - new: https://git.openjdk.org/jdk/pull/28615/files/c9c87bfa..59abe38b

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=28615&range=01
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=28615&range=00-01

  Stats: 6 lines in 1 file changed: 4 ins; 0 del; 2 mod
  Patch: https://git.openjdk.org/jdk/pull/28615.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/28615/head:pull/28615

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