RFA 8056248: Improve ForkJoin thread throttling

[Paul Sandoz]

On Sep 11, 2014, at 3:27 PM, Seán Coffey <sean.coffey at oracle.com> wrote:

> Paul,
> 
> should you tag the new java.util.concurrent.ForkJoinPool.common.maximumSpares description with @implNote ?

Here is some more context:

 * <p><b>Implementation notes</b>: This implementation restricts the
 * maximum number of running threads to 32767. Attempts to create
 * pools with greater than the maximum number result in
 * {@code IllegalArgumentException}.
 *
 * <p>This implementation supports an additional common pool parameter that may
 * be controlled by setting the following
 * {@linkplain System#getProperty system property}:
 * <ul>
 * <li>{@code java.util.concurrent.ForkJoinPool.common.maximumSpares}
 * - the maximum number of allowed extra threads to maintain target
 * parallelism (default 256).
 * </ul>
 *
 * <p>This implementation rejects submitted tasks (that is, by throwing
 * {@link RejectedExecutionException}) only when the pool is shut down
 * or internal resources have been exhausted.

Note the " <p><b>Implementation notes</b>" which could be @implNote covering all paras below it, but I don't change so as to minimise porting from 166 -> 9 -> 8.


> Consider this approved for 8u-dev once CCC approval is granted.
> 

Thanks,
Paul.