This is an automated email from the ASF dual-hosted git repository.
chaokunyang pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/fory.git
The following commit(s) were added to refs/heads/main by this push:
new 99585af83 refactor(java): use `Types.NONE + 1` as base java native id
(#3180)
99585af83 is described below
commit 99585af8324f98255afed34a07ef79df2ad9519f
Author: Shawn Yang <[email protected]>
AuthorDate: Wed Jan 21 11:56:56 2026 +0800
refactor(java): use `Types.NONE + 1` as base java native id (#3180)
## Why?
## What does this PR do?
## Related issues
## Does this PR introduce any user-facing change?
- [ ] Does this PR introduce any public API change?
- [ ] Does this PR introduce any binary protocol compatibility change?
## Benchmark
---
docs/guide/java/type-registration.md | 3 +
docs/specification/java_serialization_spec.md | 68 +++++++++++-----------
.../org/apache/fory/resolver/ClassResolver.java | 2 +-
3 files changed, 39 insertions(+), 34 deletions(-)
diff --git a/docs/guide/java/type-registration.md
b/docs/guide/java/type-registration.md
index 5b9ac80e3..014ed7042 100644
--- a/docs/guide/java/type-registration.md
+++ b/docs/guide/java/type-registration.md
@@ -41,6 +41,9 @@ fory.register(SomeClass1.class, 1);
Note that class registration order is important. Serialization and
deserialization peers should have the same registration order.
+Internal type IDs 0-32 are reserved for built-in xlang types. Java native
built-ins start at
+`Types.NONE + 1`, and user IDs are encoded as `(user_id << 8) |
internal_type_id`.
+
### Register by Name
Register class by ID will have better performance and smaller space overhead.
But in some cases, management for a bunch of type IDs is complex. In such
cases, registering class by name using API `register(Class<?> cls, String
namespace, String typeName)` is recommended:
diff --git a/docs/specification/java_serialization_spec.md
b/docs/specification/java_serialization_spec.md
index ddfbadb3e..f7f2a1386 100644
--- a/docs/specification/java_serialization_spec.md
+++ b/docs/specification/java_serialization_spec.md
@@ -84,7 +84,7 @@ full_type_id = (user_type_id << 8) | internal_type_id
- Named types use `NAMED_*` internal IDs and carry names in metadata rather
than embedding a user
ID.
-### Shared internal type IDs (0-30)
+### Shared internal type IDs (0-32)
Java native mode shares the xlang internal IDs for basic types and
user-defined enum/struct/ext
tags. These IDs are stable across languages.
@@ -122,44 +122,46 @@ tags. These IDs are stable across languages.
| 28 | NAMED_COMPATIBLE_STRUCT |
| 29 | EXT |
| 30 | NAMED_EXT |
+| 31 | UNION |
+| 32 | NONE |
### Java native built-in type IDs
-Java native serialization assigns Java-specific built-ins starting at
`Types.NAMED_EXT + 1`.
-Type IDs greater than 30 are not shared with xlang; they are only valid in
Java native mode.
+Java native serialization assigns Java-specific built-ins starting at
`Types.NONE + 1`.
+Type IDs greater than 32 are not shared with xlang; they are only valid in
Java native mode.
| Type ID | Name | Description |
| ------- | -------------------------- | ------------------------------ |
-| 31 | VOID_ID | java.lang.Void |
-| 32 | CHAR_ID | java.lang.Character |
-| 33 | PRIMITIVE_VOID_ID | void |
-| 34 | PRIMITIVE_BOOL_ID | boolean |
-| 35 | PRIMITIVE_INT8_ID | byte |
-| 36 | PRIMITIVE_CHAR_ID | char |
-| 37 | PRIMITIVE_INT16_ID | short |
-| 38 | PRIMITIVE_INT32_ID | int |
-| 39 | PRIMITIVE_FLOAT32_ID | float |
-| 40 | PRIMITIVE_INT64_ID | long |
-| 41 | PRIMITIVE_FLOAT64_ID | double |
-| 42 | PRIMITIVE_BOOLEAN_ARRAY_ID | boolean[] |
-| 43 | PRIMITIVE_BYTE_ARRAY_ID | byte[] |
-| 44 | PRIMITIVE_CHAR_ARRAY_ID | char[] |
-| 45 | PRIMITIVE_SHORT_ARRAY_ID | short[] |
-| 46 | PRIMITIVE_INT_ARRAY_ID | int[] |
-| 47 | PRIMITIVE_FLOAT_ARRAY_ID | float[] |
-| 48 | PRIMITIVE_LONG_ARRAY_ID | long[] |
-| 49 | PRIMITIVE_DOUBLE_ARRAY_ID | double[] |
-| 50 | STRING_ARRAY_ID | String[] |
-| 51 | OBJECT_ARRAY_ID | Object[] |
-| 52 | ARRAYLIST_ID | java.util.ArrayList |
-| 53 | HASHMAP_ID | java.util.HashMap |
-| 54 | HASHSET_ID | java.util.HashSet |
-| 55 | CLASS_ID | java.lang.Class |
-| 56 | EMPTY_OBJECT_ID | empty object stub |
-| 57 | LAMBDA_STUB_ID | lambda stub |
-| 58 | JDK_PROXY_STUB_ID | JDK proxy stub |
-| 59 | REPLACE_STUB_ID | writeReplace/readResolve stub |
-| 60 | NONEXISTENT_META_SHARED_ID | meta-shared unknown class stub |
+| 33 | VOID_ID | java.lang.Void |
+| 34 | CHAR_ID | java.lang.Character |
+| 35 | PRIMITIVE_VOID_ID | void |
+| 36 | PRIMITIVE_BOOL_ID | boolean |
+| 37 | PRIMITIVE_INT8_ID | byte |
+| 38 | PRIMITIVE_CHAR_ID | char |
+| 39 | PRIMITIVE_INT16_ID | short |
+| 40 | PRIMITIVE_INT32_ID | int |
+| 41 | PRIMITIVE_FLOAT32_ID | float |
+| 42 | PRIMITIVE_INT64_ID | long |
+| 43 | PRIMITIVE_FLOAT64_ID | double |
+| 44 | PRIMITIVE_BOOLEAN_ARRAY_ID | boolean[] |
+| 45 | PRIMITIVE_BYTE_ARRAY_ID | byte[] |
+| 46 | PRIMITIVE_CHAR_ARRAY_ID | char[] |
+| 47 | PRIMITIVE_SHORT_ARRAY_ID | short[] |
+| 48 | PRIMITIVE_INT_ARRAY_ID | int[] |
+| 49 | PRIMITIVE_FLOAT_ARRAY_ID | float[] |
+| 50 | PRIMITIVE_LONG_ARRAY_ID | long[] |
+| 51 | PRIMITIVE_DOUBLE_ARRAY_ID | double[] |
+| 52 | STRING_ARRAY_ID | String[] |
+| 53 | OBJECT_ARRAY_ID | Object[] |
+| 54 | ARRAYLIST_ID | java.util.ArrayList |
+| 55 | HASHMAP_ID | java.util.HashMap |
+| 56 | HASHSET_ID | java.util.HashSet |
+| 57 | CLASS_ID | java.lang.Class |
+| 58 | EMPTY_OBJECT_ID | empty object stub |
+| 59 | LAMBDA_STUB_ID | lambda stub |
+| 60 | JDK_PROXY_STUB_ID | JDK proxy stub |
+| 61 | REPLACE_STUB_ID | writeReplace/readResolve stub |
+| 62 | NONEXISTENT_META_SHARED_ID | meta-shared unknown class stub |
### Registration and named types
diff --git
a/java/fory-core/src/main/java/org/apache/fory/resolver/ClassResolver.java
b/java/fory-core/src/main/java/org/apache/fory/resolver/ClassResolver.java
index 794145119..7c8fff7b0 100644
--- a/java/fory-core/src/main/java/org/apache/fory/resolver/ClassResolver.java
+++ b/java/fory-core/src/main/java/org/apache/fory/resolver/ClassResolver.java
@@ -172,7 +172,7 @@ public class ClassResolver extends TypeResolver {
private static final int INTERNAL_ID_LIMIT = 256;
- public static final int NATIVE_START_ID = Types.NAMED_EXT + 1;
+ public static final int NATIVE_START_ID = Types.NONE + 1;
public static final int VOID_ID = NATIVE_START_ID;
public static final int CHAR_ID = NATIVE_START_ID + 1;
// Note: following pre-defined class id should be continuous, since they may
be used based range.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
