RTI Routing Service  Version 7.0.0
rti::routing::processor::ProcessorPlugin Class Referenceabstract

The top-level plug-in class. More...

#include <ProcessorPlugin.hpp>

Public Member Functions

virtual Processorcreate_processor (Route &route, const rti::routing::PropertySet &properties)=0
 Creates a Route Processor. More...
 
virtual void delete_processor (Route &route, Processor *processor)=0
 Deletes a Route Processor. More...
 
virtual rti::config::LibraryVersion get_version () const
 
virtual ~ProcessorPlugin ()
 Virtual destructor. More...
 

Detailed Description

The top-level plug-in class.

Represents a factory of Processor.

Constructor & Destructor Documentation

◆ ~ProcessorPlugin()

virtual rti::routing::processor::ProcessorPlugin::~ProcessorPlugin ( )
inlinevirtual

Virtual destructor.

Member Function Documentation

◆ create_processor()

virtual Processor* rti::routing::processor::ProcessorPlugin::create_processor ( Route route,
const rti::routing::PropertySet properties 
)
pure virtual

Creates a Route Processor.

This function is called when the Route containing the Processor is enabled.

A Routing Service running instance will product a log indicating the occurrence of this event. For example:

[.../domain_routes/DomainRoute|START|/sessions/Session|START|/routes/Route|ENABLE]

Required: yes

Parameters
route<<in>> An object representation of the Route that owns the Processor.
properties<<in>> Configuration properties for the Processor. These properties corresponds to the properties specified within the tag <processor>.
Returns
New Processor if successful. Cannot return nullptr.
Exceptions
std::exception
Multi-threading safety:
Safe

◆ delete_processor()

virtual void rti::routing::processor::ProcessorPlugin::delete_processor ( Route route,
Processor processor 
)
pure virtual

Deletes a Route Processor.

This function is called when the Route containing the Processor is disabled.

Required: yes

Parameters
route<<in>> An object representation of the Route that owns the Processor.
processor<<in>> Processor object to be deleted.
Exceptions
std::exception
Multi-threading safety:
Safe

◆ get_version()

virtual rti::config::LibraryVersion rti::routing::processor::ProcessorPlugin::get_version ( ) const
inlinevirtual
Returns
The version of this TransformationPlugin.

The version is used for logging purposes. It allows you to track which version of the TransformationPlugin the RTI Routing Service is using.

Default implementation of this operation returns the version of the required Connext libraries.