Package com.luciad.fusion.tilestore

Interface ILfnPutTileHandler

All Superinterfaces:

ILfnFailureHandler, ILfnServiceFailureHandler

public interface ILfnPutTileHandler
extends ILfnServiceFailureHandler

A handler for asynchronous tile addition operations. Tile additions are transactions.

There will always be a single interaction with the handler. Exactly one of the methods will be called, indicating that the associated request has been handled, or failed/interrupted.

Since:

10.0

Method Summary

Modifier and Type	Method	Description
void	created(long aTransactionManagementId, long aSequentialTransactionId, long aHighestCommittedTransactionId)	Indicates that the tile was put in the Tile Store, creating a new entry.
void	put(long aTransactionManagementId, long aSequentialTransactionId, long aHighestCommittedTransactionId)	Indicates that the tile was put into the Tile Store, overwriting an existing entry.

Methods inherited from interface com.luciad.fusion.tilestore.ILfnFailureHandler

cancelled, interrupted, threw, threw, threw

Methods inherited from interface com.luciad.fusion.tilestore.ILfnServiceFailureHandler

threw

Method Details

put

void put(long aTransactionManagementId,
 long aSequentialTransactionId,
 long aHighestCommittedTransactionId)

Indicates that the tile was put into the Tile Store, overwriting an existing entry. It provides a unique transaction ID for this write operation. The tile is put but not yet committed.

A tile transaction ID consists of two parts:

1. transaction management ID
2. sequential transaction ID

The combination of the two will result in a unique transaction ID.

The transaction management ID is normally fixed and only changes in failure scenarios. If the client has outstanding transactions with a different management ID, it has to discard its transactions and possibly retry them.

The sequential transaction ID is a strictly increasing number. The highest committed transaction ID indicates that all outstanding transactions of the same management ID and a lower or equal transaction ID have been committed.

Parameters:

aTransactionManagementId - the unique transaction management ID

aSequentialTransactionId - the sequential transaction ID for this particular request

aHighestCommittedTransactionId - the highest committed transaction ID

created

void created(long aTransactionManagementId,
 long aSequentialTransactionId,
 long aHighestCommittedTransactionId)

Indicates that the tile was put in the Tile Store, creating a new entry. The semantics of the transaction ID and such are the same as for the put(long, long, long) method.

Parameters:

aTransactionManagementId - the unique transaction management ID

aSequentialTransactionId - the sequential transaction ID for this particular request

aHighestCommittedTransactionId - the highest committed transaction ID