yekui/hivemq-spi

Service Provider Interfaces for Custom Plugin Development for the HiveMQ MQTT Broker

HiveMQ SDK

Note	HiveMQ 4 uses a new extension system. This SDK is not compatible with HiveMQ 4. The new version can be found here.

The enterprise MQTT broker HiveMQ offers this free and open source plugin SDK with service provider interfaces. This allows everyone to extend HiveMQ and add custom functionality via plugins.

With custom HiveMQ plugins, 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.

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

Using the SDK

A extensive HiveMQ plugin documentation is available on the official HiveMQ website. It covers the core concepts and shows how to set up your development environment.

You can also clone our example open source HiveMQ plugins at in our Github page.

Maven Repository

Since version 2.0.0, the hivemq-spi is available in Maven central, so no special configuration is needed.

Using the SDK

To use the SDK, add the following dependency to your Maven project:

    <dependency>
        <groupId>com.hivemq</groupId>
        <artifactId>hivemq-spi</artifactId>
        <version>3.4.4</version>
    </dependency>

Plugin Development Documentation

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

Example plugins

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

Contributing

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

License

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