RTI Recording Service  Version 6.1.1
rti::recording::ServiceProperty Class Reference

Configuration for a RTI Recording Service object. More...

#include <ServiceProperty.hpp>

Public Member Functions

 ServiceProperty ()
 Creates a property object with default settings. More...
 
const std::string & cfg_file () const
 Getter (see setter with the same name) More...
 
ServicePropertycfg_file (const std::string &cfg_file)
 Path to an RTI Recording Service configuration file. More...
 
const std::string & service_name () const
 Getter (see setter with the same name) More...
 
ServicePropertyservice_name (const std::string &service_name)
 The name of the RTI Recording Service configuration to run. More...
 
const std::string & application_name () const
 Getter (see setter with the same name) More...
 
ServicePropertyapplication_name (const std::string &application_name)
 Assigns a name to the execution of the RTI Recording Service. More...
 
int32_t domain_id_base () const
 Getter (see setter with the same name) More...
 
bool enforce_xsd_validation () const
 Getter (see setter with the same name) More...
 
ServicePropertyenforce_xsd_validation (bool enforce)
 Controls whether the service applies XSD validation to the loaded configuration. More...
 
ServicePropertydomain_id_base (int32_t domain_id)
 Value that is added to the domain IDs of the domain routes in the XML configuration. More...
 
bool enable_administration () const
 Getter (see setter with the same name) More...
 
ServicePropertyenable_administration (bool enable_administration)
 Set this to true to enable remote administration or false to disable it. More...
 
int32_t administration_domain_id () const
 Getter (see setter with the same name) More...
 
ServicePropertyadministration_domain_id (int32_t domain_id)
 If ServiceProperty::enable_administration is true, this is the domain ID to use for remote administration. More...
 
bool enable_monitoring () const
 Getter (see setter with the same name) More...
 
ServicePropertyenable_monitoring (bool enable_monitoring)
 Set it to true to enable remote monitoring or false to disable it. More...
 
int32_t monitoring_domain_id () const
 Getter (see setter with the same name) More...
 
ServicePropertymonitoring_domain_id (int32_t domain_id)
 If ServiceProperty::enable_monitoring is true, this is the domain ID to use for remote monitoring. More...
 
const ApplicationRoleKind & application_role () const
 Getter (see setter with the same name) More...
 
ServicePropertyapplication_role (ApplicationRoleKind application_role)
 Selects the operation mode of the service. More...
 
bool ignore_default_files () const
 Getter (see setter with the same name) More...
 
ServicePropertyignore_default_files (bool ignore)
 Set it to true to avoid loading the standard files usually loaded by RTI Recording Service. More...
 
const std::string & license_file () const
 Getter (see setter with the same name) More...
 
ServicePropertylicense_file (const std::string &license_file)
 Path to an RTI Connext license file. This field is only used by license-managed versions of the tool. More...
 
bool debug_mode () const
 Getter (see setter with the same name) More...
 
ServicePropertydebug_mode (bool debug_mode)
 Set this to true to enable debug mode or false to disable it. More...
 
const PropertySet & user_environment () const
 Getter (see setter with the same name) More...
 
PropertySet & user_environment ()
 Non-const getter for modification that can be used to add elements individually. (see setter with the same name) More...
 
ServicePropertyuser_environment (const PropertySet &user_environment)
 Dictionary of user variables. The dictionary provides a parallel way to expand XML configuration variables in the form , when they are not defined in the environment. More...
 

Detailed Description

Configuration for a RTI Recording Service object.

Constructor & Destructor Documentation

◆ ServiceProperty()

rti::recording::ServiceProperty::ServiceProperty ( )
inline

Creates a property object with default settings.

Member Function Documentation

◆ cfg_file() [1/2]

const std::string& rti::recording::ServiceProperty::cfg_file ( ) const
inline

Getter (see setter with the same name)

◆ cfg_file() [2/2]

ServiceProperty& rti::recording::ServiceProperty::cfg_file ( const std::string &  cfg_file)
inline

Path to an RTI Recording Service configuration file.

[default] empty string.

◆ service_name() [1/2]

const std::string& rti::recording::ServiceProperty::service_name ( ) const
inline

Getter (see setter with the same name)

◆ service_name() [2/2]

ServiceProperty& rti::recording::ServiceProperty::service_name ( const std::string &  service_name)
inline

The name of the RTI Recording Service configuration to run.

This is the name used to find the service XML tag in the configuration file; the name that will be used to refer to this execution in remote administration and monitoring.

[default] empty string.

◆ application_name() [1/2]

const std::string& rti::recording::ServiceProperty::application_name ( ) const
inline

Getter (see setter with the same name)

◆ application_name() [2/2]

ServiceProperty& rti::recording::ServiceProperty::application_name ( const std::string &  application_name)
inline

Assigns a name to the execution of the RTI Recording Service.

Remote commands and status information will refer to the service using this name.

In addition, the name of DomainParticipants created by RTI Recording Service will be based on this name.

