title: Using a semaphore inside a nested Java 8 parallel stream action may DEADLOCK. Is this a bug?
body: <p>Consider the following situation: We are using a Java 8 parallel stream to perform a parallel forEach loop, e.g., </p>
  
  <pre><code>IntStream.range(0,20).parallel().forEach(i -&gt; { /* work done here */})
  </code></pre>
  
  <p>The number of parallel threads is controlled by the system property "java.util.concurrent.ForkJoinPool.common.parallelism" and usually equal to the number of processors.</p>
  
  <p>Now assume that we like to limit the number of parallel executions for a specific piece of work - e.g. because that part is memory intensive and memory constrain imply a limit of parallel executions.</p>
  
  <p>An obvious and elegant way to limit parallel executions is to use a Semaphore (suggested <a href="https://stackoverflow.com/questions/23442183">here</a>), e.g., the following pice of code limits the number of parallel executions to 5:</p>
  
  <pre><code>        final Semaphore concurrentExecutions = new Semaphore(5);
          IntStream.range(0,20).parallel().forEach(i -&gt; {
  
              concurrentExecutions.acquireUninterruptibly();
  
              try {
                  /* WORK DONE HERE */
              }
              finally {
                  concurrentExecutions.release();
              }
          });
  </code></pre>
  
  <p>This works just fine!</p>
  
  <p>However: Using any other parallel stream inside the worker (at <code>/* WORK DONE HERE */</code>) may result in a <strong>deadlock</strong>.</p>
  
  <p>For me this is an unexpected behavior.</p>
  
  <p>Explanation: Since Java streams use a ForkJoin pool, the inner forEach is forking, and the join appears to be waiting for ever. However, this behavior is still unexpected. Note that parallel streams even work if you set <code>"java.util.concurrent.ForkJoinPool.common.parallelism"</code> to 1.</p>
  
  <p>Note also that it may not be transparent if there is an inner parallel forEach.</p>
  
  <p><strong>Question:</strong> <em>Is this behavior in accordance with the Java 8 specification (in that case it would imply that the use of Semaphores inside parallel streams workers is forbidden) or is this a bug?</em> </p>
  
  <p>For convenience: Below is a complete test case. Any combinations of the two booleans work, except "true, true", which results in the deadlock.</p>
  
  <p><strong>Clarification:</strong> To make the point clear, let me stress one aspect: The deadlock does not occur at the <code>acquire</code> of the semaphore. Note that the code consists of</p>
  
  <ol>
  <li>acquire semaphore</li>
  <li>run some code</li>
  <li>release semaphore</li>
  </ol>
  
  <p>and the deadlock occurs at 2. if that piece of code is using ANOTHER parallel stream. Then the deadlock occurs inside that OTHER stream. As a consequence it appears that it is not allowed to use nested parallel streams and blocking operations (like a semaphore) together!</p>
  
  <p>Note that it is documented that parallel streams use a ForkJoinPool and that ForkJoinPool and Semaphore belong to the same package - <code>java.util.concurrent</code> (so one would expect that they interoperate nicely).</p>
  
  <pre><code>/*
   * (c) Copyright Christian P. Fries, Germany. All rights reserved. Contact: email@christian-fries.de.
   *
   * Created on 03.05.2014
   */
  package net.finmath.experiments.concurrency;
  
  import java.util.concurrent.Semaphore;
  import java.util.stream.IntStream;
  
  /**
   * This is a test of Java 8 parallel streams.
   * 
   * The idea behind this code is that the Semaphore concurrentExecutions
   * should limit the parallel executions of the outer forEach (which is an
   * &lt;code&gt;IntStream.range(0,numberOfTasks).parallel().forEach&lt;/code&gt; (for example:
   * the parallel executions of the outer forEach should be limited due to a
   * memory constrain).
   * 
   * Inside the execution block of the outer forEach we use another parallel stream
   * to create an inner forEach. The number of concurrent
   * executions of the inner forEach is not limited by us (it is however limited by a
   * system property "java.util.concurrent.ForkJoinPool.common.parallelism").
   * 
   * Problem: If the semaphore is used AND the inner forEach is active, then
   * the execution will be DEADLOCKED.
   * 
   * Note: A practical application is the implementation of the parallel
   * LevenbergMarquardt optimizer in
   * {@link http://finmath.net/java/finmath-lib/apidocs/net/finmath/optimizer/LevenbergMarquardt.html}
   * In one application the number of tasks in the outer and inner loop is very large (&gt;1000)
   * and due to memory limitation the outer loop should be limited to a small (5) number
   * of concurrent executions.
   * 
   * @author Christian Fries
   */
  public class ForkJoinPoolTest {
  
      public static void main(String[] args) {
  
          // Any combination of the booleans works, except (true,true)
          final boolean isUseSemaphore    = true;
          final boolean isUseInnerStream  = true;
  
          final int       numberOfTasksInOuterLoop = 20;              // In real applications this can be a large number (e.g. &gt; 1000).
          final int       numberOfTasksInInnerLoop = 100;             // In real applications this can be a large number (e.g. &gt; 1000).
          final int       concurrentExecusionsLimitInOuterLoop = 5;
          final int       concurrentExecutionsLimitForStreams = 10;
  
          final Semaphore concurrentExecutions = new Semaphore(concurrentExecusionsLimitInOuterLoop);
  
          System.setProperty("java.util.concurrent.ForkJoinPool.common.parallelism",Integer.toString(concurrentExecutionsLimitForStreams));
          System.out.println("java.util.concurrent.ForkJoinPool.common.parallelism = " + System.getProperty("java.util.concurrent.ForkJoinPool.common.parallelism"));
  
          IntStream.range(0,numberOfTasksInOuterLoop).parallel().forEach(i -&gt; {
  
              if(isUseSemaphore) {
                  concurrentExecutions.acquireUninterruptibly();
              }
  
              try {
                  System.out.println(i + "\t" + concurrentExecutions.availablePermits() + "\t" + Thread.currentThread());
  
                  if(isUseInnerStream) {
                      runCodeWhichUsesParallelStream(numberOfTasksInInnerLoop);
                  }
                  else {
                      try {
                          Thread.sleep(10*numberOfTasksInInnerLoop);
                      } catch (Exception e) {
                      }
                  }
              }
              finally {
                  if(isUseSemaphore) {
                      concurrentExecutions.release();
                  }
              }
          });
  
          System.out.println("D O N E");
      }
  
      /**
       * Runs code in a parallel forEach using streams.
       * 
       * @param numberOfTasksInInnerLoop Number of tasks to execute.
       */
      private static void runCodeWhichUsesParallelStream(int numberOfTasksInInnerLoop) {
          IntStream.range(0,numberOfTasksInInnerLoop).parallel().forEach(j -&gt; {
              try {
                  Thread.sleep(10);
              } catch (Exception e) {
              }
          });
      }
  }
  </code></pre>