Clover coverage report - PLT Utilities Test Coverage (plt-20120304-r5436)
Coverage timestamp: Sat Mar 3 2012 22:01:56 CST
file stats: LOC: 98   Methods: 8
NCLOC: 45   Classes: 1
 
 Source file Conditionals Statements Methods TOTAL
FutureTaskController.java 0% 0% 0% 0%
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.CancellationException;
 38    import java.util.concurrent.ExecutionException;
 39    import java.util.concurrent.Future;
 40    import java.util.concurrent.TimeUnit;
 41    import java.util.concurrent.TimeoutException;
 42   
 43    import edu.rice.cs.plt.lambda.Thunk;
 44    import edu.rice.cs.plt.lambda.WrappedException;
 45   
 46    /**
 47    * Treats an arbitrary Future-producing computation as a TaskController. The task is considered "started"
 48    * once the future has been created via {@link #start()} (even though some futures are not scheduled
 49    * for immediate execution — the API provides no means for determining whether a task is
 50    * actually running).
 51    */
 52    public class FutureTaskController<T> extends PollingTaskController<T> {
 53    // fields are made null on discard; _future is initially null, too
 54    private volatile Thunk<? extends Future<? extends T>> _futureThunk;
 55    private volatile Future<? extends T> _future;
 56   
 57  0 public FutureTaskController(Thunk<? extends Future<? extends T>> futureThunk) {
 58  0 _futureThunk = futureThunk;
 59  0 _future = null;
 60    }
 61   
 62  0 protected void doStart() { _future = _futureThunk.value(); started(); }
 63  0 protected void doStop() { _future.cancel(true); }
 64  0 protected void discard() { _futureThunk = null; _future = null; }
 65   
 66  0 protected void update() {
 67  0 if (_future.isDone()) {
 68  0 if (_future.isCancelled()) { stopped(); }
 69    else {
 70  0 try { finish(); }
 71    catch (InterruptedException e) { /* shouldn't happen -- we're done -- but just ignore. */ }
 72    }
 73    }
 74    }
 75   
 76  0 protected void finish() throws InterruptedException {
 77  0 try { finishedCleanly(_future.get()); }
 78  0 catch (CancellationException e) { stopped(); }
 79  0 catch (ExecutionException e) { handleExecutionException(e); }
 80  0 catch (RuntimeException e) { finishedWithImplementationException(e); }
 81    }
 82   
 83  0 protected void finish(long timeout, TimeUnit unit) throws InterruptedException, TimeoutException {
 84  0 try { finishedCleanly(_future.get(timeout, unit)); }
 85  0 catch (CancellationException e) { stopped(); }
 86  0 catch (ExecutionException e) { handleExecutionException(e); }
 87  0 catch (RuntimeException e) { finishedWithImplementationException(e); }
 88    }
 89   
 90  0 private void handleExecutionException(ExecutionException e) {
 91  0 Throwable cause = e.getCause(); // may be null
 92  0 if (cause instanceof Exception) { finishedWithTaskException((Exception) cause); }
 93  0 else { finishedWithImplementationException(new WrappedException(e)); }
 94    }
 95   
 96    }
 97   
 98