Skip to content

Releases: apache/fory

Release list

v1.3.0

v1.3.0 Latest
Latest

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 25 Jun 03:33
v1.3.0
980636b

Highlights

  • Python gRPC code generation now defaults to the grpc.aio AsyncIO API, while synchronous grpcio output remains available through --grpc-python-mode=sync.
  • Dart joins the generated gRPC service surface: foryc --dart_out=... --grpc now emits package:grpc clients, service bases, method descriptors, and Fory-backed payload serialization.
  • Compiler gRPC documentation was refined across languages, including clearer guidance for generated service dependencies and transport behavior.
  • Runtime hardening continued with remote schema metadata limits and Java aligned-varint/type-checker fixes.

Python Async gRPC Mode

Python gRPC generation now targets AsyncIO by default. Generated companions use
grpc.aio: servicer bases expose async def methods, stubs are used with
grpc.aio.Channel instances, and streaming RPCs use async iterables. This keeps
the generated code aligned with modern Python async services while preserving
the same Fory-backed request and response encoding used by the existing gRPC
support.

Generate the default async companion with:

foryc service.fdl --python_out=./generated/python --grpc

For a simple unary service, the generated async server shape is:

import asyncio

import grpc.aio

import demo_greeter
import demo_greeter_grpc


class Greeter(demo_greeter_grpc.GreeterServicer):
    async def say_hello(self, request, context):
        return demo_greeter.HelloReply(reply=f"Hello, {request.name}")


async def serve():
    server = grpc.aio.server()
    demo_greeter_grpc.add_servicer(Greeter(), server)
    server.add_insecure_port("[::]:50051")
    await server.start()
    await server.wait_for_termination()


asyncio.run(serve())

Clients use a grpc.aio channel and await generated stub methods:

import grpc
import grpc.aio

import demo_greeter
import demo_greeter_grpc


credentials = grpc.ssl_channel_credentials()
async with grpc.aio.secure_channel("api.example.com:443", credentials) as channel:
    stub = demo_greeter_grpc.GreeterStub(channel)
    reply = await stub.say_hello(demo_greeter.HelloRequest(name="Fory"))

Existing synchronous applications can still request sync companions explicitly:

foryc service.fdl --python_out=./generated/python --grpc --grpc-python-mode=sync

In sync mode the generated public names and <module>_grpc.py filename stay the
same, but applications use grpc.server(...), standard grpc.Channel
instances, and regular def servicer methods.

Dart gRPC Code Generation

Fory 1.3.0 adds Dart gRPC service generation for schemas with service
definitions. Service definitions can come from Fory IDL, protobuf IDL, or
FlatBuffers rpc_service definitions. The generated code uses normal
grpc-dart APIs for clients, service bases, method descriptors, call options,
deadlines, cancellations, metadata, and status codes, while each request and
response object is serialized with Fory instead of protobuf message bytes.

Add grpc and build_runner alongside the Fory package in the Dart
application:

dependencies:
  fory: ^1.3.0
  grpc: ^4.0.0

dev_dependencies:
  build_runner: ^2.4.0

Generate Dart models and the gRPC companion with:

foryc service.fdl --dart_out=./lib/generated --grpc
dart run build_runner build --delete-conflicting-outputs

For a demo.greeter package, the generator emits the model file, the
build_runner serializer part, and a <stem>_grpc.dart companion with
GreeterServiceBase and GreeterClient. The generated client and service base
install the schema's Fory module automatically on first use, so service
implementations do not need a separate manual registration step for the
generated message types.

A unary Dart server uses grpc-dart's Server and the generated service base:

import 'dart:io';

import 'package:grpc/grpc.dart';
import 'demo/greeter/greeter.dart';
import 'demo/greeter/greeter_grpc.dart';

class GreeterService extends GreeterServiceBase {
  @override
  Future<HelloReply> sayHello(ServiceCall call, HelloRequest request) async {
    return HelloReply()..reply = 'Hello, ${request.name}';
  }
}

Future<void> main() async {
  final server = Server.create(services: [GreeterService()]);
  await server.serve(address: InternetAddress.loopbackIPv4, port: 50051);
}

Generated Dart clients use standard ClientChannel values and return the
grpc-dart call types:

import 'package:grpc/grpc.dart';
import 'demo/greeter/greeter.dart';
import 'demo/greeter/greeter_grpc.dart';

final channel = ClientChannel(
  'localhost',
  port: 50051,
  options: const ChannelOptions(credentials: ChannelCredentials.insecure()),
);
final client = GreeterClient(channel);

final reply = await client.sayHello(HelloRequest()..name = 'Fory');
await channel.shutdown();

Dart generation covers unary, server-streaming, client-streaming, and
bidirectional streaming RPC shapes following grpc-dart conventions.

Features

Bug Fix

Other Improvements

New Contributors

Full Changelog: v1.2.0...v1.3.0

Contributors

potiuk, chaokunyang, and yash-agarwa-l
Assets 2
Loading

v1.3.0-rc1

v1.3.0-rc1 Pre-release
Pre-release

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 21 Jun 13:48
v1.3.0-rc1
980636b

Highlights

Features

Bug Fix

Other Improvements

New Contributors

Full Changelog: v1.2.0...v1.3.0-rc1

Contributors

potiuk, chaokunyang, and yash-agarwa-l
Loading

v1.2.0

v1.2.0

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 16 Jun 12:22
v1.2.0
097966b

Highlights

  • Expanded generated gRPC support across Go, Rust, Kotlin, Scala, C#, and JavaScript, including Node.js and browser gRPC-Web support for JavaScript.
  • Improved cross-language compatibility with refined register-by-name APIs, compatible scalar read conversions, and default compatible mode for native serialization.
  • Strengthened Java platform support by adding Java 9/16 module-info generation and removing sun.misc.Unsafe usage for JDK 25.
  • Improved runtime safety and robustness with additional read checks, deflater leak fixes, and safer serializer/type-info error handling.
  • Optimized compatible-mode and row-format performance through faster compatible reads, compact row layout caching, and inlined custom-codec dispatch.
  • Enhanced compiler output quality across Rust, C++, and service generation with better identifier escaping, name-collision handling, nested container reference handling, and map code generation.

Java 25+ Without sun.misc.Unsafe

JDK 25 continues the platform shift away from sun.misc.Unsafe. Fory 1.2.0
adds a Java 25 multi-release runtime path so applications can run on JDK 25+
without resolving sun.misc.Unsafe from Fory's active class graph.

Older JDKs keep the existing fast paths. On JDK 25+, Fory uses replacement
classes backed by supported JVM mechanisms such as VarHandle, MethodHandle,
arrays, and ByteBuffer. Classes that previously depended on constructor
bypassing should provide an accessible no-arg constructor, use records, or
register a custom serializer.

Compatible Scalar Field Reads

Compatible mode already allows readers and writers to add, remove, and reorder
fields. Fory 1.2.0 extends that model to selected scalar type changes: when a
matched top-level field changes between boolean, string, numeric, and decimal
types, the reader can deserialize the value if the conversion is lossless.

Examples include reading "123" as an integer field, reading 1 or 0 as a
boolean field, reading booleans as 1/0, reading numbers or decimals as
canonical strings, and widening or narrowing numeric values only when no range
or precision is lost. Invalid strings, out-of-range values, lossy float/integer
conversions, and reference-tracked scalar type changes fail during
deserialization. The conversion applies to matched compatible fields, not to
root values or collection elements.

The examples below show Rust and Java using an int64 writer field and a
String reader field. The same compatible scalar field conversion is supported
across Fory's compatible-mode runtimes: Java, Python, Rust, C++, Go, C#, Swift,
Dart, JavaScript/TypeScript, Kotlin, and Scala. Compatible mode is enabled by
default in the Java and Python runtimes for both xlang and native serialization.

Rust example:

use fory::{Fory, ForyStruct};

#[derive(ForyStruct)]
struct MetricV1 {
    value: i64,
}

#[derive(ForyStruct)]
struct MetricV2 {
    value: String,
}

let mut writer = Fory::builder().xlang(true).compatible(true).build();
writer.register_by_name::<MetricV1>("example.Metric")?;

let mut reader = Fory::builder().xlang(true).compatible(true).build();
reader.register_by_name::<MetricV2>("example.Metric")?;

let bytes = writer.serialize(&MetricV1 { value: 42 })?;
let value: MetricV2 = reader.deserialize(&bytes)?;
assert_eq!(value.value, "42");