[default] empty string. If no application name is specified, RTI Recording Service will use ServiceProperty::service_name.

◆ domain_id_base() [1/2]

int32_t rti::recording::ServiceProperty::domain_id_base ( ) const
inline

Getter (see setter with the same name)

◆ enforce_xsd_validation() [1/2]

bool rti::recording::ServiceProperty::enforce_xsd_validation ( ) const
inline

Getter (see setter with the same name)

◆ enforce_xsd_validation() [2/2]

ServiceProperty& rti::recording::ServiceProperty::enforce_xsd_validation ( bool  enforce)
inline

Controls whether the service applies XSD validation to the loaded configuration.

[default] true

◆ domain_id_base() [2/2]

ServiceProperty& rti::recording::ServiceProperty::domain_id_base ( int32_t  domain_id)
inline

Value that is added to the domain IDs of the domain routes in the XML configuration.

By using this, an XML file can use relative domain IDs.

[default] 0

◆ enable_administration() [1/2]

bool rti::recording::ServiceProperty::enable_administration ( ) const
inline

Getter (see setter with the same name)

◆ enable_administration() [2/2]

ServiceProperty& rti::recording::ServiceProperty::enable_administration ( bool  enable_administration)
inline

Set this to true to enable remote administration or false to disable it.

[default] false

◆ administration_domain_id() [1/2]

int32_t rti::recording::ServiceProperty::administration_domain_id ( ) const
inline

Getter (see setter with the same name)

◆ administration_domain_id() [2/2]

ServiceProperty& rti::recording::ServiceProperty::administration_domain_id ( int32_t  domain_id)
inline

If ServiceProperty::enable_administration is true, this is the domain ID to use for remote administration.

Takes precedence over the XML configuration. If ServiceProperty::enable_administration is false, this value is not used even if remote administration is enabled in the XML configuration.

[default] 0

◆ enable_monitoring() [1/2]

bool rti::recording::ServiceProperty::enable_monitoring ( ) const
inline

Getter (see setter with the same name)

◆ enable_monitoring() [2/2]

ServiceProperty& rti::recording::ServiceProperty::enable_monitoring ( bool  enable_monitoring)
inline

Set it to true to enable remote monitoring or false to disable it.

[default] false

◆ monitoring_domain_id() [1/2]

int32_t rti::recording::ServiceProperty::monitoring_domain_id ( ) const
inline

Getter (see setter with the same name)

◆ monitoring_domain_id() [2/2]

ServiceProperty& rti::recording::ServiceProperty::monitoring_domain_id ( int32_t  domain_id)
inline

If ServiceProperty::enable_monitoring is true, this is the domain ID to use for remote monitoring.

Takes precedence over the XML configuration. If ServiceProperty::enable_monitoring is false, this value is not used, even if remote monitoring is enabled in the XML configuration.

[default] 0

◆ application_role() [1/2]

const ApplicationRoleKind& rti::recording::ServiceProperty::application_role ( ) const
inline

Getter (see setter with the same name)

◆ application_role() [2/2]

ServiceProperty& rti::recording::ServiceProperty::application_role ( ApplicationRoleKind  application_role)
inline

Selects the operation mode of the service.

See also
ApplicationRoleKind

◆ ignore_default_files() [1/2]

bool rti::recording::ServiceProperty::ignore_default_files ( ) const
inline

Getter (see setter with the same name)

◆ ignore_default_files() [2/2]

ServiceProperty& rti::recording::ServiceProperty::ignore_default_files ( bool  ignore)
inline

Set it to true to avoid loading the standard files usually loaded by RTI Recording Service.

Only the configuration in ServiceProperty::cfg_file or ServiceProperty::cfg_strings will be loaded.

[default] false

◆ license_file() [1/2]

const std::string& rti::recording::ServiceProperty::license_file ( ) const
inline

Getter (see setter with the same name)

◆ license_file() [2/2]

ServiceProperty& rti::recording::ServiceProperty::license_file ( const std::string &  license_file)
inline

Path to an RTI Connext license file. This field is only used by license-managed versions of the tool.

[default] empty string.

◆ debug_mode() [1/2]

bool rti::recording::ServiceProperty::debug_mode ( ) const
inline

Getter (see setter with the same name)

◆ debug_mode() [2/2]

ServiceProperty& rti::recording::ServiceProperty::debug_mode ( bool  debug_mode)
inline

Set this to true to enable debug mode or false to disable it.

[default] false

◆ user_environment() [1/3]

const PropertySet& rti::recording::ServiceProperty::user_environment ( ) const
inline

Getter (see setter with the same name)

◆ user_environment() [2/3]

PropertySet& rti::recording::ServiceProperty::user_environment ( )
inline

Non-const getter for modification that can be used to add elements individually. (see setter with the same name)

◆ user_environment() [3/3]

ServiceProperty& rti::recording::ServiceProperty::user_environment ( const PropertySet &  user_environment)
inline

Dictionary of user variables. The dictionary provides a parallel way to expand XML configuration variables in the form , when they are not defined in the environment.

[default] empty