com.atakmap.android.track.crumb

Class CrumbDatabase

java.lang.Object

com.atakmap.android.track.crumb.CrumbDatabase

public class CrumbDatabase
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	CrumbDatabase.OnCrumbListener

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COLUMN_ID
static java.lang.String	COLUMN_LAT
static java.lang.String	COLUMN_LON
static int	DATABASE_VERSION
static java.lang.String	META_TRACK_CURRENT
static java.lang.String	META_TRACK_DBID
static java.lang.String	META_TRACK_DBIDS
static java.lang.String	META_TRACK_NODE_TITLE
static java.lang.String	META_TRACK_NODE_UID
static java.lang.String	SEG_COLUMN_TIMESTAMP
static long	STALE
static java.lang.String	TAG
static double	VALUE_UNKNOWN

Method Summary

Modifier and Type	Method and Description
void	addCrumbListener(CrumbDatabase.OnCrumbListener l)
void	createSegment(long timestamp, int color, java.lang.String title, java.lang.String style, java.lang.String userTitle, java.lang.String userUid, boolean bStitch) Create new track segment with specified timestamp and style If bStitch is true, then set last point for that UID in the previous segment as the first point in this segment
void	deleteAll() Deprecated.
void	deleteSegment(int track_dbid) Given a segment identifier delete the segment
java.util.List<CrumbPoint>	getCrumbPoints(int trackDbId)
void	getCrumbPoints(int trackDbId, TrackPolyline track)
java.util.List<Crumb>	getCrumbs(int trackDbId) Deprecated.
java.util.List<Crumb>	getCrumbs(java.lang.String uid, long startTime, long endTime) Get all crumbs in the specified time range
int	getCurrentSegmentId(java.lang.String uid, java.lang.String orderBy) Get ID of segment with most recent timestamp
CrumbPoint	getLastCrumb(int trackDbId) Get last crumb for specified UID in specified track
TrackPolyline	getMostRecentTrack(java.lang.String uid) Returns the most recent track for a given user identifer
TrackPolyline	getTrack(int trackDbId, boolean bPoints)
TrackPolyline	getTrack(int trackDbId, java.util.List<CrumbPoint> points) Pull track metadata from DB and use 'crumbs' for the track points
TrackPolyline	getTrack(java.lang.String callsign, java.lang.String uid, long timestamp, java.util.List<Crumb> crumbs) Create a polyline from the specified parameters Does not access database
TrackPolyline	getTrackByCallsign(java.lang.String callsign, java.lang.String uid) Get first track matching the callsign & title
TrackPolyline	getTrackByTrackTitle(java.lang.String title, java.lang.String uid) Get first track matching the uid & title
java.util.List<TrackPolyline>	getTracks(int[] trackIds, TrackProgress progress) Get tracks for the specified track IDs
java.util.List<TrackPolyline>	getTracks(java.lang.String uid, boolean bHideTemp, boolean bDisplayAll, TrackProgress progress) Get tracks for the specified user UID If bDisplayAll, then get all tracks, else Get first 15 tracks, optionally skipping "temporary" tracks
java.util.List<TrackPolyline>	getTracks(java.lang.String uid, long startTime, long endTime)
java.util.List<TrackPolyline>	getTracks(java.lang.String uid, long startTime, long endTime, TrackProgress progress) Get all tracks in the specified time range
java.util.List<TrackUser>	getUserList() Get list of users which have tracks in the local database
static CrumbDatabase	instance()
void	persist(PointMapItem m, long timestamp, android.content.SharedPreferences prefs) Writes the crumb for a PointMapItem to the database.
void	removeCrumbListener(CrumbDatabase.OnCrumbListener l)
int	setServerTrack(java.lang.String callsign, java.lang.String uid, long startTime, Track track, android.content.SharedPreferences prefs) We store server queried tracks once for a given uid/timestamp, in local DB.
void	setTrackColor(int track_dbid, java.lang.String color)
void	setTrackName(int track_dbid, java.lang.String name)
void	setTrackStyle(int track_dbid, java.lang.String style)

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

