On Wed, 3 Dec 2025 18:46:40 GMT, Koushik Muthukrishnan Thirupattur 
<[email protected]> 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:      * <p>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

Reply via email to