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

[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 with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains seven additional commits since the last revision:

 - 8370688: Updated the documentation to describe the behavior using @implSpec
 - Merge branch 'master' into 8370688
 - 8370688: Addressed review comments-removed this method in the return label
 - 8370688: Addressed review comments-moved the sentence to return label
 - 8370688: Addressed review comments - add explicit note similar to SSLParameters
 - 8370688: Addressed review comments
 - 8370688: java.util.jar.JarEntry.getCodeSigners() and getCertificates() should specify that they return a copy of the arrays

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/28615/files
  - new: https://git.openjdk.org/jdk/pull/28615/files/cc77e339..548af3e6

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

  Stats: 117807 lines in 3863 files changed: 67264 ins; 24612 del; 25931 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