RFR: 8294693: Add Collections.shuffle overload that accepts RandomGenerator interface [v3]

[Tagir F. Valeev]

On Wed, 4 Jan 2023 21:32:17 GMT, Stuart Marks <smarks at openjdk.org> wrote:

>> A gentle ping: please review the change and the CSR. Thanks.
>
> @amaembo a couple comments on the test.
> 
> The test should probably have `@key randomness` added to it.
> 
> On 2022-10-28, @bplb wrote:
>> jdk.test.lib.RandomFactory can be used to generate a reproducible sequence of random numbers. An example of its use may be seen for example in java/nio/file/Files/CopyAndMove.java
> 
> This bit of the test library is useful if the test is testing a random subset of the state space. It prints out the random seed on each run so that if one of the test cases fails, it's possible to reproduce it by supplying the same seed. However, it's restricted to Random and SplittableRandom, and we want to test something like Xoshiro256PlusPlus that is a RandomGenerator but not a Random. So maybe this test library can't be applied. However, take a look and see if you think it might be useful to use it.

@stuart-marks thank you! I've updated PR (only since and copyright year) and CSR. Also rebased the change, though probably I should not? Hopefully, it's not very harmful.

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

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