[foreign-memaccess+abi] RFR: 8264434: Remove ResourceScope-less overload from API [v3]

[Paul Sandoz]

On Tue, 30 Mar 2021 16:25:45 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> This patch does a bunch of API cleanups related to overloaded methods:
>> 
>> * Remove ResouceScope-less overloads (in MemorySegment, CLinker, MemoryAddress, VaList)
>> * Remove ResourceScope factory overloads which take Object attachment (in ResourceScope)
>> * Fixup javadoc
>> 
>> The changes are mostly mechanical - e.g. an extra ResourceScope.ofImplicit() is added wherever needed.
>> Similarly, for address to segment conversion, an extra ResourceScope.globalScope() is added.
>> 
>> The term *implicit* has been selected to denote the subset of scopes that are not only managed by a Cleaner, but that do not play into explicit deallocation.
>> 
>> So, ResourceScope.ofImplicit() returns a new implicit scope, whereas ResourceScope.globalScope, returns a constant implicit scope which is assumed to be alive for the entire duration of the application.
>> 
>> A new predicate has been added on ResourceScope, namely `isImplicit` which allows client to see whether a segment supports deterministic closure (we used to have a similar predicate, but was called `isCloseable` and that created confusion w.r.t. the semantics of close() - the new naming is more apt, in that it clearly reflects a permanent property of the resource scope).
>
> Maurizio Cimadamore has updated the pull request incrementally with three additional commits since the last revision:
> 
>  - Update src/jdk.incubator.foreign/share/classes/jdk/incubator/foreign/ResourceScope.java
>    
>    Co-authored-by: Paul Sandoz <paul.d.sandoz at googlemail.com>
>  - Update src/jdk.incubator.foreign/share/classes/jdk/incubator/foreign/ResourceScope.java
>    
>    Co-authored-by: Paul Sandoz <paul.d.sandoz at googlemail.com>
>  - Update src/jdk.incubator.foreign/share/classes/jdk/incubator/foreign/ResourceScope.java
>    
>    Co-authored-by: Jorn Vernee <JornVernee at users.noreply.github.com>

Marked as reviewed by psandoz (Committer).

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

PR: https://git.openjdk.java.net/panama-foreign/pull/485