Tutorials

1 Hello World Example

The purpose of this example is to get you started with Web Integration Service. We will start from an empty configuration, then add applications and entities using Web Integration Service's REST API.

To run Web Integration Service from your command shell, go to the installation directory and enter:

$ <NDDSHOME>/bin/rtiwebintegrationservice -cfgName EmptyConfiguration

This will start an instance of Web Integration Service with an empty configuration. By default, Web Integration Service will listen for HTTP requests on port 8080. To set a different listening port, use the -listeningPorts <portsToListen> argument. For instance:

$ <NDDSHOME>/bin/rtiwebintegrationservice -cfgName EmptyConfiguration \
  -listeningPorts 8081

To enable HTTPS, append an "s" to the ports specified with -listeningPorts. Use -sslCertificate to specify the path to the certificate to be used by the web server when using HTTPS. The certificate file must combine both the certificate and the private key in the same file. Here is an example:

$ <NDDHSOME>/bin/rtiwebintegrationservice -cfgName EmptyConfiguration \
  -listeningPorts 8081s -sslCertificate ~/.certificates/some_cert.pem

For a complete list of command-line arguments, see Section 4 of the Usage Chapter or run rtiwebintegrationservice -help.

Now that we have a Web Integration Service instance running, we are going to configure a scenario via REST API calls. In particular, we want to create an application that will include entities to publish and subscribe to HelloWorldTopic topics.

1.1 Defining Types

Before creating any DDS entity, we first need to define the data types our application will be sending and receiving. The data type associated with HelloWorldTopic consists of two strings and a numeric counter:

  • The first string contains the name of the message's sender. This field is a "key" because it indicates the identity of the data object.
  • The second string contains the message itself.
  • The third field is a simple counter that the application increments with each sent message.

Web Integration Service uses the Dynamic Data API, so the data type must be defined in the XML configuration for its later dynamic instantiation. This is accomplished by adding the type definition within the <types> tag:

<types>
    <const name="MAX_NAME_LEN" type="long" value="64"/>
    <const name="MAX_MSG_LEN" type="long" value="128"/>
    <struct name="HelloWorld">
        <member name="sender" type="string" key="true" stringMaxLength="MAX_NAME_LEN"/>
        <member name="message" type="string" stringMaxLength="MAX_MSG_LEN"/>
        <member name="count" type="long"/>
    </struct>
</types>

To load the types we have defined, we need to call the POST method on /types and pass the XML type representation in the body of the HTTP request. In this example, as well as in the rest of examples, we provide both a raw HTTP Request and the curl command that needs to be run to execute the request.

HTTP Request
POST /dds/rest1/types HTTP/1.1
Host: ##HOST##
Content-Length: 381
Content-Type: application/dds-web+xml
Cache-Control: no-cache

<types>
    <const name="MAX_NAME_LEN" type="long" value="64"/>
    <const name="MAX_MSG_LEN" type="long" value="128"/>
    <struct name="HelloWorld">
        <member name="sender" type="string" key="true" stringMaxLength="MAX_NAME_LEN"/>
        <member name="message" type="string" stringMaxLength="MAX_MSG_LEN"/>
        <member name="count" type="long"/>
    </struct>
</types>
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache"  -d '<types>
    <const name="MAX_NAME_LEN" type="long" value="64"/>
    <const name="MAX_MSG_LEN" type="long" value="128"/>
    <struct name="HelloWorld">
        <member name="sender" type="string" key="true" stringMaxLength="MAX_NAME_LEN"/>
        <member name="message" type="string" stringMaxLength="MAX_MSG_LEN"/>
        <member name="count" type="long"/>
    </struct>
</types>' http://##HOST##/dds/rest1/types

1.2 Listing Types

You can check that the types were loaded correctly by calling GET on /types:

HTTP Request
GET /dds/rest1/types HTTP/1.1
Host: ##HOST##
Cache-Control: no-cache
Curl
curl -X GET -H "Cache-Control:no-cache" http://##HOST##/dds/rest1/types

1.3 Creating Applications

In RTI Web Integration Service, Applications are aggregations of DomainParticipants with a common goal. DomainParticipants may:

  • Register types—the <register_type> tag specifies a type definition that will be registered in the DomainParticipant. Note that since Web Integration Service uses the DDS Dynamic Data API, all the types registered within DomainParticipants need to be created with kind="dynamicData".
  • Create Topics—the <topic> tag specifies a Topic by associating it with a <register_type> that contains the type information.
  • Create Publishers—the <publisher> tag specifies a publisher that will be registered in the DomainPartipant. Publishers can create DataWriters using the <data_writer> tag.
  • Create Subscribers—the <subscriber> tag specifies a Subscriber that will be registered in the DomainParticipant. Subscribers can create DataReaders using the <data_reader> tag.

Our example Application, which we will call ExampleApplication, defines a single DomainParticipant named MyParticipant. This participant operates on Domain 0 and:

  • Registers HelloWorldType, which refers to the HelloWorld type posted before.
  • Creates HelloWorldTopic, which is associated with the registered HelloWorldType.
  • Creates a Publisher called MyPublisher, which creates a DataWriter of HelloWorldTopic called HelloWorldWriter.
  • Creates a Subscriber called MySubscriber, which creates a DataReader of HelloWorldTopic called HelloWorldReader.

Here is the XML representation of ExampleApplication:

