RFR: 8377506: Implementation of PEM Encodings of Cryptographic Objects (Final)

[Anthony Scarpino]

Please review the finalized PEM API at https://openjdk.org/jeps/8360563. The most significant changes from the second preview, JEP 524 (https://openjdk.org/jeps/524), include:

- `PEM` is changed from a record to a class, with content stored in binary form and data defensively copied.
- `DEREncodable` is renamed to `BinaryEncodable` to more accurately reflect the binary data stored in PEM text.
- In `EncryptedPrivateKeyInfo`, the `encrypt` methods now accept `BinaryEncodable`, and the `getKey()` and `getKeyPair()` methods no longer include a `Provider` parameter.
- A new `CryptoException` indicates failures during cryptographic processing at runtime.

thanks

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

Commit messages:
 - Merge branch 'master' into pem27
 - doc and test updates
 - Initial

Changes: https://git.openjdk.org/jdk/pull/29640/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=29640&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8377506
  Stats: 752 lines in 33 files changed: 272 ins; 182 del; 298 mod
  Patch: https://git.openjdk.org/jdk/pull/29640.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/29640/head:pull/29640

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