githubEdit

Stores

Stores maintain references to all tiles which belong to it, and also contain customizable metadata and cached statistics.

They are referenced by name, the single argument of FMTCStore.

circle-exclamation
circle-exclamation
// final store = FMTCStore('storeName');
await FMTCStore('storeName').manage.create(); // Creates the store

Management

FMTCStore().manage allows control over the store and its contents.

Statistics

FMTCStore().stats allows access to:

  • statistics

  • retrieval of a recent tile (as an image)

  • watching of changes to the store

Metadata

FMTCStore().metadata allows access and control over a simple persistent storage mechanism, designed for use with custom data/properties/fields tied to the store. For example, in some apps, it could store the BrowseStoreStrategy or URL template/source.

Data is interpreted in key-value pair form, where both the key and value are Strings. Internally, the default backend stores it as a flat JSON structure. The metadata is stored directly on the store: if the store is deleted, it is deleted, and an exported store retains its metadata. More advanced requirements will require use of a separate persistence mechanism.

circle-info

Remember that metadata does not have any effect on internal logic: it is simply an auxiliary method of storing any data that might need to be kept alongside a store.

Last updated

Was this helpful?