<application name="ExampleApplication">
    <domain_participant name="MyParticipant" domain_id="0">
        <register_type name="HelloWorldType" kind="dynamicData"
                type_ref="HelloWorld"/>
        <topic name="HelloWorldTopic" register_type_ref="HelloWorldType"/>
        <publisher name="MyPublisher">
            <data_writer name="HelloWorldWriter"                 
                    topic_ref="HelloWorldTopic"/>
        </publisher>
        <subscriber name="MySubscriber">
            <data_reader name="HelloWorldReader" topic_ref="HelloWorldTopic"/>
        </subscriber>
    </domain_participant>
</application>

To create ExampleApplication, along with all its contained entities, we must call POST on /applications and pass in the XML representation of the application in the body of the HTTP request:

HTTP Request
POST /dds/rest1/applications HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 574
Cache-Control: no-cache

<application name="ExampleApplication">
   <domain_participant name="MyParticipant" domain_id="0">
       <register_type name="HelloWorldType" kind="dynamicData"    
               type_ref="HelloWorld"/>
       <topic name="HelloWorldTopic" register_type_ref="HelloWorldType"/>
       <publisher name="MyPublisher">
           <data_writer name="HelloWorldWriter" topic_ref="HelloWorldTopic"/>
       </publisher>
       <subscriber name="MySubscriber">
           <data_reader name="HelloWorldReader" topic_ref="HelloWorldTopic"/>
       </subscriber>
  </domain_participant>
</application>
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" -d '<application name="ExampleApplication">
   <domain_participant name="MyParticipant" domain_id="0">
       <register_type name="HelloWorldType" kind="dynamicData" type_ref="HelloWorld"/>
       <topic name="HelloWorldTopic" register_type_ref="HelloWorldType"/>
       <publisher name="MyPublisher">
           <data_writer name="HelloWorldWriter" topic_ref="HelloWorldTopic"/>
       </publisher>
       <subscriber name="MySubscriber">
           <data_reader name="HelloWorldReader" topic_ref="HelloWorldTopic"/>
       </subscriber>
   </domain_participant>
</application>' http://##HOST##/dds/rest1/applications

To check that the defined DomainParticipants, Publishers, Subscribers, DataWriters, and DataReaders were successfully created, call GET on:

  • /applications/ExampleApplication/domain_participants,
  • /applications/ExampleApplication/domain_participants/MyParticipant/publishers,
  • /applications/ExampleApplication/domain_participants/MyParticipant/subscribers,
  • /applications/ExampleApplication/domain_participants/MyParticipant/publishers/MyPublisher/data_writers, or
  • /applications/ExampleApplication/domain_participants/MyParticipant/subscribers/MySubsriber/data_readers, respectively.

For instance, to list all the DataWriters within MyPublisher, call:

HTTP Request
GET /dds/rest1/applications/ExampleApplication/domain_participants/MyParticipant/publishers/MyPublisher/data_writers HTTP/1.1
Host: ##HOST##
Cache-Control: no-cache
Curl
curl -X GET -H "Cache-Control:no-cache" http://##HOST##/dds/rest1/applications/ExampleApplication/domain_participants/MyParticipant/publishers/MyPublisher/data_writers

1.4 Sending and Receiving Samples

1.4.1 Sending Samples

Once the DataWriter is available, you can start writing data samples. The XML representation of a HelloWorldType data sample follows this structure:

<data>
    <sender>Fernando</sender>
    <message>Hello World!</message>
    <count>0</count>
</data>

To write a new data sample, call POST on /applications/ExampleApplication/domain_participants/MyParticipant/publishers/MyPublisher/data_writers/HelloWorldWriter and pass in the XML representation of the data sample:

HTTP Request
POST /dds/rest1/applications/ExampleApplication/domain_participants/MyParticipant/publishers/MyPublisher/data_writers/HelloWorldWriter HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 101
Cache-Control: no-cache

<data>
    <sender>Fernando</sender>
    <message>Hello World!</message>
    <count>0</count>
</data>
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" -d '<data>
    <sender>Fernando</sender>
    <message>Hello World!</message>
    <count>0</count>
</data>' http://##HOST##/dds/rest1/applications/ExampleApplication/domain_participants/MyParticipant/publishers/MyPublisher/data_writers/HelloWorldWriter

1.4.2 Receiving Samples

To read the samples available on the DataReader's cache, call GET on /applications/ExampleApplication/domain_participants/MyParticipant/subscribers/MySubscriber/data_readers:

HTTP Request
GET /dds/rest1/applications/ExampleApplication/domain_participants/MyParticipant/subscribers/MySubscriber/data_readers/HelloWorldReader HTTP/1.1
Host: ##HOST##
Cache-Control: no-cache
Curl
curl -X GET -H "Cache-Control:no-cache" http://##HOST##/dds/rest1/applications/ExampleApplication/domain_participants/MyParticipant/subscribers/MySubscriber/data_readers/HelloWorldReader
Response

The response is a sequence with the samples read, which includes sample information (i.e., information pertaining to the associated Data instance sample) and sample data (i.e., the actual received data):

HTTP/1.1 200 Samples read
Content-Type: application/dds-web+xml
Cache-Control: no-cache
Content-Length: 537
Date: Fri, 04 Mar 2016 18:50:35 GMT

