Loretta
7f677418af
Refactored binary string serialization to use a new universal wire format with FixStr (135–166) and String (167) markers and unsigned excess slots, replacing the previous tiered approach. Updated all read/write logic, marker handling, and type code definitions accordingly. FastWire UTF-16 marker (91) now has dedicated handling with legacy compatibility. Removed legacy StringSmall/Medium/Big/Ascii code paths except for backward-compatibility. Improved buffer management in ArrayBinaryOutput and documented new critical issues regarding buffer ownership and disposal. Added new utility methods for marker encoding/decoding and excess slot sizing. Updated documentation and comments to match the new format. |
||
|---|---|---|
| .. | ||
| BINARY_ASYNCPIPE_ISSUES.md | ||
| BINARY_ASYNCPIPE_TODO.md | ||
| BINARY_BYTECODE_OPTIMIZATION.md | ||
| BINARY_FEATURES.md | ||
| BINARY_FORMAT.md | ||
| BINARY_IMPLEMENTATION.md | ||
| BINARY_ISSUES.md | ||
| BINARY_OPTIONS.md | ||
| BINARY_SGEN.md | ||
| BINARY_SGEN_OPTIMIZATION.md | ||
| BINARY_STRICT_SGEN.md | ||
| BINARY_TODO.md | ||
| BINARY_TODO_2026_04.md | ||
| BINARY_TODO_2026_05.md | ||
| BINARY_WHYUSE.md | ||
| BINARY_WRITERS.md | ||
| README.md | ||
README.md
BINARY — AcBinary serializer
AcBinary serialization system. Primary goal: speed (two-phase scan+serialize, reference tracking, string interning).
Files in this folder
BINARY_WHYUSE.md— Architectural framing: why AcBinary exists (category vs wire-only serializers, three-pillar value proposition, fit/not-fit decision lists, benchmark reading guide)BINARY_FEATURES.md— High-level features and capabilitiesBINARY_FORMAT.md— Wire format specificationBINARY_OPTIONS.md— Configuration options (AcBinaryOptions)BINARY_IMPLEMENTATION.md— Internal implementation detailsBINARY_WRITERS.md— Writer internals (streaming, buffering)BINARY_SGEN.md— Source generator (AyCode.Core.Serializers.SourceGenerator)BINARY_SGEN_OPTIMIZATION.md— SGen per-property emit micro-optimization brainstorming / methodology notes (working doc, not a TODO)BINARY_BYTECODE_OPTIMIZATION.md— Wire-format hot/cold marker layout reorganization (sibling working doc, feature-flag-aligned bytecode space partition)BINARY_STRICT_SGEN.md—AcBinary.StrictNuGet package plan (sibling working doc, SGen-only build target, AOT-friendly opt-in next to the default Hybrid)BINARY_ISSUES.md— Known issues and limitations (binary serializer core)BINARY_TODO.md— Planned work / open tickets (binary serializer core)BINARY_ASYNCPIPE_ISSUES.md— Known issues and limitations (streaming I/O layer:AsyncPipeReaderInput+AsyncPipeWriterOutput)BINARY_ASYNCPIPE_TODO.md— Planned work / open tickets (streaming I/O layer)
Start here
Start with BINARY_WHYUSE.md (architectural framing — why this serializer over the alternatives), then BINARY_FEATURES.md (feature overview), then BINARY_FORMAT.md (wire-level). BINARY_SGEN.md covers build-time code-gen integration.
Cross-references
- Serialization overview (Toon vs AcBinary vs AcJson, shared infrastructure):
../../Serializers/README.md - SignalR binary transport (uses this serializer):
../../AyCode.Services/docs/SIGNALR_BINARY_PROTOCOL/README.md - ASP.NET Core MVC formatter (uses this serializer):
../../AyCode.Services/docs/MVC/README.md - Glossary terms:
../../../docs/GLOSSARY.md
Related ADRs
AyCode.Core/docs/adr/0003-acbinary-streaming-receive-architecture.md— Receive-side streaming architecture (Status: Accepted 2026-05-03, partially executed). Delivered:SegmentBufferReader+SegmentBufferReaderInputconsolidated into a singleAsyncPipeReaderInputprimitive (mirrors send-sideAsyncPipeWriterOutput); SignalR receive-side migration completed. Dropped during execution: NamedPipe + FileStream helpers (Steps 4 & 5) — framework stays consumer-implements-transport, exposes only genericPipeWriter/PipeReaderprimitives.