org.solovyev.android.Threads Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of android-common-samples Show documentation
There is a newer version: 1.1.18
Show newest version
/*
 * Copyright 2013 serso aka se.solovyev
 *
 * 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.
 *
 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 * Contact details
 *
 * Email: [email protected]
 * Site:  http://se.solovyev.org
 */

package org.solovyev.android;

import android.app.Activity;
import android.os.Handler;
import android.os.Looper;
import android.support.v4.app.Fragment;
import android.support.v4.app.FragmentActivity;

import javax.annotation.Nonnull;
import javax.annotation.Nullable;

public final class Threads {

	private Threads() {
		throw new AssertionError();
	}

	/**
	 * Method tries to run runnable on UI thread. Run can be failed if:
	 * 1. Specified activity is null
	 * 2. Specified activity is finishing
	 *
	 * @param activity activity bound to runnable
	 * @param runnable runnable to bve executed
	 */
	public static void tryRunOnUiThread(@Nullable final Activity activity, @Nonnull final Runnable runnable) {
		if (activity != null && !activity.isFinishing()) {
			if (isUiThread()) {
				runnable.run();
			} else {
				activity.runOnUiThread(new Runnable() {
					@Override
					public void run() {
						// some time may pass and activity might be closing
						if (!activity.isFinishing()) {
							runnable.run();
						}
					}
				});
			}
		}
	}

	public static void tryRunOnUiThread(@Nonnull final Fragment fragment, @Nonnull final Runnable runnable) {
		Threads.tryRunOnUiThread(fragment.getActivity(), new Runnable() {
			@Override
			public void run() {
				final FragmentActivity activity = fragment.getActivity();
				if (activity != null) {
					runnable.run();
				}
			}
		});
	}

	/**
	 * @return true if current thread is UI thread (= main application thread)
	 */
	public static boolean isUiThread() {
		return Looper.myLooper() == Looper.getMainLooper();
	}

	/**
	 * @return new instance of {@link Handler} which runs on UI thread
	 */
	@Nonnull
	public static Handler newUiHandler() {
		return new Handler(Looper.getMainLooper());
	}
}