<read_sample_seq>
    <sample>
        <read_sample_info>
            <source_timestamp>
                <sec>1457117216</sec>
                <nanosec>260702000</nanosec>
            </source_timestamp>
            <valid_data>true</valid_data>
            <instance_handle>
                88,11,164,23,155,26,109,107,76,215,206,79,84,179,182,60
            </instance_handle>
            <instance_state>ALIVE</instance_state>
            <sample_state>NOT_READ</sample_state>
            <view_state>NEW</view_state>
        </read_sample_info>
        <data>
            <sender>Fernando</sender>
            <message>Hello World!</message>
            <count>0</count>
        </data>
    </sample>
</read_sample_seq>

2 Shapes Demo

In the previous example, we started off with an embedded empty configuration to which—using the REST API—we added an application and different DDS entities to send and receive HelloWorldTopic data samples. In this example, we will use another embedded configuration that contains predefined entities to communicate with RTI Shapes Demo.

The embedded ShapesDemo configuration can be found in the following configuration file: <NDDSHOME>/resource/xml/RTI_WEB_INTEGRATION_SERVICE.xml. Let's analyze the different components it contains.

2.1 Types Definition

The first thing you will find in RTI_WEB_INTEGRATION_SERVICE.xml is the definition of a data type called ShapeType. This is the type that all the topics that RTI Shapes Demo publishes and subscribes to (i.e., Square, Triangle, and Circle) are associated with. Here is its XML representation:

<types>
   <const name="MAX_COLOR_LEN" type="long" value="128"/>
   <struct name="ShapeType">
       <member name="color" type="string" stringMaxLength="128" key="true"/>
       <member name="x" type="long"/>
       <member name="y" type="long"/>
       <member name="shapesize" type="long"/>
   </struct>
</types>

2.2 Domain Library

In RTI_WEB_INTEGRATION_SERVICE.xml you will also find a domain library and a domain. Domain libraries provide a way to organize different template domains that can be used in the definition of DomainParticipants. Domains represent data spaces where information can be shared by means of reading and writing the same Topics (which need to be associated with a registered data type). Therefore, in a <domain> tag you can specify Topics and their data types.

Our domain library contains a ShapesDomain that pre-registers ShapeType and creates a Square topic associated with it. DomainParticipants referring to the ShapesDomainLibrary::ShapeDomain domain will automatically instantiate these entities upon creation.

Here is the XML representation of ShapesDomainLibrary, as defined in RTI_WEB_INTEGRATION_SERVICE.xml:

<domain_library name="ShapesDomainLibrary">
    <domain name="ShapesDomain" domain_id="0">
        <register_type name="ShapeType" kind="dynamicData"
            type_ref="ShapeType" />
        <topic name="Square" register_type_ref="ShapeType" />
    </domain>
</domain_library>

2.3 Shapes Demo Configuration

The ShapesDemo configuration in RTI_WEB_INTEGRATION_SERVICE.xml also contains an application called ShapesDemoApp. This application creates a single DomainParticipant called ShapesDemoParticipant using the MyDomainLibrary::ShapeDomain domain. This significantly reduces the entities that need to be defined (i.e., we do not need to register ShapeType or create the Square topic). ShapesDemoParticipant creates both a Publisher and a Subscriber, which create a Square DataWriter, and a Square DataReader, respectively.

Here is the XML representation of ShapesDemo as defined in RTI_WEB_INTEGRATION_SERVICE.xml:

<web_integration_service name="ShapesDemo">
    <application name="ShapesDemoApp">
        <domain_participant name="ShapesDemoParticipant"
            domain_ref="ShapesDomainLibrary::ShapesDomain">
            <publisher name="MyPublisher">
                <data_writer name="MySquareWriter" topic_ref="Square" />
            </publisher>
            <subscriber name="MySubscriber">
                <data_reader name="MySquareRdr" topic_ref="Square" />
            </subscriber>
        </domain_participant>
    </application>
</web_integration_service>

To load the whole system definition, start Web Integration Service and specify the ShapesDemo configuration, like this:

$ <NDDSHOME>/bin/rtiwebintegrationservice -cfgName ShapesDemo

Web Integration Service will instantiate all the applications under ShapesDemo and their contained entities. You can check that the ShapesDemoParticipant has been created by calling GET on /applications/ShapesDemoApp/domain_participants:

HTTP Request
GET /dds/rest1/applications/ShapesDemoApp/domain_participants HTTP/1.1
Host: ##HOST##
Cache-Control: no-cache
Curl
curl -X GET -H "Cache-Control:no-cache" http://localhost:8080/dds/rest1/applications/ShapesDemoApp/domain_participants

2.3.1 Sending and Receiving Square Topics

2.3.1.1 Sending a Square

You can use the instantiated DataWriter to start writing Square samples. The XML representation of a ShapeType data sample follows this structure:

<data>
    <color>YELLOW</color>
    <x>100</x>
    <y>150</y>
    <shapesize>30</shapesize>
</data>

To write a new data sample, do a POST on /applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers/MySquareWriter and pass in the XML representation of the data sample:

HTTP Request
POST /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers/MySquareWriter HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 110
Cache-Control: no-cache

<data>
    <color>YELLOW</color>
    <x>100</x>
    <y>150</y>
    <shapesize>30</shapesize>
</data>
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" -d '<data>
    <color>YELLOW</color>
    <x>100</x>
    <y>150</y>
    <shapesize>30</shapesize>
</data>' http://localhost:8080/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers/MySquareWriter

If you subscribe to Squares on Domain 0 using RTI Shapes Demo and publish the sample again, you see a new yellow square in position (100,150).

