Getting Started Examples
MQ Telemetry Transport (MQTT)
MQTT is a standard lightweight protocol for sending and receiving messages. As such, in addition to information provided on the Solace developer portal, you may also look at some external sources for more details about MQTT. The following are good places to start
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.
Contents
This repository contains code and matching tutorial walk throughs for different basic scenarios. It is best to view the associated tutorials home page.
Prerequisites
There are no prerequisites.
Build the Samples
./gradlew build
Running the Samples
To try individual samples, build the project from source and then run samples like the following:
./build/staged/bin/topicPublisher tcp://<HOST>:<PORT> <client-username> <client-password>
See the individual tutorials linked from the tutorials home page for full details which can walk you through the samples, what they do, and how to correctly run them to explore MQTT.
Exploring the Samples
Setting up your preferred IDE
Using a modern Java IDE provides cool productivity features like auto-completion, on-the-fly compilation, assisted refactoring and debugging which can be useful when you're exploring the samples and even modifying the samples. Follow the steps below for your preferred IDE.
Using Eclipse
To generate Eclipse metadata (.classpath and .project files), do the following:
./gradlew eclipse
Once complete, you may then import the projects into Eclipse as usual:
File -> Import -> Existing projects into workspace
Browse to the 'solace-samples-java' root directory. All projects should import free of errors.
Using IntelliJ IDEA
To generate IDEA metadata (.iml and .ipr files), do the following:
./gradlew idea
Contributing
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
Authors
See the list of contributors who participated in this project.
License
This project is licensed under the Apache License, Version 2.0. - See the LICENSE file for details.
Resources
For more information try these resources:
- Tutorials
- 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.