com.airs

Class AIRS_local

java.lang.Object

Service

com.airs.AIRS_local

public class AIRS_local
extends Service

Class to implement the local recording

See Also:

AIRS_remote, AIRS_record_tab, Service

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	AIRS_local.LocalBinder
class	AIRS_local.SortBasedOnName

Field Summary

Fields

Modifier and Type	Field and Description
Context	airs Context of the main Service
static SQLiteDatabase	airs_storage Reference to AIRS database
static AIRS_database	database_helper Reference to current AIRS_database
boolean	discovered Flag if discovery has been done
	mValuesArrayAdapter List of Values, being used in visualisation activity
boolean	paused Flag that recording should be paused (where possible)
boolean	registered Flag that sensors have been registered
boolean	restarted Flag if AIRS has been restarted
boolean	running Flag if AIRS is recording
boolean	show_values
boolean	start Flag that AIRS should be started initially
boolean	started Flag if AIRS has been started as a service already
String	template Template being used for starting the recording, if any used

Constructor Summary

Constructors

Constructor and Description
AIRS_local()

Method Summary

Methods

Modifier and Type	Method and Description
void	Discover(Activity airs) Called to start all sensor handlers and inquire the discovered sensors from these handlers The function also populates the UI sensor list and shows the appropriate view This function needs calling from a UI thread, e.g., from AIRS_record_tab
void	execStorage(long milli, String query) Synchronised method for writing to AIRS database from the recording threads being created
String	getSymbol(int j) Gets Sensor symbol that the j-th thread is recording
String	getValue(int j) Gets Value of the j-th thread
IBinder	onBind(Intent intent) Returns current instance of AIRS_local Service to anybody binding to AIRS_local
void	onCreate() Called when starting the service the first time around
void	onDestroy() Called when service is destroyed, e.g., by stopService() Here, we tear down all recording threads, close all handlers, unregister receivers for battery signal and close the thread for indicating the recording
void	onLowMemory() Called when system is running low on memory
int	onStartCommand(Intent intent, int flags, int startId)
void	pause_threads() Asks threads to pause
void	refresh_values() Asks threads to refresh latest value
void	Restart(boolean check) Restarts the AIRS_local recording service, calling the Rediscover() function, restarting all recordings threads and then make the service sticky
void	resume_threads() Ask threads to pause recording.
void	saveSelections() Save all sensor selections in the UI sensor list as persistent values in the preference file
void	selectall() Sets all sensors being selected in the sensor list - called from UI in AIRS_record_tab
void	sensor_info() Builds AlertDialog with sensor information
String	share(int j) Sharing info for sensor entry that j-th thread is recording
void	show_info(int j) Show timeline, map or similar for sensor entry that j-th thread is recording
boolean	startMeasurements(boolean restarted) Sets up the main threads to run, acquire values, store them locally and display them (if wanted)
void	unselectall() Unselects all sensors in the sensor list - called from UI in AIRS_record_tab

Methods inherited from class java.lang.Object

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

Field Detail

show_values

public boolean show_values

airs

public Context airs

Context of the main Service

See Also:

Context

template

public String template

Template being used for starting the recording, if any used

discovered

public boolean discovered

Flag if discovery has been done

running

public boolean running

Flag if AIRS is recording

restarted

public boolean restarted

Flag if AIRS has been restarted

started

public boolean started

Flag if AIRS has been started as a service already

start

public boolean start

Flag that AIRS should be started initially

paused

public boolean paused

Flag that recording should be paused (where possible)

registered

public boolean registered

Flag that sensors have been registered

mValuesArrayAdapter

public  mValuesArrayAdapter

List of Values, being used in visualisation activity

See Also:

AIRS_measurements

database_helper

public static AIRS_database database_helper

Reference to current AIRS_database

See Also:

AIRS_database

airs_storage

public static SQLiteDatabase airs_storage

Reference to AIRS database

See Also:

SQLiteDatabase

Constructor Detail

AIRS_local

public AIRS_local()

Method Detail

onBind

public IBinder onBind(Intent intent)

Returns current instance of AIRS_local Service to anybody binding to AIRS_local

Parameters:

intent - Reference to calling Intent

Returns:

current instance to service

onLowMemory

public void onLowMemory()

Called when system is running low on memory

See Also:

Service

onCreate

public void onCreate()

Called when starting the service the first time around

See Also:

Service

execStorage

public void execStorage(long milli,
               String query)

Synchronised method for writing to AIRS database from the recording threads being created

Parameters:

milli - timestamp of the recording

query - the SQL query being executed, formed in the recording threads

onDestroy

public void onDestroy()

Called when service is destroyed, e.g., by stopService() Here, we tear down all recording threads, close all handlers, unregister receivers for battery signal and close the thread for indicating the recording

onStartCommand

public int onStartCommand(Intent intent,
                 int flags,
                 int startId)

refresh_values

public void refresh_values()

Asks threads to refresh latest value

pause_threads

public void pause_threads()

Asks threads to pause

getValue

public String getValue(int j)

Gets Value of the j-th thread

Parameters:

j - index to thread which should provide the value

Returns:

String of the current recording

getSymbol

public String getSymbol(int j)

Gets Sensor symbol that the j-th thread is recording

Parameters:

j - index to thread which should provide the symbol

Returns:

String of the sensor symbol, see http://tecvis.co.uk/software/airs/internal-workings for list of supported sensor symbols

share

public String share(int j)

Sharing info for sensor entry that j-th thread is recording

Parameters:

j - index to thread which should provide the sharing string

Returns:

String to be shared or null if nothing to share

show_info

public void show_info(int j)

Show timeline, map or similar for sensor entry that j-th thread is recording

Parameters:

j - index to thread which should show the information

resume_threads

public void resume_threads()

Ask threads to pause recording. Where callback receivers are used, such pausing is not supported!

selectall

public void selectall()

Sets all sensors being selected in the sensor list - called from UI in AIRS_record_tab

unselectall

public void unselectall()

Unselects all sensors in the sensor list - called from UI in AIRS_record_tab

sensor_info

public void sensor_info()

Builds AlertDialog with sensor information

startMeasurements

public boolean startMeasurements(boolean restarted)

Sets up the main threads to run, acquire values, store them locally and display them (if wanted)

Parameters:

restarted - is this measurements restarted (true) or not (false).

Returns:

true if successfully started, false otherwise

saveSelections

public void saveSelections()

Save all sensor selections in the UI sensor list as persistent values in the preference file

Discover

public void Discover(Activity airs)

Called to start all sensor handlers and inquire the discovered sensors from these handlers The function also populates the UI sensor list and shows the appropriate view This function needs calling from a UI thread, e.g., from AIRS_record_tab

Parameters:

airs - Reference to the current Activity

Restart

public void Restart(boolean check)

Restarts the AIRS_local recording service, calling the Rediscover() function, restarting all recordings threads and then make the service sticky

Parameters:

check - Should the service been running (true) and was it therefore restarted?