2.3.1.2 Receiving Squares

To read samples using Web Integration Service, call GET on /applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers/MySquareRdr:

HTTP Request
GET /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers/MySquareRdr HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Cache-Control: no-cache
Curl
curl -X GET -H "Cache-Control:no-cache" http://##HOST##/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers/MySquareRdr
Response
HTTP/1.1 200 Samples read
Content-Type: application/dds-web+xml
Cache-Control: no-cache
Content-Length: 528
Date: Fri, 04 Mar 2016 18:52:45 GMT

<read_sample_seq>
    <sample>
        <read_sample_info>
            <source_timestamp>
                <sec>1457117555</sec>
                <nanosec>247519000</nanosec>
            </source_timestamp>
            <valid_data>true</valid_data>
            <instance_handle>
                158,208,232,178,159,2,73,190,207,107,36,86,125,59,13,169
            </instance_handle>
            <instance_state>ALIVE</instance_state>
            <sample_state>NOT_READ</sample_state>
            <view_state>NEW</view_state>
        </read_sample_info>
        <data>
            <color>YELLOW</color>
            <x>100</x>
            <y>150</y>
            <shapesize>30</shapesize>
        </data>
    </sample>
</read_sample_seq>

2.4 Creating New Topics, DataWriters, and DataReaders

Sometimes you may want to create new DataWriters and DataReaders for sending and receiving new Topics. For instance, with the current configuration our ShapesDemoApp application can only send and receive Square topics. This section explains how to add new Topics, DataWriters, and DataReaders to our ShapesDemo application to be able to send and receive Circles and Triangles as well.

2.4.1 Creating New Topics

To create a new Circle Topic, call POST on /applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/topics and pass in the XML representation of the Topic in the HTTP request. Note that since ShapeType is already registered, you do not need to register it again.

HTTP Request
POST /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/topics HTTP/1.1
Host: ##HOST##
Content-Length: 52
Content-Type: application/dds-web+xml
Cache-Control: no-cache

<topic name="Circle" register_type_ref="ShapeType"/>
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" -d '<topic name="Circle" register_type_ref="ShapeType"/>' http://##HOST##/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/topics

To create a Triangle topic, call POST on /applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/topics and pass in the XML representation of the Topic in the HTTP request:

HTTP Request
POST /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/topics HTTP/1.1
Host: ##HOST##
Content-Length: 54
Content-Type: application/dds-web+xml
Cache-Control: no-cache

<topic name="Triangle" register_type_ref="ShapeType"/>
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" -d '<topic name="Triangle" register_type_ref="ShapeType"/>' http://##HOST##/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/topics

2.4.2 Creating New DataWriters and DataReaders

Once you have created the Circle and Triangle Topics, you can create DataWriters and DataReaders for each Topic calling POST on /applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers and /applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers, respectively, and pass in their XML representations in the body of the HTTP request.

To create a Circle DataWriter:

HTTP Request
POST /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 56
Cache-Control: no-cache

<data_writer name="MyCircleWriter" topic_ref="Circle" />
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" -d '<data_writer name="MyCircleWriter" topic_ref="Circle" />' http://##HOST##/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers

To create a Triangle DataWriter:

HTTP Request
POST /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers HTTP/1.1
Host: ##HOST##
Content-Length: 60
Content-Type: application/dds-web+xml
Cache-Control: no-cache

<data_writer name="MyTriangleWriter" topic_ref="Triangle" />
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" -d '<data_writer name="MyTriangleWriter" topic_ref="Triangle" />' http://##HOST##/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers

To create a Circle DataReader:

HTTP Request
POST /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 52
Cache-Control: no-cache

<data_reader name="MyCircleRdr" topic_ref="Circle"/>
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" -d '<data_reader name="MyCircleRdr" topic_ref="Circle"/>' http://##HOST##/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers

To create a Triangle DataReader:

HTTP Request
POST /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 55
Cache-Control: no-cache

<data_reader name="MyTriangleRdr" topic_ref="Triangle/>
Curl
curl -X POST -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" -d '<data_reader name="MyTriangleRdr" topic_ref="Triangle"/>' http://##HOST##/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers

You can check whether the new DataWriters and DataReaders were successfully created by calling GET on their respective resource URLs:

HTTP Request
GET /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Cache-Control: no-cache
Curl
curl -X GET -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" http://##HOST##/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/publishers/MyPublisher/data_writers
Response
<data_writer_list>
    <data_writer name="MySquareWriter" />
    <data_writer name="MyCircleWriter" />
    <data_writer name="MyTriangleWriter" />
</data_writer_list>
HTTP Request
GET /dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Cache-Control: no-cache
Curl
curl -X GET -H "Content-Type:application/dds-web+xml" -H "Cache-Control:no-cache" http://##HOST##/dds/rest1/applications/ShapesDemoApp/domain_participants/ShapesDemoParticipant/subscribers/MySubscriber/data_readers
Response
<data_reader_list>
    <data_reader name="MySquareRdr" />
    <data_reader name="MyCircleRdr" />
    <data_reader name="MyTriangleRdr" />
</data_reader_list>

3 More Complex Example

This example shows you how to send and receive samples of more complex data types. We will show you how to write nested structures, sequences, arrays, and enums. We will also explain how to create QoS libraries and QoS profiles to configure QoS settings for different DDS entities.

Just like we did in the Hello World example in Section 1, we will start a new instance of Web Integration Service from an empty configuration.

