org.openstreetmap.gui.jmapviewer

Class OsmFileCacheTileLoader

java.lang.Object

org.openstreetmap.gui.jmapviewer.OsmTileLoader

org.openstreetmap.gui.jmapviewer.OsmFileCacheTileLoader

All Implemented Interfaces:

CachedTileLoader, TileLoader

public class OsmFileCacheTileLoader
extends OsmTileLoader
implements CachedTileLoader

A TileLoader implementation that loads tiles from OSM via HTTP and saves all loaded files in a directory located in the temporary directory. If a tile is present in this file cache it will not be loaded from OSM again.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	OsmFileCacheTileLoader.FileLoadJob

Field Summary

Fields

Modifier and Type	Field and Description
protected String	cacheDirBase
private static String	ETAG_FILE_EXT
static long	FILE_AGE_ONE_DAY
static long	FILE_AGE_ONE_WEEK
private static Logger	log
protected long	maxCacheFileAge
protected long	recheckAfter
protected Map<TileSource,File>	sourceCacheDirMap
private static Charset	TAGS_CHARSET
private static String	TAGS_FILE_EXT

Fields inherited from class org.openstreetmap.gui.jmapviewer.OsmTileLoader

headers, listener, timeoutConnect, timeoutRead

Constructor Summary

Constructors

Constructor and Description
OsmFileCacheTileLoader(TileLoaderListener map) Create a OSMFileCacheTileLoader with system property temp dir.
OsmFileCacheTileLoader(TileLoaderListener map, File cacheDir) Create a OSMFileCacheTileLoader with given cache directory.

Method Summary

Modifier and Type	Method and Description
void	clearCache(TileSource source)
void	clearCache(TileSource source, TileClearController controller)
TileJob	createTileLoaderJob(Tile tile) A typical implementation of this function should create and return a new TileJob instance that performs the load action.
String	getCacheDirBase()
static File	getDefaultCacheDir()
long	getMaxFileAge()
protected File	getSourceCacheDir(TileSource source)
void	setCacheMaxFileAge(long maxFileAge) Sets the maximum age of the local cached tile in the file system.
void	setTileCacheDir(String tileCacheDir)

Methods inherited from class org.openstreetmap.gui.jmapviewer.OsmTileLoader

loadTileFromOsm, loadTileMetadata, prepareHttpUrlConnection, toString

Methods inherited from class java.lang.Object

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

Field Detail

log

private static final Logger log

ETAG_FILE_EXT

private static final String ETAG_FILE_EXT

See Also:

Constant Field Values

TAGS_FILE_EXT

private static final String TAGS_FILE_EXT

See Also:

Constant Field Values

TAGS_CHARSET

private static final Charset TAGS_CHARSET

FILE_AGE_ONE_DAY

public static final long FILE_AGE_ONE_DAY

See Also:

Constant Field Values

FILE_AGE_ONE_WEEK

public static final long FILE_AGE_ONE_WEEK

See Also:

Constant Field Values

cacheDirBase

protected String cacheDirBase

sourceCacheDirMap

protected final Map<TileSource,File> sourceCacheDirMap

maxCacheFileAge

protected long maxCacheFileAge

recheckAfter

protected long recheckAfter

Constructor Detail

OsmFileCacheTileLoader

public OsmFileCacheTileLoader(TileLoaderListener map,
                              File cacheDir)
                       throws IOException

Create a OSMFileCacheTileLoader with given cache directory. If cacheDir is not set or invalid, IOException will be thrown.

Parameters:

map - the listener checking for tile load events (usually the map for display)

cacheDir - directory to store cached tiles

Throws:

IOException

OsmFileCacheTileLoader

public OsmFileCacheTileLoader(TileLoaderListener map)
                       throws SecurityException,
                              IOException

Create a OSMFileCacheTileLoader with system property temp dir. If not set an IOException will be thrown.

Parameters:

map - the listener checking for tile load events (usually the map for display)

Throws:

SecurityException

IOException

Method Detail

getDefaultCacheDir

public static File getDefaultCacheDir()
                               throws SecurityException

Throws:

SecurityException

createTileLoaderJob

public TileJob createTileLoaderJob(Tile tile)

Description copied from interface: TileLoader

A typical implementation of this function should create and return a new TileJob instance that performs the load action.

Specified by:

createTileLoaderJob in interface TileLoader

Overrides:

createTileLoaderJob in class OsmTileLoader

Parameters:

tile - the tile to be loaded

Returns:

TileJob implementation that performs the desired load action.

getSourceCacheDir

protected File getSourceCacheDir(TileSource source)

getMaxFileAge

public long getMaxFileAge()

setCacheMaxFileAge

public void setCacheMaxFileAge(long maxFileAge)

Sets the maximum age of the local cached tile in the file system. If a local tile is older than the specified file age OsmFileCacheTileLoader will connect to the tile server and check if a newer tile is available using the mechanism specified for the selected tile source/server.

Parameters:

maxFileAge - maximum age in milliseconds

See Also:

FILE_AGE_ONE_DAY, FILE_AGE_ONE_WEEK, TileSource.getTileUpdate()

getCacheDirBase

public String getCacheDirBase()

setTileCacheDir

public void setTileCacheDir(String tileCacheDir)

clearCache

public void clearCache(TileSource source)

Specified by:

clearCache in interface CachedTileLoader

clearCache

public void clearCache(TileSource source,
                       TileClearController controller)

Specified by:

clearCache in interface CachedTileLoader