RFR: 8361300: Document exceptions for Unsafe offset methods [v6]

[Chen Liang]

On Thu, 31 Jul 2025 19:04:34 GMT, Chen Liang <liach at openjdk.org> wrote:

>> Unsafe throws IAE for misusing static vs instance fields, and it's revealed that AtomicXxxFieldUpdaters are using this mechanism to reject static fields. This is not a good practice, but we can at least document this so we don't accidentally introduce problems.
>
> Chen Liang has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Less specific reasons for IAE

@vy Can you help review this patch too? For context, `objectFieldOffset(Class, String)` should only find trusted fields and is a bootstrap optimization, while the Field-accepting version is the generic API.

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

PR Comment: https://git.openjdk.org/jdk/pull/25945#issuecomment-3142172712