/* * Copyright (c) 2010-2012 Sonatype, Inc. All rights reserved. * * This program is licensed to you under the Apache License Version 2.0, * and you may not use this file except in compliance with the Apache License Version 2.0. * You may obtain a copy of the Apache License Version 2.0 at http://www.apache.org/licenses/LICENSE-2.0. * * Unless required by applicable law or agreed to in writing, * software distributed under the Apache License Version 2.0 is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the Apache License Version 2.0 for the specific language governing permissions and limitations there under. */ /* * Copyright (C) 2007 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.ning.http.client.listenable; import java.util.Queue; import java.util.concurrent.Executor; import java.util.concurrent.LinkedBlockingQueue; public class ExecutionList { // The runnable,executor pairs to execute. private final Queue<RunnableExecutorPair> runnables = new LinkedBlockingQueue<RunnableExecutorPair>(); // Boolean we use mark when execution has started. Only accessed from within // synchronized blocks. private boolean executed = false; /** * Add the runnable/executor pair to the list of pairs to execute. Executes * the pair immediately if we've already started execution. */ public void add(final Runnable runnable, final Executor executor) { if (runnable == null) { throw new NullPointerException("Runnable is null"); } if (executor == null) { throw new NullPointerException("Executor is null"); } boolean executeImmediate = false; // Lock while we check state. We must maintain the lock while adding the // new pair so that another thread can't run the list out from under us. // We only add to the list if we have not yet started execution. synchronized (runnables) { if (!executed) { runnables.add(new RunnableExecutorPair(runnable, executor)); } else { executeImmediate = true; } } // Execute the runnable immediately. Because of scheduling this may end // up // getting called before some of the previously added runnables, but // we're // ok with that. If we want to change the contract to guarantee ordering // among runnables we'd have to modify the logic here to allow it. if (executeImmediate) { executor.execute(runnable); } } /** * Runs this execution list, executing all pairs in the order they were * added. Pairs added after this method has started executing the list will * be executed immediately. */ public void run() { // Lock while we update our state so the add method above will finish // adding // any listeners before we start to run them. synchronized (runnables) { executed = true; } // At this point the runnables will never be modified by another // thread, so we are safe using it outside of the synchronized block. while (!runnables.isEmpty()) { runnables.poll().execute(); } } private static class RunnableExecutorPair { final Runnable runnable; final Executor executor; RunnableExecutorPair(final Runnable runnable, final Executor executor) { this.runnable = runnable; this.executor = executor; } void execute() { try { executor.execute(runnable); } catch (final RuntimeException e) { // Log it and keep going, bad runnable and/or executor. Don't // punish the other runnables if we're given a bad one. We only // catch RuntimeException because we want Errors to propagate // up. e.printStackTrace(); } } } }