https://github.com/hivemq/hivemq-delete-retained-messages-recursively-plugin

The MQTT Delete Retained Messages Recursively Plugin is a small HiveMQ plugin, meant to demonstrate the functionality of the Retained Message Store Service. It enables a client to delete the retained message of a topic and the retained messages of all it's subtopic at once.
https://github.com/hivemq/hivemq-delete-retained-messages-recursively-plugin

Last synced: 5 days ago
JSON representation

The MQTT Delete Retained Messages Recursively Plugin is a small HiveMQ plugin, meant to demonstrate the functionality of the Retained Message Store Service. It enables a client to delete the retained message of a topic and the retained messages of all it's subtopic at once.

• Host: GitHub
• URL: https://github.com/hivemq/hivemq-delete-retained-messages-recursively-plugin
• Owner: hivemq
• License: apache-2.0
• Created: 2014-04-22T22:04:29.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-08-29T11:06:27.000Z (about 1 year ago)
• Last Synced: 2024-04-17T19:14:13.113Z (7 months ago)
• Language: Java
• Size: 37.1 KB
• Stars: 3
• Watchers: 15
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.adoc
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
:websocket-link: http://www.hivemq.com/demos/websocket-client/

== Delete Retained Messages Recursively Plugin

=== Purpose

The Delete Retained Messages Recursively Plugin is just a small example plugin, meant to demonstrate the functionality of the Retained Message Store.

It enables a client to delete the retained message of a topic and the retained messages of all it's subtopic at once.

=== How to use the plugin

Usually a retained message is removed, by publishing a new retained message with an empty payload to the topic of the retained message that should be deleted.

As long as this plugin is installed, the retained messages of all subtopics will be removed as well.

=== Example

. Copy the plugin into the plugins directory of you HiveMQ

. Run HiveMQ

. Connect a client (you could use the {websocket-link}[HiveMQ Websocket Client] for this purpose.

. Publish a retained message with a not empty payload to the topic "test"

. Publish an other retained message with a not empty payload to the topic "test/a"

. Publish an empty retained message to "test"

. Both retained messages should be removed

= Contributing

If you want to contribute to HiveMQ Delete Retained Messages Recursively Plugin, see the link:CONTRIBUTING.md[contribution guidelines].

= License

HiveMQ Delete Retained Messages Recursively Plugin is licensed under the `APACHE LICENSE, VERSION 2.0`. A copy of the license can be found link:LICENSE.txt[here].