Caching: PersistedSchemaId and MarkWritten are internal for 2.0; Mesh single-file write guard in the CHANGELOG
C2a's StoredVersion owns the same identity and deletes both. No consumer outside CultLib uses them, so they do not ship public in 2.0.0 and C2a's release is not a major. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
parent
7678148c1a
commit
8b47a2e8d9
4 changed files with 13 additions and 17 deletions
|
|
@ -227,13 +227,14 @@ against what is durably on disk at that moment:
|
|||
`(key, schemaId, storedAt)`. Any insert, delete or replace fails it.
|
||||
|
||||
Record identity for conditions is `(schemaId, storedAt)`, where `schemaId` is
|
||||
the id the record is persisted under (`CultStoredDocument.PersistedSchemaId`),
|
||||
the id the record is persisted under (the internal `CultStoredDocument.PersistedSchemaId`),
|
||||
not the one this cache decodes it as. A value change mints a `storedAt`
|
||||
strictly later than the record it replaces; writers bump a minted timestamp by
|
||||
one tick when it is not later. An entry loaded under compatible schema drift
|
||||
keeps its persisted id until its store rewrites it; a store records each
|
||||
record its completed write rewrote with the protected instance method
|
||||
`CacheBackingStore.MarkWritten`, which refuses an entry that is not the one
|
||||
record its completed write rewrote with the internal instance method
|
||||
`CacheBackingStore.MarkWritten` (the shipped stores call it; it is not part of
|
||||
the public API), which refuses an entry that is not the one
|
||||
the store holds in its own `Entries` at that key. That guards against a store
|
||||
marking by mistake an entry it never held; a store that writes another copy
|
||||
into its own `Entries` and then marks it is trusted to have rewritten that
|
||||
|
|
|
|||
|
|
@ -394,9 +394,9 @@ namespace GameCult.Caching
|
|||
/// The schema id this record is durably stored under, as its backing store last read or wrote it. It differs from
|
||||
/// <see cref="CultDocumentDescriptor.SchemaId"/> only for a record loaded under compatible schema drift that its
|
||||
/// store has not rewritten since; a store records its rewrite of an entry it holds with <see cref="CacheBackingStore.MarkWritten"/>.
|
||||
/// Conditional commit compares this id and <see cref="StoredAt"/> with the disk.
|
||||
/// Conditional commit compares this id and <see cref="StoredAt"/> with the disk. Internal to the shipped stores.
|
||||
/// </summary>
|
||||
public string PersistedSchemaId => _persisted.SchemaId;
|
||||
internal string PersistedSchemaId => _persisted.SchemaId;
|
||||
|
||||
// The complete document. For a variant, the resolved view: derived, never written back.
|
||||
public object Document => _document ??
|
||||
|
|
@ -3333,7 +3333,7 @@ namespace GameCult.Caching
|
|||
/// </summary>
|
||||
/// <exception cref="ArgumentException"><paramref name="entry"/> is not the entry this store holds in
|
||||
/// <see cref="Entries"/> at its key: a store marks only its own rewrite.</exception>
|
||||
protected void MarkWritten(CultStoredDocument entry)
|
||||
internal void MarkWritten(CultStoredDocument entry)
|
||||
{
|
||||
if (entry == null)
|
||||
throw new ArgumentNullException(nameof(entry));
|
||||
|
|
|
|||
|
|
@ -9,5 +9,6 @@
|
|||
<PackageReference Include="R3" Version="1.3.0" />
|
||||
<PackageReference Include="ConcurrentHashSet " Version="1.3.0" />
|
||||
<InternalsVisibleTo Include="GameCult.Caching.Tests" />
|
||||
<InternalsVisibleTo Include="GameCult.Caching.MessagePack" />
|
||||
</ItemGroup>
|
||||
</Project>
|
||||
Loading…
Reference in a new issue