org.openstreetmap.josm.data.imagery

Class TMSCachedTileLoaderJob

java.lang.Object

org.openstreetmap.josm.data.cache.JCSCachedTileLoaderJob<java.lang.String,BufferedImageCacheEntry>

org.openstreetmap.josm.data.imagery.TMSCachedTileLoaderJob

All Implemented Interfaces:

java.lang.Runnable, TileJob, ICachedLoaderJob<java.lang.String>, ICachedLoaderListener

Direct Known Subclasses:

WMSCachedTileLoaderJob

public class TMSCachedTileLoaderJob
extends JCSCachedTileLoaderJob<java.lang.String,BufferedImageCacheEntry>
implements TileJob, ICachedLoaderListener

Since:

8168

Nested Class Summary

Nested classes/interfaces inherited from interface org.openstreetmap.josm.data.cache.ICachedLoaderListener

ICachedLoaderListener.LoadResult

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.concurrent.ConcurrentMap<java.lang.String,java.util.Set<TileLoaderListener>>	inProgress
private static java.util.logging.Logger	LOG
private static long	MAXIMUM_EXPIRES
private static long	MINIMUM_EXPIRES
private Tile	tile
private java.net.URL	url

Fields inherited from class org.openstreetmap.josm.data.cache.JCSCachedTileLoaderJob

ABSOLUTE_EXPIRE_TIME_LIMIT, attributes, cacheData, DEFAULT_EXPIRE_TIME, EXPIRE_TIME_SERVER_LIMIT, now, THREAD_LIMIT

Constructor Summary

Constructors

Constructor and Description
TMSCachedTileLoaderJob(TileLoaderListener listener, Tile tile, org.apache.commons.jcs.access.behavior.ICacheAccess<java.lang.String,BufferedImageCacheEntry> cache, int connectTimeout, int readTimeout, java.util.Map<java.lang.String,java.lang.String> headers, java.util.concurrent.ThreadPoolExecutor downloadExecutor) Constructor for creating a job, to get a specific tile from cache

Method Summary

Modifier and Type	Method and Description
protected boolean	cacheAsEmpty() Simple implementation.
protected BufferedImageCacheEntry	createCacheEntry(byte[] content)
Tile	getCachedTile() Method for getting the tile from cache only, without trying to reach remote resource
java.lang.String	getCacheKey() returns cache entry key
protected java.lang.String	getServerKey() For TMS use BaseURL as settings discovery, so for different paths, we will have different settings (useful for developer servers)
Tile	getTile() Function to return the tile associated with the job
java.net.URL	getUrl() method to get download URL for Job
private boolean	handleNoTileAtZoom()
private boolean	isNoTileAtZoom()
boolean	isObjectLoadable()
protected boolean	isResponseLoadable(java.util.Map<java.lang.String,java.util.List<java.lang.String>> headers, int statusCode, byte[] content) Check if the object is loadable.
void	loadingFinished(CacheEntry object, CacheEntryAttributes attributes, ICachedLoaderListener.LoadResult result) Will be called when K object processed.
protected CacheEntryAttributes	parseHeaders(HttpClient.Response urlConn)
void	submit() submits download job to backend.
void	submit(boolean force) submits download job to backend.
private boolean	tryLoadTileImage(CacheEntry object)

Methods inherited from class org.openstreetmap.josm.data.cache.JCSCachedTileLoaderJob

cancelOutstandingTasks, executionFinished, get, handleJobCancellation, isCacheElementValid, run, setFinishedTask, submit

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Runnable

run

Field Detail

LOG

private static final java.util.logging.Logger LOG

MAXIMUM_EXPIRES

private static final long MAXIMUM_EXPIRES

See Also:

Constant Field Values

MINIMUM_EXPIRES

private static final long MINIMUM_EXPIRES

See Also:

Constant Field Values

tile

private final Tile tile

url

private volatile java.net.URL url

inProgress

private static final java.util.concurrent.ConcurrentMap<java.lang.String,java.util.Set<TileLoaderListener>> inProgress

Constructor Detail

TMSCachedTileLoaderJob

public TMSCachedTileLoaderJob(TileLoaderListener listener,
                              Tile tile,
                              org.apache.commons.jcs.access.behavior.ICacheAccess<java.lang.String,BufferedImageCacheEntry> cache,
                              int connectTimeout,
                              int readTimeout,
                              java.util.Map<java.lang.String,java.lang.String> headers,
                              java.util.concurrent.ThreadPoolExecutor downloadExecutor)

Constructor for creating a job, to get a specific tile from cache

