kryo java语言编写的高效的二进制对象图形序列化框架

 [](https://github.com/EsotericSoftware/kryo/actions/workflows/ci-workflow.yml) [](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.esotericsoftware%22%20AND%20a%3Akryo) [](https://gitter.im/EsotericSoftware/kryo) [](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:kryo) Kryo is a fast and efficient binary object graph serialization framework for Java. The goals of the project are high speed, low size, and an easy to use API. The project is useful any time objects need to be persisted, whether to a file, database, or over the network. Kryo can also perform automatic deep and shallow copying/cloning. This is direct copying from object to object, not object to bytes to object. This documentation is for Kryo version 5.x. See [the Wiki](https://github.com/EsotericSoftware/kryo/wiki/Kryo-v4) for version 4.x. ## Contact / Mailing list Please use the [Kryo mailing list](https://groups.google.com/forum/#!forum/kryo-users) for questions, discussions, and support. Please limit use of the Kryo issue tracker to bugs and enhancements, not questions, discussions, or support. ## Table of contents - [Recent releases](#recent-releases) - [Installation](#installation) * [With Maven](#with-maven) * [Without Maven](#without-maven) * [Building from source](#building-from-source) - [Quickstart](#quickstart) - [IO](#io) * [Output](#output) * [Input](#input) * [ByteBuffers](#bytebuffers) * [Unsafe buffers](#unsafe-buffers) * [Variable length encoding](#variable-length-encoding) * [Chunked encoding](#chunked-encoding) * [Buffer performance](#buffer-performance) - [Reading and writing objects](#reading-and-writing-objects) * [Round trip](#round-trip) * [Deep and shallow copies](#deep-and-shallow-copies) * [References](#references) + [ReferenceResolver](#referenceresolver) + [Reference limits](#reference-limits) * [Context](#context) * [Reset](#reset) - [Serializer framework](#serializer-framework) * [Registration](#registration) + [ClassResolver](#classresolver) + [Optional registration](#optional-registration) * [Default serializers](#default-serializers) + [Serializer factories](#serializer-factories) * [Object creation](#object-creation) + [InstantiatorStrategy](#instantiatorstrategy) + [Overriding create](#overriding-create) * [Final classes](#final-classes) * [Closures](#closures) * [Compression and encryption](#compression-and-encryption) - [Implementing a serializer](#implementing-a-serializer) * [Serializer references](#serializer-references) + [Nested serializers](#nested-serializers) + [KryoException](#kryoexception) + [Stack size](#stack-size) * [Accepting null](#accepting-null) * [Generics](#generics) * [KryoSerializable](#kryoserializable) * [Serializer copying](#serializer-copying) + [KryoCopyable](#kryocopyable) + [Immutable serializers](#immutable-serializers) - [Kryo versioning and upgrading](#kryo-versioning-and-upgrading) - [Interoperability](#interoperability) - [Compatibility](#compatibility) - [Serializers](#serializers) * [FieldSerializer](#fieldserializer) + [CachedField settings](#cachedfield-settings) + [FieldSerializer annotations](#fieldserializer-annotations) * [VersionFieldSerializer](#versionfieldserializer) * [TaggedFieldSerializer](#taggedfieldserializer) * [CompatibleFieldSerializer](#compatiblefieldserializer) * [BeanSerializer](#beanserializer) * [CollectionSerializer](#collectionserializer) * [MapSerializer](#mapserializer) * [JavaSerializer and ExternalizableSerializer](#javaserializer-and-externalizableserializer) - [Logging](#logging) - [Thread safety](#thread-safety) * [Pooling](#pooling) - [Benchmarks](#benchmarks) - [Links](#links) * [Projects using Kryo](#projects-using-kryo) * [Scala](#scala) * [Clojure](#clojure) * [Objective-C](#objective-c) ## Recent releases * [4.0.3](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-4.0.3) - brings bug fixes and performance improvements for chunked encoding. * [5.5.0](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.5.0) - brings bug fixes and performance improvements. * [5.4.0](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.4.0) - brings bug fixes and performance improvements. * [5.3.0](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.3.0) - brings bug fixes and performance improvements. * [5.2.1](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.2.1) - brings minor bug fixes and improvements. * [5.2.0](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.2.0) - brings bug fixes for `RecordSerializer` and improvements. Important: If you are currently storing serialized `java.util.Record`, please see the [release notes](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.2.0) for upgrade instructions. * [5.1.1](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.1.1) - brings bug fixes for `CompatibleFieldSerializer` and removes dependency from versioned artifact * [5.1.0](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.1.0) - brings support for `java.util.Record` and improved support for older Android versions * [5.0.0](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.0.0) - the final Kryo 5 release fixing many issues and making many long awaited improvements over Kryo 4. Note: For libraries (not applications) using Kryo, there's now a completely self-contained, versioned artifact (for details see [installation](#installation)). For migration from Kryo 4.x see also [Migration to v5](https://github.com/EsotericSoftware/kryo/wiki/Migration-to-v5). ## Installation Kryo publishes two kinds of artifacts/jars: * the default jar (with the usual library dependencies) which is meant for direct usage in applications (not libraries) * a dependency-free, "versioned" jar which should be used by other libraries. Different libraries shall be able to use different major versions of Kryo. Kryo JARs are available on the [releases page](https://github.com/EsotericSoftware/kryo/releases) and at [Maven Central](https://search.maven.org/#search|gav|1|g%3Acom.esotericsoftware%20a%3Akryo). The latest snapshots of Kryo, including snapshot builds of master, are in the [Sonatype Repository](https://oss.sonatype.org/content/repositories/snapshots/com/esotericsoftware/kryo/). ### With Maven To use the latest Kryo release in your application, use this dependency entry in your `pom.xml`: ```xml <dependency> <groupId>com.esotericsoftware</groupId> <artifactId>kryo</artifactId> <version>5.5.0</version> </dependency> ``` To use the latest Kryo release in a library you want to publish, use this dependency entry in your `pom.xml`: ```xml <dependency> <groupId>com.esotericsoftware.kryo</groupId> <artifactId>kryo5</artifactId> <version>5.5.0</version> </dependency> ``` To use the latest Kryo snapshot, use: ```xml <repository> <id>sonatype-snapshots</id> <name>sonatype snapshots repo</name> <url>https://oss.sonatype.org/content/repositories/snapshots</url> </repository> <!-- for usage in an application: --> <dependency> <groupId>com.esotericsoftware</groupId> <artifactId>kryo</artifactId> <version>5.5.1-SNAPSHOT</version> </dependency> <!-- for usage in a library that should be published: --> <dependency