Class: StorageClient

Storage Client (Finsemble Connect)

The Storage Client handles saving and retrieving data for your SmartDesktop.

See the Storing Data tutorial for an overview of using the Storage Client.

Methods

addEventListener
(event, handler)

Name Type Description
event string
handler Function

clearCache
(cb)

Clears a storage adapter of all data.

Name Type Description
cb StandardCallback

The callback to be invoked if the method fails.

get
(params, cb)

Get a value from storage.

Name Type Description
params
Name Type Description
key string

The key to get from storage.

topic string

The topic that the data is saved under.

cb StandardCallback

The callback to be invoked if the method fails.

Example
FSBL.Clients.StorageClient.get({ topic:"finsemble", key:"testKey" }, function(err, data) {
	var myData = data;
});

keys
(params, cb)

Get all keys for the topic.

Name Type Description
params
Name Type Description
keyPrefix string optional

Filter all keys that don't start with this prefix.

topic string

Topic for the keys to return.

cb StandardCallback

The callback to be invoked if the method fails.

Example
FSBL.Clients.StorageClient.keys({topic:"finsemble", keyPrefix:"test"}, function(err, data){
	var myKeys = data;
});

remove
(params, cb)

Delete a value from storage.

Name Type Description
params
Name Type Description
key string

The key to get from storage.

topic string

The topic that the data is saved under.

cb StandardCallback

The callback to be invoked if the method fails.

Example
FSBL.Clients.StorageClient.remove({ key:"testKey" })

removeEventListener
(event, handler)

Removes an event listener added by addEventListener

Name Type Description
event any

An event that was used with addEventListener to add a listener

handler any

The handler that was used with addEventListener for the event

save
(params, cb)

Save a key value pair into storage.

Name Type Description
params componentMutateParams
Name Type Description
field string optional

Field to save.

fields optional

Fields to save.

key string optional

Key to store the data under.

stateVar optional

Whether the data is componentState or windowData.

topic string optional

Topic that the data is stored under.

value any optional

Value to save.

cb StandardCallback

The callback to be invoked if the method fails.

Example
FSBL.Clients.StorageClient.save({topic:"finsemble", key:"testKey", value:"testValue"})

setStore
(params, cb)

Specifies the data store. For normal operation this function doesn't have to be invoked -- the default data store is set in configuration.

Name Type Description
params
Name Type Description
dataStore string optional

Identifies the data store (e.g. "localStorage", "redis").

topic string

If specified then data store is set only for topic.

cb StandardCallback

The callback to be invoked if the method fails.

Example
FSBL.Clients.StorageClient.setStore({topic:"finsemble", dataStore:"redis"})

setUser
(params, cb)

Define the user name for storage (i.e., each user has unique storage).

Name Type Description
params
Name Type Description
user string

A unique key to store user data under

cb StandardCallback

The callback to be invoked if the method fails.

Example
FSBL.Clients.StorageClient.setUser({ user: "JohnDeere"});