Java example:

public class MetricV1 {
  public long value;
}

public class MetricV2 {
  public String value;
}

Fory writer = Fory.builder().withXlang(true).withCompatible(true).build();
writer.register(MetricV1.class, "example", "Metric");

Fory reader = Fory.builder().withXlang(true).withCompatible(true).build();
reader.register(MetricV2.class, "example", "Metric");

MetricV1 source = new MetricV1();
source.value = 42L;
byte[] bytes = writer.serialize(source);
MetricV2 value = reader.deserialize(bytes, MetricV2.class);
assert value.value.equals("42");

The same rule works in the other direction, for example reading a String
field value such as "42" as int64, when the string uses Fory's strict
finite decimal grammar and the target range can represent the value exactly.

Generated gRPC Support

Fory 1.2.0 expands compiler-generated gRPC service companions. The generated
services use standard gRPC transports, channels, deadlines, metadata,
interceptors, status codes, and streaming shapes, while request and response
objects are encoded with Fory instead of protobuf message bytes. Use this mode
when both sides of the RPC are generated from the same Fory IDL, protobuf IDL,
or FlatBuffers IDL and you want gRPC operational semantics with Fory payload
encoding.

Generated gRPC support now covers Java, Python, Go, Rust, C#, Scala, Kotlin,
and JavaScript/TypeScript. JavaScript includes Node.js gRPC support and browser
gRPC-Web client generation. Only Rust and Java snippets are shown below; the
other supported languages provide the same Fory-backed service companion model
without duplicating code here.

The examples below use this shared schema:

package demo.greeter;

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string reply = 1;
}

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply);
}

Rust generation emits tonic-based service API and binding modules:

use demo_greeter::{HelloReply, HelloRequest};
use demo_greeter_service::Greeter;
use demo_greeter_service_grpc::greeter_client::GreeterClient;
use demo_greeter_service_grpc::greeter_server::GreeterServer;

tonic::transport::Server::builder()
    .add_service(GreeterServer::new(MyGreeter::default()))
    .serve(addr)
    .await?;

let mut client = GreeterClient::connect("http://[::1]:50051").await?;
let reply = client.say_hello(HelloRequest { name: "Fory".into() }).await?;

Java generation emits grpc-java service bases, stubs, and Fory codecs:

final class GreeterService extends GreeterGrpc.GreeterImplBase {
  @Override
  public void sayHello(
      HelloRequest request, StreamObserver<HelloReply> responseObserver) {
    HelloReply reply = new HelloReply();
    reply.setReply("Hello, " + request.getName());
    responseObserver.onNext(reply);
    responseObserver.onCompleted();
  }
}

Server server = ServerBuilder.forPort(50051)
    .addService(new GreeterService())
    .build()
    .start();

GreeterGrpc.GreeterBlockingStub stub = GreeterGrpc.newBlockingStub(channel);
HelloRequest request = new HelloRequest();
request.setName("Fory");
HelloReply reply = stub.sayHello(request);

The generated gRPC companions intentionally do not make gRPC a hard dependency
of the core Fory language packages. Applications add the transport libraries
they use: grpc-java for Java and Scala, grpcio for Python, grpc-go for Go,
tonic/bytes for Rust, .NET gRPC packages for C#, @grpc/grpc-js or
grpc-web for JavaScript, and grpc-java/grpc-kotlin for Kotlin.

Features

Bug Fix

  • fix(go): return nil serializer on getTypeInfo err by @ayush00git in #3719
  • fix(benchmarks): uses outdated google-java-format, upgrade spotless by @stevenschlansker in ht...
Read more

Contributors

stevenschlansker, mandrean, and 6 other contributors
Loading

v1.2.0-rc1

v1.2.0-rc1 Pre-release
Pre-release

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 13 Jun 10:00
v1.2.0-rc1
097966b

Highlights

  • Expanded generated gRPC support across Go, Rust, Kotlin, Scala, C#, and JavaScript, including Node.js and browser gRPC-Web support for JavaScript.
  • Improved cross-language compatibility with refined register-by-name APIs, compatible scalar read conversions, and default compatible mode for native serialization.
  • Strengthened Java platform support by adding Java 9/16 module-info generation and removing sun.misc.Unsafe usage for JDK 25.
  • Improved runtime safety and robustness with additional read checks, deflater leak fixes, and safer serializer/type-info error handling.
  • Optimized compatible-mode and row-format performance through faster compatible reads, compact row layout caching, and inlined custom-codec dispatch.
  • Enhanced compiler output quality across Rust, C++, and service generation with better identifier escaping, name-collision handling, nested container reference handling, and map code generation.

