com.luciad.fusion.tilestore

LuciadFusionClass ALfnTileStoreProvider

java.lang.Object

com.luciad.fusion.tilestore.ALfnTileStoreProvider

Direct Known Subclasses:

TLfnTileStoreProvider

public abstract class ALfnTileStoreProvider
extends Object

A provider that can provide a Tile Store based on a URI.

The contract of getTileStore(URI) is that callers of this method are responsible for closing the returned tile store instance. Implementations of this class should take this into account. Implementations can choose to:

• Create new instances. In that case, they transfer the ownership of the created tile store to the caller, and assume it will close the tile store.
• Return an existing instance. In this case, the lifetime of the returned tile store is most likely longer than the scope in which the tile store is used. This means that the tile store provider needs to prevent the returned tile store is actually closed. It can do so for example by returning a tile store wrapper that does nothing in its close method.

It is advised not to create and cache tile store instances in a tile store provider. Doing so makes it unclear when a tile store instance must be disposed.

Since:

2013.0

Constructor Summary

Constructors

Constructor and Description
ALfnTileStoreProvider()

Method Summary

Modifier and Type	Method and Description
abstract ALfnTileStore	getTileStore(URI aUri) Returns a Tile Store for the given URI.

Methods inherited from class java.lang.Object

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

Constructor Detail

ALfnTileStoreProvider

public ALfnTileStoreProvider()

Method Detail

getTileStore

public abstract ALfnTileStore getTileStore(URI aUri)
                                    throws IOException,
                                           TLfnServiceException

Returns a Tile Store for the given URI.

Caller code must always close the returned tile store instance after using it. See class doc for more information.

Parameters:

aUri - The URI to create the Tile Store for

Returns:

The Tile Store

Throws:

IOException - if the Tile Store cannot be opened because of unexpected IO reasons

TLfnServiceException - if the Tile Store cannot be opened because of unexpected reasons