RFR: 8335939: Hide element writing across the ClassFile API [v3]

[Chen Liang]

On Sat, 20 Jul 2024 23:12:59 GMT, Chen Liang <liach at openjdk.org> wrote:

>> `WritableElement` has always been one of the biggest peculiarities of ClassFile API: it exposes element writing yet has no corresponding reading ability exposed. Its existence creates a lot of API noise, increasing maintenance cost in the long run. (This is an iceberg whose tip was exposed in #14705)
>> 
>> Removal details:
>> - `LocalVariable/LocalVariableType.writeTo`
>> - `WritableElement`
>> - In `BufWriter`:
>>   - `writeList(List<WritableElement>)`
>>   - `writeListIndices`: Hidden as we are not exposing `BoundAttribute.readEntryList`
>>   - `writeBytes(BufWriter other)`
>> - `ClassReader.compare`: Avoid reading from `BufWriter`
>> 
>> Future implementation cleanup out of scope of this patch:
>> - Annotation writing can be upgraded and move away from `Util.Writable`
>> - The writing of CP indices and attributes can move to their dedicated methods
>> - reading of entry list can pair up with writing of entry list in ClassReader/BufWriter in future addition
>
> Chen Liang has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 10 commits:
> 
>  - Merge branch 'master' of https://github.com/openjdk/jdk into fix/cf-apis
>  - Merge branch 'master' of https://github.com/openjdk/jdk into fix/cf-apis
>  - Merge BoundAttributeTest
>  - Merge branch 'master' of https://github.com/openjdk/jdk into fix/cf-apis
>  - Merge branch 'master' of https://github.com/openjdk/jdk into fix/cf-apis
>  - 2 test failures
>  - Web review cleanup
>  - Remove WritableElement and reduce Writable usage
>    
>    The rest of Writable in annotations can be removed in later cleanup
>  - Fix up usages of Util.write
>  - Hide writeTo from all class file elements
>    
>    To consider the fate of WritableElement later!

Re-requesting a review: there was a conflict with #20244 in implements list of `DirectMethodBuilder`.

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

PR Comment: https://git.openjdk.org/jdk/pull/20205#issuecomment-2244260340