JDK-8263195 : [JEP-356] : SplittableRandom :: makeXXXSpliterator does not state on boundary conditions
  • Type: Enhancement
  • Component: core-libs
  • Sub-Component: java.util
  • Affected Version: 17
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2021-03-08
  • Updated: 2021-03-12
  • Resolved: 2021-03-12
Related Reports
Relates :  
JDK-8255395 - Implement Enhanced Pseudo-Random Number Generators
Description
The new methods makeXXXSpliterator proposed as part of SplittableRandom does not state the boundary conditions like 
===============
index - the (inclusive) lower bound on traversal positions
fence - the (exclusive) upper bound on traversal positions
origin - the (inclusive) lower bound on the (pseudo)random values to be generated
bound - the (exclusive) upper bound on the (pseudo)random values to be generated
=============
It needs to be enhanced to state any exception scenarios based in input parameter boundary checks.
Comments
These routines should not have been exposed as public API. Have added @hidden to javadoc. Boundary checks are performed by higher level APIs; insist(), longs(), doubles().
12-03-2021