-
Notifications
You must be signed in to change notification settings - Fork 519
Intermediate Representation
SBE uses an Intermediate Representation (IR) between data layout mechanisms and code generators and on-the-fly decoders. SBE Tool can generate serialised IR via the sbe.generate.ir
option (false by default). This generates a file, conventionally using the .sbeir
extension, that can serve as input to SBE Tool instead of XML for code generation. In addition, the On-The-Fly (OTF) decoder, requires serialised IR for decoding. In this section, we will explore how to generate IR and use it, as well as how IR works.
NOTE: it is our hope that serialised IR can form the foundation for a tool chain approach.
Generating serialised IR is straight forward with the SBE Tool. Simply set sbe.generate.ir
to true. The SBE tool will to write the serialised IR file using the same name as the input file with the .sbeir
suffix. Here is an example.
$ java -Dsbe.generate.ir=true -jar sbe-all-1.12.2.jar <message-declarations-file.xml>
Serialized IR can act as input to the SBE Tool for code generation. This is done by using the file extension .sbeir
instead of .xml
. Here is an example.
$ java -jar sbe-all-1.12.2.jar <message-declarations-file.sbeir>
Therefore it is possible to use serialized IR as a means to pass around "compiled" representations.
IR is serialised via SBE itself. The schema for SBE IR is here.
The format of a serialised IR file is a simple sequence, or list, of "Tokens". Each Token is one of the TokenCodec
messages in the schema above. The first sequence of Tokens in the file is the message header for the messages. This is a composite, usually with the name messageHeader
that holds the following three encodings: blockLength
, templateId
, and version
. After the header is one or more messages represented by sequences of Tokens. At a high level, a serialised IR file looks like this:
Header (List of Tokens) | Message(s) (List of Tokens) |
Each Token has several fields, one of which is the Signal
. See here and here for more
detail on the Token elements. The header would be expanded to look something like below.
BEGIN_COMPOSITE name="messageHeader" |
ENCODING name="blockLength" type=uint16 size=2 offset=0 |
ENCODING name="templateId" type=uint16 size=2 offset=2 |
ENCODING name="version" type=uint8 size=1 offset=4 |
END_COMPOSITE name="messageHeader" |
Each message is similar in that it is started with BEGIN_MESSAGE
and ended with END_MESSAGE
.
Careful readers may realise that it is simple to add more messages to an IR file by concatenation. Just concatenate a list of Tokens to the end of the file. This is intentional and provides a simple mechanism for composition.