Futuroid - Android library for asynchronous tasks

Futuroid is an Android library that allows running asynchronous tasks and attaching callbacks thanks to a convenient syntax. It offers an alternative to the Android AsyncTask class.

Features

• Future-based API (similar to Guava's ListenableFutures, Scala/Akka Futures, Javascript promises...)
• Allows registering callbacks to be run on the Android UI/main thread
• Provides a default ExecutorService (fixed thread pool with 5 threads) that can be replaced by a custom one
• Each task can be run on the default ExecutorService or on a custom one
• Allows task chaining (monad-style)

Sample code

Image download asynchronous service:

public class DownloadService {

    /**
     * Downloads an image asynchronously.
     */
    public Future<Bitmap> downloadImage(String url) {
        return Async.submit(new Callable<Bitmap>() {
            @Override
            public Bitmap call() {
                Bitmap bitmap;

                // HTTP request goes here...

                return bitmap;
            }
        });
    }
}

Client code:

// download an image from a URL
imageService.downloadImage(url).addCallback(new FutureCallback<Bitmap>() {
    @Override
    public void onSuccess(Bitmap bitmap) {
        // display the image
        imageView.setImageBitmap(bitmap);
    }

    @Override
    public void onFailure(Throwable t) {
        Log.e(TAG, "Unable to download image", t);
    }
});

Adding Futuroid to your project

Futuroid is available on the Maven Central Repository.

Maven-based configuration:

<dependency>
    <groupId>com.github.clemp6r.futuroid</groupId>
    <artifactId>futuroid</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle-based configuration:

dependencies {
    compile 'com.github.clemp6r.futuroid:futuroid:1.0.0'
}

Links

API documentation