haberman.rhizomatics.fsm

Class GPS

java.lang.Object

haberman.rhizomatics.fsm.GPS

public class GPS
extends java.lang.Object

The GPS state machine.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GPS.AppState States enum.
private static class	GPS.AppTrigger Triggers enum.
private class	GPS.FailEntry Action taken before the state machine enter GPS.AppState.FAILURE -> destroy_internals() and dispatches a new GPSEvent.STOP.
private class	GPS.SearchEntry Action taken before the state machine enters GPS.AppState.SEARCHING -> requests a new location by using the location_provider_.
private class	GPS.SleepEntry Action taken before the state machine enter GPS.AppState.OFF -> destroy_internals() and dispatches a new GPSEvent.STOP.
private class	GPS.StartEntry Action taken before the state machine enters GPS.AppState.ON -> dispatches a new GPSEvent.START event.
private class	GPS.StopEntry Action taken before the state machine enter GPS.AppState.OFF -> destroy_internals() and dispatches a new GPSEvent.STOP.

Field Summary

Fields

Modifier and Type	Field and Description
private android.app.Activity	activity_ MainActivity backref.
private android.content.Context	context_ MainActivity's Context backref.
private com.github.oxo42.stateless4j.StateMachine<GPS.AppState,GPS.AppTrigger>	fsm_ The state machine.
private android.location.Location	last_location_ The last know location
private com.google.android.gms.location.LocationCallback	location_callback_ A LocationCallback instance.
private com.google.android.gms.location.FusedLocationProviderClient	location_provider_ A FusedLocationProviderClient instance.
private short	search_duration_ Amount of time (in ms) spent between 2 location updates when searching for an initial (and acceptable) user location.
private android.os.Handler	timeout_handler_ Location timeout thread handler.
private java.lang.Runnable	timeout_runnable_ Location timeout thread runnable.

Constructor Summary

Constructors

Constructor and Description
GPS(android.content.Context context, android.app.Activity activity)

Method Summary

Modifier and Type	Method and Description
private void	destroy_internals() Removes location updates and nullify related holders.
void	search() search() trigger.
GPS.AppState	state() Returns the current state of the fsm_.
void	stop() stop() trigger.

Methods inherited from class java.lang.Object

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

Field Detail

timeout_runnable_

private final java.lang.Runnable timeout_runnable_

Location timeout thread runnable.

timeout_handler_

private final android.os.Handler timeout_handler_

Location timeout thread handler.

context_

private final android.content.Context context_

MainActivity's Context backref.

activity_

private final android.app.Activity activity_

MainActivity backref.

fsm_

private final com.github.oxo42.stateless4j.StateMachine<GPS.AppState,GPS.AppTrigger> fsm_

The state machine.

location_provider_

@Nullable
private com.google.android.gms.location.FusedLocationProviderClient location_provider_

A FusedLocationProviderClient instance.

See Also:

FusedLocationProviderClient

location_callback_

@Nullable
private com.google.android.gms.location.LocationCallback location_callback_

A LocationCallback instance.

See Also:

LocationCallback

search_duration_

private short search_duration_

Amount of time (in ms) spent between 2 location updates when searching for an initial (and acceptable) user location.

last_location_

@Nullable
private android.location.Location last_location_

The last know location

Constructor Detail

GPS

public GPS(@NonNull
           android.content.Context context,
           @NonNull
           android.app.Activity activity)

Method Detail

destroy_internals

private void destroy_internals()

Removes location updates and nullify related holders.

search

public void search()

search() trigger.

stop

public void stop()

stop() trigger.

state

public GPS.AppState state()

Returns the current state of the fsm_.

Returns:

An GPS.AppState variable.