Features

Bug Fix

Other Improvements

New Contributors

Full Changelog: v1.1.0...v1.2.0-rc1

Contributors

stevenschlansker, mandrean, and 6 other contributors
Loading

v1.1.0

v1.1.0

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 31 May 14:01
v1.1.0
3dcf32f

Highlights

  • Added Java/Python gRPC support in the compiler.
  • Improved xlang union handling with unknown union case support and sealed record generation for C# unions.

Features

Bug Fix

Other Improvements

New Contributors

Full Changelog: v1.0.0...v1.1.0

Contributors

arpitjain099, chaokunyang, and 2 other contributors
Loading

v1.1.0-rc1

v1.1.0-rc1 Pre-release
Pre-release

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 28 May 07:03
v1.1.0-rc1
3dcf32f

Highlights

  • Added Java/Python gRPC support in the compiler.
  • Improved xlang union handling with unknown union case support and sealed record generation for C# unions.

Features

Bug Fix

Other Improvements

New Contributors

Full Changelog: v1.0.0...v1.1.0-rc1

Contributors

arpitjain099, chaokunyang, and 2 other contributors
Loading

v1.0.0

v1.0.0

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 21 May 06:19
v1.0.0
36a01b6

The Apache Fory team is pleased to announce the 1.0.0 release. This milestone release includes 84 PRs from 11 distinct contributors and turns the cross-language runtime into the default path across supported languages. See the Install page to get the libraries for your platform.

Highlights

Apache Fory 1.0.0 standardizes the cross-language serialization model. The unified xlang type system is now the default mode across languages, with compatible-mode reads, simplified field ordering, and better list/array compatibility. The release also adds decimal and bfloat16 support for xlang serialization.

The language runtimes continue to converge around the same schema and metadata model. Nested container and field codec support landed across Rust, C++, C#, Go, Dart, Python, and Swift. Kotlin gains xlang, KSP, and schema IDL support, while Scala adds schema IDL support and updated generated annotations.

This release also expands deployment coverage and performance work. Java gains Android serialization support, annotation processor support and nested type-use serialization metadata. Dart typed-container fast paths and generated struct optimizations improve throughput, alongside refreshed benchmark plots.

Key Features:

Features

Bug Fixes

  • fix(dart): resolve fory pub.dev score issues by @chaokunyang in #3585
  • fix(dart): fix dart ci by @chaokunyang in #3586
  • fix(dart): use getUint32 for correctly encoding u64 value by @ayush00git in #3592
  • fix(c++): fix c++ duration serialization by @chaokunyang in #3598
  • fix(javascript): align TypeMeta preamble constants with python/java/rust/go xlang bindings by @emrul in #3603
  • fix(javascript): fix javascript schema idl tests by @chaokunyang in #3604
  • fix(dart): added >>> for correct logical right shift semantics in uint by @ayush00git in #3607
  • fix(go): ensure physical buffer space for unsafe varint fast-paths by @ayush00git in #3613
  • fix(go): add bound checking for refResolver and metaStringResolver reads by @ayush00git in #3615
  • fix(go): added pre-allocation bounds checks for slices and strings by @ayush00git in #3618
  • fix(go): added maxBinarySize limit to decimal deserialization by @ayush00git in #3623
  • fix(go): add configurable fieldCount and fieldDepth guardrails by @ayush00git in #3620
  • fix(java): honor record field encoding in generated decode by @mandrean in #3626
  • fix(java): preserve externalizable containers in compatible mode by @mandrean in #3628
  • fix(python): enforce more checks in read by @chaokunyang in #3632
  • fix(xlang): fix xlang type system by @chaokunyang in #3646
  • fix(java): use REPLACE_STUB_ID for unregistered writeReplace classes to prevent cross-JVM ClassNotFoundException by @wakilurislam in #3638
  • fix(java): fix set view ref tracking by @chaokunyang in #3649
  • fix(java): recover map declared serializers for compatible reads by @mandrean in #3654
  • fix: include TypeMeta header bits in hash by @chaokunyang in #3659
  • fix(java): serialize suppressed exceptions by @chaokunyang in #3663
  • fix(javascript): preserve getTypeInfo in regenerated read serializer by @xhzq233 in #3669
  • fix(java): validate subclass serializer layer counts by @chaokunyang in #3676
  • fix(java): avoid instantiating abstract meta-share types by @chaokunyang in #3677
  • fix: fix release script by @chaokunyang in #3687...
