You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@fury.apache.org by ch...@apache.org on 2024/09/04 07:39:30 UTC
(fury) branch main updated: chore(java): fix default value doc for metaShareEnabled/scopedMetaShareEnabled (#1826)
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/fury.git
The following commit(s) were added to refs/heads/main by this push:
new d8738f99 chore(java): fix default value doc for metaShareEnabled/scopedMetaShareEnabled (#1826)
d8738f99 is described below
commit d8738f99963b69baec2bf1db7cc7c88ad3732748
Author: Shawn Yang <sh...@gmail.com>
AuthorDate: Wed Sep 4 15:39:26 2024 +0800
chore(java): fix default value doc for metaShareEnabled/scopedMetaShareEnabled (#1826)
## What does this PR do?
<!-- Describe the purpose of this PR. -->
## Related issues
Closes #1822
## Does this PR introduce any user-facing change?
<!--
If any user-facing interface changes, please [open an
issue](https://github.com/apache/fury/issues/new/choose) describing the
need to do so and update the document if necessary.
-->
- [ ] Does this PR introduce any public API change?
- [ ] Does this PR introduce any binary protocol compatibility change?
## Benchmark
<!--
When the PR has an impact on performance (if you don't know whether the
PR will have an impact on performance, you can submit the PR first, and
if it will have impact on performance, the code reviewer will explain
it), be sure to attach a benchmark data here.
-->
---
docs/guide/java_serialization_guide.md | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/docs/guide/java_serialization_guide.md b/docs/guide/java_serialization_guide.md
index 3d8522b5..6d4a0d15 100644
--- a/docs/guide/java_serialization_guide.md
+++ b/docs/guide/java_serialization_guide.md
@@ -108,8 +108,8 @@ public class Example {
| `registerGuavaTypes` | Whether to pre-register Guava types such as `RegularImmutableMap`/`RegularImmutableList`. These types are not public API, but seem pretty stable. [...]
| `requireClassRegistration` | Disabling may allow unknown classes to be deserialized, potentially causing security risks. [...]
| `suppressClassRegistrationWarnings` | Whether to suppress class registration warnings. The warnings can be used for security audit, but may be annoying, this suppression will be enabled by default. [...]
-| `metaShareEnabled` | Enables or disables meta share mode. [...]
-| `scopedMetaShareEnabled` | Scoped meta share focuses on a single serialization process. Metadata created or identified during this process is exclusive to it and is not shared with by other serializations. [...]
+| `metaShareEnabled` | Enables or disables meta share mode. [...]
+| `scopedMetaShareEnabled` | Scoped meta share focuses on a single serialization process. Metadata created or identified during this process is exclusive to it and is not shared with by other serializations. [...]
| `metaCompressor` | Set a compressor for meta compression. Note that the passed MetaCompressor should be thread-safe. By default, a `Deflater` based compressor `DeflaterMetaCompressor` will be used. Users can pass other compressor such as `zstd` for better compression rate. [...]
| `deserializeNonexistentClass` | Enables or disables deserialization/skipping of data for non-existent classes. [...]
| `codeGenEnabled` | Disabling may result in faster initial serialization but slower subsequent serializations. [...]
@@ -179,13 +179,13 @@ bit is set, then next byte will be read util first bit of next byte is unset.
For long compression, fury support two encoding:
- Fury SLI(Small long as int) Encoding (**used by default**):
- - If long is in [-1073741824, 1073741823], encode as 4 bytes int: `| little-endian: ((int) value) << 1 |`
+ - If long is in `[-1073741824, 1073741823]`, encode as 4 bytes int: `| little-endian: ((int) value) << 1 |`
- Otherwise write as 9 bytes: `| 0b1 | little-endian 8bytes long |`
- Fury PVL(Progressive Variable-length Long) Encoding:
- First bit in every byte indicate whether has next byte. if first bit is set, then next byte will be read util
- first bit of next byte is unset.
+ first bit of next byte is unset.
- Negative number will be converted to positive number by `(v << 1) ^ (v >> 63)` to reduce cost of small negative
- numbers.
+ numbers.
If a number are `long` type, it can't be represented by smaller bytes mostly, the compression won't get good enough
result,
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@fury.apache.org
For additional commands, e-mail: commits-help@fury.apache.org