RFR: 8298420: PEM API: Implementation (Preview) [v13]

[Anthony Scarpino]

> Hi all,
> 
> I need a code review of the PEM API.  Privacy-Enhanced Mail (PEM) is a format for encoding and decoding cryptographic keys and certificates.  It will be integrated into JDK24 as a Preview Feature.  Preview features does not permanently define the API and it is subject to change in future releases until it is finalized.
> 
> Details about this change can be seen at [PEM API JEP](https://bugs.openjdk.org/browse/JDK-8300911).
> 
> Thanks
> 
> Tony

Anthony Scarpino has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 61 commits:

 - merge with master
 - better comment and remove commented out code
 - Merge branch 'master' into pem
 - Merge branch 'pem-merge' into pem
 - merge
 - Merge in PEMRecord as part of the API.
 - Merge branch 'pem-record' into pem-merge
   
   # Conflicts:
   #	src/java.base/share/classes/java/security/PEMDecoder.java
   #	src/java.base/share/classes/java/security/PEMRecord.java
   #	src/java.base/share/classes/sun/security/util/Pem.java
   #	test/jdk/java/security/PEM/PEMData.java
   #	test/jdk/java/security/PEM/PEMDecoderTest.java
   #	test/jdk/java/security/PEM/PEMEncoderTest.java
 - Merge branch 'master' into pem-record
   
   # Conflicts:
   #	src/java.base/share/classes/jdk/internal/javac/PreviewFeature.java
 - test fixes & cleanup
 - Implement stream decoding
   fix StringBuffer/Builder
   X509C* changes
 - ... and 51 more: https://git.openjdk.org/jdk/compare/a347ecde...106788ef

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

Changes: https://git.openjdk.org/jdk/pull/17543/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=17543&range=12
  Stats: 3379 lines in 41 files changed: 3061 ins; 129 del; 189 mod
  Patch: https://git.openjdk.org/jdk/pull/17543.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/17543/head:pull/17543

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