MCPcopy Index your code
hub / github.com/RuedigerMoeller/fast-serialization

github.com/RuedigerMoeller/fast-serialization @3.0.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release 3.0.0 ↗ · + Follow
3,017 symbols 8,615 edges 246 files 436 documented · 14% updated 3y ago3.0.0 · 2020-05-17★ 1,594116 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

fast-serialization

  • up to 10 times faster 100% JDK Serialization compatible drop-in replacement (Ok, might be 99% ..). As an example: Lambda Serialization which came with 1.8 worked instantly.
  • Android compatible since version >= 2.17 (use FSTConfiguration.createAndroidDefaultConfiguration() both on server and client side. The configuration object has to be passed into FSTObjectIn/Output constructors)
  • OffHeap Maps, Persistent OffHeap maps
  • FSTStructs is very similar to IBM's packed objects. Difference is: You can run it with Oracle JDK today.
  • optionally en/decode any Serializable object graph to JSON (incl. shared references) (since 2.29) for interop
  • Apache 2.0 license since 2.17

Docs:

Fast JDK-compatible Serialization

Json Serialization

OffHeap + Persistent Maps

MinBin cross platform binary format

Kson: a JSon extension

Struct Emulation (currently not covered by tests)

mvn

note: maven.org might lag 1 day behind after releasing.

2.0 version

<dependency>
    <groupId>de.ruedigermoeller</groupId>
    <artifactId>fst</artifactId>
    <version>2.56</version>
</dependency>

jdk1.6 compatible build of fst 2.x

<dependency>
    <groupId>de.ruedigermoeller</groupId>
    <artifactId>fst</artifactId>
    <version>2.48-jdk-6</version>
</dependency>

1.x version (different package name, 1.6 compatible ..). Fixes are not backported anymore, unsupported.

<dependency>
    <groupId>de.ruedigermoeller</groupId>
    <artifactId>fst</artifactId>
    <version>1.63</version>
</dependency>

Who uses FST ?

I am not actively tracking use, maven.org reports more than 14000 downloads from 6000 distinct IP accesses triggered by maven builds world wide per month.

Notable also:

  • used in production in Eurex Exchange's trading back end's middleware
  • JUptr.io's distributed system / NLP engine uses FST
  • Popular Apache Wicket supplementals use FST to speed up Wicket

alt tag

how to build

  • master contains dev branch/trunk.
  • 1.x contains old version
  • The maven build should work out of the box and reproduces the artifact hosted on maven.org
  • To use the gradle build, you need to configure the proxy server in settings.properties (or just set empty if you do not sit behind a proxy).

Note that instrumentation done for fst-structs works only if debug info is turned on during compile. Reason is that generating methods at runtime with javassist fails (probably a javassist bug ..). This does not affect the serialization implementation.

JDK 1.6 Build 1.x build since v1.62 are still jdk 6 compatible

Extension points exported contracts — how you extend this code

FSTDecoder (Interface)
Created by ruedi on 27.03.14. [8 implementers]
src/main/java/org/nustaq/serialization/FSTDecoder.java
WriteReplace (Interface)
(no doc) [3 implementers]
src/test/ser/FSTJavaAssistTest.java
FSTEncoder (Interface)
Created by ruedi on 27.03.14. [8 implementers]
src/main/java/org/nustaq/serialization/FSTEncoder.java
I (Interface)
(no doc) [2 implementers]
src/test/ser/LineageTest.java
FSTCrossPlatformSerialzer (Interface)
Created by ruedi on 31.03.14. [8 implementers]
src/main/java/org/nustaq/serialization/FSTCrossPlatformSerialzer.java
II (Interface)
(no doc) [2 implementers]
src/test/ser/LineageTest.java
ByteSource (Interface)
Created by ruedi on 27.06.14. [13 implementers]
src/main/java/org/nustaq/offheap/bytez/ByteSource.java
MktDataListener (Interface)
(no doc) [1 implementers]
src/test/ser/offheaplatency/MktDataDispatcher.java

Core symbols most depended-on inside this repo

getClass
called by 143
src/main/java/org/nustaq/serialization/FSTConfiguration.java
getCodec
called by 139
src/main/java/org/nustaq/serialization/FSTObjectInput.java
getName
called by 137
src/main/java/org/nustaq/serialization/FSTConfiguration.java
getCodec
called by 119
src/main/java/org/nustaq/serialization/FSTObjectOutput.java
put
called by 119
src/main/java/org/nustaq/offheap/bytez/ByteSink.java
get
called by 107
src/main/java/org/nustaq/offheap/bytez/BasicBytez.java
length
called by 94
src/main/java/org/nustaq/offheap/bytez/ByteSink.java
get
called by 93
src/main/java/org/nustaq/serialization/util/FSTInt2ObjectMap.java

Shape

Method 2,607
Class 336
Interface 35
Function 30
Enum 9

Languages

Java99%
TypeScript1%

Modules by API surface

src/main/java/org/nustaq/serialization/FSTConfiguration.java124 symbols
src/main/java/org/nustaq/serialization/FSTObjectInput.java111 symbols
src/main/java/org/nustaq/serialization/FSTClazzInfo.java99 symbols
src/test/ser/androidbitset/JDKBigInt.java70 symbols
src/test/ser/BasicFSTTest.java69 symbols
src/main/java/org/nustaq/offheap/bytez/onheap/HeapBytez.java68 symbols
src/main/java/org/nustaq/offheap/bytez/malloc/MallocBytez.java67 symbols
src/main/java/org/nustaq/serialization/FSTObjectOutput.java59 symbols
src/main/java/org/nustaq/serialization/coders/FSTStreamDecoder.java54 symbols
src/main/java/org/nustaq/serialization/coders/FSTJsonDecoder.java54 symbols
src/main/java/org/nustaq/serialization/coders/FSTBytezDecoder.java54 symbols
src/main/java/org/nustaq/serialization/coders/FSTBytezEncoder.java50 symbols

For agents

$ claude mcp add fast-serialization \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact