RFR: 8065554: MatchResult should provide values of named-capturing groups

[Raffaello Giulietti]

On Wed, 24 Aug 2022 17:34:17 GMT, Daniel Fuchs <dfuchs at openjdk.org> wrote:

>> Not sure.
>> If the convention is to document every single `RuntimeException` that methods invoked by this one could throw, then yes.
>> In other words, should `RuntimeExcpetion`s thrown deep in an invocation stack be documented in every caller method?
>
> In principle, yes. In practice, I see that `namedGroups` doesn't have an `@throws UnsupportedOperationException` but has an `@implSpec` that says that the default implementation throws `UnsupportedOperationException`. This seems strange to me - maybe @stuart-marks or @jddarcy can comment.
> 
> What I was hinting at here however is that we might want to extend the `@implSpec` of the new methods to note that these method will throw `UnsuportedOperationException` if `namedGroups` is not implemented (like the `@implSpec` of `namedGroups` does).

Ah, I see.
So what you mean is not adding another @throws clause but to either improve @implNote or, better, to add @implSpec.

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

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