Skip to content

hivemq/hivemq-maven-extension-archetype

Repository files navigation

Maven Archetype for HiveMQ Extensions

Maven Central

The enterprise MQTT broker HiveMQ offers this free and open source Extension SDK. This allows everyone to extend HiveMQ and add custom functionality via extensions.

With custom HiveMQ extensions, it’s easy to add functionality like writing messages to databases, integrate with other service buses, collect statistics, add fine-grained security and virtually anything you else you can imagine.

Extension development for HiveMQ is as easy as writing a Java main method once you grasp the core concepts.

Using the Maven Archetype

A new HiveMQ extension project can be created by running the following maven command.

mvn archetype:generate -DarchetypeGroupId=com.hivemq -DarchetypeArtifactId=hivemq-extension-archetype -DarchetypeVersion=4.6.3 -DhivemqExtensionSdkVersion=4.6.2

The hivemq-extension-archetype is available in Maven Central, so no special configuration is needed.

Extension Development Documentation

Please visit our website for the documentation how to develop extensions.

Example Extensions

Many example extensions are available, most of them as open source. You can find an overview of officially supported extensions here:

You can find many example extensions by browsing here on Github.

Need help ?

If you need help with custom HiveMQ extensions please contact support@hivemq.com.

Contributing

If you want to contribute to HiveMQ Maven Extension Archetype, see the contribution guidelines.

License

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