OSSL Script Library/JsonStore - Revision history

Tampa at 07:36, 20 January 2025

2025-01-20T07:36:25Z

Manni at 15:27, 12 January 2025

2025-01-12T15:27:54Z

Justincc: /* Introduction */

2013-02-14T01:05:44Z

‎Introduction

Cmickeyb: /* Introduction */

2012-04-17T22:16:05Z

‎Introduction

Cmickeyb: /* Enabling modInvoke() */

2012-04-17T22:13:08Z

‎Enabling modInvoke()

Cmickeyb: /* The Generator Script */

2012-04-17T22:12:43Z

‎The Generator Script

Cmickeyb: Created page with "== Introduction == This functionality current only exists in OpenSimulator development code (0.7.4-dev). == Enabling modInvoke() == The first thing is to enable the JsonStore ..."

2012-04-17T22:09:41Z

Created page with "== Introduction == This functionality current only exists in OpenSimulator development code (0.7.4-dev). == Enabling modInvoke() == The first thing is to enable the JsonStore ..."

New page

== Introduction ==

This functionality current only exists in OpenSimulator development code (0.7.4-dev).

== Enabling modInvoke() ==

The first thing is to enable the JsonStore module in OpenSim.ini. Add the following to enable the module:

<pre>
[JsonStore]
Enabled = True
</pre>

== The Generator Script ==

<source lang="lsl">
string sStoreName = "JsonStoreTest";
key kGlobalStore = (key)NULL_KEY;

integer iCounter = 0;
key kStoreID;

default
{
state_entry()
{
llOwnerSay("running...");
}

touch_start(integer i)
{
state running;
}
}

state running
{
state_entry()
{
// Create a JsonStore initialized with an empty array associated with the key 'Event'
kStoreID = JsonCreateStore("{'Event' : []}");

// Save the store that was just created in the global store, this makes it easier for
// other scripts to find; an alternative is to say the store id in a private channel
JsonSetValue(kGlobalStore,sStoreName,(string)kStoreID);

// Start a timer that will generate counters periodically
llSetTimerEvent(1.0);
}

timer()
{
// Generate a new counter and add it to the end of the Event array
iCounter += 1;
JsonSetValue(kStoreID,"Event[+]",(string)iCounter);
}

touch_start(integer i)
{
// When the test is done, remove the identity of the store and destroy it
JsonRemoveValue(kGlobalStore,sStoreName);
JsonDestroyStore(kStoreID);

llResetScript();
}
}
</source>

== The Consumer Script ==

The consumer script waits for the generator to create the store and place its identity into the global store. At that
point it begins to read values from the generator's store.

<source lang="lsl">
string sStoreName = "JsonStoreTest";
key kGlobalStore = (key)NULL_KEY;

key kStoreID;
key kReqID;

default
{
state_entry()
{
// Set up a request for the identity of the generator's store
// This posts a request, when the value is available a link message event will be fired
kReqID = JsonReadValue(kGlobalStore,sStoreName);
}

link_message(integer sender, integer result, string msg, key id)
{
if (sender != -1)
return;

llOwnerSay("shared store id: " + msg);
kStoreID = (key)msg;

state running;
}
}

state running
{
state_entry()
{
// Set up a request that will take a value (remove it from the store) when it is available
// A link_message will be fired when the value is available
kReqID = JsonTakeValue(kStoreID,"Event[0]");
}

link_message(integer sender, integer result, string msg, key id)
{
if (sender != -1)
return;

llOwnerSay("read " + msg);
kReqID = JsonTakeValue(kStoreID,"Event[0]");
}

touch_start(integer i)
{
llResetScript();
}
}
</source>

[[Category:Scripts]]

← Older revision		Revision as of 07:36, 20 January 2025
Line 1:		Line 1:
−	{{Quicklinks\|~~OSSL Script Library~~/JsonStore}}	+	{{Quicklinks\|OSSL_Script_Library/JsonStore}}

	== Introduction ==		== Introduction ==

← Older revision		Revision as of 15:27, 12 January 2025
Line 1:		Line 1:
		+	{{Quicklinks\|OSSL Script Library/JsonStore}}
		+
	== Introduction ==		== Introduction ==

@@ Line 5: / Line 5: @@
 To see the value of the master/worker pattern, try to make multiple copies of the consumer object. Each one will read tasks created by the generator.
-This functionality current only exists in OpenSimulator development code (0.7.4-dev).
+This functionality current only exists in OpenSimulator development code (0.7.4-dev).  Please be aware that it is currently experimental and subject to change which may make older scripts fail to work or work slightly differently.  You can find documentation of all the functions available and examples of their use can be found on the [[JsonStore Module]] page.
 == Enabling the JsonStore Module ==

← Older revision		Revision as of 22:16, 17 April 2012
Line 1:		Line 1:
	== Introduction ==		== Introduction ==
		+
		+	This page describes two scripts, a generator and a consumer, that demonstrate how to use the JsonStore JsonStoreRead and JsonStoreTake operations for creating a master/worker pair of scripts. Place the generator script in an object and the consumer script in another object. Touch the generator to start the process.
		+
		+	To see the value of the master/worker pattern, try to make multiple copies of the consumer object. Each one will read tasks created by the generator.

	This functionality current only exists in OpenSimulator development code (0.7.4-dev).		This functionality current only exists in OpenSimulator development code (0.7.4-dev).

← Older revision		Revision as of 22:12, 17 April 2012
Line 13:		Line 13:

	== The Generator Script ==		== The Generator Script ==
		+
		+	The generator script writes values to a shared array where consumers can pull those values. The script uses the global store (public scratch storage space) to share the identity of the Json store that it creates.

	<source lang="lsl">		<source lang="lsl">

@@ Line 3: / Line 3: @@
 This functionality current only exists in OpenSimulator development code (0.7.4-dev).
-== Enabling modInvoke() ==
+== Enabling the JsonStore Module ==
 The first thing is to enable the JsonStore module in OpenSim.ini. Add the following to enable the module: