twx7d3 / simple-binary-encoding

Simple Binary Encoding (SBE)

Simple Binary Encoding (SBE)

SBE is OSI layer 6 presentation for encoding and decoding application messages in binary format for low-latency applications.

Further details on the background and usage of SBE can be found on the Wiki.

Benchmark tools and information can be found here and run from he root perf-build.xml file.

An XSD for SBE specs can be found here

License (See LICENSE file for full license)

Copyright 2013 Real Logic Limited

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Binaries

Binaries and dependency information for Maven, Ivy, Gradle, and others can be found at http://search.maven.org.

Example for Maven:

<dependency>
    <groupId>uk.co.real-logic</groupId>
    <artifactId>sbe</artifactId>
    <version>1.0-RC2</version>
</dependency>

For .NET, you will find the binaries on NuGet

Search for 'SBE' in NuGet or run the following command line in the NuGet console

Install-Package Adaptive.SBE

Directory Layout

Main source code

main

Unit tests

test

Examples of usage

examples

Build

Full clean build:

$ ant

Run the Java examples

$ ant examples:java

Installing into a local maven (.m2) repository

$ ant maven.install

Distribution

Jars for the executable, source, and javadoc can be found in

target/dist

Android Build

In order to build the android binaries you need to run the android:dist target

$ ant android:dist

As a prerequisite, you need Android SDK to be installed and the path needs to be configured inside build-local.properties file. You need at least Android target 19 (it comes with Java 7 support) and Android build tools version at least 20.0.0. E.g.

android.sdk.dir=/opt/android-sdk-linux
android.target=android-19
android.build.tools.version=20.0.0

Android jars for the codec, source, and javadoc can be found in

target/dist

C++ Build

NOTE: Linux, Mac OS, and Windows only for the moment. See FAQ. Windows builds have been tested with Visual Studio Express 12.

Dependent build:

$ ant cpp:test

If you have doxygen installed:

$ ant cpp

Run the C++98 examples

$ ant examples:cpp

C# Build

See readme.md in vs2013 directory