<NDDSHOME>/bin/rtiwebintegrationservice -cfgName EmptyConfiguration

3.1 Types Definition

In this example we define a much more complicated type called ComplexType. To load ComplexType, call POST on /types passing its XML definition in the body of the HTTP request:

HTTP Request
POST /dds/rest1/types HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 2475
Cache-Control: no-cache

<types>
    <const name="MAX_COLOR_LEN" type="long" value="255" />
    <typedef name="MYBOOL" type="boolean" />
    <enum name="MyEnum">
        <enumerator name="ACE" value="1" />
        <enumerator name="KING" value="13" />
        <enumerator name="QUEEN" value="12" />
    </enum>
    <struct name="PrimitivesType">
        <member name="aString" type="string" stringMaxLength="MAX_COLOR_LEN" />
        <member name="aLong" type="long" />
        <member name="aShort" type="short" />
        <member name="aUnsignedShort" type="unsignedShort" />
        <member name="aUnsignedLong" type="unsignedLong" />
        <member name="aFloat" type="float" />
        <member name="aDouble" type="double" />
        <member name="aBoolean" type="boolean" />
        <member name="aChar" type="char" />
        <member name="aWchar" type="wchar" />
        <member name="aLongLong" type="longLong" />
        <member name="aUnsignedLongLong" type="unsignedLongLong" />
        <member name="anEnum" type="nonBasic" nonBasicTypeName="MyEnum" />
        <member sequenceMaxLength="3" name="anEnumSeq" type="nonBasic"
            nonBasicTypeName="MyEnum" />
        <member arrayDimensions="3" name="anEnumArr" type="nonBasic"
            nonBasicTypeName="MyEnum" />
    </struct>
    <struct name="ComplexType">
        <member name="aString" type="string" stringMaxLength="MAX_COLOR_LEN" />
        <member name="aLong" type="long" />
        <member name="aShort" type="short" />
        <member name="anOctet" type="octet" />
        <member name="aUnsignedShort" type="unsignedShort" />
        <member name="aUnsignedLong" type="unsignedLong" />
        <member name="aFloat" type="float" />
        <member name="aDouble" type="double" />
        <member name="aBoolean" type="boolean" />
        <member name="aChar" type="char" />
        <member name="aWchar" type="wchar" />
        <member name="aLongLong" type="longLong" />
        <member name="aUnsignedLongLong" type="unsignedLongLong" />
        <member name="anAlias" type="nonBasic" nonBasicTypeName="MYBOOL" />
        <member name="aComplexType" type="nonBasic" nonBasicTypeName="PrimitivesType" />
        <member name="anEnum" type="nonBasic" nonBasicTypeName="MyEnum" />
        <member sequenceMaxLength="3" name="anEnumSeq" type="nonBasic"
            nonBasicTypeName="MyEnum" />
        <member arrayDimensions="3" name="anEnumArr" type="nonBasic"
            nonBasicTypeName="MyEnum" />
    </struct>
</types>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<types>
    <const name="MAX_COLOR_LEN" type="long" value="255"/>
    <typedef name="MYBOOL" type="boolean"/>
    <enum name="MyEnum">
        <enumerator name="ACE" value="1"/>
        <enumerator name="KING" value="13"/>
        <enumerator name="QUEEN" value="12"/>
    </enum>
    <struct name="PrimitivesType">
        <member name="aString" type="string" stringMaxLength="MAX_COLOR_LEN"/>
        <member name="aLong" type="long"/>
        <member name="aShort" type="short"/>
        <member name="aUnsignedShort" type="unsignedShort"/>
        <member name="aUnsignedLong" type="unsignedLong"/>
        <member name="aFloat" type="float"/>
        <member name="aDouble" type="double"/>
        <member name="aBoolean" type="boolean"/>
        <member name="aChar" type="char"/>
        <member name="aWchar" type="wchar"/>
        <member name="aLongLong" type="longLong"/>
        <member name="aUnsignedLongLong" type="unsignedLongLong"/>
        <member name="anEnum" type="nonBasic" nonBasicTypeName="MyEnum"/>
        <member sequenceMaxLength="3" name="anEnumSeq" type="nonBasic"
            nonBasicTypeName="MyEnum"/>
        <member arrayDimensions="3" name="anEnumArr" type="nonBasic"
            nonBasicTypeName="MyEnum"/>
    </struct>
    <struct name="ComplexType">
        <member name="aString" type="string" stringMaxLength="MAX_COLOR_LEN"/>
        <member name="aLong" type="long"/>
        <member name="aShort" type="short"/>
        <member name="anOctet" type="octet"/>
        <member name="aUnsignedShort" type="unsignedShort"/>
        <member name="aUnsignedLong" type="unsignedLong"/>
        <member name="aFloat" type="float"/>
        <member name="aDouble" type="double"/>
        <member name="aBoolean" type="boolean"/>
        <member name="aChar" type="char"/>
        <member name="aWchar" type="wchar"/>
        <member name="aLongLong" type="longLong"/>
        <member name="aUnsignedLongLong" type="unsignedLongLong"/>
        <member name="anAlias" type="nonBasic" nonBasicTypeName="MYBOOL"/>
        <member name="aComplexType" type="nonBasic" nonBasicTypeName="PrimitivesType"/>
        <member name="anEnum" type="nonBasic" nonBasicTypeName="MyEnum"/>
        <member sequenceMaxLength="3" name="anEnumSeq" type="nonBasic"
            nonBasicTypeName="MyEnum"/>
        <member arrayDimensions="3" name="anEnumArr" type="nonBasic"
            nonBasicTypeName="MyEnum"/>
    </struct>
