com.airs.handlers

Class GPSHandler

java.lang.Object

com.airs.handlers.GPSHandler

All Implemented Interfaces:

Handler, Runnable

public class GPSHandler
extends Object
implements Handler, Runnable

Class to read GPS-based sensors, specifically the GO, GL, GA, GI, GC, GS sensor

See Also:

Handler

Constructor Summary

Constructors

Constructor and Description
GPSHandler(Context activity) Constructor, allocating all necessary resources for the handler Here, it's reading the persistent preferences Then, we retrieve the adaptive GPS records Then, we are trying to obtain a reference to the LocationManager - this will fail if there is no GPS on the device Finally, it's arming the semaphore

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	Acquire(String sensor, String query) Method to acquire sensor data Here, we instruct the UI handler to reset the AGPS data as well as register the GPS receiver, if not done before if adaptive GPS is selected by the user, we also start the thread for the GPS suppression
void	destroyHandler() Method to release all handler resources Here, we unregister the location receiver and release all handler semaphores as well as interrupt the adaptive GPS thread
void	Discover() Method to discover the sensor symbols support by this handler As the result of the discovery, appropriate Sensor entries will be added to the SensorRepository, if the GPS has been successfully enabled
void	History(String sensor) Method to view historical chart of the given sensor symbol - supporting timeline as well as map view here
void	run() This thread keeps on listening to WiFis and switches off the GPS readings if known WiFis are found If requires the recording of WI sensor to be enabled
String	Share(String sensor) Method to share the last value of the given sensor

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GPSHandler

public GPSHandler(Context activity)

Constructor, allocating all necessary resources for the handler Here, it's reading the persistent preferences Then, we retrieve the adaptive GPS records Then, we are trying to obtain a reference to the LocationManager - this will fail if there is no GPS on the device Finally, it's arming the semaphore

Parameters:

activity - Reference to the calling Context

Method Detail

Acquire

public byte[] Acquire(String sensor,
             String query)

Method to acquire sensor data Here, we instruct the UI handler to reset the AGPS data as well as register the GPS receiver, if not done before if adaptive GPS is selected by the user, we also start the thread for the GPS suppression

Specified by:

Acquire in interface Handler

Parameters:

sensor - String of the sensor symbol

query - String of the query to be fulfilled - not used here

See Also:

Handler.Acquire(java.lang.String, java.lang.String)

Share

public String Share(String sensor)

Method to share the last value of the given sensor

Specified by:

Share in interface Handler

Parameters:

sensor - String of the sensor symbol to be shared

Returns:

human-readable string of the last sensor value

See Also:

Handler.Share(java.lang.String)

History

public void History(String sensor)

Method to view historical chart of the given sensor symbol - supporting timeline as well as map view here

Specified by:

History in interface Handler

Parameters:

sensor - String of the symbol for which the history is being requested

See Also:

Handler.History(java.lang.String)

Discover

public void Discover()

Method to discover the sensor symbols support by this handler As the result of the discovery, appropriate Sensor entries will be added to the SensorRepository, if the GPS has been successfully enabled

Specified by:

Discover in interface Handler

See Also:

Handler.Discover(), Sensor, SensorRepository

destroyHandler

public void destroyHandler()

Method to release all handler resources Here, we unregister the location receiver and release all handler semaphores as well as interrupt the adaptive GPS thread

Specified by:

destroyHandler in interface Handler

See Also:

Handler.destroyHandler()

run

public void run()

This thread keeps on listening to WiFis and switches off the GPS readings if known WiFis are found If requires the recording of WI sensor to be enabled

Specified by:

run in interface Runnable