DATABASE_VERSION

public static final int DATABASE_VERSION

See Also:

Constant Field Values

VALUE_UNKNOWN

public static final double VALUE_UNKNOWN

COLUMN_ID

public static final java.lang.String COLUMN_ID

See Also:

Constant Field Values

COLUMN_LAT

public static final java.lang.String COLUMN_LAT

See Also:

Constant Field Values

COLUMN_LON

public static final java.lang.String COLUMN_LON

See Also:

Constant Field Values

SEG_COLUMN_TIMESTAMP

public static final java.lang.String SEG_COLUMN_TIMESTAMP

See Also:

Constant Field Values

META_TRACK_DBID

public static final java.lang.String META_TRACK_DBID

See Also:

Constant Field Values

META_TRACK_CURRENT

public static final java.lang.String META_TRACK_CURRENT

See Also:

Constant Field Values

META_TRACK_DBIDS

public static final java.lang.String META_TRACK_DBIDS

See Also:

Constant Field Values

META_TRACK_NODE_UID

public static final java.lang.String META_TRACK_NODE_UID

See Also:

Constant Field Values

META_TRACK_NODE_TITLE

public static final java.lang.String META_TRACK_NODE_TITLE

See Also:

Constant Field Values

STALE

public static final long STALE

Method Detail

instance

public static CrumbDatabase instance()

deleteAll

@Deprecated
public void deleteAll()

Deprecated.

getCurrentSegmentId

public int getCurrentSegmentId(java.lang.String uid,
                               java.lang.String orderBy)

Get ID of segment with most recent timestamp

Returns:

the current segment id based on the uid passed in.

persist

public void persist(PointMapItem m,
                    long timestamp,
                    android.content.SharedPreferences prefs)

Writes the crumb for a PointMapItem to the database.

Parameters:

m - the point map to create a crumb for

timestamp - the timestamp for the point map item

prefs - the shared preference used to record the next available track color.

createSegment

public void createSegment(long timestamp,
                          int color,
                          java.lang.String title,
                          java.lang.String style,
                          java.lang.String userTitle,
                          java.lang.String userUid,
                          boolean bStitch)

Create new track segment with specified timestamp and style If bStitch is true, then set last point for that UID in the previous segment as the first point in this segment

Parameters:

timestamp - the timestamp for the segment

color - the color of the segment

title - the title of the segment

style - how the segment should be styled

userTitle - the title of the segment

userUid - the user id that represents the segment

bStitch - true will result in the new segement being joined with the previous segment

deleteSegment

public void deleteSegment(int track_dbid)

Given a segment identifier delete the segment

Parameters:

track_dbid - the segment id

getLastCrumb

public CrumbPoint getLastCrumb(int trackDbId)

Get last crumb for specified UID in specified track

Parameters:

trackDbId - Track database ID

Returns:

Last crumb point

getCrumbs

@Deprecated
public java.util.List<Crumb> getCrumbs(int trackDbId)

Deprecated.

NOTE: Each Crumb is a map item and not as memory efficient as CrumbPoint

Parameters:

trackDbId - Track database ID

Returns:

List of crumbs

getCrumbPoints

public java.util.List<CrumbPoint> getCrumbPoints(int trackDbId)

getCrumbPoints

public void getCrumbPoints(int trackDbId,
                           TrackPolyline track)

getTracks

public java.util.List<TrackPolyline> getTracks(java.lang.String uid,
                                               long startTime,
                                               long endTime,
                                               TrackProgress progress)

Get all tracks in the specified time range

Parameters:

uid - the identifier for the map item that created the track (ie the user uid)

startTime - the start time for the track

endTime, - if -1 then search all crumbs starting at startTime

Returns:

a list of tracks that meet the criteria

getTracks

public java.util.List<TrackPolyline> getTracks(java.lang.String uid,
                                               long startTime,
                                               long endTime)

