winIDEA SDK
isys::CConnectionConfig Class Reference

Description

This class contains information for connection to winIDEA.

Its methods return reference to self, so we can use it like this:

CConnectionConfig config = new CConnectionConfig();
config.udpDiscoveryPort(5534).instanceId("main");

All parameters are optional. Set only what is required, default values are used for unspecified parameters.

Python example: advanced_winidea_launching.py

#include <ConnectionMgr.h>

Inherits std::enable_shared_from_this< CConnectionConfig >.

Public Member Functions

SPConnectionConfig workspace (const std::string &rstrWorkspace)
 Sets winIDEA workspace. More...
 
SPConnectionConfig exe_dir (const std::string &rstr_exe_dir)
 Sets winIDEA exe dir to use. More...
 
SPConnectionConfig host (const std::string &rstr_host)
 Sets PC host to use. More...
 
SPConnectionConfig udpDiscoveryPort (uint16_t w_UDP_discovery_port)
 Sets UDP discovery port.
 
SPConnectionConfig instanceId (const std::string &rstr_instance_ID)
 Sets winIDEA instance ID. More...
 
SPConnectionConfig cmd_line (const std::string &rstr_cmd_line)
 Command line parameters for winIDEA This value is used to. More...
 
SPConnectionConfig waitTime (IConnect::ELaunchFlags e_wait_time)
 Determines how long the isystem.connect should wait for running instances to respond. More...
 
SPConnectionConfig useIPCDiscovery (bool b_use_IPC_discovery)
 Locally running winIDEA instances will be discovered using local IPC discovery. More...
 
SPConnectionConfig visibility (IConnect::ELaunchFlags e_visibility)
 Determines how the newly launched instance will start. More...
 
SPConnectionConfig start (IConnect::ELaunchFlags eStart)
 Determines how to potentially start a new winIDEA instance. More...
 
SPConnectionConfig start_if_required ()
 Start a new winIDEA instance if no existing is matching the connection criteria.
 
SPConnectionConfig start_always ()
 Always start a new winIDEA instance.
 
SPConnectionConfig start_existing ()
 Connect to an existing winIDEA instance. More...
 
const std::string & getWorkspace () const
 Returns workspace path.
 
int getUdpDiscoveryPort () const
 Returns UDP discovery port.
 
const std::string & getInstanceId () const
 Returns instanceId.
 
const std::string & getCmdLineParams () const
 Returns command line parameters.
 
IConnect::ELaunchFlags getWaitTime () const
 Returns wait time.
 
bool isUseIPCDiscovery () const
 Returns true, if IPC discovery should be used.
 
IConnect::ELaunchFlags getVisibility () const
 Returns winIDEA window visibility after startup.
 
IConnect::ELaunchFlags get_start () const
 Returns winIDEA start policy.
 
uint32_t getProcessId () const
 Returns process id. More...
 
uint16_t getTCPPort () const
 Returns TCP port. More...
 

Member Function Documentation

◆ cmd_line()

SPConnectionConfig isys::CConnectionConfig::cmd_line ( const std::string &  rstr_cmd_line)

Command line parameters for winIDEA This value is used to.

  • start a new winIDEA instance.

(it is not used to search for an existing instance)

◆ exe_dir()

SPConnectionConfig isys::CConnectionConfig::exe_dir ( const std::string &  rstr_exe_dir)

Sets winIDEA exe dir to use.

This value is used to

  • start a new winIDEA instance.

(it is not used to search for an existing instance)

◆ getProcessId()

uint32_t isys::CConnectionConfig::getProcessId ( ) const

Returns process id.

The id is set after call to findExistingInstance(), startNewInstance(), or findOrStartInstance(). It is valid only when different from 0.

◆ getTCPPort()

uint16_t isys::CConnectionConfig::getTCPPort ( ) const

Returns TCP port.

The port is set after call to findExistingInstance(), startNewInstance(), or findOrStartInstance(). It is valid only when different from 0.

◆ host()

SPConnectionConfig isys::CConnectionConfig::host ( const std::string &  rstr_host)

Sets PC host to use.

If empty, local host is used to look for winIDEA.

◆ instanceId()

SPConnectionConfig isys::CConnectionConfig::instanceId ( const std::string &  rstr_instance_ID)

Sets winIDEA instance ID.

This value is used to

  • search for an existing instance
  • start a new winIDEA instance.

◆ start()

SPConnectionConfig isys::CConnectionConfig::start ( IConnect::ELaunchFlags  eStart)

Determines how to potentially start a new winIDEA instance.

Only one of lfStart flags from IConnect::ELaunchFlags may be specified.

◆ start_existing()

SPConnectionConfig isys::CConnectionConfig::start_existing ( )

Connect to an existing winIDEA instance.

Never start new.

◆ useIPCDiscovery()

SPConnectionConfig isys::CConnectionConfig::useIPCDiscovery ( bool  b_use_IPC_discovery)

Locally running winIDEA instances will be discovered using local IPC discovery.

By default this setting is set to true.

◆ visibility()

SPConnectionConfig isys::CConnectionConfig::visibility ( IConnect::ELaunchFlags  e_visibility)

Determines how the newly launched instance will start.

Only one of lfShowXXX flags from IConnect::ELaunchFlags may be specified.

This value is used to

  • start a new winIDEA instance.

(it is not used to search for an existing instance)

◆ waitTime()

SPConnectionConfig isys::CConnectionConfig::waitTime ( IConnect::ELaunchFlags  e_wait_time)

Determines how long the isystem.connect should wait for running instances to respond.

Only one of lfWaitXXX flags from IConnect::ELaunchFlags may be specified.

◆ workspace()

SPConnectionConfig isys::CConnectionConfig::workspace ( const std::string &  rstrWorkspace)

Sets winIDEA workspace.

This value is used to

  • search for an existing instance
  • start a new winIDEA instance.