docs: announce Apache Fory 1.7.1

blog/2026-09-04-fory_1_7_1_released.md

@@ -0,0 +1,136 @@
+---
+slug: fory_1_7_1_release
+title: Fory v1.7.1 Released
+description: "Fory 1.7.1 adds string output for 64-bit integers and makes Base64 the default JSON representation for byte arrays."
+authors: [chaokunyang]
+tags: [fory, java, json, javascript, xlang]
+---
+
+The Apache Fory team is pleased to announce the 1.7.1 release. This patch release improves Java
+JSON interoperability, expands cross-language field tag IDs, and delivers correctness and
+compatibility fixes across multiple runtimes. See the
+[Getting Started](https://fory.apache.org/docs/start/) page to get the libraries for your platform.
+
+## Highlights
+
+- Java JSON can write 64-bit integer values as strings, helping applications preserve exact values
+  when JSON passes through JavaScript.
+- Java JSON now writes byte arrays as Base64 strings by default, providing a more compact and
+  conventional representation for binary data.
+
+## JSON-Safe 64-Bit Integers
+
+JavaScript numbers cannot exactly represent every 64-bit integer. Fory JSON 1.7.1 adds the
+`writeLongAsString` builder option so applications can emit Java `long` and `Long` values as quoted
+decimal strings when data will pass through JavaScript or another number-limited consumer:
+
+```java
+import org.apache.fory.json.ForyJson;
+
+ForyJson json = ForyJson.builder().writeLongAsString(true).build();
+String encoded = json.toJson(9_007_199_254_740_993L);
+
+assert encoded.equals("\"9007199254740993\"");
+```
+
+The option is disabled by default. It also applies to the supported Long-like wrappers and to
+declared Long values inside arrays, collections, maps, and equivalent Scala and Kotlin containers.
+Readers accept both quoted and unquoted integer tokens regardless of the writer setting. See the
+[Java JSON object mapping guide](/docs/json/object-mapping) for the complete behavior.
+
+## Base64 Byte Arrays by Default
+
+Unannotated Java `byte[]` values now use quoted standard Base64 strings instead of JSON arrays of
+decimal byte values. For example, the bytes `{1, -2, 3}` are written as `"Af4D"`. This matches the
+usual JSON representation for binary data and reduces encoding and parsing overhead for
+binary-heavy payloads.
+
+This is a default representation change from Fory 1.7.0. The Base64 reader does not accept the old
+numeric-array representation. Applications that need to retain that representation can select it
+for an exact field or getter:
+
+```java
+import org.apache.fory.json.annotation.JsonByteArray;
+
+public final class Attachment {
+  @JsonByteArray(JsonByteArray.Format.ARRAY)
+  public byte[] content;
+}
+```
+
+See the [JSON annotations guide](/docs/json/annotations) for `JsonByteArray` Base64 and
+numeric-array mapping details.
+
+## Features
+
+- feat(xlang): expand field tag IDs to signed int32 by
+  [@chaokunyang](https://github.com/chaokunyang) in
+  [#3982](https://github.com/apache/fory/pull/3982)
+- feat(json): support writing long values as strings by
+  [@chaokunyang](https://github.com/chaokunyang) in
+  [#4008](https://github.com/apache/fory/pull/4008)
+- feat(json): encode byte arrays as Base64 JSON strings by default by
+  [@ingokegel](https://github.com/ingokegel) in
+  [#4012](https://github.com/apache/fory/pull/4012)
+
+## Bug Fixes
+
+- fix(ci): increase Android Gradle memory by [@chaokunyang](https://github.com/chaokunyang) in
+  [#3980](https://github.com/apache/fory/pull/3980)
+- fix(xlang): close field tag validation gaps by
+  [@chaokunyang](https://github.com/chaokunyang) in
+  [#3984](https://github.com/apache/fory/pull/3984)
+- test(java): shorten inherited tag test name by
+  [@chaokunyang](https://github.com/chaokunyang) in
+  [#3985](https://github.com/apache/fory/pull/3985)
+- fix: harden low-level codec boundaries by [@chaokunyang](https://github.com/chaokunyang) in
+  [#3987](https://github.com/apache/fory/pull/3987)
+- fix(go): preserve primitive map iteration across chunks by
+  [@chaokunyang](https://github.com/chaokunyang) in
+  [#3990](https://github.com/apache/fory/pull/3990)
+- fix(js): avoid precision loss in negative varint64 fast path by
+  [@ayush00git](https://github.com/ayush00git) in
+  [#3992](https://github.com/apache/fory/pull/3992)
+- fix(java): reuse local compatible type info by
+  [@chaokunyang](https://github.com/chaokunyang) in
+  [#4000](https://github.com/apache/fory/pull/4000)
+- fix(kotlin): accept supported metadata versions by
+  [@chaokunyang](https://github.com/chaokunyang) in
+  [#4001](https://github.com/apache/fory/pull/4001)
+- fix(javascript): use correct typemeta special chars by
+  [@ayush00git](https://github.com/ayush00git) in
+  [#3995](https://github.com/apache/fory/pull/3995)
+- ci(kotlin): test Kotlin 2.4.10 on JDK 26 by
+  [@chaokunyang](https://github.com/chaokunyang) in
+  [#4002](https://github.com/apache/fory/pull/4002)
+- fix(javascript): reserve writer capacity for write paths by
+  [@ayush00git](https://github.com/ayush00git) in
+  [#3994](https://github.com/apache/fory/pull/3994)
+- fix(rust): correct send sync ownership by [@chaokunyang](https://github.com/chaokunyang) in
+  [#4003](https://github.com/apache/fory/pull/4003)
+- fix(scala): support nested case classes in fory-json-scala by
+  [@pjfanning](https://github.com/pjfanning) in
+  [#4006](https://github.com/apache/fory/pull/4006)
+- fix(javascript): underflow tiny float16 magnitudes to signed zero by
+  [@ayush00git](https://github.com/ayush00git) in
+  [#4004](https://github.com/apache/fory/pull/4004)
+- fix(javascript): keep float64 precision for dynamic non-integer numbers by
+  [@ayush00git](https://github.com/ayush00git) in
+  [#4005](https://github.com/apache/fory/pull/4005)
+- fix(javascript): round float16 values to nearest even by
+  [@chaokunyang](https://github.com/chaokunyang) in
+  [#4007](https://github.com/apache/fory/pull/4007)
+
+## Other Improvements
+
+- chore: improve Fory release skill by [@chaokunyang](https://github.com/chaokunyang) in
+  [#3979](https://github.com/apache/fory/pull/3979)
+- chore: clean unnecessary buffer checks by [@chaokunyang](https://github.com/chaokunyang) in
+  [#3988](https://github.com/apache/fory/pull/3988)
+
+## New Contributors
+
+- [@ingokegel](https://github.com/ingokegel) made their first contribution in
+  [#4012](https://github.com/apache/fory/pull/4012)
+
+**Full Changelog**: [v1.7.0...v1.7.1](https://github.com/apache/fory/compare/v1.7.0...v1.7.1)

i18n/zh-CN/docusaurus-plugin-content-blog/2026-09-04-fory_1_7_1_released.md

@@ -0,0 +1,126 @@
+---
+slug: fory_1_7_1_release
+title: Apache Fory 1.7.1 正式发布
+description: "Fory 1.7.1 支持将 64 位整数写为字符串，并默认使用 Base64 表示 JSON 字节数组。"
+authors: [chaokunyang]
+tags: [fory, java, json, javascript, xlang]
+---
+
+Apache Fory 团队很高兴地宣布 1.7.1 版本正式发布。这个补丁版本提升了 Java JSON 的互操作性，
+扩展了跨语言字段 tag ID，并为多个运行时带来了正确性与兼容性修复。请访问
+[快速开始](https://fory.apache.org/zh-CN/docs/start/)页面，获取适用于您所用平台的库。
+
+## 亮点
+
+- Java JSON 支持将 64 位整数值写为字符串，帮助应用在 JSON 经过 JavaScript 时保持精确值。
+- Java JSON 现在默认将字节数组写为 Base64 字符串，为二进制数据提供更紧凑、更通用的表示形式。
+
+## 避免 JSON 中的 64 位整数精度损失
+
+JavaScript 数字无法精确表示所有 64 位整数。Fory JSON 1.7.1 新增 `writeLongAsString` builder 选项，
+当数据会经过 JavaScript 或其他数值范围受限的使用方时，应用可以将 Java `long` 和 `Long` 值输出为
+带引号的十进制字符串：
+
+```java
+import org.apache.fory.json.ForyJson;
+
+ForyJson json = ForyJson.builder().writeLongAsString(true).build();
+String encoded = json.toJson(9_007_199_254_740_993L);
+
+assert encoded.equals("\"9007199254740993\"");
+```
+
+该选项默认关闭。它也适用于受支持的 Long 类包装器，以及数组、collection、Map 和等效 Scala、Kotlin
+容器中声明的 Long 值。无论写入端是否启用该选项，Reader 都同时接受带引号和不带引号的整数 token。
+完整行为请参阅 [Java JSON 对象映射指南](/zh-CN/docs/json/object-mapping)。
+
+## 默认使用 Base64 表示字节数组
+
+未标注的 Java `byte[]` 值现在使用带引号的标准 Base64 字符串，不再使用十进制字节值组成的 JSON
+数组。例如，字节 `{1, -2, 3}` 会写为 `"Af4D"`。这符合 JSON 生态中常见的二进制数据表示方式，
+并能减少二进制密集型载荷的编码和解析开销。
+
+这是相对于 Fory 1.7.0 的默认表示变化。Base64 Reader 不接受旧的数字数组表示。需要保留该表示的
+应用可以为精确字段或 getter 显式选择数字数组格式：
+
+```java
+import org.apache.fory.json.annotation.JsonByteArray;
+
+public final class Attachment {
+  @JsonByteArray(JsonByteArray.Format.ARRAY)
+  public byte[] content;
+}
+```
+
+Base64 与数字数组的映射详情请参阅 [JSON 注解指南](/zh-CN/docs/json/annotations)中的
+`JsonByteArray` 说明。
+
+## 功能改进
+
+- feat(xlang): 将字段 tag ID 扩展为 signed int32，由
+  [@chaokunyang](https://github.com/chaokunyang) 在
+  [#3982](https://github.com/apache/fory/pull/3982) 中贡献
+- feat(json): 支持将 long 值写为字符串，由
+  [@chaokunyang](https://github.com/chaokunyang) 在
+  [#4008](https://github.com/apache/fory/pull/4008) 中贡献
+- feat(json): 默认将字节数组编码为 Base64 JSON 字符串，由
+  [@ingokegel](https://github.com/ingokegel) 在
+  [#4012](https://github.com/apache/fory/pull/4012) 中贡献
+
+## 问题修复
+
+- fix(ci): 增加 Android Gradle 内存，由 [@chaokunyang](https://github.com/chaokunyang) 在
+  [#3980](https://github.com/apache/fory/pull/3980) 中贡献
+- fix(xlang): 补全字段 tag 校验，由 [@chaokunyang](https://github.com/chaokunyang) 在
+  [#3984](https://github.com/apache/fory/pull/3984) 中贡献
+- test(java): 缩短继承 tag 测试名称，由 [@chaokunyang](https://github.com/chaokunyang) 在
+  [#3985](https://github.com/apache/fory/pull/3985) 中贡献
+- fix: 加固底层编解码器边界，由 [@chaokunyang](https://github.com/chaokunyang) 在
+  [#3987](https://github.com/apache/fory/pull/3987) 中贡献
+- fix(go): 在分块处理期间保留基本类型 Map 的迭代状态，由
+  [@chaokunyang](https://github.com/chaokunyang) 在
+  [#3990](https://github.com/apache/fory/pull/3990) 中贡献
+- fix(js): 避免负数 varint64 快速路径中的精度损失，由
+  [@ayush00git](https://github.com/ayush00git) 在
+  [#3992](https://github.com/apache/fory/pull/3992) 中贡献
+- fix(java): 复用本地兼容类型信息，由 [@chaokunyang](https://github.com/chaokunyang) 在
+  [#4000](https://github.com/apache/fory/pull/4000) 中贡献
+- fix(kotlin): 接受受支持的元数据版本，由 [@chaokunyang](https://github.com/chaokunyang) 在
+  [#4001](https://github.com/apache/fory/pull/4001) 中贡献
+- fix(javascript): 为类型元信息使用正确的特殊字符，由
+  [@ayush00git](https://github.com/ayush00git) 在
+  [#3995](https://github.com/apache/fory/pull/3995) 中贡献
+- ci(kotlin): 在 JDK 26 上测试 Kotlin 2.4.10，由
+  [@chaokunyang](https://github.com/chaokunyang) 在
+  [#4002](https://github.com/apache/fory/pull/4002) 中贡献
+- fix(javascript): 为写入路径预留 writer 容量，由
+  [@ayush00git](https://github.com/ayush00git) 在
+  [#3994](https://github.com/apache/fory/pull/3994) 中贡献
+- fix(rust): 修正 `Send`/`Sync` 所有权，由 [@chaokunyang](https://github.com/chaokunyang) 在
+  [#4003](https://github.com/apache/fory/pull/4003) 中贡献
+- fix(scala): 支持 fory-json-scala 中的嵌套 case class，由
+  [@pjfanning](https://github.com/pjfanning) 在
+  [#4006](https://github.com/apache/fory/pull/4006) 中贡献
+- fix(javascript): 将过小的 float16 值下溢为带符号零，由
+  [@ayush00git](https://github.com/ayush00git) 在
+  [#4004](https://github.com/apache/fory/pull/4004) 中贡献
+- fix(javascript): 为动态非整数保留 float64 精度，由
+  [@ayush00git](https://github.com/ayush00git) 在
+  [#4005](https://github.com/apache/fory/pull/4005) 中贡献
+- fix(javascript): 按最近偶数规则舍入 float16 值，由
+  [@chaokunyang](https://github.com/chaokunyang) 在
+  [#4007](https://github.com/apache/fory/pull/4007) 中贡献
+
+## 其他改进
+
+- chore: 改进 Fory 发布 skill，由 [@chaokunyang](https://github.com/chaokunyang) 在
+  [#3979](https://github.com/apache/fory/pull/3979) 中贡献
+- chore: 清理不必要的缓冲区检查，由 [@chaokunyang](https://github.com/chaokunyang) 在
+  [#3988](https://github.com/apache/fory/pull/3988) 中贡献
+
+## 新贡献者
+
+- [@ingokegel](https://github.com/ingokegel) 在
+  [#4012](https://github.com/apache/fory/pull/4012) 中完成首次贡献
+
+**完整变更日志**：[v1.7.0...v1.7.1](https://github.com/apache/fory/compare/v1.7.0...v1.7.1)

i18n/zh-CN/docusaurus-plugin-content-docs/current/compiler/build-integration.md

@@ -211,7 +211,7 @@ cc_library(
 
 ```yaml
 dependencies:
-  fory: ^1.7.0
+  fory: ^1.7.1
 
 dev_dependencies:
   build_runner: ^2.4.0

i18n/zh-CN/docusaurus-plugin-content-docs/current/compiler/cli.md

@@ -659,5 +659,5 @@ fory = "x.y.z"
 
 ```yaml
 dependencies:
-  fory: ^1.7.0
+  fory: ^1.7.1
 ```

i18n/zh-CN/docusaurus-plugin-content-docs/current/grpc/csharp.md

@@ -36,7 +36,7 @@ gRPC 客户端、服务基类、方法描述符、元数据、截止时间、取
 
 ```xml
 <ItemGroup>
-  <PackageReference Include="Apache.Fory" Version="1.7.0" />
+  <PackageReference Include="Apache.Fory" Version="1.7.1" />
   <PackageReference Include="Grpc.AspNetCore" Version="2.71.0" />
 </ItemGroup>
 ```
@@ -45,7 +45,7 @@ gRPC 客户端、服务基类、方法描述符、元数据、截止时间、取
 
 ```xml
 <ItemGroup>
-  <PackageReference Include="Apache.Fory" Version="1.7.0" />
+  <PackageReference Include="Apache.Fory" Version="1.7.1" />
   <PackageReference Include="Grpc.Core.Api" Version="2.71.0" />
   <PackageReference Include="Grpc.Net.Client" Version="2.71.0" />
 </ItemGroup>

i18n/zh-CN/docusaurus-plugin-content-docs/current/grpc/dart.md

@@ -29,7 +29,7 @@ license: |
 
 ```yaml
 dependencies:
-  fory: ^1.7.0
+  fory: ^1.7.1
   grpc: ^4.0.0
 
 dev_dependencies:

i18n/zh-CN/docusaurus-plugin-content-docs/current/grpc/rust.md

@@ -29,7 +29,7 @@ license: |
 
 ```toml
 [dependencies]
-fory = "1.7.0"
+fory = "1.7.1"
 bytes = "1"
 tonic = { version = "0.14", features = ["transport"] }
 tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

i18n/zh-CN/docusaurus-plugin-content-docs/current/json/android.md

@@ -115,12 +115,12 @@ public final class Invoice {
 
 ```java
 import org.apache.fory.json.ForyJson;
-import org.apache.fory.json.annotation.JsonBase64;
+import org.apache.fory.json.annotation.JsonByteArray;
 import org.apache.fory.json.annotation.JsonMixin;
 
 @JsonMixin(target = ThirdPartyInvoice.class)
 public abstract class ThirdPartyInvoiceMixin {
-  @JsonBase64 byte[] signature;
+  @JsonByteArray(JsonByteArray.Format.BASE64) byte[] signature;
 }
 
 ForyJson json =
@@ -158,7 +158,7 @@ Mixin 可在与目标公共方法精确匹配的公共抽象无参 `void` 方法
 
 本节的反射规则适用于 Java 模型。Kotlin 模型使用 Kotlin JSON 模块；启用代码压缩的 Android 构建应使用 KSP，而不是编写宽泛的包级 keep 规则。
 
-Java `@JsonType` 模型支持有效的 `JsonValidator`、`JsonValue`、`JsonRawValue`、`JsonBase64` 和 `JsonFormat` 注解。未标注 `@JsonType` 时，这些注解仍可通过反射工作，但经过发布压缩的应用必须自行保留精确的注解成员、注解属性和编解码器构造函数。`JsonValue` 方法可以使用不符合 JavaBean 约定的名称，因此手写规则必须明确指定该方法。
+Java `@JsonType` 模型支持有效的 `JsonValidator`、`JsonValue`、`JsonRawValue`、`JsonByteArray` 和 `JsonFormat` 注解。未标注 `@JsonType` 时，这些注解仍可通过反射工作，但经过发布压缩的应用必须自行保留精确的注解成员、注解属性和编解码器构造函数。`JsonValue` 方法可以使用不符合 JavaBean 约定的名称，因此手写规则必须明确指定该方法。
 
 Kotlin 模型使用相同的有效注解。启用代码压缩时，请使用 KSP。`JsonFormat` 与 JVM 上一样支持直接字段和一层包装，包括为 `Instant`、`ZonedDateTime` 和 `OffsetDateTime` 指定 `timezone`。