com.mchange.v2.async.AsynchronousRunner Maven / Gradle / Ivy
/*
* Distributed as part of mchange-commons-java 0.2.11
*
* Copyright (C) 2015 Machinery For Change, Inc.
*
* Author: Steve Waldman
*
* This library is free software; you can redistribute it and/or modify
* it under the terms of EITHER:
*
* 1) The GNU Lesser General Public License (LGPL), version 2.1, as
* published by the Free Software Foundation
*
* OR
*
* 2) The Eclipse Public License (EPL), version 1.0
*
* You may choose which license to accept if you wish to redistribute
* or modify this work. You may offer derivatives of this work
* under the license you have chosen, or you may provide the same
* choice of license which you have been offered here.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
*
* You should have received copies of both LGPL v2.1 and EPL v1.0
* along with this software; see the files LICENSE-EPL and LICENSE-LGPL.
* If not, the text of these licenses are currently available at
*
* LGPL v2.1: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
* EPL v1.0: http://www.eclipse.org/org/documents/epl-v10.php
*
*/
package com.mchange.v2.async;
import com.mchange.v1.util.ClosableResource;
public interface AsynchronousRunner extends ClosableResource
{
public void postRunnable(Runnable r);
/**
* Finish with this AsynchronousRunner, and clean-up
* any Threads or resources it may hold.
*
* @param skip_remaining_tasks Should be regarded as
* a hint, not a guarantee. If true, pending,
* not-yet-performed tasks will be skipped,
* if possible.
* Currently executing tasks may or
* may not be interrupted. If false, all
* previously scheduled tasks will be
* completed prior to clean-up. The method
* returns immediately regardless.
*/
public void close( boolean skip_remaining_tasks );
/**
* Clean-up resources held by this asynchronous runner
* as soon as possible. Remaining tasks are skipped if possible,
* and any tasks executing when close() is called may
* or may not be interrupted. Equivalent to close( true ).
*/
public void close();
}