RFR: 8316970: Add internal annotation to mark restricted methods [v2]

[Iris Clark]

On Wed, 27 Sep 2023 17:29:29 GMT, Maurizio Cimadamore <mcimadamore at openjdk.org> wrote:

>> This patch adds a new internal annotation that is used to mark all restricted me
>> thods in the FFM API. The new annotation is similar to the one we used for preview API methods.
>> 
>> We plan to use the new annotation for adding new javac warnings when calling restricted methods, as well as to add better javadoc support for restricted methods.
>> 
>> I have added a test which, similar to the test for `@CallerSensitive` checks all methods in `java.base` that are annotated with `@Restricted` and makes sure they conform to the list of restricted methods.
>
> Maurizio Cimadamore has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Drop requires tag from test

I've confirmed that the identified set of restricted methods matches those declared for Java SE 21 (https://cr.openjdk.org/~iris/se/21/latestSpec/#Restricted-methods).

I'm looking forward to the planned javadoc support for restricted methods.

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

Marked as reviewed by iris (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/15947#pullrequestreview-1647234726