Sbe Tool Guide

David Arnold edited this page Oct 21, 2016 · 30 revisions

The SBE tool is a command line utility that can be used to generate codecs and validate message declaration schemas. The tool is written in Java and can run as an executable JAR file, e.g:

$ java -jar sbe-all-1.5.2.jar <message-declarations-file.xml>

The tool will accept options using the system property option format as follows:

$ java [-Doption=value] -jar sbe-all-1.5.2.jar <message-declarations-file.xml>

The tool supports the following options:

  • sbe.validation.xsd: Use XSD to validate or not. XSD filename should be the provided option.
  • sbe.validation.stop.on.error: Should the parser stop on first error encountered? Defaults to false.
  • sbe.validation.warnings.fatal: Are warnings in parsing considered fatal? Defaults to false.
  • sbe.validation.suppress.output: Should the parser suppress output during validation? Defaults to false.
  • sbe.generate.stubs: Generate stubs or not. Defaults to true.
  • Generate IR or not. Defaults to false.
  • Target language for code generation, defaults to Java (also supports CPP).
  • sbe.output.dir: Target directory for output generation, defaults to current directory.
  • Namespace to be used for generated code. Equates package for Java. If not provided then the package attribute from the schema will be used.
  • Buffer type to be used for the encoder stubs. This type needs to mutate the underlying buffer.
  • Buffer type to be used for the decoder stubs. This type only reads the underlying buffer.
  • Should the GroupOrder annotation be generated, defaults to false.
  • sbe.cpp.namespaces.collapse: Boolean to turn on or off collapsing of nested namespaces in generated C++ stubs. Defaults to false.
  • sbe.keyword.append.token: String to append to schema tokens that collide with reserved words in the target language.

The SBE tool can be used with Maven see