rtiddsgen [-help]

[-allocateWithMalloc]

[-alwaysUseStdVector]

[-autoGenFiles <architecture>]

[-constructor]

[-create <typefiles| examplefiles|makefiles>]

[-convertToIdl | -convertToXML | -convertToXsd]

[-D <name>[=<value>]]

[-d <outdir>]

[-disableXSDValidation]

[-dllExportMacroSuffix <suffix>]

[-dotnet <modern|legacy>]

[-enableEscapeChar]

[-example <architecture>]

[-exampleTemplate]

[-I <directory>]

[[-inputIdl] <IDLInputFile.idl> | [-inputXml] <XMLInputFile.xml>

|[-inputXsd <IDLInputFile.idl>]]

[-language <Ada|C|C++|C++11|C++/CLI|C#|Java>]

[-namespace]

[-obfuscate]

[-optimization <level>]

[-package <packagePrefix>]

[-platform <architecture>]

[-ppDisable]

[-ppPath <path to preprocessor>]

[-ppOption <option>]

[-qualifiedEnumerator]

[-reader]

[-replace]

[-sequenceSize <unbounded sequences size>]

[-sharedLib]

[-showTemplates]

[-strict]

[-stringSize <unbounded strings size>]

[-typeSequenceSuffix <suffix>]

[-U <name>]

[-unboundedSupport]

[-update <typefiles| examplefiles|makefiles>]

[-use52Keyhash]

[-use526Keyhash]

[-useStdString]

[-V <name< [=<value>]]

[-verbosity [1-3]]

[-version]

[-virtualDestructor]

[-writer]

rtiddsgen [-help]

[-create <typefiles| examplefiles|makefiles>]

[-convertToIdl | -convertToXML]

[-D <name>[=<value>]]

[-d <outdir>]

[-enableEscapeChar]

[-example]

[-exampleTemplate]

[-I <directory>]

[[-inputIdl] <IDLInputFile.idl> | [-inputXml] <XMLInputFile.xml>]

[-language <C|C++>]

[-micro]

[-namespace]

[-ppDisable]

[-ppPath <path to preprocessor>]

[-ppOption <option>]

[-reader]

[-replace]

[-showTemplates]

[-sequenceSize <unbounded sequences size>]

[-strict]

[-stringSize <unbounded strings size>]

[-U <name>]

[-update <typefiles| examplefiles|makefiles>]

[-V <name< [=<value>]]

[-verbosity [1-3]]

[-version]

[-writer]

选项

描述

-allocateWithMalloc

在C++中使用DDS_Heap_malloc分配可选成员时使用此标志可获得向后兼容性。

-alwaysUseStdVector

仅适用于指定了-语言C++11的情况。

生成将所有序列映射到std:vector的代码甚至将映射到rti:core:bounded_sequence的有界序列。

或者@use_vector注释可以应用于每个序列成员。

-autoGenFiles <architecture>

更新自动生成的文件即typefile和makefile/项目文件。

要查看每种语言的<体系结构>有效选项请使用-help选项运行rtiddsgen或使用字符串

“通用”-autoGenFiles通用为所有支持的平台生成兼容的发布者/订户代码。universalarchitecture不会生成makefile/项目文件。

这是以下项的快捷方式

-更新typefiles-更新makefiles-平台<体系结构>

-constructor

仅当同时指定了-语言C++时适用。

生成类型默认构造函数、复制构造函数、复制赋值运算符和析构函数。使用此选项还将禁用以下TypeSupport方法的生成create_data_ex、delete_

data_ex、initialize_data_e x、finalize_data。

-create <typefiles| examplefiles|makefiles>

创建指定的文件typefile、examplefile或makefile如果它们不存在。例如

rtiddsgen-语言C++11-创建类型文件test.idl如果文件已经存在则不会修改文件并打印警告。

可以有多个创建选项。

如果为同一文件类型同时指定-create和-update则只应用-update。

如果使用-create makefile则需要-platform<arch>选项。例如

rtiddsgen-语言c-创建makefile-平台x64Darwin17clang9.0 test.idl

-convertToIdl

将输入类型描述文件转换为IDL格式。此选项将创建一个与输入文件同名且扩展名为.idl的新文件。

-convertToXML

将输入类型描述文件转换为XML格式。此选项创建一个与输入文件同名且扩展名为.xml的新文件。

-convertToXsd

将输入类型描述文件转换为XSD格式。此选项将创建一个与输入文件同名且扩展名为.xsd的新文件。

-D <name>[=<value>]

定义预处理器宏。

在Windows系统上将参数括在引号中

-D“<name>[=<value>]”

-d <outdir>

在指定目录中生成输出。默认情况下代码生成器将在找到输入类型定义文件的目录中生成文件。

-disableXSDValidation

导致代码生成器不检查输入XSD文件的格式是否正确。

通常不建议使用此选项因为代码生成器可能会收到无效输入。

-dllExportMacroSuffix <suffix>

定义在生成Windows DLL时用于导出符号的宏的后缀。默认宏为NDDS_USER_DLL_EXPORT。指定此选项时宏的名称为NDDS_USER_DLL_

EXPORT_<后缀>。

$rtiddsgen -language c++11 -example x64Darwin17clang9.0 hello_world.idl

rtiddsgen -language C+11 -example x64Darwin17clang9.0 -exampleTemplate advanced hello_ world.idl

产生文件

描述

用户数据类型需要以下文件。源文件应编译并与应用程序链接。需要头文件才能在源中使用数据类型。

除非您打算自定义生成的支持您类型的代码否则不应修改这些文件。

Hello.[c, cxx, cpp]

HelloSupport.[c, cxx, cpp]

HelloPlugin.[c, cxx, cpp]

为数据类型生成的代码。这些文件包含数据类型的实现。

Hello.h

HelloSupport.h

HelloPlugin.h

包含数据类型实现中使用的声明的头文件。

使用-example<architecture>命令行选项时会生成以下可选文件。您可以修改并使用这些文件作为创建发布或订阅用户数据类型的简单应用程序的方法。

application.h (traditional C++ only)

Hello_publisher.cxxand Hello_subscriber.cxxapplications的帮助程序代码

Hello_publisher.[c, cxx, cpp, cs]

发布用户数据类型的应用程序的示例代码。此示例显示了创建发送数据所需的所有DDS对象的基本步骤。

您需要修改代码以设置和更改数据结构中发送的值。否则只需编译并运行。

Hello_subscriber.[c, cxx, cpp,cs]

订阅用户数据类型的应用程序的示例代码。此示例显示了创建接收数据所需的所有DDS对象的基本步骤。

不需要修改此文件。它已准备好供您编译和运行。

Hello-<architecture>.sln

Hello_publisher-<architecture>.v[c, cs, cx]proj

Hello_subscriber-<architecture>.v[c, cs, cx]-proj

Microsoft Visual Studio解决方案和项目文件仅为基于Visual Studio的体系结构生成。示例<architecture>isarmv8Linux4gcc7.3.0。要编译生成的源代码请打开工作区文件并构建两个项目。

makefile_Hello_<architecture>

非基于Visual Studio的架构的Makefile。一个<体系结构>的例子是rmv8Linux4gcc7.3.0。

USER_QOS_PROFILES.xml

生成的示例中DDS实体的服务质量QoS配置从该文件加载。

产生文件

描述

用户数据类型需要以下文件。源文件应编译并与应用程序链接。需要头文件才能在源中使用数据类型。

除非您打算自定义生成的支持您类型的代码否则不应修改这些文件。

Hello.cxx

HelloPlugin.cxx

为数据类型生成的代码。这些文件包含数据类型的实现。

Hello.hpp

HelloPlugin.hpp

包含数据类型实现中使用的声明的头文件

使用-example<architecture>命令行选项时会生成以下可选文件。您可以修改并使用这些文件作为创建发布或订阅用户数据类型的简单应用程序的方法。

application.hpp

Hello_publisher.cxxand Hello_subscriber.cxxapplications的帮助程序代码

Hello_publisher.cxx

发布用户数据类型的应用程序的示例代码。此示例显示了创建发送数据所需的所有DDS对象的基本步骤。

您需要修改代码以设置和更改数据结构中发送的值。否则只需编译并运行。

Hello_subscriber.cxx

订阅用户数据类型的应用程序的示例代码。此示例显示了创建接收数据所需的所有DDS对象的基本步骤。

不需要修改此文件。它已准备好供您编译和运行。

Hello-<architecture>.sln

Hello_publisher-<architecture>.vcxproj

Hello_subscriber-<architecture>.vcxproj

Microsoft Visual Studio解决方案和项目文件仅为基于Visual Studio的体系结构生成。示例<architecture>isarmv8Linux4gcc7.3.0。要编译生成的源代码请打开工作区文件并构建两个项目。

makefile_Hello_<architecture>

非基于Visual Studio的架构的Makefile。一个<体系结构>的例子是rmv8Linux4gcc7.3.0。

USER_QOS_PROFILES.xml

生成的示例中DDS实体的服务质量QoS配置从该文件加载。

产生文件

描述

用户数据类型需要以下文件。源文件应与.NET项目一起编译。

您不应修改这些文件。

Hello.cs

HelloPlugin.cs

为数据类型生成的代码。这些文件包含数据类型的实现。

使用-example<platform>命令行选项其中<platform>

是.NET平台标识符如net5或netcoreapp3.1。您可以修改并使用这些文件来创建发布或订阅用户数据类型的简单应用程序。

HelloProgram.cs

运行HelloPublisher.cs和HelloSubscriber.cs应用程序的代码

HelloPublisher.cs

发布用户数据类型的应用程序的示例代码。此示例显示了创建发送数据所需的所有DDS对象的基本步骤。

您需要修改代码以设置和更改数据结构中发送的值。否则只需编译并运行。

HelloSubscriber.cs

订阅用户数据类型的应用程序的示例代码。

此示例显示了创建接收数据所需的所有DDS对象的基本步骤。

不需要修改此文件。它已准备好供您编译和运行。

Hello.csproj

NuGet.Config

用于构建和运行应用程序。NuGet.Config告诉.NET编译器在哪里可以找到Rti.ConnextDds NuGet包。

USER_QOS_PROFILES.xml

生成的示例中DDS实体的服务质量QoS配置从该文件加载。

类型

产生文件

描述

由于Java语言要求为每个类创建单独的文件所以Code Generator将为每个IDL构造生成一个源文件并将其转换为Java中的类。

常量

Hello.java

与常量关联的类

枚举

Hello.java

与枚举类型关联的类

结构/活接头

Hello.java

HelloSeq.java

HelloDataReader.java

HelloDataWriter.java

HelloTypeSupport.java

结构/联合类序列类DDS DataReader和DataWriter类支持序列化、反序列化等类

序列数组的类型定义

Hello.java

HelloSeq.java

HelloTypeSupport.java

包装类序列类支持序列化、反序列化等类

使用-example<architecture>命令行选项时会生成以下可选文件。您可以修改并使用这些文件作为创建发布或订阅用户数据类型的简单应用程序的方法。

最后一个结构/联合

HelloPublisher.java HelloSubscriber.java

发布或订阅用户数据类型的应用程序的示例代码。您应该修改发布应用程序中的代码以设置和更改发布数据的值。否则两个文件都应该准备好编译和运行。

makefile_Hello_

<architecture>

非基于Windows的体系结构的Makefile。一个<体系结构>的例子是rmv8Linux4gcc7.3.0。

USER_QOS_PROFILES.xml

生成的示例中DDS实体的服务质量QoS配置从该文件加载。

结构/活接头/

类型定义/枚举

HelloTypeCode.java

与IDL类型关联的类型代码类Hello

USER_QOS_PROFILES.xml

生成的示例中DDS实体的服务质量QoS配置从该文件加载。

产生文件

描述

Hello[.h,.c]

为数据类型生成的代码其中包含数据类型的实现以及包含数据类型实现中使用的声明的头文件。

HelloSupport[.h,.c]

HelloPlugin[.h,.c]

hello_idl_file[.adb, .ads]

hello_idl_file-hello_datawriter.ads

DataReader和DataWriter类以及序列化/反序列化方法。

hello_idl_file-hello_datawriter.ads

hello_idl_file-hello_typesupport[.adb,.ads]

hello_idl_file-hello_metptypesupport[.adb,.ads]

这些文件仅为支持零拷贝传输共享内存的类型生成即在IDL文件中用@transfer_modeSHMEM_REF注释。

hello_idl_file-hello_publisher[.adb.ads]在示例/目录中

发布用户数据类型的应用程序的示例代码。您需要修改代码以设置和更改数据结构中发送的值。否则只需编译并运行。subscriberlistener文件实现了on_data_available回调。

hello_idl_file-hello_subscriber[.adb.ads]在示例/目录中

hello_idl_file-hello_subscriberlistener[.adb.ads]在示例/目录中

hello.gpr

使用类似Ada语法的项目文件。这些文件定义了应用程序的构建相关特性。这些特征包括源列表、这些源的位置、生成的对象文件的位置、主程序的名称以及构建过程中涉及的各种工具的选项。每个文件都是一组不同的文件hello示例用于示例hello_c用于c文件hello用于其余ada文件

hello_c.gpr

hello-samples.gpr (in the samples directory)

使用-example<architecture>命令行选项时会生成以下可选文件。您可以修改并使用此文件来创建发布或订阅用户数据类型的简单应用程序。

USER_QOS_PROFILES.xml

生成的示例中DDS实体的服务质量QoS配置从该文件加载。

#parse(“<pathToTemplate>/template.vm”)

module Mymodule{

struct MyStruct{

int32 longMember;

int32 arrayMember [2][100];

sequence<char,2> sequenceMember;

sequence <int32, 5> arrayOfSequenceMember[28];

};

};

void MyModule_MyStruct_specialPrint(){

printf(" longMember \n");

printf(" arrayMember is an array [2, 100] \n ");

printf(" sequenceMember is a sequence <2> \n");

printf(" arrayOfSequenceMember is an array [28] is a sequence <5> ");

}

## We go through all the list of types

#foreach ($node in $constructMapList)

##We only want the method for structs

#*--*##if ($node.constructKind.equals(“¡ãstruct”¡À))

void ${node. nativeFQName}_specialPrint(){

##We go through all the members and call to the macros that check if they are array or

sequences

#*----*##foreach($member in $node.memberFieldMapList)

print("$member.name #isAnArray($member) #isASeq($member) \n");

#*----*##end

}

#*--*##end

#end

#macro (isAnArray $member)

#if($member.dimensionList) is an array $member.dimensionList #end

#end

#macro (isASeq $member)

#if($member.seqSize) is a sequence <$member.seqSize> #end

#end

typedef int32 Latitude;

typedef int32 Longitude;

struct Position {

Latitude x;

Longitude y;

};

LatitudePlugin_serialize(...) {

serialize_long(...)

}

LongitudePlugin_serialize(...) {

serialize_long(...)

}

Position_serialize(...) {

LatitudePlugin_serialize(...)

LongitudePlugin_serialize(...)

}

Position_serialize(...) {

serialize_long(...)

serialize_long(...)

}

struct Point {

int32 x;

int32 y;

};

struct Dimension {

int32 height;

int32 width;

};

struct Rectangle {

Point leftTop;

Dimension size;

};

struct Rectangle {

int32 leftTop_x;

int32 leftTop_y;

int32 size_height;

int32 size_width;

};

Rectangle_serialize(...) {

memcpy(..., 4) // leftTop_x

memcpy(..., 4) // leftTop_y

memcpy(..., 4) // size_height

memcpy(..., 4) // size_width

}

Rectangle_serialize(...) {

memcpy(..., 16) // leftTop_x

}

struct Dimension {

int32 height;

int32 width;

}; // Inlinable

struct Dimension {

string label; // Inlinable structures cannot contain strings

int32 height;

int32 width;

}; // Not Inlinable

基本类型

对齐方式字节

大小字节

int8

1

1

uint8

1

1

int16

2

2

uint16

2

2

int32

4

4

uint32

4

4

int64

8

8

int64

8

8

float

4

4

double

8

8

octet

1

1

char

1

1

struct Dimension {

int32 height;

int16 width;

}; // Inlinable. Independently of the alignment of the starting memory address (4 or 8),

there is no padding between height and width

struct Dimension {

int16 height;

int32 width;

}; // Not Inlinable. Starting in a memory address aligned to 4 will require adding a

padding of two bytes between height and width

struct Dimension {

int32 height;

int16 width;

}; // Not inlinable. Let's assume an array of two dimensions Dimension[2]. If the array

starts in a memory address aligned to 4, there would be padding between the first and the

second element of the array

struct Dimension {

int32 height;

int16 width;

int16 padding;

}; // Inlinable

struct Dimension {

int16 height;

int32 width;

}; // Coalescing not possible because the alignment of width 4 is greater than the alignment of height 2

struct Dimension {

int32 width;

int16 height;

}; // Coalescing is possible because the alignment of width 4 is greater than the alignment of height 2

-XX:+TieredCompilation

-XX:TieredStopAtLevel=1

-XX:CICompilerCount=4

-Xverify:none

-XX:+UseParallelGC

-XX:+OptimizeStringConcat

-XX:CompileThreshold=5000