Read more

Contributors

emrul, mandrean, and 7 other contributors
Loading

v1.0.0-rc1

v1.0.0-rc1 Pre-release
Pre-release

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 18 May 01:44
v1.0.0-rc1
36a01b6

Highlights

  • Unified the xlang type system and made xlang the default mode across languages: #3644, #3685
  • Added decimal and bfloat16 support for xlang serialization: #3599, #3605
  • Added nested container and field codec support across Rust, C++, C#, Go, Dart, Python, and Swift: #3625, #3630, #3636, #3639, #3640, #3641, #3643
  • Added Kotlin xlang, KSP, and schema IDL support: #3679, #3684
  • Added Scala schema IDL support and updated generated annotations: #3681, #3682
  • Added Android serialization support, including Java annotation processor support: #3667, #3670
  • Improved xlang compatibility with default compatible mode, simplified field ordering, and list/array compatible reads: #3648, #3650, #3675
  • Improved serialization performance, including Dart typed-container fast paths and generated struct optimizations: #3609, #3653, #3656, #3661
  • Added Java schema typed row field accessors and nested type-use serialization metadata: #3631, #3633

Features

Bug Fix

  • fix(dart): resolve fory pub.dev score issues by @chaokunyang in #3585
  • fix(dart): fix dart ci by @chaokunyang in #3586
  • fix(dart): use getUint32 for correctly encoding u64 value by @ayush00git in #3592
  • fix(c++): fix c++ duration serialization by @chaokunyang in #3598
  • fix(javascript): align TypeMeta preamble constants with python/java/rust/go xlang bindings by @emrul in #3603
  • fix(javascript): fix javascript schema idl tests by @chaokunyang in #3604
  • fix(dart): added <<< for correct logical right shift semantics in uint by @ayush00git in #3607
  • fix(go): ensure physical buffer space for unsafe varint fast-paths by @ayush00git in #3613
  • fix(go): add bound checking for refResolver and metaStringResolver reads by @ayush00git in #3615
  • fix(go): added pre-allocation bounds checks for slices and strings by @ayush00git in #3618
  • fix(go): added maxBinarySize limit to decimal deserialization by @ayush00git in #3623
  • fix(go): add configurable fieldCount and fieldDepth guardrails by @ayush00git in #3620
  • fix(java): honor record field encoding in generated decode by @mandrean in #3626
  • fix(java): preserve externalizable containers in compatible mode by @mandrean in #3628
  • fix(python): enforce more checks in read by @chaokunyang in #3632
  • fix(xlang): fix xlang type system by @chaokunyang in #3646
  • fix(java): use REPLACE_STUB_ID for unregistered writeReplace classes to prevent cross-JVM ClassNotFoundException by @wakilurislam in #3638
  • fix(java): fix set view ref tracking by @chaokunyang in #3649
  • fix(java): recover map declared serializers for compatible reads by @mandrean in #3654
  • fix: include TypeMeta header bits in hash by @chaokunyang in #3659
  • fix(java): serialize suppressed exceptions by @chaokunyang in #3663
  • fix(javascript): preserve getTypeInfo in regenerated read serializer by @xhzq233 in #3669
  • fix(java): validate subclass serializer layer counts by @chaokunyang in #3676
  • fix(java): avoid instantiating abstract meta-share types by @chaokunyang in #3677
  • fix: fix release script by @chaokunyang in #3687

Other Improvements

Read more

Contributors

emrul, mandrean, and 7 other contributors
Loading

v0.17.0

v0.17.0

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 19 Apr 11:52
v0.17.0
ad1b286

The Apache Fory team is pleased to announce the 0.17.0 release. This is a major release that includes 71 PR from 19 distinct contributors. See the Install Page to learn how to get the libraries for your platform.

