com.mousebird.maply

Class SimpleTileFetcher

java.lang.Object

java.lang.Thread

android.os.HandlerThread

com.mousebird.maply.SimpleTileFetcher

All Implemented Interfaces:

TileFetcher, java.lang.Runnable

Direct Known Subclasses:

MBTileFetcher

public class SimpleTileFetcher
extends android.os.HandlerThread
implements TileFetcher

Simple Tile Fetcher is meant for sub classing. Some data sources aren't all that complex. You read from a local source, you return the data. Something else turns it into visible objects. Simple. To implement one of those, subclass the Simple Tile Fetcher and let it do the tricky bits.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	SimpleTileFetcher.SimpleTileFetchInfo No remote URLs to track, so we just keep the tile ID.
class	SimpleTileFetcher.SimpleTileInfo We don't need to describe a remote URL, so this is basically a stub that passes back the tile ID.
class	SimpleTileFetcher.TileInfo Wrapper around the fetch request so we can prioritize loads.

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
int	maxZoom
int	minZoom
protected java.lang.String	name
protected boolean	neverFail
protected java.util.Queue<android.os.AsyncTask<java.lang.Void,java.lang.Void,java.lang.Void>>	tasks
protected SimpleTileFetcher.SimpleTileInfo	tileInfo
protected boolean	valid

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
SimpleTileFetcher(java.lang.String inName) Construct with the name, min and max zoom levels.

Method Summary

Modifier and Type	Method and Description
void	cancelTileFetches(java.lang.Object[] fetches) Cancel a group of requests at once Use the object returned by the startTileFetch call (which is just a Request object)
byte[]	dataForTile(java.lang.Object fetchInfo, TileID tileID) Fill this in in your subclass.
protected void	finishTile(SimpleTileFetcher.TileInfo tileInfo)
java.lang.String	getFetcherName() Name of this tile fetcher.
SimpleTileFetcher.SimpleTileInfo	getTileInfo() The tile info is used by the quad paging logic to figure out min/max zoom level and such.
protected void	scheduleLoading()
void	shutdown() Kill all outstanding connections and clean up.
void	startTileFetches(TileFetchRequest[] requests) Add a bunch of requests to the queue and kick them off in a tick.
protected void	updateLoading()
protected void	updateTasks()
java.lang.Object	updateTileFetch(java.lang.Object fetchRequest, int priority, float importance) Update an active request with a new priority and importance.

Methods inherited from class android.os.HandlerThread

getLooper, getThreadId, onLooperPrepared, quit, quitSafely, run

Methods inherited from class java.lang.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 java.lang.Object

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

Field Detail

valid

protected boolean valid

name

protected java.lang.String name

minZoom

public int minZoom

maxZoom

public int maxZoom

tileInfo

protected SimpleTileFetcher.SimpleTileInfo tileInfo

tasks

protected java.util.Queue<android.os.AsyncTask<java.lang.Void,java.lang.Void,java.lang.Void>> tasks

neverFail

protected boolean neverFail

Constructor Detail

SimpleTileFetcher

public SimpleTileFetcher(java.lang.String inName)

Construct with the name, min and max zoom levels.

Method Detail

getTileInfo

public SimpleTileFetcher.SimpleTileInfo getTileInfo()

The tile info is used by the quad paging logic to figure out min/max zoom level and such. This version is very simple compared to the RemoteTileInfoNew object.

getFetcherName

public java.lang.String getFetcherName()

Name of this tile fetcher. Used for coordinating tile sources.

Specified by:

getFetcherName in interface TileFetcher

startTileFetches

public void startTileFetches(TileFetchRequest[] requests)

Add a bunch of requests to the queue and kick them off in a tick.

Specified by:

startTileFetches in interface TileFetcher

scheduleLoading

protected void scheduleLoading()

updateLoading

protected void updateLoading()

updateTasks

protected void updateTasks()

finishTile

protected void finishTile(SimpleTileFetcher.TileInfo tileInfo)

updateTileFetch

public java.lang.Object updateTileFetch(java.lang.Object fetchRequest,
                                        int priority,
                                        float importance)

Update an active request with a new priority and importance.

Specified by:

updateTileFetch in interface TileFetcher

cancelTileFetches

public void cancelTileFetches(java.lang.Object[] fetches)

Cancel a group of requests at once Use the object returned by the startTileFetch call (which is just a Request object)

Specified by:

cancelTileFetches in interface TileFetcher

shutdown

public void shutdown()

Kill all outstanding connections and clean up.

Specified by:

shutdown in interface TileFetcher

dataForTile

public byte[] dataForTile(java.lang.Object fetchInfo,
                          TileID tileID)

Fill this in in your subclass.

Returns:

Return the data for a particular tile. This is synchronous, but may be called on a random thread.