- Cache wrapper/metadata in serialization bridge methods to avoid redundant GetType and GetWrapper calls, improving performance. - Update source generator to combine null/depth checks and cache depthExceeded for collections. - Add useAcBinaryProtocol option to AcSignalRClientBase, allowing binary protocol to be toggled via constructor and registered via DI. - Update documentation to reflect new caching rules and performance improvements. |
||
|---|---|---|
| .. | ||
| AcBinaryHubProtocol.cs | ||
| AcSignalRClientBase.cs | ||
| AcSignalRTags.cs | ||
| IAcSignalRHubBase.cs | ||
| IAcSignalRHubClient.cs | ||
| README.md | ||
| SendToClientType.cs | ||
| SignalMessageTagAttribute.cs | ||
| SignalRCrudTags.cs | ||
| SignalRRequestModel.cs | ||
| SignalRSerializationHelper.cs | ||
README.md
SignalRs
Custom binary SignalR protocol, client infrastructure, message tagging, and serialization helpers.
Architecture: For full dispatch flow, tag system, and tech debt documentation see
AyCode.Services/docs/SIGNALR.md. Binary protocol: For wire format, zero-copy pipeline, and dual BWO pattern seeAyCode.Services/docs/SIGNALR_BINARY_PROTOCOL.md.
Key Files
Protocol
AcBinaryHubProtocol.cs— CustomIHubProtocolreplacing JSON+Base64 withAcBinarySerializer. Handles all 9 SignalR message types (Invocation, StreamItem, Completion, Ping, Close, etc.). UsesBufferWriterBinaryOutputstandalone mode for zero-copy writes to the SignalR pipe.byte[]fast-path bypasses the serializer entirely. InnerSpanReaderref struct for zero-alloc parsing.
Client
AcSignalRClientBase.cs— Abstract SignalR client managingHubConnection, request/response tracking via pooledSignalRRequestModel. Methods:SendMessageToServerAsync<TResponse>(), CRUD helpers (Post, Get, GetAll, GetAllInto). Configurable timeouts.IAcSignalRHubClient.cs— Client interface +SignalResponseDataMessage(sealed, supports JSON/Binary with GZip, caching, diagnostics).IAcSignalRHubBase.cs— Base hub interface:OnReceiveMessage(int messageTag, byte[] messageBytes, int? requestId).
Message Tagging
SignalMessageTagAttribute.cs— Three attributes:TagAttribute(base, int messageTag),SignalRAttribute(server method routing + client notification),SignalRSendToClientAttribute(client-side receive).AcSignalRTags.cs— Static constants:None,PingTag,EchoTag.SignalRCrudTags.cs— Sealed class bundling 5 independent CRUD tag integers.GetMessageTagByTrackingState()mapsTrackingState→ tag. SeeAyCode.Services.Server/docs/SIGNALR_DATASOURCE.md.SendToClientType.cs— Enum: None, Others, Caller, All.
Serialization & Pooling
SignalRSerializationHelper.cs— Static helpers:SerializeToBinary(),DeserializeFromBinary(), compressed JSON variants,CreateResponseData().SignalRRequestModel.cs— Poolable (IResettable) request tracking model withObjectPoolfor reuse.