java高效序列化,MessagePack for Java 是一个高效的二进制序列化格式

MessagePack for Java

MessagePack is a binary serialization format. If you need a fast and compact alternative of JSON, MessagePack is your friend. For example, a small integer can be encoded in a single byte, and short strings only need a single byte prefix + the original byte array. MessagePack implementation is already available in various languages (See also the list in http://msgpack.org) and works as a universal data format.

MessagePack v7 (or later) is a faster implementation of the previous version v06, and supports all of the message pack types, including extension format.

Quick Start

For Maven users:

org.msgpack

msgpack-core

(version)

For sbt users:

libraryDependencies += "org.msgpack" % "msgpack-core" % "(version)"

For gradle users:

repositories {

mavenCentral()

}

dependencies {

compile 'org.msgpack:msgpack-core:(version)'

}

Integration with Jackson ObjectMapper (jackson-databind)

msgpack-java supports serialization and deserialization of Java objects through jackson-databind. For details, see msgpack-jackson/README.md. The template-based serialization mechanism used in v06 is deprecated.

For MessagePack Developers

msgpack-java uses sbt for building the projects. For the basic usage of sbt, see:

Coding style

Basic sbt commands

Enter the sbt console:

$ ./sbt

Here is a list of sbt commands for daily development:

> ~compile # Compile source codes

> ~test:compile # Compile both source and test codes

> ~test # Run tests upon source code change

> ~testOnly *MessagePackTest # Run tests in the specified class

> ~testOnly *MessagePackTest -- -n prim # Run the test tagged as "prim"

> project msgpack-core # Focus on a specific project

> package # Create a jar file in the target folder of each project

> findbugs # Produce findbugs report in target/findbugs

> jacoco:cover # Report the code coverage of tests to target/jacoco folder

> jcheckStyle # Run check style

> ;scalafmt;test:scalafmt;scalafmtSbt # Reformat Scala codes

Publishing

> publishLocal # Install to local .ivy2 repository

> publishM2 # Install to local .m2 Maven repository

> publish # Publishing a snapshot version to the Sonatype repository

> release # Run the release procedure (set a new version, run tests, upload artifacts, then deploy to Sonatype)

# If you need to perform the individual release steps manually, use the following commands:

> publishSigned # Publish GPG signed artifacts to the Sonatype repository

> sonatypeRelease # Publish to the Maven Central (It will be synched within less than 4 hours)

For publishing to Maven central, msgpack-java uses sbt-sonatype plugin. Set Sonatype account information (user name and password) in the global sbt settings. To protect your password, never include this file in your project.

$HOME/.sbt/(sbt-version)/sonatype.sbt

credentials += Credentials("Sonatype Nexus Repository Manager",

"oss.sonatype.org",

"(Sonatype user name)",

"(Sonatype password)")

Project Structure

msgpack-core # Contains packer/unpacker implementation that never uses third-party libraries

msgpack-jackson # Contains jackson-dataformat-java implementation