Clover coverage report - PLT Utilities Test Coverage (plt-20120304-r5436)
Coverage timestamp: Sat Mar 3 2012 22:01:56 CST
file stats: LOC: 85   Methods: 5
NCLOC: 34   Classes: 1
 
 Source file Conditionals Statements Methods TOTAL
ExecutorTaskController.java 25% 68.4% 80% 64.3%
coverage coverage
 1    /*BEGIN_COPYRIGHT_BLOCK*
 2   
 3    PLT Utilities BSD License
 4   
 5    Copyright (c) 2007-2010 JavaPLT group at Rice University
 6    All rights reserved.
 7   
 8    Developed by: Java Programming Languages Team
 9    Rice University
 10    http://www.cs.rice.edu/~javaplt/
 11   
 12    Redistribution and use in source and binary forms, with or without modification, are permitted
 13    provided that the following conditions are met:
 14   
 15    - Redistributions of source code must retain the above copyright notice, this list of conditions
 16    and the following disclaimer.
 17    - Redistributions in binary form must reproduce the above copyright notice, this list of
 18    conditions and the following disclaimer in the documentation and/or other materials provided
 19    with the distribution.
 20    - Neither the name of the JavaPLT group, Rice University, nor the names of the library's
 21    contributors may be used to endorse or promote products derived from this software without
 22    specific prior written permission.
 23   
 24    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 25    IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 26    FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND
 27    CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 28    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 29    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
 30    IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 31    OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 32   
 33    *END_COPYRIGHT_BLOCK*/
 34   
 35    package edu.rice.cs.plt.concurrent;
 36   
 37    import java.util.concurrent.Executor;
 38   
 39    import edu.rice.cs.plt.lambda.Thunk;
 40    import edu.rice.cs.plt.lambda.WrappedException;
 41   
 42    /**
 43    * A TaskController for a simple task, which is scheduled for execution by an Executor. To support
 44    * canceling, the task should respond to an interrupt by throwing an {@link InterruptedException}, wrapped by a
 45    * {@link WrappedException}. The task is submitted (via {@link Executor#execute}) when {@code start()} is
 46    * invoked (if the executor blocks, so will {@code start()}); its status is changed to "running" when it
 47    * actually begins executing; if canceled in the interim, the status will still be "paused" until the
 48    * task begins its scheduled execution.
 49    */
 50    public class ExecutorTaskController<R> extends TaskController<R> {
 51    // fields will be changed to null by discard(), but no need for volatile because it's only for garbage collection
 52    private Executor _executor;
 53    private Thunk<? extends R> _task;
 54    // must be volatile because it starts uninitialized
 55    private volatile Thread _t;
 56   
 57  3 public ExecutorTaskController(Executor executor, Thunk<? extends R> task) {
 58  3 _executor = executor;
 59  3 _task = task;
 60  3 _t = null; // initialized immediately before started() is called
 61    }
 62   
 63  3 protected void doStart() {
 64  3 _executor.execute(new Runnable() {
 65  3 public void run() {
 66  3 _t = Thread.currentThread();
 67  3 started();
 68  3 try {
 69    // stop if the task was canceled before execution began
 70  0 if (Thread.interrupted()) { throw new InterruptedException(); }
 71  3 finishedCleanly(_task.value());
 72    }
 73  0 catch (InterruptedException e) { stopped(); }
 74    catch (WrappedException e) {
 75  0 if (e.getCause() instanceof InterruptedException) { stopped(); }
 76  0 else { finishedWithTaskException(e); }
 77    }
 78  1 catch (RuntimeException e) { finishedWithTaskException(e); }
 79    }
 80    });
 81    }
 82   
 83  0 protected void doStop() { _t.interrupt(); }
 84  3 protected void discard() { _executor = null; _task = null; _t = null; }
 85    }