Parameters:

listener - Tile loader listener

tile - to be fetched from cache

cache - object

connectTimeout - when connecting to remote resource

readTimeout - when connecting to remote resource

headers - HTTP headers to be sent together with request

downloadExecutor - that will be executing the jobs

Method Detail

getTile

public Tile getTile()

Description copied from interface: TileJob

Function to return the tile associated with the job

Specified by:

getTile in interface TileJob

Returns:

Tile to be handled

getCacheKey

public java.lang.String getCacheKey()

Description copied from interface: ICachedLoaderJob

returns cache entry key

Specified by:

getCacheKey in interface ICachedLoaderJob<java.lang.String>

Returns:

cache key for tile

getUrl

public java.net.URL getUrl()
                    throws java.io.IOException

Description copied from interface: ICachedLoaderJob

method to get download URL for Job

Specified by:

getUrl in interface ICachedLoaderJob<java.lang.String>

Returns:

URL that should be fetched

Throws:

java.io.IOException - when could not determine the URL of the tile

isObjectLoadable

public boolean isObjectLoadable()

Overrides:

isObjectLoadable in class JCSCachedTileLoaderJob<java.lang.String,BufferedImageCacheEntry>

Returns:

checks if object from cache has sufficient data to be returned

isResponseLoadable

protected boolean isResponseLoadable(java.util.Map<java.lang.String,java.util.List<java.lang.String>> headers,
                                     int statusCode,
                                     byte[] content)

Description copied from class: JCSCachedTileLoaderJob

Check if the object is loadable. This means, if the data will be parsed, and if this response will finish as successful retrieve. This simple implementation doesn't load empty response, nor client (4xx) and server (5xx) errors

Overrides:

isResponseLoadable in class JCSCachedTileLoaderJob<java.lang.String,BufferedImageCacheEntry>

Parameters:

headers - headers sent by server

statusCode - http status code

content - data read from server

Returns:

true if object should be cached and returned to listener

cacheAsEmpty

protected boolean cacheAsEmpty()

Description copied from class: JCSCachedTileLoaderJob

Simple implementation. All errors should be cached as empty. Though some JDK (JDK8 on Windows for example) doesn't return 4xx error codes, instead they do throw an FileNotFoundException or IOException

Overrides:

cacheAsEmpty in class JCSCachedTileLoaderJob<java.lang.String,BufferedImageCacheEntry>

Returns:

true if we should put empty object into cache, regardless of what remote resource has returned

submit

public void submit(boolean force)

Description copied from interface: TileJob

submits download job to backend.

Specified by:

submit in interface TileJob

Parameters:

force - true if the load should skip all the caches (local & remote)

loadingFinished

public void loadingFinished(CacheEntry object,
                            CacheEntryAttributes attributes,
                            ICachedLoaderListener.LoadResult result)

Description copied from interface: ICachedLoaderListener

Will be called when K object processed. The result might be: LoadResult.SUCCESS when object was fetched LoadResult.FAILURE when there was a failure during download LoadResult.REJECTED when job was rejected because of full queue

Specified by:

loadingFinished in interface ICachedLoaderListener

Parameters:

object - cache entry contents

attributes - cache entry attributes

result - load result (success, failure, canceled)

getServerKey

protected java.lang.String getServerKey()

For TMS use BaseURL as settings discovery, so for different paths, we will have different settings (useful for developer servers)

Overrides:

getServerKey in class JCSCachedTileLoaderJob<java.lang.String,BufferedImageCacheEntry>

Returns:

base URL of TMS or server url as defined in super class

createCacheEntry

protected BufferedImageCacheEntry createCacheEntry(byte[] content)

Specified by:

createCacheEntry in class JCSCachedTileLoaderJob<java.lang.String,BufferedImageCacheEntry>

submit

public void submit()

Description copied from interface: TileJob

submits download job to backend.

Specified by:

submit in interface TileJob

parseHeaders

protected CacheEntryAttributes parseHeaders(HttpClient.Response urlConn)

Overrides:

parseHeaders in class JCSCachedTileLoaderJob<java.lang.String,BufferedImageCacheEntry>

getCachedTile

public Tile getCachedTile()

Method for getting the tile from cache only, without trying to reach remote resource

Returns:

tile or null, if nothing (useful) was found in cache

handleNoTileAtZoom

private boolean handleNoTileAtZoom()

isNoTileAtZoom

private boolean isNoTileAtZoom()

tryLoadTileImage

private boolean tryLoadTileImage(CacheEntry object)
                          throws java.io.IOException

Throws:

java.io.IOException