flatbuffers

Maven artifacts for use with flatbuffers.

The Google flatbuffers project team do not publish artifacts of any sort for flatbuffers to repositories like Maven Central. Users are expected to build from source. This project shortcuts these actions for you and allows you to do all using Maven artifacts from Maven Central.

Supports flatbuffers 1.3, 1.4, 1.5, 1.6, 1.7, 1.8, 1.10, 1.12, 2.0.3
Supports Java 1.6+ (Java 8 for 1.10+)

Update: From 2.0.3, the Google flatbuffers project started publishing binaries for Linux, OSX and Windows for download from their Releases page. This project continues to package them up as Maven artifacts.

Status: released to Maven Central

Versioning

The artifacts carry versions like 1.6.0.3 which correspond to a 0.3 release of the flatbuffers 1.6.0 release (from google).

Current versions:

flatbuffers-compiler, flatbuffers-java	Supports
1.3.0.1	1.3
1.4.0.1	1.4
1.5.0.3	1.5
1.6.0.3	1.6
1.7.0.1	1.7
1.8.0.1	1.8
1.10.0.2	1.10
1.12.0.1	1.12
2.0.3.1	2.0.3

flatbuffers-compiler

Contains compiled binaries to generate java classes (and other) from flatbuffers schema files:

linux (x86 64-bit) (tar.gz artifact)
osx (tar.gz artifact) (from 1.6, 1.7 will be supported in 1.7.0.2+)
windows (zip artifact)

This artifact is used with maven-dependency-plugin to unpack, maven-exec-plugin to execute and build-helper-maven-plugin to add the generated source to the build path. See example project for details.

flatbuffers-java

Runtime library artifact for use with flatbuffers generated java classes.

<dependency>
    <groupId>com.google.flatbuffers</groupId>
    <artifactId>flatbuffers-java</artifactId>
    <version>2.0.3</version>
</dependency>

Example usage

See example project which is also used to unit test the artifacts.

Essentially you add this block of xml to the build/plugins section of your pom.xml to generate flatbuffers classes (java):

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>2.10</version>
    <executions>
        <execution>
            <id>unpack</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>unpack</goal>
            </goals>
            <configuration>
                <artifactItems>
                    <artifactItem>
                        <groupId>com.github.davidmoten</groupId>
                        <artifactId>flatbuffers-compiler</artifactId>
                        <version>2.0.3.1</version>
                        <type>tar.gz</type>
                        <classifier>distribution-linux</classifier>
                        <overWrite>true</overWrite>
                        <outputDirectory>${project.build.directory}</outputDirectory>
                    </artifactItem>
                </artifactItems>
            </configuration>
        </execution>
    </executions>
</plugin>
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>exec-maven-plugin</artifactId>
    <version>1.6.0</version>
    <executions>
        <execution>
            <goals>
                <goal>exec</goal>
            </goals>
            <phase>generate-sources</phase>
        </execution>
    </executions>
    <configuration>
        <executable>${project.build.directory}/bin/flatc</executable>
        <workingDirectory>${fbs.sources}</workingDirectory>
        <arguments>
            <argument>--java</argument>
            <argument>--gen-mutable</argument>
            <argument>-o</argument>
            <argument>${fbs.generated.sources}</argument>
            <argument>monster.fbs</argument>
        </arguments>
    </configuration>
</plugin>
<plugin>
    <groupId>org.codehaus.mojo</groupId>
    <artifactId>build-helper-maven-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <id>add-source</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>add-source</goal>
            </goals>
            <configuration>
                <sources>
                    <source>${fbs.generated.sources}</source>
                </sources>
            </configuration>
        </execution>
    </executions>
</plugin>

There are a couple of properties mentioned in the xml block above. I set them to these values for my projects:

<properties>
    <fbs.sources>${basedir}/src/main/fbs</fbs.sources>
    <fbs.generated.sources>${project.build.directory}/generated-sources/java</fbs.generated.sources>
</properties>

To use the generated classes you'll need the runtime dependency flatbuffers-java. Add the following to the dependencies section in pom.xml:

<dependency>
    <groupId>com.github.davidmoten</groupId>
    <artifactId>flatbuffers-java</artifactId>
    <version>1.12.0.1</version>
</dependency>

How to build the binaries that are placed in this artifact

You don't need to do this (it's why this artifact exists!):

sudo apt-get install cmake
git clone https://github.com/google/flatbuffers.git
git checkout vN.N.N

## for flatbuffers < 1.9.0
cd flatbuffers
mkdir build
cd build
cmake ..

## for flatbuffers >= 1.9.0 on xenial
cmake .
make
mkdir bin
cp flat* bin
cp libflat* bin

The flatbuffers/build/bin directory now contains the binaries that are placed in the bin directory of this artifact.

In addition, the java source classes need to be copied from flatbuffers/java(google repo) into flatbuffers/flatbuffers-java/src/main/java.

To generate java sources manually here's an example:

cd src/fbs
../../bin/flatc --java --gen-mutable -o ../../target/generated-sources/java monster.fbs

For project maintainers

To update this project with executables for a new version of flatbuffers:

copy the files in flatbuffers/build/bin above to flatbuffers-compiler/bin/linux/
download flatc_windows_exe.zip from releases, unpack it and copy flatc.exe to flatbuffers-compiler/bin/windows/
update the google flatbuffers-java dependency in example/pom.xml to latest
build and release!

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

davidmoten / flatbuffers