RFR: 8360564: Implement JEP 524: PEM Encodings of Cryptographic Objects (Second Preview) [v15]

[Anthony Scarpino]

> Hi
> 
> Please review the [Second Preview](https://openjdk.org/jeps/8360563) for the PEM API.  The most significant changes from [JEP 470](https://openjdk.org/jeps/470) are:
> 
> - Renamed the name of `PEMRecord` class to `PEM`.
> - Revised the new `encryptKey` methods of the `EncryptedPrivateKeyInfo` class to accept `DEREncodable` objects rather than just `PrivateKey` objects so that cryptographic objects with public keys, i.e., `KeyPair` and `PKCS8EncodedKeySpec`, can also be encrypted.
> - Enhanced the `PEMEncoder` and `PEMDecoder` classes to support the encryption and decryption of `KeyPair` and `PKCS8EncodedKeySpec` objects.
> 
> thanks
> 
> Tony

Anthony Scarpino 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 27 additional commits since the last revision:

 - Merge branch 'master' into pem26
 - remove PEMRecord import
 - mistakes
 - Merge branch 'master' into pem26
 - minor doc updates, fix some bugs, PEM set to 26
 - more docs, remove runtimeexception
 - EKPI has a lot of @link's
 - docs
 - more doc updates and zeroing
 - fix non-pbe
 - ... and 17 more: https://git.openjdk.org/jdk/compare/70ba91ed...2ee3e7a4

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/27147/files
  - new: https://git.openjdk.org/jdk/pull/27147/files/5cba4d9e..2ee3e7a4

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=27147&range=14
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=27147&range=13-14

  Stats: 43834 lines in 872 files changed: 26634 ins; 12871 del; 4329 mod
  Patch: https://git.openjdk.org/jdk/pull/27147.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/27147/head:pull/27147

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