ServerStorage: Difference between revisions
Line 3: | Line 3: | ||
== Description == | == Description == | ||
ServerStorage allows you to save string data on the server so it is available next time you run the program. An entry can be created by assigning to serverStorage.setItem(''variableName'', ''value''), where ''variableName'' is chosen by you. Data is retrieved a similar way. | |||
By default, the data is saved into a namespace with the same name as the app's ID. It can be set to any string, even that of another app, making it possible for apps to share data. | |||
ServerStorage is insecure: there is currently no protection against other apps reading or changing the data. | |||
This feature is currently experimental. It only works on apps deployed to nsbapp.com. It will not work locally or on your server at this time. Since the data is on the nsbapp.com test server, do not assume that data you save will be permanently available. | This feature is currently experimental. It only works on apps deployed to nsbapp.com. It will not work locally or on your server at this time. Since the data is on the nsbapp.com test server, do not assume that data you save will be permanently available. |
Revision as of 16:29, 6 November 2014
serverStorage(string | variable)
Description
ServerStorage allows you to save string data on the server so it is available next time you run the program. An entry can be created by assigning to serverStorage.setItem(variableName, value), where variableName is chosen by you. Data is retrieved a similar way.
By default, the data is saved into a namespace with the same name as the app's ID. It can be set to any string, even that of another app, making it possible for apps to share data.
ServerStorage is insecure: there is currently no protection against other apps reading or changing the data.
This feature is currently experimental. It only works on apps deployed to nsbapp.com. It will not work locally or on your server at this time. Since the data is on the nsbapp.com test server, do not assume that data you save will be permanently available.
Properties and Methods
clear() | Clear all entries in the current namespace. |
deleteItem(key) | Deletes item key. |
getItem(key) | Get the item which is saved under key. String. |
key(n) | Get the nth item in the namespace. |
length | The number of items in the current namespace. |
namespace | The group used by all serverStorage methods. Defaults to app ID. |
setItem(key, value) | Sets item key to value. Creates item if it does not exist. |
Example
Rem serverStorage Save Example serverStorage.data = "This is Data." (run and exit program) Rem serverStorage Retrieve Example Print serverStorage.data Rem Test if Private Browsing is turned on Try serverStorage.private = "test" Catch err MsgBox "Please turn Private Browsing off" End Try Rem Some additional samples: serverStorage.setItem("key", value) 'creates serverStorage.key with defined value serverStorage["key"] = value 'alternative method for above serverStorage.getItem("key") 'calls serverStorage.key...useful to check if it exists serverStorage.removeItem("key") 'deletes serverStorage.key delete serverStorage.key 'alternative method for above delete serverStorage["key"] 'another alternative method for above serverStorage.clear() 'nuclear deletion of all serverStorage variables in the domain. Use with care. serverStorage[DBRecords.rows.item(0)["ModsType"]] = "alpha"
Output
This is Data.