Supporting Inter-Plugin Configuration

Table of Contents

• Receiving Inter-Plugin Configuration Request
• Sending Inter-Plugin Configuration Request

The cc_tools_qt allows one plugin to influence the configuration of another. The configuration exchange is done via QVariantMap data type and it's up to the plugins to interpret the values stored in the map.

Receiving Inter-Plugin Configuration Request

The plugin class is expected to extend the cc_tools_qt::ToolsPlugin and override the applyInterPluginConfigImpl() member function.

class MyFilterPlugin : public cc_tools_qt::ToolsPlugin
{
    ...
protected:
    void applyInterPluginConfigImpl(const QVariantMap& props) override
    {
        auto somePropVar = props.value("some_prop");
        if (somePropVar.isValid()) {
            // The inter-plugin configuration contains a value this plugin
            // can use:
            auto someProp = somePropVar.value<QString>();
            ... // Do something with the extracted value.
        }
    }
 
    ...
};

In most cases the plugin configuration is handled inside the class extending the socket, filter, or protocol, then such class can override its applyInterPluginConfigImpl() member function while the plugin's applyInterPluginConfigImpl() one can redirect the request.

class MySocket : public cc_tools_qt::ToolsSocket
{
    ...
protected:
    void applyInterPluginConfigImpl(const QVariantMap& props) override
    {
        auto somePropVar = props.value("some_prop");
        if (somePropVar.isValid()) {
            // The inter-plugin configuration contains a value this plugin
            // can use:
            auto someProp = somePropVar.value<QString>();
            ... // Do something with the extracted value.
        }
    }
 
    ...
};
 
class MySocketPlugin : public cc_tools_qt::ToolsPlugin
{
 
public:
    MyFilterPlugin() : m_socket(new MySocket) {...}
 
protected:
    void applyInterPluginConfigImpl(const QVariantMap& props) override
    {
        m_socket->applyInterPluginConfig(props);
    }
 
    ...
};

Sending Inter-Plugin Configuration Request

The plugin class can invoke inheirted reportInterPluginConfig() member function to report populated inter-plugin configuration.

class MyFilterPlugin : public cc_tools_qt::ToolsPlugin
{
    ...
private:
    void someEvent()
    {
        QVariantMap props;
        prop["some_prop"] = QVariant::fromValue(QString("some_value"));
        prop["some_other_prop"] = QVariant::fromValue(123);
        reportInterPluginConfig(props);
    }
};

In case the inter-plugin configuration event is initiated inside the class extending the socket, filter, or protocol, then such class can use inherited cc_tools_qt::ToolsSocket::reportInterPluginConfig() member function. The plugin class will connect the signals and emit its own sigInterPluginConfigReport().

class MySocket : public cc_tools_qt::ToolsSocket
{
    ...
private:
    void someEvent()
    {
        QVariantMap props;
        prop["some_prop"] = QVariant::fromValue(QString("some_value"));
        prop["some_other_prop"] = QVariant::fromValue(123);
        reportInterPluginConfig(props);
    }
};