PersistentCacheTileDataSource

java.lang.Object
- com.nutiteq.datasources.TileDataSource
- - com.nutiteq.datasources.CacheTileDataSource
  - - com.nutiteq.datasources.PersistentCacheTileDataSource

```
public class PersistentCacheTileDataSource
extends CacheTileDataSource
```
A tile data source that loads tiles from another tile data source
and caches them in an offline sqlite database. Tiles will remain in the database
even after the application is closed.
The database contains table "persistent_cache" with the following fields:
"tileId" (tile id), "compressed" (compressed tile image),
"time" (the time the tile was cached in milliseconds from epoch).
Default cache capacity is 50MB.

Field Summary
- Fields inherited from class com.nutiteq.datasources.TileDataSource
  swigCMemOwn

Constructor Summary

Constructors
Constructor and Description
`PersistentCacheTileDataSource(long cPtr, boolean cMemoryOwn)`
`PersistentCacheTileDataSource(TileDataSource dataSource, java.lang.String databasePath)` Constructs a PersistentCacheTileDataSource object from tile data source and a sqlite database.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clear()` Clear the cache.
`void`	`close()` Close the cache database.
`void`	`delete()`
`protected void`	`finalize()`
`long`	`getCapacity()` Returns the compressed tile cache capacity.
`static long`	`getCPtr(PersistentCacheTileDataSource obj)`
`boolean`	`isCacheOnlyMode()` Returns the state of cache only mode.
`TileData`	`loadTile(MapTile mapTile)` Loads the specified tile.
`void`	`setCacheOnlyMode(boolean enabled)` Switches the datasource to 'cache only' mode or switches back from the mode. If enabled, tiles are loaded from the cache only and the original data source is not used. By default, cache only mode is off.
`void`	`setCapacity(long capacity)` Sets the cache capacity.
`static PersistentCacheTileDataSource`	`swigCreatePolymorphicInstance(long cPtr, boolean cMemoryOwn)` Creates a polymorphic instance of the given native object.
`protected void`	`swigDirectorDisconnect()`
`java.lang.String`	`swigGetClassName()` Returns the actual class name of this object.
`java.lang.Object`	`swigGetDirectorObject()` Returns the connected director object.
`void`	`swigReleaseOwnership()`
`void`	`swigTakeOwnership()`

Methods inherited from class com.nutiteq.datasources.CacheTileDataSource
getCPtr, notifyTilesChanged

Methods inherited from class com.nutiteq.datasources.TileDataSource
getCPtr, getMaxZoom, getMinZoom, getProjection

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - PersistentCacheTileDataSource
```
public PersistentCacheTileDataSource(long cPtr,
                                     boolean cMemoryOwn)
```
  - PersistentCacheTileDataSource
```
public PersistentCacheTileDataSource(TileDataSource dataSource,
                                     java.lang.String databasePath)
```
    Constructs a PersistentCacheTileDataSource object from tile data source
    and a sqlite database. The sqlite database must be writable, if it doesn't exist, an empty one
    will be created instead.
    
    Parameters:
    
    dataSource - The datasource to be cached.
    
    databasePath - The path to the sqlite database, where the tiles will be cached.
- Method Detail
  - getCPtr
```
public static long getCPtr(PersistentCacheTileDataSource obj)
```
  - finalize
```
protected void finalize()
```
    Overrides:
    
    finalize in class CacheTileDataSource
  - delete
```
public void delete()
```
    Overrides:
    
    delete in class CacheTileDataSource
  - swigDirectorDisconnect
```
protected void swigDirectorDisconnect()
```
    Overrides:
    
    swigDirectorDisconnect in class CacheTileDataSource
  - swigReleaseOwnership
```
public void swigReleaseOwnership()
```
    Overrides:
    
    swigReleaseOwnership in class CacheTileDataSource
  - swigTakeOwnership
```
public void swigTakeOwnership()
```
    Overrides:
    
    swigTakeOwnership in class CacheTileDataSource
  - swigCreatePolymorphicInstance
```
public static PersistentCacheTileDataSource swigCreatePolymorphicInstance(long cPtr,
                                                                          boolean cMemoryOwn)
```
    Creates a polymorphic instance of the given native object. This is used internally by the SDK.
  - isCacheOnlyMode
```
public boolean isCacheOnlyMode()
```
    Returns the state of cache only mode.
    
    Returns:
    
    True when cache only mode is enabled, false otherwise.
  - setCacheOnlyMode
```
public void setCacheOnlyMode(boolean enabled)
```
    Switches the datasource to 'cache only' mode or switches back from the mode.
    If enabled, tiles are loaded from the cache only and the original data source is not used.
    By default, cache only mode is off.
    
    Parameters:
    
    enabled - True when the mode should be enabled, false otherwise.
  - close
```
public void close()
```
    Close the cache database. The datasource will still work afterwards,
    but all requests will be directed to the original datasource.
  - loadTile
```
public TileData loadTile(MapTile mapTile)
```
    Description copied from class: TileDataSource
    
    Loads the specified tile.
    
    Overrides:
    
    loadTile in class TileDataSource
    
    Parameters:
    
    mapTile - The tile to load.
    
    Returns:
    
    The tile data. If the tile is not available, null may be returned.
  - clear
```
public void clear()
```
    Description copied from class: CacheTileDataSource
    
    Clear the cache.
    
    Overrides:
    
    clear in class CacheTileDataSource
  - getCapacity
```
public long getCapacity()
```
    Description copied from class: CacheTileDataSource
    
    Returns the compressed tile cache capacity.
    
    Overrides:
    
    getCapacity in class CacheTileDataSource
    
    Returns:
    
    The compressed tile cache capacity in bytes.
  - setCapacity
```
public void setCapacity(long capacity)
```
    Description copied from class: CacheTileDataSource
    
    Sets the cache capacity.
    
    Overrides:
    
    setCapacity in class CacheTileDataSource
  - swigGetClassName
```
public java.lang.String swigGetClassName()
```
    Returns the actual class name of this object. This is used internally by the SDK.
    
    Overrides:
    
    swigGetClassName in class CacheTileDataSource
    
    Returns:
    
    The class name of this object.
  - swigGetDirectorObject
```
public java.lang.Object swigGetDirectorObject()
```
    Returns the connected director object. This is used internally by the SDK.
    
    Overrides:
    
    swigGetDirectorObject in class CacheTileDataSource
    
    Returns:
    
    The connected director object or null if director is not connected.

Class PersistentCacheTileDataSource

Field Summary

Fields inherited from class com.nutiteq.datasources.TileDataSource

Constructor Summary

Method Summary

Methods inherited from class com.nutiteq.datasources.CacheTileDataSource

Methods inherited from class com.nutiteq.datasources.TileDataSource

Methods inherited from class java.lang.Object

Constructor Detail

PersistentCacheTileDataSource

PersistentCacheTileDataSource

Method Detail

getCPtr

finalize

delete

swigDirectorDisconnect

swigReleaseOwnership

swigTakeOwnership

swigCreatePolymorphicInstance

isCacheOnlyMode

setCacheOnlyMode

close

loadTile

clear

getCapacity

setCapacity

swigGetClassName

swigGetDirectorObject