</types>' http://##HOST##/dds/rest1/types

3.2 QoS Libraries and QoS Profiles Definition

The QoS section of the XML file provides a way to define QoS libraries and QoS profiles that can be used to configure different QoS settings in your applications.

In this example, we create a QoS library with an empty QoS profile to provide a placeholder in which QoS settings can be specified. Using this empty profile results in the default DDS QoS being used. To create a new QoS library, call POST on /qos_libraries and pass in its XML representation in the body of the HTTP request:

HTTP Request
POST /dds/rest1/qos_libraries HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 105
Cache-Control: no-cache

<qos_library name="qosLibrary">
    <qos_profile name="DefaultProfile">
    </qos_profile>
</qos_library>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<qos_library name="qosLibrary">
    <qos_profile name="DefaultProfile">
    </qos_profile>
</qos_library>' http://##HOST##/dds/rest1/qos_libraries

To create new QoS profiles within the created QoS library, call POST on /qos_libraries/qosLibrary/qos_profiles and pass in its XML representation in the body of the HTTP request.

HTTP Request
POST /dds/rest1/qos_libraries/qosLibrary/qos_profiles HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 50
Cache-Control: no-cache

<qos_profile name="AnotherProfile">
</qos_profile>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<qos_profile name="AnotherProfile">
</qos_profile>' http://##HOST##/dds/rest1/qos_libraries/qosLibrary/qos_profiles

3.3 Application Definition

To illustrate the creation of DDS entities using separate requests, let’s create an empty application to which we will add subsequent elements.

HTTP Request
POST /dds/rest1/applications HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 40
Cache-Control: no-cache

<application name="ComplexApplication"/>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<application name="ComplexApplication"/>' http://##HOST##/dds/rest1/applications

We are going to create two DomainParticipants within ComplexApplication : DefaultParticipant and SHMEMParticipant. Each participant inherits from a different QoS profile using the base_name attribute of the <participant_qos> tag. Note that base_name takes the fully qualified name of the QoS profile, i.e., <qos_library>::<qos_profile>.

You can override these values by specifying different QoS settings within the <participant_qos> tag. In this example, we override the value of TransportBuiltinQosPolicy to specify the transports that DomainParticipants register automatically when they are enabled.

Creating DefaultParticipant:

HTTP Request
POST /dds/rest1/applications/ComplexApplication/domain_participants HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 248
Cache-Control: no-cache

<domain_participant name="DefaultParticipant">
    <participant_qos base_name="qosLibrary::DefaultProfile">
        <transport_builtin>
            <mask>UDPv4 | SHMEM</mask>
        </transport_builtin>
    </participant_qos>
</domain_participant>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<domain_participant name="DefaultParticipant">
    <participant_qos base_name="qosLibrary::DefaultProfile">
        <transport_builtin>
            <mask>UDPv4 | SHMEM</mask>
        </transport_builtin>
    </participant_qos>
</domain_participant>' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants

Creating SHMEMParticipant

HTTP Request
POST /dds/rest1/applications/ComplexApplication/domain_participants HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 238
Cache-Control: no-cache

<domain_participant name="SHMEMParticipant">
    <participant_qos base_name="qosLibrary::AnotherProfile">
        <transport_builtin>
            <mask>SHMEM</mask>
        </transport_builtin>
    </participant_qos>
</domain_participant>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<domain_participant name="SHMEMParticipant">
    <participant_qos base_name="qosLibrary::AnotherProfile">
        <transport_builtin>
            <mask>SHMEM</mask>
        </transport_builtin>
    </participant_qos>
</domain_participant>' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants

In the rest of the example we will only be using DefaultParticipant, so we can delete the SHMEMParticipant we just created:

HTTP Request
DELETE /dds/rest1/applications/ComplexApplication/domain_participants/SHMEMParticipant HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Cache-Control: no-cache
Curl
curl -X DELETE -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants/SHMEMParticipant

Before creating Topics and other DDS entities, we need to register ComplexType. Since Web Integration Service uses the Dynamic Data API, we need to set kind="dynamicData" in the registered type XML representation:

HTTP Request
POST /dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/registered_types HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 77
Cache-Control: no-cache

<register_type name="ComplexType" kind="dynamicData" type_ref="ComplexType"/>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<register_type name="ComplexType" kind="dynamicData" type_ref="ComplexType"/>' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/registered_types

Now we are going to create a ComplexTopic associated with ComplextType. Call POST on /applications/ComplexApplication/domain_participants/DefaultParticipant/topics and pass in the XML representation of the Topic in the body of the HTTP request. In this case we will modify <topic_qos> to set the ReliabilityQosPolicy kind to RELIABLE_RELIABILITY_QOS:

HTTP Request
POST /dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/topics HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 235
Cache-Control: no-cache

<topic register_type_ref="ComplexType" name="ComplexTopic">
    <topic_qos base_name="qosLibrary::DefaultProfile">
        <reliability>
            <kind>RELIABLE_RELIABILITY_QOS</kind>
        </reliability>
    </topic_qos>
