m-amit / hivemq-extension-sdk

Open source Extension SDK for the HiveMQ Enterprise MQTT broker that you can use to extend the broker with custom functionality and integrate the broker with other external systems

HiveMQ Extension SDK

The enterprise MQTT broker HiveMQ offers this free, open source extension SDK. The HiveMQ extension framework provides an open API that allows developers to create custom extensions that suit their specific infrastructures. Use our extension framework to extend HiveMQ with custom business logic or to integrate virtually any system into HiveMQ.

The HiveMQ extension framework can be used to add many different types of functionality:

• Write messages to a database,

• integrate other services,

• collect statistics,

• add fine-grained security,

• and much more.

Resources:

• Web Site: http://www.hivemq.com

• Documentation: http://www.hivemq.com/docs/latest/extensions/

• Community Forum: https://community.hivemq.com/

• Contribution Guidelines: Contributing.adoc

• License: The source files in this repository are made available under the Apache License Version 2.0.

Using the SDK

The HiveMQ extension SDK is available in Maven central, so no special configuration is needed. To use the SDK, add the following dependency to your Maven project:

<dependency>
    <groupId>com.hivemq</groupId>
    <artifactId>hivemq-extension-sdk</artifactId>
    <version>4.5.0</version>
</dependency>

Extension Development Documentation

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

Please visit the extensive HiveMQ extension developer documentation. It covers the core concepts and shows how to set up your development environment.

Example Extensions

You can find many example extensions by browsing the HiveMQ GitHub space.

Check out the HiveMQ Marketplace for officially supported extensions.

Need help ?

If you need help with custom HiveMQ extensions please contact [email protected].

Contributing

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

License

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