lightstreamer-jms-web-client
Version:
JavaScript library for the development of Lightstreamer JMS Extender clients running inside the web browser
78 lines (60 loc) • 2.41 kB
Markdown
# Lightstreamer JMS Extender Web Client #
## Overview ##
The Lightstreamer JMS Extender Web Client enables any JavaScript application running inside the web browser to act as a *JMS* client, that is, ready to connect to a JMS broker via Lightstreamer JMS Extender.
The library is designed to be as class-by-class and method-by-method equivalent to JMS API 2.0 as possible.
## Installation ##
### npm
The library is available as npm package, so you can download and install it through:
```
npm install lightstreamer-jms-web-client
```
Then load it from local `node_modules`:
```html
<html>
<head>
<script src="./node_modules/lightstreamer-jms-web-client/dist/lightstreamer-jms.js"></script>
...
</html>
```
### cdn
The library is also available on [unpkg](https://unpkg.com/lightstreamer-jms-web-client),
to which you can point directly in the script tag:
```html
<script src="https://unpkg.com/lightstreamer-jms-web-client@3.0.1/dist/lightstreamer-jms.js"></script>
```
## Development
Open a session against Lightstreamer JMS Extender, create a Topic Connection and connect to the JMS broker:
```js
jms.TopicConnectionFactory.createTopicConnection("http://localhost:8080/", "ActiveMQ", null, null, {
onConnectionCreated: function(conn) {
var topicSession = conn.createSession(false, "PRE_ACK");
.....
conn.start();
}
});
```
Create a Topic Subscription and send it to the broker:
```js
var topic = topicSession.createTopic("stocksTopic");
var consumer = topicSession.createConsumer(topic, null);
```
Listen for messages:
```js
consumer.setMessageListener({
onMessage: function(message) {
var feedMessage = message.getObject();
var key = feedMessage.itemName;
var values = feedMessage.currentValues;
console.log(values["stock_name"] + ": " + values["last_price"]);
}
});
```
## Compatibility
- Compatible with JMS Extender since 2.0.0.
- Based on Lightstreamer SDK for Web Clients version 8.0.9 build 1811.
- Compatible with code developed with the previous version.
## Changelog
See detailed changes [here](https://lightstreamer.com/sdks/ls-jms-web-client/3.0.1/CHANGELOG.html).
## Documentation
- [API Reference](https://lightstreamer.com/sdks/ls-jms-web-client/3.0.1/api/index.html)
- Chapter ["Client Application Development"](https://lightstreamer.com/distros/jmsext/2.1.0/docs/JMS%20Extender%20Documentation.pdf) of _JMS Extender Documentation_