</topic>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache"  -d '<topic register_type_ref="ComplexType" name="ComplexTopic">
    <topic_qos base_name="qosLibrary::DefaultProfile">
        <reliability>
            <kind>RELIABLE_RELIABILITY_QOS</kind>
        </reliability>
    </topic_qos>
</topic>' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/topics

To create a new Publisher within DefaultParticipant, call POST on /applications/ComplexApplication/domain_participants/DefaultParticipant/publishers and pass in its XML representation in the body of the HTTP request:

HTTP Request
POST /dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/publishers HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 36
Cache-Control: no-cache

<publisher name="ComplexPublisher"/>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<publisher name="ComplexPublisher"/>' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/publishers

To create a DataWriter of ComplexTopic, call POST on /applications/ComplexApplication/domain_participants/DefaultParticipant/publishers/ComplexPublisher/data_writers and pass in its XML representation in the body of the HTTP request. In this case we modify the DataWriter QoS and set the ReliabilityQosPolicy kind to RELIABLE_RELIABILITY_QOS:

HTTP Request
POST /dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/publishers/ComplexPublisher/data_writers HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 247
Cache-Control: no-cache

<data_writer topic_ref="ComplexTopic" name="ComplexDW">
    <datawriter_qos base_name="qosLibrary::AnotherProfile">
        <reliability>
            <kind>RELIABLE_RELIABILITY_QOS</kind>
        </reliability>
    </datawriter_qos>
</data_writer>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<data_writer topic_ref="ComplexTopic" name="ComplexDW">
    <datawriter_qos base_name="qosLibrary::AnotherProfile">
        <reliability>
            <kind>RELIABLE_RELIABILITY_QOS</kind>
        </reliability>
    </datawriter_qos>
</data_writer>' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/publishers/ComplexPublisher/data_writers

To create a new Subscriber within DefaultParticipant, call POST on /applications/ComplexApplication/domain_participants/DefaultParticipant/subscribers and pass in its XML representation in the body of the HTTP request:

HTTP Request
POST /dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/subscribers HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 38
Cache-Control: no-cache

<subscriber name="ComplexSubscriber"/>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<subscriber name="ComplexSubscriber"/>' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/subscribers

To create a DataReader of ComplexTopic, call POST on /applications/ComplexApplication/domain_participants/DefaultParticipant/subscribers/ComplexSubscriber/data_readers and pass in its XML representation in the body of the HTTP request. In this case we modify the DataReader QoS and set the ReliabilityQosPolicy kind to RELIABLE_RELIABILITY_QOS:

HTTP Request
POST /dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/subscribers/ComplexSubscriber/data_readers HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 276
Cache-Control: no-cache

<data_reader topic_ref="ComplexTopic" name="ComplexDR">
    <datareader_qos>
        <reliability>
            <kind>RELIABLE_RELIABILITY_QOS</kind>
        </reliability>
        <history>
            <depth>10</depth>
        </history>
    </datareader_qos>
</data_reader>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<data_reader topic_ref="ComplexTopic" name="ComplexDR">
    <datareader_qos>
        <reliability>
            <kind>RELIABLE_RELIABILITY_QOS</kind>
        </reliability>
        <history>
            <depth>10</depth>
        </history>
    </datareader_qos>
</data_reader>
' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/subscribers/ComplexSubscriber/data_readers

3.4 Sending and Receiving Complex Samples

Once the DataWriter is available, you can start writing ComplexType data samples. The XML representation of a ComplexType data sample follows the structure of the previous examples, but introduces the concept of complex members (e.g., nested structs, sequences, or arrays). We also introduce the concept of enums. Note that when writing enums you need to provide the integer representation of the enumeration value.

To write a new ComplexType data sample, POST the XML sample representation on /applications/ComplexApplication/domain_participants/DefaultParticipant/publishers/ComplexPublisher/data_writers/ComplexDW.

HTTP Request
POST /dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/publishers/ComplexPublisher/data_writers/ComplexDW HTTP/1.1
Host: ##HOST##
Content-Type: application/dds-web+xml
Content-Length: 1296
Cache-Control: no-cache

<data>
  <aString>This is a string!</aString>
  <aLong>-123456789</aLong>
  <aShort>125</aShort>
  <anOctet>0xff</anOctet>
  <aUnsignedShort>5</aUnsignedShort>
  <aUnsignedLong>123456789</aUnsignedLong>
  <aFloat>3.14</aFloat>
  <aDouble>3.1592</aDouble>
  <aBoolean>false</aBoolean>
  <aChar>a</aChar>
  <aWchar>~</aWchar>
  <aLongLong>-4215479752654469884268442</aLongLong>
  <aUnsignedLongLong>14</aUnsignedLongLong>
  <anEnumSeq>
    <item>13</item>
    <item>12</item>
    <item>1</item>
  </anEnumSeq>
  <anEnumArr>
    <item>1</item>
    <item>12</item>
    <item>13</item>
  </anEnumArr>
  <aComplexType>
    <aString>Another string!</aString>
    <aLong>-123456789</aLong>
    <aShort>125</aShort>
    <aUnsignedShort>5</aUnsignedShort>
    <aUnsignedLong>123456789</aUnsignedLong>
    <aFloat>3.14</aFloat>
    <aDouble>3.1592</aDouble>
    <aBoolean>true</aBoolean>
    <aChar>a</aChar>
    <aWchar>~</aWchar>
    <aLongLong>-4215479752654469884268442</aLongLong>
    <aUnsignedLongLong>21</aUnsignedLongLong>
    <anEnumSeq>
      <item>13</item>
      <item>12</item>
      <item>1</item>
    </anEnumSeq>
    <anEnumArr>
      <item>1</item>
      <item>12</item>
      <item>13</item>
    </anEnumArr>
  </aComplexType>
  <anEnum>12</anEnum>
