Class: DistributedStoreClient

Distributed Store Client

The Distributed Store Client handles creating, retrieving, and destroying stores. Stores are used to save and retrieve data either locally or globally. This data is not persisted. You can add listeners at multiple levels (store or field), and get the updated data as it's updated in the store. Fields are stored within the store as key/value pair. For more information, see the Distributed Store tutorial.

Methods

createStore
(params, cb)

Creates a store.

Name Type Description
params
Name Type Description
global boolean optional

Whether a store is accessible outside of the component it's created in.

persist boolean optional

Whether to persist the values of the store to storage. The store must be global to use this flag.

store string

The name of the store.

values any optional

Starting values for the store.

cb Function

Will return the store on success.

Example
FSBL.Clients.DistributedStoreClient.createStore({
	store:"store1",
	global:false,
	values:{}
},
function(error, storeObject){});

getStore
(params, cb)

Get a store. If no store is set, you will get the global Finsemble store. If global is not set, Finsemble will check local first then check global.

Name Type Description
params
Name Type Description
global boolean optional

Whether a store is accessible outside of the component it's created in.

store string optional

The name of the store.

cb any

Will return the value if found.

Example
FSBL.Clients.DistributedStoreClient.getStore({
	store:'store1'
},
function(error, storeObject){});

removeStore
(params, cb)

Remove a store. If global is not set and a local store isn't found, Finsemble will remove the global store.

Name Type Description
params
Name Type Description
global boolean optional

Whether the store you're trying to remove is a global store.

store string

The name of the store.

cb any

Callback to be invoked when the store is removed.

Example
FSBL.Clients.DistributedStoreClient.removeStore({
	store:"store1",
	global:true
},
function(){});