History

Loretta d147398698 Switch SignalR payloads to ArrayPool-backed SignalData Major protocol refactor: all byte[] payloads in SignalR hub/client interfaces, plumbing, and DTOs are now wrapped in SignalData, a disposable, ArrayPool-backed type with Span access. Introduces AyCodeBinaryHubProtocol (derived from AcBinaryHubProtocol) to rent pooled buffers for SignalData on receive. All message signatures, diagnostics, and serialization logic updated. Documentation and tests revised to reflect SignalData usage. Enables zero-copy, low-GC, high-performance binary messaging for large payloads.		2026-04-06 11:17:02 +02:00
..
AcLoggerSignalRHub.cs	Implement SignalRLoggerClient	2025-09-02 11:48:05 +02:00
AcSessionService.cs	Add SignalR common services and dependencies	2025-08-31 12:39:47 +02:00
AcSignalRDataSource.cs	Switch SignalR payloads to ArrayPool-backed SignalData	2026-04-06 11:17:02 +02:00
AcSignalRSendToClientService.cs	Switch SignalR payloads to ArrayPool-backed SignalData	2026-04-06 11:17:02 +02:00
AcWebSignalRHubBase.cs	Switch SignalR payloads to ArrayPool-backed SignalData	2026-04-06 11:17:02 +02:00
ExtensionMethods.cs	Refactor JSON/SignalR infra; add full test & benchmark suite	2025-12-11 21:25:50 +01:00
IAcSessionItem.cs	Add SignalR common services and dependencies	2025-08-31 12:39:47 +02:00
IAcSignalRHubItemServer.cs	improvements, fixes, etc	2024-05-25 22:16:22 +02:00
README.md	Update README links to use code-style paths for docs	2026-03-30 08:01:05 +02:00
TrackingItemHelpers.cs	Add SignalR common services and dependencies	2025-08-31 12:39:47 +02:00

README.md

SignalRs

Server-side SignalR hub infrastructure: hub base class, session management, data source with change tracking, and client broadcast service.

Architecture: For full dispatch flow, tag system, and tech debt documentation see AyCode.Services/docs/SIGNALR.md.

Key Files

Hub

AcWebSignalRHubBase.cs — Abstract hub extending Hub<IAcSignalRHubItemServer>. Manages connection lifecycle, message dispatch via DynamicMethodRegistry, binary/JSON parameter deserialization. Response methods: ResponseToCaller(), SendMessageToOthers(), SendMessageToUserIdInternal().
IAcSignalRHubItemServer.cs — Server hub interfaces: IAcSignalRHubItemServer, IAcSignalRHubServer.
AcLoggerSignalRHub.cs — Specialized hub for receiving log items via SignalR (AddLogItem()).

Session & Broadcast

AcSessionService.cs — Generic session manager with ConcurrentDictionary<TSessionItemId, TSessionItem>.
IAcSessionItem.cs — Session item interface with SessionId property.
AcSignalRSendToClientService.cs — Abstract broadcast service: SendMessageToClient(), SendMessageToAllClients(), SendMessageToConnection(), SendMessageToUser().

Data Source

Full specification: AyCode.Services.Server/docs/SIGNALR_DATASOURCE.md

AcSignalRDataSource.cs — Generic real-time collection (AcSignalRDataSource<TDataItem, TId, TIList>) implementing IList<T> with full CRUD and change tracking.
- Change tracking: TrackingItem<T, TId> wraps each modified item with TrackingState + OriginalValue for rollback. ChangeTracking<T, TId> manages the tracking list.
- Loading: LoadDataSource() (sync), LoadDataSourceAsync() (async callback), LoadItem(id) (single). Binary path uses BinaryToMerge() for AcObservableCollection (batch UI update via BeginUpdate/EndUpdate).
- Saving: SaveChanges() iterates tracked items, posts each via CRUD tag, rollbacks on failure. SaveItem() for individual saves.
- Sync state: IsSyncing (Interlocked counter) + OnSyncingStateChanged event for UI loading indicators.
- Locking: object _syncRoot (sync ops) + SemaphoreSlim _asyncLock (async ops). GetEnumerator() returns safe copy.
- Working reference list: SetWorkingReferenceList() allows external list to become inner storage (zero-copy).
- Context: ContextIds (object[]) + FilterText (string) sent with GetAll requests for server-side filtering.

Utilities

ExtensionMethods.cs — InvokeMethod() — invokes methods and unwraps Task/Task<T>/ValueTask results.
TrackingItemHelpers.cs — Deep clone helpers: JsonClone<T>(), ReflectionClone<T>().