</data>
Curl
curl -X POST -H "Content-Type: application/dds-web+xml" -H "Cache-Control: no-cache" -d '<data>
  <aString>This is a string!</aString>
  <aLong>-123456789</aLong>
  <aShort>125</aShort>
  <anOctet>0xff</anOctet>
  <aUnsignedShort>5</aUnsignedShort>
  <aUnsignedLong>123456789</aUnsignedLong>
  <aFloat>3.14</aFloat>
  <aDouble>3.1592</aDouble>
  <aBoolean>false</aBoolean>
  <aChar>a</aChar>
  <aWchar>~</aWchar>
  <aLongLong>-4215479752654469884268442</aLongLong>
  <aUnsignedLongLong>14</aUnsignedLongLong>
  <anEnumSeq>
    <item>13</item>
    <item>12</item>
    <item>1</item>
  </anEnumSeq>
  <anEnumArr>
    <item>1</item>
    <item>12</item>
    <item>13</item>
  </anEnumArr>
  <aComplexType>
    <aString>Another string!</aString>
    <aLong>-123456789</aLong>
    <aShort>125</aShort>
    <aUnsignedShort>5</aUnsignedShort>
    <aUnsignedLong>123456789</aUnsignedLong>
    <aFloat>3.14</aFloat>
    <aDouble>3.1592</aDouble>
    <aBoolean>true</aBoolean>
    <aChar>a</aChar>
    <aWchar>~</aWchar>
    <aLongLong>-4215479752654469884268442</aLongLong>
    <aUnsignedLongLong>21</aUnsignedLongLong>
    <anEnumSeq>
      <item>13</item>
      <item>12</item>
      <item>1</item>
    </anEnumSeq>
    <anEnumArr>
      <item>1</item>
      <item>12</item>
      <item>13</item>
    </anEnumArr>
  </aComplexType>
  <anEnum>12</anEnum>        
</data>' http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/publishers/ComplexPublisher/data_writers/ComplexDW

To read samples, call GET on /applications/ComplexApplication/domain_participants/DefaultParticipant/subscribers/ComplexSubscriber/data_readers/ComplexDR:

HTTP Request
GET /dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/subscribers/ComplexSubscriber/data_readers/ComplexDR HTTP/1.1
Host: ##HOST##
Cache-Control: no-cache
Curl
curl -X GET -H "Cache-Control: no-cache" http://##HOST##/dds/rest1/applications/ComplexApplication/domain_participants/DefaultParticipant/subscribers/ComplexSubscriber/data_readers/ComplexDR

The response contains the sequence of read samples, including sample information and sample data:

HTTP/1.1 200 Samples read
Content-Type: application/dds-web+xml
Cache-Control: no-cache
Content-Length: 1535
Date: Fri, 04 Mar 2016 19:00:36 GMT

<read_sample_seq>
    <sample>
        <read_sample_info>
            <source_timestamp>
                <sec>1457118026</sec>
                <nanosec>979762998</nanosec>
            </source_timestamp>
            <valid_data>true</valid_data>
            <instance_handle>
                0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
            </instance_handle>
            <instance_state>ALIVE</instance_state>
            <sample_state>NOT_READ</sample_state>
            <view_state>NEW</view_state>
        </read_sample_info>
        <data>
            <aString>This is a string!</aString>
            <aLong>-123456789</aLong>
            <aShort>125</aShort>
            <anOctet>0xff</anOctet>
            <aUnsignedShort>5</aUnsignedShort>
            <aUnsignedLong>123456789</aUnsignedLong>
            <aFloat>3.140000</aFloat>
            <aDouble>3.159200</aDouble>
            <aBoolean>false</aBoolean>
            <aChar>a</aChar>
            <aWchar>0x00000000</aWchar>
            <aLongLong>-9223372036854775808</aLongLong>
            <aUnsignedLongLong>14</aUnsignedLongLong>
            <anAlias>false</anAlias>
            <aComplexType>
                <aString>Another string!</aString>
                <aLong>-123456789</aLong>
                <aShort>125</aShort>
                <aUnsignedShort>5</aUnsignedShort>
                <aUnsignedLong>123456789</aUnsignedLong>
                <aFloat>3.140000</aFloat>
                <aDouble>3.159200</aDouble>
                <aBoolean>true</aBoolean>
                <aChar>a</aChar>
                <aWchar>0x00000000</aWchar>
                <aLongLong>-9223372036854775808</aLongLong>
                <aUnsignedLongLong>21</aUnsignedLongLong>
                <anEnum>1</anEnum>
                <anEnumSeq>
                    <item>13</item>
                    <item>12</item>
                    <item>1</item>
                </anEnumSeq>
                <anEnumArr>
                    <item>1</item>
                    <item>12</item>
                    <item>13</item>
                </anEnumArr>
            </aComplexType>
            <anEnum>12</anEnum>
            <anEnumSeq>
                <item>13</item>
                <item>12</item>
                <item>1</item>
            </anEnumSeq>
            <anEnumArr>
                <item>1</item>
                <item>12</item>
                <item>13</item>
            </anEnumArr>
        </data>
    </sample>
</read_sample_seq>