Tasks #1418

Describe Recommend Way of using Domain Classes and Converters in the manual

Added by J. Wienke about 11 years ago. Updated over 6 years ago.

Status:NewStart date:02/14/2013
Priority:NormalDue date:
Assignee:-% Done:

0%

Category:Documentation
Target version:rsb-0.18

Description

How to deal with custom data types, protobuf types, rst etc.

Fragments from the wiki:

Note: more basic explanations of RSB's converters can be found here and here. However, the approaches described there, although seemingly less complex, have some problems, and should not be applied in production code.

Introduction

Using automatically generated protocol buffer messages for serialization and network communication has several advantages:

  • IDL-defined message format (as opposed to an informal "definition" through a particular implementation)
  • Proper handling of machine Endianess
  • Proper handling of machine word sizes
  • Some degree of data validation
  • Introspection support
  • Generated data-holder classes and (de)serializers
    • Available in multiple programming languages without additional effort
    • Inter-language consistency of data-holder classes and serialized representations

It may even seem sensible to use the generated protocol buffer message classes as domain classes as well. However, Google's protocol buffer tutorial advises against this (see "Protocol Buffers and O-O Design" in the protocol buffer tutorial).

History

#1 Updated by J. Moringen over 10 years ago

  • Target version changed from rsb-0.10 to rsb-0.11

#2 Updated by J. Moringen about 10 years ago

  • Target version changed from rsb-0.11 to rsb-0.12

#3 Updated by J. Wienke about 9 years ago

  • Target version changed from rsb-0.12 to rsb-0.13

#4 Updated by J. Moringen about 8 years ago

  • Target version changed from rsb-0.13 to rsb-0.14

#5 Updated by J. Moringen about 8 years ago

  • Target version changed from rsb-0.14 to rsb-0.15

#6 Updated by J. Moringen almost 8 years ago

  • Target version changed from rsb-0.15 to rsb-0.16

#7 Updated by J. Moringen about 7 years ago

  • Target version changed from rsb-0.16 to rsb-0.17

#8 Updated by J. Moringen over 6 years ago

  • Target version changed from rsb-0.17 to rsb-0.18

Also available in: Atom PDF