RFR: 8295044: Implementation of Foreign Function and Memory API (Second Preview) [v19]

[Maurizio Cimadamore]

On Tue, 15 Nov 2022 10:12:12 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> This PR contains the API and implementation changes for JEP-434 [1]. A more detailed description of such changes, to avoid repetitions during the review process, is included as a separate comment.
>> 
>> [1] - https://openjdk.org/jeps/434
>
> Maurizio Cimadamore 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 49 additional commits since the last revision:
> 
>  - Merge branch 'master' into PR_20
>  - Tweak preview feature description for JEP 434
>  - Tweak Arena::close javadoc
>  - Merge pull request #15 from minborg/test
>    
>    Add @apiNote to package-info
>  - Add @apiNote to package-info
>  - Merge pull request #16 from minborg/fix-tests2
>    
>    Fix failing tests
>  - Fix failing tests
>  - Rename isOwnedBy -> isCloseableBy
>    Fix minor typos
>    Fix StrLenTest/RingAllocator
>  - Fix typo
>  - More javadoc fixes
>  - ... and 39 more: https://git.openjdk.org/jdk/compare/3ebf94de...20ee6e8d

I've renamed `MemorySession` to `SegmentScope`, following some internal and external feedback. I've also greatly improved the javadoc of both `Arena` and `SegmentScope`. A javadoc of the API contained in this iteration can be found here:

http://cr.openjdk.java.net/~mcimadamore/jdk/8295044/v3/javadoc/java.base/module-summary.html

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

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