com.scantrust.mobile.android_sdk.threading

Class LocationHandlerThread

Object

Thread

android.os.HandlerThread

com.scantrust.mobile.android_sdk.threading.LocationHandlerThread

All Implemented Interfaces:

Runnable

public class LocationHandlerThread
extends HandlerThread

This class is a helper class to deal with the location management necessary for ScanTrust in an async way. It extends HandlerThread so should be used in a similar way.

It doesn't internally deal with the LOCATION permissions, so once instantiated, a Thread.UncaughtExceptionHandler should be added to it in order to catch the potential SecurityExceptions.

The thread is started with Thread.start(), but the location updates will only start after having called resumeLocationUpdates(). The location updates can be stopped with pauseLocationUpdates() and the HandlerThread itself should be stopped with HandlerThread.quit() or HandlerThread.quitSafely().

Nested Class Summary

Nested classes/interfaces inherited from class Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
LocationHandlerThread(Context context, String name, int priority) Constructs a new LocationHandlerThread.

Method Summary

Modifier and Type	Method and Description
Location	getLocation() Returns the latest Location that was obtained from the system.
protected void	onLooperPrepared()
void	pauseLocationUpdates() Pauses the location updates from the system location services.
void	resumeLocationUpdates() Resumes the location updates from the system location services.

Methods inherited from class android.os.HandlerThread

getLooper, getThreadId, quit, quitSafely, run

Methods inherited from class Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LocationHandlerThread

public LocationHandlerThread(Context context,
                             String name,
                             int priority)

Constructs a new LocationHandlerThread.

Parameters:

context - the source context

name - the thread name

priority - the thread priority

Method Detail

onLooperPrepared

protected void onLooperPrepared()

Overrides:

onLooperPrepared in class HandlerThread

getLocation

public Location getLocation()

Returns the latest Location that was obtained from the system.

Returns:

a Location object or null if the no data is available.

resumeLocationUpdates

public void resumeLocationUpdates()

Resumes the location updates from the system location services. Should be called after having called the LocationHandlerThread start() method or after having paused the updates.

pauseLocationUpdates

public void pauseLocationUpdates()

Pauses the location updates from the system location services. This method should be called when the app is idle in order to save battery power.