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