getCrumbs

public java.util.List<Crumb> getCrumbs(java.lang.String uid,
                                       long startTime,
                                       long endTime)

Get all crumbs in the specified time range

Parameters:

uid - the user identifier for the crumbs.

startTime - the start time

endTime, - if -1 then search all crumbs starting at startTime

Returns:

the list of crumns that are in that time range

getTrack

public TrackPolyline getTrack(java.lang.String callsign,
                              java.lang.String uid,
                              long timestamp,
                              java.util.List<Crumb> crumbs)

Create a polyline from the specified parameters Does not access database

Parameters:

callsign - Track callsign

uid - Track UID

timestamp - Track start time

crumbs - List of crumbs

Returns:

New track polyline

getTrack

public TrackPolyline getTrack(int trackDbId,
                              java.util.List<CrumbPoint> points)

Pull track metadata from DB and use 'crumbs' for the track points

Parameters:

trackDbId - Track database ID

points - Crumb points

Returns:

the track polyline based on a list of points and a track id

getTrack

public TrackPolyline getTrack(int trackDbId,
                              boolean bPoints)

getTrackByCallsign

public TrackPolyline getTrackByCallsign(java.lang.String callsign,
                                        java.lang.String uid)

Get first track matching the callsign & title

Parameters:

callsign - the title (callsign) for the track

uid - the uid for the for the track

Returns:

the Track Polyline that matches the title and uid

getTrackByTrackTitle

public TrackPolyline getTrackByTrackTitle(java.lang.String title,
                                          java.lang.String uid)

Get first track matching the uid & title

Parameters:

title - the segment title

uid - the uid for the user segment

Returns:

the track representing the title and uid pair

getMostRecentTrack

public TrackPolyline getMostRecentTrack(java.lang.String uid)

Returns the most recent track for a given user identifer

Parameters:

uid - the uid

Returns:

the track

getTracks

public java.util.List<TrackPolyline> getTracks(java.lang.String uid,
                                               boolean bHideTemp,
                                               boolean bDisplayAll,
                                               TrackProgress progress)

Get tracks for the specified user UID If bDisplayAll, then get all tracks, else Get first 15 tracks, optionally skipping "temporary" tracks

Parameters:

uid - the user uid

bHideTemp - If true, omit tracks shorter than 10 minutes and did not move more than 100 meters

bDisplayAll - If true, include all tracks, otherwise include first 15 tracks

progress - the progress callback for long running operatations.

Returns:

the list of track polylines that match

getTracks

public java.util.List<TrackPolyline> getTracks(int[] trackIds,
                                               TrackProgress progress)

Get tracks for the specified track IDs

Parameters:

trackIds - the list of track id's

progress - the progress callback for getting the tracks.

Returns:

a list of tracks for a given set of track ids.

getUserList

public java.util.List<TrackUser> getUserList()

Get list of users which have tracks in the local database

Returns:

the list of users that have recorded tracks locally stored

setTrackName

public void setTrackName(int track_dbid,
                         java.lang.String name)

setTrackColor

public void setTrackColor(int track_dbid,
                          java.lang.String color)

setTrackStyle

public void setTrackStyle(int track_dbid,
                          java.lang.String style)

setServerTrack

public int setServerTrack(java.lang.String callsign,
                          java.lang.String uid,
                          long startTime,
                          Track track,
                          android.content.SharedPreferences prefs)

We store server queried tracks once for a given uid/timestamp, in local DB. If a future server query is returned with the same start time, it will be replaced in the local DB with the updated track (which may be shorter or longer depending on user's search terms). Like all tracks in the local DB, data is erased on demand by user, or automatically 30 days from the date of the track (not 30 days from the date of DB insertion)

Parameters:

callsign -

uid -

startTime -

track -

Returns:

addCrumbListener

public void addCrumbListener(CrumbDatabase.OnCrumbListener l)

removeCrumbListener

public void removeCrumbListener(CrumbDatabase.OnCrumbListener l)