JavaScript/NodeJS Serialization: First Release

Apache Fory 0.17.0 marks the first release with official JavaScript/NodeJS
documentation, benchmark coverage, and TypeScript-friendly IDL code generation.
The JavaScript runtime is built for modern Node.js services and TypeScript
codebases, while preserving Fory's cross-language object model, schema-driven
APIs, and optional reference tracking.

Key capabilities:

  • High-performance serialization for JavaScript and TypeScript objects in Node.js
  • Cross-language compatibility with Java, Python, Go, Rust, C#, Swift, and Dart
  • Schema-driven APIs via Type.* builders and TypeScript decorators
  • Optional reference tracking for shared and circular object graphs
  • Compatible mode for schema evolution
  • Configurable depth, binary size, and collection size guardrails
  • JavaScript/TypeScript target support in the Fory IDL/compiler workflow
  • Optional @apache-fory/hps fast string path for Node.js 20+

Quick Start

import Fory, { Type } from "@apache-fory/core";

const userType = Type.struct(
  { typeName: "example.user" },
  {
    id: Type.int64(),
    name: Type.string(),
    age: Type.int32(),
  },
);

const fory = new Fory();
const { serialize, deserialize } = fory.register(userType);

const bytes = serialize({
  id: 1n,
  name: "Alice",
  age: 30,
});

const user = deserialize(bytes);
console.log(user);

JavaScript Benchmarks

Below are throughput results (ops/sec; higher is better) comparing Fory with
Protocol Buffers and JSON across representative data structures.

Datatype Operation Fory TPS Protobuf TPS JSON TPS Fastest
Struct Serialize 8,453,950 1,903,706 3,058,232 fory
Struct Deserialize 9,705,287 8,233,664 3,860,538 fory
Sample Serialize 1,498,391 422,620 744,790 fory
Sample Deserialize 1,918,162 819,010 762,048 fory
MediaContent Serialize 1,293,157 729,497 1,299,908 json
MediaContent Deserialize 1,638,086 1,209,140 921,191 fory
StructList Serialize 3,928,325 495,648 891,810 fory
StructList Deserialize 3,264,827 1,529,744 986,144 fory
SampleList Serialize 355,581 92,741 163,120 fory
SampleList Deserialize 424,916 163,253 162,520 fory
MediaContentList Serialize 286,053 148,977 282,445 fory
MediaContentList Deserialize 376,826 244,622 190,155 fory

Serialized data sizes (bytes):

Datatype Fory Protobuf JSON
Struct 58 61 103
Sample 446 377 724
MediaContent 391 307 596
StructList 184 315 537
SampleList 1980 1900 3642
MediaContentList 1665 1550 3009

Benchmark details: https://github.com/apache/fory/tree/v0.17.0/benchmarks/javascript

Dart Serialization: First Release

Apache Fory 0.17.0 also marks the first release with official Dart
documentation, benchmark coverage, a rebuilt runtime, and Dart IDL support.
The Dart implementation focuses on generated serializers, stable
cross-language type identity, schema evolution, and predictable APIs for
service workloads.

Key capabilities:

  • High-performance Dart serialization with generated code instead of reflection
  • Cross-language compatibility with Java, Python, Go, Rust, C#, Swift, and JavaScript
  • @ForyStruct and @ForyField annotations with build_runner code generation
  • Compatible mode for schema evolution across versions
  • Optional reference tracking for shared and circular object graphs
  • Manual Serializer<T> extension points for advanced or custom types
  • Dart target support in the Fory IDL/compiler workflow

Quick Start

import 'package:fory/fory.dart';

part 'person.fory.dart';

enum Color {
  red,
  blue,
}

@ForyStruct()
class Person {
  Person();

  String name = '';
  Int32 age = Int32(0);
  Color favoriteColor = Color.red;
}

void main() {
  final fory = Fory();
  PersonFory.register(
    fory,
    Color,
    namespace: 'example',
    typeName: 'Color',
  );
  PersonFory.register(
    fory,
    Person,
    namespace: 'example',
    typeName: 'Person',
  );

  final bytes = fory.serialize(Person()
    ..name = 'Ada'
    ..age = Int32(36)
    ..favoriteColor = Color.blue);
  final roundTrip = fory.deserialize<Person>(bytes);
  print(roundTrip.name);
}

