RTI Connext Java API  Version 6.0.0
 All Classes Namespaces Functions Variables Groups Pages
BytesTypeSupport Class Reference

<<interface>> com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type support. More...

Inheritance diagram for BytesTypeSupport:
TypeSupport

Public Member Functions

long serialize_to_cdr_buffer (byte[] buffer, long length, Bytes src)
 <<extension>> Serializes the input sample into a CDR buffer of octets.
 
long serialize_to_cdr_buffer (byte[] buffer, long length, Bytes src, short representation)
 <<extension>> Serializes the input sample into a buffer of octets.
 
String data_to_string (Bytes src, PrintFormatProperty property)
 <<extension>> Get the string representation of an input sample.
 
String data_to_string (Bytes src)
 <<extension>> Get the string representation of an input sample.
 
void deserialize_from_cdr_buffer (Bytes dst, byte[] buffer, long length)
 <<extension>> Deserializes a sample from a buffer of octets.
 

Static Public Member Functions

static void register_type (DomainParticipant participant, String type_name)
 Allows an application to communicate to RTI Connext the existence of the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes data type.
 
static void unregister_type (DomainParticipant participant, String type_name)
 Allows an application to unregister the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes data type from RTI Connext. After calling unregister_type, no further communication using this type is possible.
 
static String get_type_name ()
 Get the default name for the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type.
 

Detailed Description

<<interface>> com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type support.

Member Function Documentation

static void register_type ( DomainParticipant  participant,
String  type_name 
)
static

Allows an application to communicate to RTI Connext the existence of the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes data type.

By default, The com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes built-in type is automatically registered when a DomainParticipant is created using the type_name returned by com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport.get_type_name. Therefore, the usage of this function is optional and it is only required when the automatic built-in type registration is disabled using the participant property "dds.builtin_type.auto_register".

This method can also be used to register the same com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport with a com.rti.dds.domain.DomainParticipant using different values for the type_name.

If register_type is called multiple times with the same com.rti.dds.domain.DomainParticipant and type_name, the second (and subsequent) registrations are ignored by the operation.

Parameters
participant<<in>> the com.rti.dds.domain.DomainParticipant to register the data type com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes with. Cannot be null.
type_name<<in>> the type name under with the data type com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes is registered with the participant; this type name is used when creating a new com.rti.dds.topic.Topic. (See com.rti.dds.domain.DomainParticipant.create_topic.) The name may not be null or longer than 255 characters.
Exceptions
Oneof the Standard Return Codes, com.rti.dds.infrastructure.RETCODE_PRECONDITION_NOT_MET or com.rti.dds.infrastructure.RETCODE_OUT_OF_RESOURCES.
MT Safety:
UNSAFE on the FIRST call. It is not safe for two threads to simultaneously make the first call to register a type. Subsequent calls are thread safe.
See Also
com.rti.dds.domain.DomainParticipant.create_topic
static void unregister_type ( DomainParticipant  participant,
String  type_name 
)
static

Allows an application to unregister the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes data type from RTI Connext. After calling unregister_type, no further communication using this type is possible.

Precondition
The com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type with type_name is registered with the participant and all com.rti.dds.topic.Topic objects referencing the type have been destroyed. If the type is not registered with the participant, or if any com.rti.dds.topic.Topic is associated with the type, the operation will fail with com.rti.dds.infrastructure.RETCODE_ERROR.
Postcondition
All information about the type is removed from RTI Connext. No further communication using this type is possible.
Parameters
participant<<in>> the com.rti.dds.domain.DomainParticipant to unregister the data type com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes from. Cannot be null.
type_name<<in>> the type name under with the data type com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes is registered with the participant. The name should match a name that has been previously used to register a type with the participant. Cannot be null.
Exceptions
Oneof the Standard Return Codes, com.rti.dds.infrastructure.RETCODE_BAD_PARAMETER or com.rti.dds.infrastructure.RETCODE_ERROR
MT Safety:
SAFE.
See Also
com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport.register_type
static String get_type_name ( )
static

Get the default name for the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type.

Can be used for calling com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport.register_type or creating com.rti.dds.topic.Topic.

Returns
default name for the com.rti.dds.type.builtin.com.rti.dds.type.builtin.Bytes type.
See Also
com.rti.dds.type.builtin.com.rti.dds.type.builtin.BytesTypeSupport.register_type
com.rti.dds.domain.DomainParticipant.create_topic
long serialize_to_cdr_buffer ( byte[]  buffer,
long  length,
Bytes  src 
)

<<extension>> Serializes the input sample into a CDR buffer of octets.

See Also
com.rti.ndds.example.FooTypeSupport.serialize_to_cdr_buffer
long serialize_to_cdr_buffer ( byte[]  buffer,
long  length,
Bytes  src,
short  representation 
)

<<extension>> Serializes the input sample into a buffer of octets.

See Also
com.rti.ndds.example.FooTypeSupport.serialize_to_cdr_buffer
String data_to_string ( Bytes  src,
PrintFormatProperty  property 
)

<<extension>> Get the string representation of an input sample.

See Also
com.rti.ndds.example.FooTypeSupport.data_to_string
String data_to_string ( Bytes  src)

<<extension>> Get the string representation of an input sample.

Use the default values for com.rti.dds.topic.PrintFormatProperty to create the output string.

See Also
com.rti.ndds.example.FooTypeSupport.data_to_string
void deserialize_from_cdr_buffer ( Bytes  dst,
byte[]  buffer,
long  length 
)

<<extension>> Deserializes a sample from a buffer of octets.

See Also
com.rti.ndds.example.FooTypeSupport.deserialize_from_cdr_buffer

RTI Connext Java API Version 6.0.0 Copyright © Sun Mar 3 2019 Real-Time Innovations, Inc