Java二进制序列化与克隆快速、高效、自动化.zip

 [](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) * [Replacing a class](#replacing-a-class) - [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.6.2](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.6.2) - recompiles 5.6.1 to be compatible with Java 8 again * [5.6.1](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.6.1) - brings a bug fix for the Maven coordinates of the versioned artifact * [5.6.0](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.6.0) - brings bug fixes and performance improvements. * [5.5.0](https://github.com/EsotericSoftware/kryo/releases/tag/kryo-parent-5.5.0) - brings bug fixes and performance improvements. ## 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.6.2</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.6.2</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.6.3-SNAPSHOT</version> </dependency> <!-- for usage in a library that should be published: --> <dependency> <groupId>com.esotericsoftware.kryo</groupId> <artifactId>kryo5</artifactId> <version>5.6.3-SNAPSHOT</version> </dependency> ``` ### Without Maven Not everyone is a Maven fan. Using Kryo without Maven requires placing the [Kryo JAR](#installation) on your classpath along with the dependency JARs found in [lib](https://github.com/EsotericSoftware/kryo/tree/master/lib). ### Building from source Building Kryo from source requires JDK11+ and Maven. To build all artifacts, run: ``` mvn clean && mvn install ``` ## Quickstart Jumping ahead to show how the library can be used: ```java import com.esotericsoftware.kryo.Kryo; import com.esotericsoftware.kryo.io.Input; import com.esotericsoftware.kryo.io.Output; import java.io.*; public class HelloKryo { static public void main (String[] args) throws Exception { Kryo kryo = new Kryo(); kryo.register(SomeClass.class); SomeClass object = new SomeClass(); object.value = "Hello Kryo!"; Output output = new Output(new FileOutputStream("file.bin")); kryo.writeObject(output,