A simple stocklist demo application showing integration between the Dojo Toolkit and the Lightstreamer JS Client
JavaScript HTML CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
profiles
src
LICENSE
README.md
screen_dojo.png
screen_dojo_large.png
screenshot.png

README.md

Lightstreamer - Stock-List Demo - HTML (Dojo Toolkit) Client

A simple stocklist demo application showing integration between the Dojo Toolkit and the Lightstreamer JavaScript Client library.

Live Demo

screenshot

View live demo

Details

The demo shows how to use the Lightstreamer JavaScript Client library, the lightstreamer-store, the dgrid component, and DojoX Charts together.

Real-Time simulated Stock-List data is received from the Lightstreamer Server deployed @ http://push.lightstreamer.com

Install

If you want to install a version of this demo pointing to your local Lightstreamer Server, follow these steps:

  • Note that, as prerequisite, the Lightstreamer - Stock- List Demo - Java Adapter has to be deployed on your local Lightstreamer Server instance. Please check out that project and follow the installation instructions provided with it.
  • Launch Lightstreamer Server.
  • Create the folders /pages/demos/[demo_name] into your Lightstreamer server installation then copy here the content of src folder of this project.
  • Get the lightstreamer_namespace.js file from the latest Lightstreamer distribution and put it in the src folder of the demo. Alternatively, you can build a lightstreamer_namespace.js file from the online generator. In that case, be sure to include the LightstreamerClient, Subscription, ConnectionSharing, and StatusWidget modules and to use the "AMD with namespaced names" version.
  • Download the Dojo Toolkit and copy the dojox folder from the package to the src folder of the demo. The demo requires the Dojo Toolkit v.1.8 or higher.
  • Using the CommonJS Package Manager install dgrid, dijit and lightstreamer-store in the src folder; dependencies for these packages will be automatically resolved by the cpm process:
    • cpm install dgrid 0.3.8
    • cpm install dijit
    • cpm install lightstreamer-store
  • The demo is now ready to be launched: navigate to src/index.html and enjoy.

Build

It is suggested to compress the dojo/dojox/dijit files in a single js source file to minimize startup times.

Head for the Dojo Web Builder and select the following packages:

  • dijit.layout.BorderContainer
  • dijit.Dialog
  • dijit.registry
  • dojox.charting.Chart
  • dojox.charting.StoreSeries
  • dojox.charting.axis2d.Default
  • dojox.charting.plot2d.Default
  • dojox.charting.themes.Claro
  • dijit.form.ToggleButton
  • dojo.store.Memory
  • dojo.store.Observable
  • dojo.parser
  • dojo.domReady
  • dijit.layout.ContentPane
  • dijit.form.Button
  • dojox.collections.Dictionary
  • dojox.collections.ArrayList
  • dojox.gfx.svg

Then click the "build" button and wait. Once the builder is done, a zip file will be downloaded; copy the files/folders from the archive in the src/dojo foloder and reload the demo.

Once the demo is working in your environment, it is time to deploy it on a web server.

The demo currently connects to a local Lightstreamer server to get the stock data. It is possible to change this setting, making the demo point to a different server. Obviously, in this Case, the DEMO adapter needs to be installed on the tagert server (currently, such adapter is installed by default). To change the server, edit the js/lsClient.js file and substitute the following line:

    var lsClient = new LightstreamerClient(protocolToUse+"//localhost:"+portToUse,"DEMO");

with:

    var lsClient = new LightstreamerClient(myServer,"DEMO");

where myServer contains the address of the server (comprehending the port if different from the default one). As an example, to connect to a local server listening on port 8080 use:

    var lsClient = new LightstreamerClient("http://localhost:8080","DEMO");

See Also

Lightstreamer Adapters Needed by This Client

Related Projects

Lightstreamer Compatibility Notes

  • Compatible with Lightstreamer JavaScript Client library version 6.0 or newer.
  • Compatible with Dojo Toolkit v.1.8 or newer.