Support shared-memory body capabilities

This commit is contained in:
Meta Vens 2026-07-13 02:00:41 +01:00
commit 66632fec00
2 changed files with 63 additions and 2 deletions

View file

@ -276,6 +276,38 @@ namespace GameCult.Mesh
}
}
public sealed class CultMeshSharedMemoryBodyAdapter : ICultMeshBodyTransportAdapter
{
public CultMeshBodyTransportKind TransportKind => CultMeshBodyTransportKind.SharedMemory;
public bool CanOpen(CultMeshBodyDescriptor descriptor) =>
descriptor != null && descriptor.TransportKind == TransportKind;
public ICultMeshBodyReadLease OpenReadOnly(
CultMeshBodyDescriptor descriptor,
CultMeshBodyValidationRequest request)
{
CultMeshBodyDescriptorValidator.Validate(descriptor, request);
MemoryMappedFile mapping;
try
{
mapping = MemoryMappedFile.OpenExisting(descriptor.CapabilityToken, MemoryMappedFileRights.Read);
}
catch (FileNotFoundException error)
{
throw new InvalidDataException("CultMesh shared-memory capability is unavailable or revoked.", error);
}
try
{
return new CultMeshMappedBodyLease(descriptor, mapping);
}
catch
{
mapping.Dispose();
throw;
}
}
}
public sealed class CultMeshMappedBodyLease : ICultMeshBodyReadLease
{
private readonly MemoryMappedFile _mapping;
@ -283,14 +315,19 @@ namespace GameCult.Mesh
private bool _disposed;
internal CultMeshMappedBodyLease(CultMeshBodyDescriptor descriptor, string path)
: this(descriptor, MemoryMappedFile.CreateFromFile(path, FileMode.Open, null, 0, MemoryMappedFileAccess.Read))
{
}
internal CultMeshMappedBodyLease(CultMeshBodyDescriptor descriptor, MemoryMappedFile mapping)
{
Descriptor = descriptor;
_mapping = MemoryMappedFile.CreateFromFile(path, FileMode.Open, null, 0, MemoryMappedFileAccess.Read);
_mapping = mapping;
_view = _mapping.CreateViewAccessor(0, descriptor.ByteSize, MemoryMappedFileAccess.Read);
}
public CultMeshBodyDescriptor Descriptor { get; }
public CultMeshBodyTransportKind TransportKind => CultMeshBodyTransportKind.SharedFileMapping;
public CultMeshBodyTransportKind TransportKind => Descriptor.TransportKind;
public byte ReadByte(long offset) { ValidateRange(offset, 1); return _view.ReadByte(offset); }
public int ReadInt32(long offset) { ValidateRange(offset, sizeof(int)); return _view.ReadInt32(offset); }
public long ReadInt64(long offset) { ValidateRange(offset, sizeof(long)); return _view.ReadInt64(offset); }

View file

@ -2,6 +2,7 @@ using System;
using System.IO;
using FluentAssertions;
using NUnit.Framework;
using System.IO.MemoryMappedFiles;
namespace GameCult.Mesh.Tests;
@ -147,6 +148,29 @@ public sealed class CultMeshBodyTransportTests
open.Should().Throw<UnauthorizedAccessException>();
}
[Test]
[Platform("Win")]
public void SharedMemoryAdapter_OpensOpaqueCapabilityReadOnly()
{
var token = "CultMesh.Body.Test." + Guid.NewGuid().ToString("N");
using var mapping = MemoryMappedFile.CreateNew(token, 8, MemoryMappedFileAccess.ReadWrite);
using (var writer = mapping.CreateViewAccessor(0, 8, MemoryMappedFileAccess.Write)) writer.Write(0, 99L);
var now = DateTimeOffset.UtcNow;
var descriptor = new CultMeshBodyDescriptor
{
BodyId = "body", SchemaId = "schema", LayoutVersion = 1,
ByteSize = 8, Capacity = 8, ProducerEpoch = 4, Sequence = 2,
LeaseExpiresAtUnixMs = now.AddMinutes(1).ToUnixTimeMilliseconds(),
TransportKind = CultMeshBodyTransportKind.SharedMemory,
CapabilityToken = token
};
using var lease = new CultMeshSharedMemoryBodyAdapter().OpenReadOnly(descriptor, Request(descriptor, now));
lease.ReadInt64(0).Should().Be(99);
lease.TransportKind.Should().Be(CultMeshBodyTransportKind.SharedMemory);
}
private static CultMeshBodyValidationRequest Request(CultMeshBodyDescriptor descriptor, DateTimeOffset now) => new()
{
BodyId = descriptor.BodyId,