Skip to content
HiveMQ extension for demonstrating the HiveMQ extension system
Java
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/main update to current SDK version 4.2.0 Jul 24, 2019
.gitignore
CODE_OF_CONDUCT.md
CONTRIBUTING.md
HEADER Add contribution documents and links May 21, 2019
LICENSE.txt
README.adoc
assembly.xml version 4.0.0 Dec 11, 2018
pom.xml update to current SDK version 4.2.0 Jul 24, 2019

README.adoc

HiveMQ 4 Hello World Extension

Extension Type: Demonstration

Version: 4.2.0

License: Apache License 2.0

Purpose

This Hello World extension sets a ClientLifecycleEventListener which logs the MQTT Version and identifier of every connecting and disconnecting client.

There is a Maven Archetype available to generate a basic extension from the IDE.

We strongly recommend to read the HiveMQ Extension Documentation to grasp the core concepts of HiveMQ extension development.

Installation

  1. Clone this repository into a Java 11 maven project.

  2. Run mvn package goal from Maven to build the extension.

  3. Move the file: "target/hivemq-hello-world-extension-4.2.0-distribution.zip" to the directory: "HIVEMQ_HOME/extensions".

  4. Unzip the file.

  5. Start HiveMQ.

First Steps

Connect with an MQTT client of your choice. You should see a log message with its identifier and MQTT version.

Next steps

Awesome, you got your first HiveMQ 4 extension working.

Now read the HiveMQ Extension Documentation to see what extensions can do.

Need help?

If you encounter any problems, we are happy to help. The best place to get in contact is our support.

Contributing

If you want to contribute to HiveMQ Hello World Extension, see the contribution guidelines.

License

HiveMQ Hello World Extension is licensed under the APACHE LICENSE, VERSION 2.0. A copy of the license can be found here.

You can’t perform that action at this time.