/AndroidThreadSwitcher

A handy Android Kotlin library to make it easy to switch between UI and Worker thread

Primary LanguageKotlinMIT LicenseMIT

NOTE: This repository has been deprecated. Use kotlin coroutine

Download GitHub license

AndroidThreadSwitcher Logo

About

AndroidThreadSwitcher helps you to switch between UI thread and Worker thread easily. It would free you from a lot of boilerplate codes and the Callback Hell.

Getting Started

Add the following to app's build.gradle file:

dependencies { 
    implementation 'boxresin.library:AndroidThreadSwitcher:1.2.0'
}

Usage in Kotlin

ThreadSwitcher.newChain() // Create an empty chain.
        // Concat a UI chain to the empty chain.
        .onUI {
            // Some tasks to do on a UI Thread
            "result" // Pass any value to the next chain.
        }
        // Concat a Worker chain to the previous chain.
        .onWorker { result: String -> // Receive the value from the previous chain.
            // Some tasks to do on Worker Thread
        }
        .onUI {
            // Some tasks to do on a UI Thread
        }
        .onWorker {
            // Some tasks to do on a Worker Thread
            "data"
        }

        // Start to perform all chains from the top to bottom.
        .start(
        // onSuccess callback would be invoked when all chains are finished without any exception.
        onSuccess = { result: String -> // The type of parameter is settled by the return value of last chain.
        },

        // onError callback would be invoked when an exception occurred during performancing chains.
        onError = { e: Throwable -> // The exception
        })

Usage in Java 8+

ThreadSwitcher.newChain() // Create an empty chain.
        // Concat a UI chain to the empty chain.
        .onUI(v -> // v is Void type.
        {
            // Some tasks to do on a UI Thread
            return "result"; // Pass any value to the next chain.
        })
        // Concat a Worker chain to the previous chain.
        .onWorker((String result) -> // Receive the value from the previous chain.
        {
            // Some tasks to do on Worker Thread
            return Unit.INSTANCE; // Unit type of Kotlin
        })
        .onUI(unit -> // Unit type of Kotlin
        {
            // Some tasks to do on a UI Thread
            return Unit.INSTANCE;
        })
        .onWorker(unit ->
        {
            // Some tasks to do on a Worker Thread
            return "data";
        })

        // Start to perform all chains from the top to bottom.
        .start(
            // This function would be invoked when all chains are finished without any exception.
            (String result) -> { // The type of parameter is settled by the return value of last chain.
                return Unit.INSTANCE;
            },
            // This function would be invoked when an exception occurred during performancing chains.
            (Throwable e) -> {
                return Unit.INSTANCE;
            }
        );

License

link