The "Getting Started" tutorials will get you up to speed and sending messages with Solace technology as quickly as possible. There are three ways you can get started:
- Follow these instructions to quickly spin up a cloud-based Solace messaging service for your applications.
- Follow these instructions to start the Solace VMR in leading Clouds, Container Platforms or Hypervisors. The tutorials outline where to download and how to install the Solace VMR.
- If your company has Solace message routers deployed, contact your middleware team to obtain the host name or IP address of a Solace message router to test against, a username and password to access it, and a VPN in which you can produce and consume messages.
This repository contains:
-
Code and matching tutorial walk throughs for five different basic Solace messaging patterns. For a nice introduction to the Solace API and associated tutorials, check out the tutorials home page.
See the individual tutorials for details:
- Publish/Subscribe: Learn how to set up pub/sub messaging on a Solace VMR.
- Persistence: Learn how to set up persistence for guaranteed delivery.
- Request/Reply: Learn how to set up request/reply messaging.
- Confirmed Delivery: Learn how to confirm that your messages are received by a Solace message router.
- Topic to Queue Mapping: Learn how to map existing topics to Solace queues.
-
Additional sample code, showing how to make use of advanced features of the Solace message router is available in the features directory.
- Secure Session: Learn how to use secure connection to the server, and server and client certificate authentication.
- Active Consumer Indication: Learn how multiple consumers can bind to an exclusive queue, but only one client at a time can actively receive messages.
- Durable Topic Endpoint Consumer: Learn how to consume messages from a Durable Topic Endpoint (DTE).
- Event Monitor: Learn how to monitor message router generated events.
- GuaranteedRequestor/Replier: Learn how to set up guaranteed request/reply messaging.
- NoLocal Pub-Sub: Learn how to prevent messages published on a session or consumer received on that same session or consumer.
To check out the project, clone this GitHub repository:
git clone https://github.com/SolaceSamples/solace-samples-nodejs
cd solace-samples-nodejs
Note: the code in the master
branch of this repository depends on Solace Node.js API version 10 or later. If you want to work with an older version clone the branch that corresponds your version.
These samples depend on version 10 or later of the Solace Node.js API library.
The library can be installed from the npmjs
central repository using the package.json
specs.
For a local installation of the API package, run from the current solace-samples-nodejs
directory:
npm install
The samples are found in the src/basic-samples
and src/features
directories.
You run the sample using node. For example:
node TopicPublisher.js <protocol://host:port> <client-username>@<message-vpn> <client-password>
See the tutorials for more details.
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
See the list of contributors who participated in this project.
This project is licensed under the Apache License, Version 2.0. - See the LICENSE file for details.
For more information try these resources:
- The Solace Developer Portal website at: http://dev.solace.com
- Get a better understanding of Solace technology.
- Check out the Solace blog for other interesting discussions around Solace technology
- Ask the Solace community.