├── app
├── .gitignore
├── src
│ ├── main
│ │ ├── res
│ │ │ ├── mipmap-hdpi
│ │ │ │ └── ic_launcher.png
│ │ │ ├── mipmap-mdpi
│ │ │ │ └── ic_launcher.png
│ │ │ ├── mipmap-xhdpi
│ │ │ │ └── ic_launcher.png
│ │ │ ├── mipmap-xxhdpi
│ │ │ │ └── ic_launcher.png
│ │ │ ├── mipmap-xxxhdpi
│ │ │ │ └── ic_launcher.png
│ │ │ ├── values
│ │ │ │ ├── colors.xml
│ │ │ │ ├── dimens.xml
│ │ │ │ ├── styles.xml
│ │ │ │ └── strings.xml
│ │ │ ├── values-w820dp
│ │ │ │ └── dimens.xml
│ │ │ └── layout
│ │ │ │ └── activity_main.xml
│ │ ├── java
│ │ │ └── com
│ │ │ │ └── franktan
│ │ │ │ └── multithreadingblogs
│ │ │ │ ├── UiThreadCallback.java
│ │ │ │ ├── Util.java
│ │ │ │ ├── CustomRunnable.java
│ │ │ │ ├── CustomCallable.java
│ │ │ │ ├── CustomHandlerThread.java
│ │ │ │ ├── CustomThreadPoolManager.java
│ │ │ │ └── MainActivity.java
│ │ └── AndroidManifest.xml
│ ├── test
│ │ └── java
│ │ │ └── com
│ │ │ └── franktan
│ │ │ └── multithreadingblogs
│ │ │ └── ExampleUnitTest.java
│ └── androidTest
│ │ └── java
│ │ └── com
│ │ └── franktan
│ │ └── multithreadingblogs
│ │ └── ApplicationTest.java
├── proguard-rules.pro
└── build.gradle
├── settings.gradle
├── gradle
└── wrapper
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── .gitignore
├── README.md
├── gradle.properties
├── gradlew.bat
└── gradlew
/app/.gitignore:
--------------------------------------------------------------------------------
1 | /build
2 |
--------------------------------------------------------------------------------
/settings.gradle:
--------------------------------------------------------------------------------
1 | include ':app'
2 |
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/frank-tan/AndroidMultithreadingBlogs/HEAD/gradle/wrapper/gradle-wrapper.jar
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | *.iml
2 | .gradle
3 | /local.properties
4 | /.idea/workspace.xml
5 | /.idea/libraries
6 | .DS_Store
7 | /build
8 | /captures
9 | .idea/**
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-hdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/frank-tan/AndroidMultithreadingBlogs/HEAD/app/src/main/res/mipmap-hdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-mdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/frank-tan/AndroidMultithreadingBlogs/HEAD/app/src/main/res/mipmap-mdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/frank-tan/AndroidMultithreadingBlogs/HEAD/app/src/main/res/mipmap-xhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/frank-tan/AndroidMultithreadingBlogs/HEAD/app/src/main/res/mipmap-xxhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/frank-tan/AndroidMultithreadingBlogs/HEAD/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png
--------------------------------------------------------------------------------
/app/src/main/res/values/colors.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | #3F51B5
4 | #303F9F
5 | #FF4081
6 |
7 |
--------------------------------------------------------------------------------
/app/src/main/res/values/dimens.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 | 16dp
4 | 16dp
5 |
6 |
--------------------------------------------------------------------------------
/gradle/wrapper/gradle-wrapper.properties:
--------------------------------------------------------------------------------
1 | #Sun Apr 10 20:46:19 AWST 2016
2 | distributionBase=GRADLE_USER_HOME
3 | distributionPath=wrapper/dists
4 | zipStoreBase=GRADLE_USER_HOME
5 | zipStorePath=wrapper/dists
6 | distributionUrl=https\://services.gradle.org/distributions/gradle-2.10-all.zip
7 |
--------------------------------------------------------------------------------
/app/src/main/res/values-w820dp/dimens.xml:
--------------------------------------------------------------------------------
1 |
2 |
5 | 64dp
6 |
7 |
--------------------------------------------------------------------------------
/app/src/main/java/com/franktan/multithreadingblogs/UiThreadCallback.java:
--------------------------------------------------------------------------------
1 | package com.franktan.multithreadingblogs;
2 |
3 | import android.os.Message;
4 |
5 | /**
6 | * Created by Frank Tan on 3/04/2016.
7 | *
8 | * An interface for worker threads to send messages to the UI thread.
9 | * MainActivity implemented this Interface in this app.
10 | */
11 | public interface UiThreadCallback {
12 | void publishToUiThread(Message message);
13 | }
14 |
--------------------------------------------------------------------------------
/app/src/test/java/com/franktan/multithreadingblogs/ExampleUnitTest.java:
--------------------------------------------------------------------------------
1 | package com.franktan.multithreadingblogs;
2 |
3 | import org.junit.Test;
4 |
5 | import static org.junit.Assert.*;
6 |
7 | /**
8 | * To work on unit tests, switch the Test Artifact in the Build Variants view.
9 | */
10 | public class ExampleUnitTest {
11 | @Test
12 | public void addition_isCorrect() throws Exception {
13 | assertEquals(4, 2 + 2);
14 | }
15 | }
--------------------------------------------------------------------------------
/app/src/main/res/values/styles.xml:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
10 |
11 |
12 |
--------------------------------------------------------------------------------
/app/src/androidTest/java/com/franktan/multithreadingblogs/ApplicationTest.java:
--------------------------------------------------------------------------------
1 | package com.franktan.multithreadingblogs;
2 |
3 | import android.app.Application;
4 | import android.test.ApplicationTestCase;
5 |
6 | /**
7 | * Testing Fundamentals
8 | */
9 | public class ApplicationTest extends ApplicationTestCase {
10 | public ApplicationTest() {
11 | super(Application.class);
12 | }
13 | }
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # Source Code for Android Multithreading Blogs
2 |
3 | This is an example app for demonstrating various of multi-threading techniques. The detailed discussions of these techniques are available on my [technical blog](https://medium.com/@frank.tan).
4 |
5 | The blogs in this series are still expanding. Available blogs are:
6 |
7 | * [HandlerThread](https://medium.com/@frank.tan/using-handlerthread-in-android-46c285936fdd#.cbg6w03kc)
8 |
9 | * [Thread Pool](https://medium.com/@frank.tan/using-a-thread-pool-in-android-e3c88f59d07f#.wz5n8aao6)
10 |
--------------------------------------------------------------------------------
/app/src/main/res/values/strings.xml:
--------------------------------------------------------------------------------
1 |
2 | Multithreading Series
3 | Send a Runnable to a HandlerThread
4 | Send a Message to a HandlerThread
5 | Send 4 tasks to Thread Pool
6 | Send 8 tasks to Thread Pool
7 | Clear Messages
8 | Stop all threads in thread pool
9 |
10 |
--------------------------------------------------------------------------------
/app/proguard-rules.pro:
--------------------------------------------------------------------------------
1 | # Add project specific ProGuard rules here.
2 | # By default, the flags in this file are appended to flags specified
3 | # in /Users/tan/Library/Android/sdk/tools/proguard/proguard-android.txt
4 | # You can edit the include path and order by changing the proguardFiles
5 | # directive in build.gradle.
6 | #
7 | # For more details, see
8 | # http://developer.android.com/guide/developing/tools/proguard.html
9 |
10 | # Add any project specific keep options here:
11 |
12 | # If your project uses WebView with JS, uncomment the following
13 | # and specify the fully qualified class name to the JavaScript interface
14 | # class:
15 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview {
16 | # public *;
17 | #}
18 |
--------------------------------------------------------------------------------
/app/build.gradle:
--------------------------------------------------------------------------------
1 | apply plugin: 'com.android.application'
2 |
3 | android {
4 | compileSdkVersion 23
5 | buildToolsVersion "23.0.2"
6 |
7 | defaultConfig {
8 | applicationId "com.franktan.multithreadingblogs"
9 | minSdkVersion 16
10 | targetSdkVersion 23
11 | versionCode 1
12 | versionName "1.0"
13 | }
14 | buildTypes {
15 | release {
16 | minifyEnabled false
17 | proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
18 | }
19 | }
20 | }
21 |
22 | dependencies {
23 | compile fileTree(dir: 'libs', include: ['*.jar'])
24 | testCompile 'junit:junit:4.12'
25 | compile 'com.android.support:appcompat-v7:23.2.1'
26 | }
27 |
--------------------------------------------------------------------------------
/app/src/main/AndroidManifest.xml:
--------------------------------------------------------------------------------
1 |
2 |
4 |
5 |
11 |
12 |
13 |
14 |
15 |
16 |
17 |
18 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/gradle.properties:
--------------------------------------------------------------------------------
1 | # Project-wide Gradle settings.
2 |
3 | # IDE (e.g. Android Studio) users:
4 | # Gradle settings configured through the IDE *will override*
5 | # any settings specified in this file.
6 |
7 | # For more details on how to configure your build environment visit
8 | # http://www.gradle.org/docs/current/userguide/build_environment.html
9 |
10 | # Specifies the JVM arguments used for the daemon process.
11 | # The setting is particularly useful for tweaking memory settings.
12 | # Default value: -Xmx10248m -XX:MaxPermSize=256m
13 | # org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
14 |
15 | # When configured, Gradle will run in incubating parallel mode.
16 | # This option should only be used with decoupled projects. More details, visit
17 | # http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
18 | # org.gradle.parallel=true
--------------------------------------------------------------------------------
/app/src/main/java/com/franktan/multithreadingblogs/Util.java:
--------------------------------------------------------------------------------
1 | package com.franktan.multithreadingblogs;
2 |
3 | import android.os.Bundle;
4 | import android.os.Message;
5 |
6 | import java.text.SimpleDateFormat;
7 | import java.util.Date;
8 |
9 | /**
10 | * Created by Frank Tan on 10/04/2016.
11 | *
12 | * A helper class with static properties and methods
13 | */
14 | public class Util {
15 | public static final String LOG_TAG = "BackgroundThread";
16 | public static final int MESSAGE_ID = 1;
17 | public static final String MESSAGE_BODY = "MESSAGE_BODY";
18 | public static final String EMPTY_MESSAGE = "";
19 |
20 | public static String getReadableTime() {
21 | SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss.SSS");
22 | return sdf.format(new Date());
23 | }
24 |
25 | public static Message createMessage(int id, String dataString) {
26 | Bundle bundle = new Bundle();
27 | bundle.putString(Util.MESSAGE_BODY, dataString);
28 | Message message = new Message();
29 | message.what = id;
30 | message.setData(bundle);
31 |
32 | return message;
33 | }
34 | }
35 |
--------------------------------------------------------------------------------
/app/src/main/java/com/franktan/multithreadingblogs/CustomRunnable.java:
--------------------------------------------------------------------------------
1 | package com.franktan.multithreadingblogs;
2 |
3 | import android.os.Message;
4 |
5 | import java.lang.ref.WeakReference;
6 |
7 | /**
8 | * Created by tan on 11/04/2016.
9 | * CustomRunnable run some lengthy blocking code on a worker thread and notify UI thread when the
10 | * work is done
11 | */
12 | public class CustomRunnable implements Runnable {
13 | // Keep a weak reference to ui callback, so we can send a message to the UI thread
14 | // Use weak reference to avoid leaking activity object
15 | private WeakReference uiThreadCallbackWeakReference;
16 |
17 | @Override
18 | public void run() {
19 | try {
20 | // Before running some lengthy and blocking work, check if the thread has been interrupted
21 | if (Thread.interrupted()) throw new InterruptedException();
22 |
23 | // In real world app, you might do some blocking IO operation
24 | // In this example, I just let the thread sleep for 3 second
25 | Thread.sleep(3000);
26 |
27 | // After work is finished, send a message to UI thread
28 | Message message = Util.createMessage(Util.MESSAGE_ID,
29 | "Thread " + String.valueOf(Thread.currentThread().getId()) + " completed");
30 |
31 | if(uiThreadCallbackWeakReference != null && uiThreadCallbackWeakReference.get() != null) {
32 | uiThreadCallbackWeakReference.get().publishToUiThread(message);
33 | }
34 | } catch (InterruptedException e) {
35 | e.printStackTrace();
36 | }
37 | }
38 |
39 | public void setUiThreadCallback(UiThreadCallback uiThreadCallback) {
40 | this.uiThreadCallbackWeakReference = new WeakReference(uiThreadCallback);
41 | }
42 | }
43 |
--------------------------------------------------------------------------------
/app/src/main/java/com/franktan/multithreadingblogs/CustomCallable.java:
--------------------------------------------------------------------------------
1 | package com.franktan.multithreadingblogs;
2 |
3 | import android.os.Message;
4 |
5 | import java.lang.ref.WeakReference;
6 | import java.util.concurrent.Callable;
7 |
8 | /**
9 | * Created by frank.yitan on 12/04/2016.
10 | * CustomCallable is used for sending tasks to the thread pool. When a callable is submitted,
11 | * a Future object is returned, allowing the thread pool manager to stop the task.
12 | */
13 | public class CustomCallable implements Callable {
14 |
15 | // Keep a weak reference to the CustomThreadPoolManager singleton object, so we can send a
16 | // message. Use of weak reference is not a must here because CustomThreadPoolManager lives
17 | // across the whole application lifecycle
18 | private WeakReference mCustomThreadPoolManagerWeakReference;
19 |
20 | @Override
21 | public Object call() throws Exception {
22 | try {
23 | // check if thread is interrupted before lengthy operation
24 | if (Thread.interrupted()) throw new InterruptedException();
25 |
26 | // In real world project, you might do some blocking IO operation
27 | // In this example, I just let the thread sleep for 3 second
28 | Thread.sleep(3000);
29 |
30 | // After work is finished, send a message to CustomThreadPoolManager
31 | Message message = Util.createMessage(Util.MESSAGE_ID, "Thread " +
32 | String.valueOf(Thread.currentThread().getId()) + " " +
33 | String.valueOf(Thread.currentThread().getName()) + " completed");
34 |
35 | if(mCustomThreadPoolManagerWeakReference != null
36 | && mCustomThreadPoolManagerWeakReference.get() != null) {
37 |
38 | mCustomThreadPoolManagerWeakReference.get().sendMessageToUiThread(message);
39 | }
40 | } catch (InterruptedException e) {
41 | e.printStackTrace();
42 | }
43 | return null;
44 | }
45 |
46 | public void setCustomThreadPoolManager(CustomThreadPoolManager customThreadPoolManager) {
47 | this.mCustomThreadPoolManagerWeakReference = new WeakReference(customThreadPoolManager);
48 | }
49 | }
50 |
--------------------------------------------------------------------------------
/gradlew.bat:
--------------------------------------------------------------------------------
1 | @if "%DEBUG%" == "" @echo off
2 | @rem ##########################################################################
3 | @rem
4 | @rem Gradle startup script for Windows
5 | @rem
6 | @rem ##########################################################################
7 |
8 | @rem Set local scope for the variables with windows NT shell
9 | if "%OS%"=="Windows_NT" setlocal
10 |
11 | @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
12 | set DEFAULT_JVM_OPTS=
13 |
14 | set DIRNAME=%~dp0
15 | if "%DIRNAME%" == "" set DIRNAME=.
16 | set APP_BASE_NAME=%~n0
17 | set APP_HOME=%DIRNAME%
18 |
19 | @rem Find java.exe
20 | if defined JAVA_HOME goto findJavaFromJavaHome
21 |
22 | set JAVA_EXE=java.exe
23 | %JAVA_EXE% -version >NUL 2>&1
24 | if "%ERRORLEVEL%" == "0" goto init
25 |
26 | echo.
27 | echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
28 | echo.
29 | echo Please set the JAVA_HOME variable in your environment to match the
30 | echo location of your Java installation.
31 |
32 | goto fail
33 |
34 | :findJavaFromJavaHome
35 | set JAVA_HOME=%JAVA_HOME:"=%
36 | set JAVA_EXE=%JAVA_HOME%/bin/java.exe
37 |
38 | if exist "%JAVA_EXE%" goto init
39 |
40 | echo.
41 | echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
42 | echo.
43 | echo Please set the JAVA_HOME variable in your environment to match the
44 | echo location of your Java installation.
45 |
46 | goto fail
47 |
48 | :init
49 | @rem Get command-line arguments, handling Windowz variants
50 |
51 | if not "%OS%" == "Windows_NT" goto win9xME_args
52 | if "%@eval[2+2]" == "4" goto 4NT_args
53 |
54 | :win9xME_args
55 | @rem Slurp the command line arguments.
56 | set CMD_LINE_ARGS=
57 | set _SKIP=2
58 |
59 | :win9xME_args_slurp
60 | if "x%~1" == "x" goto execute
61 |
62 | set CMD_LINE_ARGS=%*
63 | goto execute
64 |
65 | :4NT_args
66 | @rem Get arguments from the 4NT Shell from JP Software
67 | set CMD_LINE_ARGS=%$
68 |
69 | :execute
70 | @rem Setup the command line
71 |
72 | set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
73 |
74 | @rem Execute Gradle
75 | "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
76 |
77 | :end
78 | @rem End local scope for the variables with windows NT shell
79 | if "%ERRORLEVEL%"=="0" goto mainEnd
80 |
81 | :fail
82 | rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
83 | rem the _cmd.exe /c_ return code!
84 | if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
85 | exit /b 1
86 |
87 | :mainEnd
88 | if "%OS%"=="Windows_NT" endlocal
89 |
90 | :omega
91 |
--------------------------------------------------------------------------------
/app/src/main/res/layout/activity_main.xml:
--------------------------------------------------------------------------------
1 |
2 |
7 |
8 |
16 |
17 |
23 |
24 |
30 |
31 |
37 |
38 |
44 |
45 |
51 |
52 |
59 |
60 |
65 |
66 |
--------------------------------------------------------------------------------
/app/src/main/java/com/franktan/multithreadingblogs/CustomHandlerThread.java:
--------------------------------------------------------------------------------
1 | package com.franktan.multithreadingblogs;
2 |
3 | import android.os.Handler;
4 | import android.os.HandlerThread;
5 | import android.os.Looper;
6 | import android.os.Message;
7 | import android.util.Log;
8 |
9 | import java.lang.ref.WeakReference;
10 |
11 | /**
12 | * Created by Frank Tan on 3/04/2016.
13 | * Our custom class extending HandlerThread
14 | */
15 | public class CustomHandlerThread extends HandlerThread {
16 |
17 | CustomHandler mHandler;
18 | // use weak reference to avoid activity being leaked
19 | private WeakReference mUiThreadCallback;
20 |
21 | public CustomHandlerThread(String name){
22 | super(name, android.os.Process.THREAD_PRIORITY_BACKGROUND);
23 | }
24 |
25 | // Get a reference to worker thread's handler after looper is prepared
26 | @Override
27 | protected void onLooperPrepared() {
28 | super.onLooperPrepared();
29 | mHandler = new CustomHandler(getLooper());
30 | }
31 |
32 | // Used by UI thread to send a message to the worker thread's message queue
33 | public void addMessage(int message){
34 | if(mHandler != null) {
35 | mHandler.sendEmptyMessage(message);
36 | }
37 | }
38 |
39 | // Used by UI thread to send a runnable to the worker thread's message queue
40 | public void postRunnable(Runnable runnable){
41 | if(mHandler != null) {
42 | mHandler.post(runnable);
43 | }
44 | }
45 |
46 | // The UiThreadCallback is used to send message to UI thread
47 | public void setUiThreadCallback(UiThreadCallback callback){
48 | this.mUiThreadCallback = new WeakReference(callback);
49 | }
50 |
51 | // Custom Handler. It pause the thread for some time and send a message back to UI Thread
52 | private class CustomHandler extends Handler {
53 | public CustomHandler(Looper looper) {
54 | super(looper);
55 | }
56 |
57 |
58 | @Override
59 | public void handleMessage(Message msg) {
60 | super.handleMessage(msg);
61 | switch (msg.what){
62 | case 1:
63 | try {
64 | Thread.sleep(1000);
65 | if(!Thread.interrupted() && mUiThreadCallback != null && mUiThreadCallback.get() != null){
66 | Message message = Util.createMessage(Util.MESSAGE_ID, "Thread " + String.valueOf(Thread.currentThread().getId()) + " completed");
67 | mUiThreadCallback.get().publishToUiThread(message);
68 | }
69 | } catch (InterruptedException e){
70 | Log.e(Util.LOG_TAG,"HandlerThread interrupted");
71 | }
72 | break;
73 | default:
74 | break;
75 | }
76 | }
77 | }
78 | }
79 |
--------------------------------------------------------------------------------
/app/src/main/java/com/franktan/multithreadingblogs/CustomThreadPoolManager.java:
--------------------------------------------------------------------------------
1 | package com.franktan.multithreadingblogs;
2 |
3 | import android.os.Message;
4 | import android.os.Process;
5 | import android.util.Log;
6 |
7 | import java.lang.ref.WeakReference;
8 | import java.util.ArrayList;
9 | import java.util.List;
10 | import java.util.concurrent.BlockingQueue;
11 | import java.util.concurrent.Callable;
12 | import java.util.concurrent.ExecutorService;
13 | import java.util.concurrent.Future;
14 | import java.util.concurrent.LinkedBlockingQueue;
15 | import java.util.concurrent.ThreadFactory;
16 | import java.util.concurrent.ThreadPoolExecutor;
17 | import java.util.concurrent.TimeUnit;
18 |
19 | /**
20 | * Created by Frank Tan on 11/04/2016.
21 | * A Singleton Manager for managing the thread pool
22 | */
23 | public class CustomThreadPoolManager {
24 |
25 | private static CustomThreadPoolManager sInstance = null;
26 | private static final int DEFAULT_THREAD_POOL_SIZE = 4;
27 | private static int NUMBER_OF_CORES = Runtime.getRuntime().availableProcessors();
28 | private static final int KEEP_ALIVE_TIME = 1;
29 | private static final TimeUnit KEEP_ALIVE_TIME_UNIT;
30 |
31 | private final ExecutorService mExecutorService;
32 | private final BlockingQueue mTaskQueue;
33 | private List mRunningTaskList;
34 |
35 | private WeakReference uiThreadCallbackWeakReference;
36 |
37 | // The class is used as a singleton
38 | static {
39 | KEEP_ALIVE_TIME_UNIT = TimeUnit.SECONDS;
40 | sInstance = new CustomThreadPoolManager();
41 | }
42 |
43 | // Made constructor private to avoid the class being initiated from outside
44 | private CustomThreadPoolManager() {
45 | // initialize a queue for the thread pool. New tasks will be added to this queue
46 | mTaskQueue = new LinkedBlockingQueue();
47 |
48 | mRunningTaskList = new ArrayList<>();
49 |
50 | Log.e(Util.LOG_TAG,"Available cores: " + NUMBER_OF_CORES);
51 |
52 | /*
53 | TODO: You can choose between a fixed sized thread pool and a dynamic sized pool
54 | TODO: Comment one and uncomment another to see the difference.
55 | */
56 | //mExecutorService = Executors.newFixedThreadPool(DEFAULT_THREAD_POOL_SIZE, new BackgroundThreadFactory());
57 | mExecutorService = new ThreadPoolExecutor(NUMBER_OF_CORES, NUMBER_OF_CORES*2, KEEP_ALIVE_TIME, KEEP_ALIVE_TIME_UNIT, mTaskQueue, new BackgroundThreadFactory());
58 | }
59 |
60 | public static CustomThreadPoolManager getsInstance() {
61 | return sInstance;
62 | }
63 |
64 | // Add a callable to the queue, which will be executed by the next available thread in the pool
65 | public void addCallable(Callable callable){
66 | Future future = mExecutorService.submit(callable);
67 | mRunningTaskList.add(future);
68 | }
69 |
70 | /* Remove all tasks in the queue and stop all running threads
71 | * Notify UI thread about the cancellation
72 | */
73 | public void cancelAllTasks() {
74 | synchronized (this) {
75 | mTaskQueue.clear();
76 | for (Future task : mRunningTaskList) {
77 | if (!task.isDone()) {
78 | task.cancel(true);
79 | }
80 | }
81 | mRunningTaskList.clear();
82 | }
83 | sendMessageToUiThread(Util.createMessage(Util.MESSAGE_ID, "All tasks in the thread pool are cancelled"));
84 | }
85 |
86 | // Keep a weak reference to the UI thread, so we can send messages to the UI thread
87 | public void setUiThreadCallback(UiThreadCallback uiThreadCallback) {
88 | this.uiThreadCallbackWeakReference = new WeakReference(uiThreadCallback);
89 | }
90 |
91 | // Pass the message to the UI thread
92 | public void sendMessageToUiThread(Message message){
93 | if(uiThreadCallbackWeakReference != null && uiThreadCallbackWeakReference.get() != null) {
94 | uiThreadCallbackWeakReference.get().publishToUiThread(message);
95 | }
96 | }
97 |
98 | /* A ThreadFactory implementation which create new threads for the thread pool.
99 | The threads created is set to background priority, so it does not compete with the UI thread.
100 | */
101 | private static class BackgroundThreadFactory implements ThreadFactory {
102 | private static int sTag = 1;
103 |
104 | @Override
105 | public Thread newThread(Runnable runnable) {
106 | Thread thread = new Thread(runnable);
107 | thread.setName("CustomThread" + sTag);
108 | thread.setPriority(Process.THREAD_PRIORITY_BACKGROUND);
109 |
110 | // A exception handler is created to log the exception from threads
111 | thread.setUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
112 | @Override
113 | public void uncaughtException(Thread thread, Throwable ex) {
114 | Log.e(Util.LOG_TAG, thread.getName() + " encountered an error: " + ex.getMessage());
115 | }
116 | });
117 | return thread;
118 | }
119 | }
120 | }
121 |
--------------------------------------------------------------------------------
/gradlew:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env bash
2 |
3 | ##############################################################################
4 | ##
5 | ## Gradle start up script for UN*X
6 | ##
7 | ##############################################################################
8 |
9 | # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
10 | DEFAULT_JVM_OPTS=""
11 |
12 | APP_NAME="Gradle"
13 | APP_BASE_NAME=`basename "$0"`
14 |
15 | # Use the maximum available, or set MAX_FD != -1 to use that value.
16 | MAX_FD="maximum"
17 |
18 | warn ( ) {
19 | echo "$*"
20 | }
21 |
22 | die ( ) {
23 | echo
24 | echo "$*"
25 | echo
26 | exit 1
27 | }
28 |
29 | # OS specific support (must be 'true' or 'false').
30 | cygwin=false
31 | msys=false
32 | darwin=false
33 | case "`uname`" in
34 | CYGWIN* )
35 | cygwin=true
36 | ;;
37 | Darwin* )
38 | darwin=true
39 | ;;
40 | MINGW* )
41 | msys=true
42 | ;;
43 | esac
44 |
45 | # Attempt to set APP_HOME
46 | # Resolve links: $0 may be a link
47 | PRG="$0"
48 | # Need this for relative symlinks.
49 | while [ -h "$PRG" ] ; do
50 | ls=`ls -ld "$PRG"`
51 | link=`expr "$ls" : '.*-> \(.*\)$'`
52 | if expr "$link" : '/.*' > /dev/null; then
53 | PRG="$link"
54 | else
55 | PRG=`dirname "$PRG"`"/$link"
56 | fi
57 | done
58 | SAVED="`pwd`"
59 | cd "`dirname \"$PRG\"`/" >/dev/null
60 | APP_HOME="`pwd -P`"
61 | cd "$SAVED" >/dev/null
62 |
63 | CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
64 |
65 | # Determine the Java command to use to start the JVM.
66 | if [ -n "$JAVA_HOME" ] ; then
67 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
68 | # IBM's JDK on AIX uses strange locations for the executables
69 | JAVACMD="$JAVA_HOME/jre/sh/java"
70 | else
71 | JAVACMD="$JAVA_HOME/bin/java"
72 | fi
73 | if [ ! -x "$JAVACMD" ] ; then
74 | die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
75 |
76 | Please set the JAVA_HOME variable in your environment to match the
77 | location of your Java installation."
78 | fi
79 | else
80 | JAVACMD="java"
81 | which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
82 |
83 | Please set the JAVA_HOME variable in your environment to match the
84 | location of your Java installation."
85 | fi
86 |
87 | # Increase the maximum file descriptors if we can.
88 | if [ "$cygwin" = "false" -a "$darwin" = "false" ] ; then
89 | MAX_FD_LIMIT=`ulimit -H -n`
90 | if [ $? -eq 0 ] ; then
91 | if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
92 | MAX_FD="$MAX_FD_LIMIT"
93 | fi
94 | ulimit -n $MAX_FD
95 | if [ $? -ne 0 ] ; then
96 | warn "Could not set maximum file descriptor limit: $MAX_FD"
97 | fi
98 | else
99 | warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
100 | fi
101 | fi
102 |
103 | # For Darwin, add options to specify how the application appears in the dock
104 | if $darwin; then
105 | GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
106 | fi
107 |
108 | # For Cygwin, switch paths to Windows format before running java
109 | if $cygwin ; then
110 | APP_HOME=`cygpath --path --mixed "$APP_HOME"`
111 | CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
112 | JAVACMD=`cygpath --unix "$JAVACMD"`
113 |
114 | # We build the pattern for arguments to be converted via cygpath
115 | ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
116 | SEP=""
117 | for dir in $ROOTDIRSRAW ; do
118 | ROOTDIRS="$ROOTDIRS$SEP$dir"
119 | SEP="|"
120 | done
121 | OURCYGPATTERN="(^($ROOTDIRS))"
122 | # Add a user-defined pattern to the cygpath arguments
123 | if [ "$GRADLE_CYGPATTERN" != "" ] ; then
124 | OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
125 | fi
126 | # Now convert the arguments - kludge to limit ourselves to /bin/sh
127 | i=0
128 | for arg in "$@" ; do
129 | CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
130 | CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
131 |
132 | if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
133 | eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
134 | else
135 | eval `echo args$i`="\"$arg\""
136 | fi
137 | i=$((i+1))
138 | done
139 | case $i in
140 | (0) set -- ;;
141 | (1) set -- "$args0" ;;
142 | (2) set -- "$args0" "$args1" ;;
143 | (3) set -- "$args0" "$args1" "$args2" ;;
144 | (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
145 | (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
146 | (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
147 | (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
148 | (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
149 | (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
150 | esac
151 | fi
152 |
153 | # Split up the JVM_OPTS And GRADLE_OPTS values into an array, following the shell quoting and substitution rules
154 | function splitJvmOpts() {
155 | JVM_OPTS=("$@")
156 | }
157 | eval splitJvmOpts $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS
158 | JVM_OPTS[${#JVM_OPTS[*]}]="-Dorg.gradle.appname=$APP_BASE_NAME"
159 |
160 | exec "$JAVACMD" "${JVM_OPTS[@]}" -classpath "$CLASSPATH" org.gradle.wrapper.GradleWrapperMain "$@"
161 |
--------------------------------------------------------------------------------
/app/src/main/java/com/franktan/multithreadingblogs/MainActivity.java:
--------------------------------------------------------------------------------
1 | package com.franktan.multithreadingblogs;
2 |
3 | import android.os.Bundle;
4 | import android.os.Handler;
5 | import android.os.Looper;
6 | import android.os.Message;
7 | import android.support.v7.app.AppCompatActivity;
8 | import android.view.View;
9 | import android.widget.TextView;
10 |
11 | import java.lang.ref.WeakReference;
12 |
13 | /**
14 | * Created by Frank Tan on 3/04/2016.
15 | * The launching activity for the app
16 | */
17 | public class MainActivity extends AppCompatActivity implements UiThreadCallback {
18 | // A worker thread which has the same lifecycle with the activity
19 | // It is created and started in Activity onStart and stopped in Activity onStop
20 | private CustomHandlerThread mHandlerThread;
21 |
22 | // The handler for the UI thread. Used for handling messages from worker threads.
23 | private UiHandler mUiHandler;
24 |
25 | // A text view to show messages sent from work threads
26 | private TextView mDisplayTextView;
27 |
28 | // A thread pool manager
29 | // It is a static singleton instance by design and will survive activity lifecycle
30 | private CustomThreadPoolManager mCustomThreadPoolManager;
31 |
32 | @Override
33 | protected void onCreate(Bundle savedInstanceState) {
34 | super.onCreate(savedInstanceState);
35 | setContentView(R.layout.activity_main);
36 | mDisplayTextView = (TextView)findViewById(R.id.display);
37 | }
38 |
39 | @Override
40 | protected void onStart() {
41 | super.onStart();
42 |
43 | // Initialize the handler for UI thread to handle message from worker threads
44 | mUiHandler = new UiHandler(Looper.getMainLooper(), mDisplayTextView);
45 |
46 | // create and start a new HandlerThread worker thread
47 | mHandlerThread = new CustomHandlerThread("HandlerThread");
48 | mHandlerThread.setUiThreadCallback(this);
49 | mHandlerThread.start();
50 |
51 | // get the thread pool manager instance
52 | mCustomThreadPoolManager = CustomThreadPoolManager.getsInstance();
53 | // CustomThreadPoolManager stores activity as a weak reference. No need to unregister.
54 | mCustomThreadPoolManager.setUiThreadCallback(this);
55 | }
56 |
57 | @Override
58 | protected void onStop() {
59 | super.onStop();
60 | // clear the message queue of HandlerThread worker thread and stop the current task
61 | if(mHandlerThread != null){
62 | mHandlerThread.quit();
63 | mHandlerThread.interrupt();
64 | }
65 | }
66 |
67 | // onClick handler for Send Runnable button
68 | public void sendRunnableToHandlerThread(View view){
69 | // send a runnable to run on the HandlerThread
70 | CustomRunnable runnable = new CustomRunnable();
71 | runnable.setUiThreadCallback(this);
72 | mHandlerThread.postRunnable(runnable);
73 | }
74 |
75 | // onClick handler for Send Message button
76 | public void sendMessageToHandlerThread(View view){
77 | // add a message to worker thread's message queue
78 | mHandlerThread.addMessage(1);
79 | }
80 |
81 | // onClick handler for Send 4 Tasks button
82 | public void send4tasksToThreadPool(View view) {
83 | for(int i = 0; i < 4; i++) {
84 | CustomCallable callable = new CustomCallable();
85 | callable.setCustomThreadPoolManager(mCustomThreadPoolManager);
86 | mCustomThreadPoolManager.addCallable(callable);
87 | }
88 | }
89 |
90 | // onClick handler for Send 8 Tasks button
91 | public void send8TasksToThreadPool(View view) {
92 | for(int i = 0; i < 8; i++) {
93 | CustomCallable callable = new CustomCallable();
94 | callable.setCustomThreadPoolManager(mCustomThreadPoolManager);
95 | mCustomThreadPoolManager.addCallable(callable);
96 | }
97 | }
98 |
99 | // onClick handler for Stop All Thread button
100 | public void cancelAllTasksInThreadPool(View view) {
101 | mCustomThreadPoolManager.cancelAllTasks();
102 | }
103 |
104 | // onClick handler for Clear Messages button
105 | public void clearDisplay(View view) {
106 | mDisplayTextView.setText("");
107 | }
108 |
109 | // Send message from worker thread to the UI thread
110 | @Override
111 | public void publishToUiThread(Message message) {
112 | // add the message from worker thread to UI thread's message queue
113 | if(mUiHandler != null){
114 | mUiHandler.sendMessage(message);
115 | }
116 | }
117 |
118 | // UI handler class, declared as static so it doesn't have implicit
119 | // reference to activity context. This helps to avoid memory leak.
120 | private static class UiHandler extends Handler {
121 | private WeakReference mWeakRefDisplay;
122 |
123 | public UiHandler(Looper looper, TextView display) {
124 | super(looper);
125 | this.mWeakRefDisplay = new WeakReference(display);
126 | }
127 |
128 | // This method will run on UI thread
129 | @Override
130 | public void handleMessage(Message msg) {
131 | super.handleMessage(msg);
132 | switch (msg.what){
133 | // Our communication protocol for passing a string to the UI thread
134 | case Util.MESSAGE_ID:
135 | Bundle bundle = msg.getData();
136 | String messsageText = bundle.getString(Util.MESSAGE_BODY, Util.EMPTY_MESSAGE);
137 | if(mWeakRefDisplay != null && mWeakRefDisplay.get() != null)
138 | mWeakRefDisplay.get().append(Util.getReadableTime() + " " + messsageText + "\n");
139 | break;
140 | default:
141 | break;
142 | }
143 | }
144 | }
145 | }
146 |
--------------------------------------------------------------------------------