Dart Benchmarks

Below are throughput results (ops/sec; higher is better) comparing Fory with
Protocol Buffers across representative data structures.

Datatype Operation Fory TPS Protobuf TPS Fastest
Struct Serialize 3,989,432 1,884,653 fory (2.12x)
Struct Deserialize 5,828,197 4,199,680 fory (1.39x)
Sample Serialize 1,649,722 500,167 fory (3.30x)
Sample Deserialize 2,060,113 785,109 fory (2.62x)
MediaContent Serialize 800,876 391,235 fory (2.05x)
MediaContent Deserialize 1,315,115 683,533 fory (1.92x)
StructList Serialize 1,456,396 367,506 fory (3.96x)
StructList Deserialize 1,921,006 645,958 fory (2.97x)
SampleList Serialize 411,144 48,508 fory (8.48x)
SampleList Deserialize 464,273 103,558 fory (4.48x)
MediaContentList Serialize 186,870 77,029 fory (2.43x)
MediaContentList Deserialize 330,293 128,215 fory (2.58x)

Serialized data sizes (bytes):

Datatype Fory Protobuf
Struct 58 61
Sample 446 377
MediaContent 365 307
StructList 184 315
SampleList 1980 1900
MediaContentList 1535 1550

Benchmark details: https://github.com/apache/fory/tree/v0.17.0/benchmarks/dart

Highlights

Features

Read more

Contributors

stevenschlansker, mandrean, and 17 other contributors
Loading

v0.17.0-rc2

v0.17.0-rc2 Pre-release
Pre-release

Choose a tag to compare

View all tags
@chaokunyang chaokunyang released this 16 Apr 07:08
v0.17.0-rc2
ad1b286

Highlights

Features

Bug Fix

  • fix(java): Restore compact codec fixed width optimizations by @stevenschlansker in #3478
  • fix(rust): handle panics from fuzz-found edge cases by @utafrali in #3481
  • fix(rust): add error handling logic for std duration; add support for chrono duration by @BaldDemian in #3490
  • fix(compiler): validate rpc request/response types by @retryoos in #3493
  • fix(c++): fix misaligned address access errors detected by UBSan in buffer.h by @BaldDemian in #3479
  • fix(java): finalize codegen config hash on first use by @chaokunyang in #3495
  • fix(rust): fix several panics detected by cargo-fuzz by @BaldDemian in #3483
  • fix(java): handle private final map codegen by @chaokunyang in #3504
  • fix(compiler): repair broken service example and add regression coverage by @VikingDeng in #3505
  • fix(rust): deep clone TypeMeta to prevent UB in concurrent scenarios by @BaldDemian in #3511
  • fix(compiler): fix failed tests in compiler; add compiler CI by @BaldDemian in #3516
  • fix(compiler): allow qualified nested types in FDL rpc signatures by @VikingDeng in #3518
  • fix(java): preserve ConcurrentSkipListSet comparator on copy by @mandrean in #3520
  • test(compiler): add IR validation and codegen tests for gRPC service support by @darius024 in #3528
  • fix(java): Correct resolution of dependent/nested serializers in GraalVM by @rakow in #3532
  • fix(java): fix objectstream serializer async jit and graalvm support by @chaokunyang in #3534
  • ci: fix Bazel cache paths for C++ workflows by @chaokunyang in #3535
  • fix(python): fix wrong calling orders in visit_other by @BaldDemian in #3542
  • fix(js): corrected the float64 array size by @ayush00git in #3541
  • fix(java): configure type checker during build by @chaokunyang in #3550
  • fix(java): auto-select child serializers for sorted containers by @chaokunyang in #3552
  • fix(java): support skip optional sql serializers for java11+ by @chaokunyang in #3553
  • fix(rust): apply consistent pascalcase naming for nested types by @utafrali in #3548
  • fix(javascript): fix flaky javascript idl tests by @chaokunyang in #3565
  • fix(swift): fix swift generated code compile warnings by @chaokunyang in #3566
  • fix(java): add test for previous uncaught regression. by @PiotrDuz in #3573

Other Improvements

New Contributors

Full Changelog: v0.16.0...v0.17.0-rc2

Contributors

stevenschlansker, mandrean, and 17 other contributors
Loading