Class NavigationView<TSource, TTarget>

Namespace

Typhon.Engine

Assembly

Typhon.Engine.dll

Navigation join view: tracks source entities whose FK-referenced target satisfies predicates. Registered in both source and target ViewRegistries for incremental refresh.

public class NavigationView<TSource, TTarget> : ViewBase, IView, IDisposable, IEnumerable<long>, IEnumerable where TSource : unmanaged where TTarget : unmanaged

Type Parameters

TSource

TTarget

Inheritance

object

ViewBase

NavigationView<TSource, TTarget>

Implements

IView

IDisposable

IEnumerable<long>

IEnumerable

Inherited Members

ViewBase.Evaluators

ViewBase.WithTier<T>(SimTier)

ViewBase.WithTier(SimTier)

ViewBase.Contains(long)

ViewBase.GetDelta()

ViewBase.ClearDelta()

ViewBase.SetLastRefreshTSN(long)

ViewBase.SetOverflowDetected(bool)

ViewBase.TryMarkDisposed()

ViewBase.Dispose()

ViewBase.ApplyDelta(long, bool, bool)

ViewBase.DrainBufferAfterRefreshFull(long)

ViewBase.ViewId

ViewBase.FieldDependencies

ViewBase.IsDisposed

ViewBase.SourceFile

ViewBase.SourceLine

ViewBase.SourceMethod

ViewBase.IsPublished

ViewBase.IsSystemInput

ViewBase.Count

ViewBase.LastRefreshTSN

ViewBase.HasOverflow

ViewBase.ExecutionPlan

ViewBase.HasCachedPlan

ViewBase.CachedPlan

ViewBase.CachedPlans

ViewBase.HasCachedPlanInternal

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Remarks

Ring buffer semantics differ from a single-entity multi-component EcsView<TArchetype>: componentTag=0 entries carry the source entity PK, componentTag=1 entries carry the target entity PK (a different entity). Forward navigation (source FK changes or source predicate changes) is 1:1. Reverse navigation (target predicate changes) requires fan-out: one target change may affect many source entities.

Methods

DeregisterFromRegistries()

Deregister from all owning ViewRegistries. Called during disposal.

protected override void DeregisterFromRegistries()

Refresh(Transaction, string, int, string)

Drain the ring buffer, evaluate predicates, and update entity set and delta tracking.

public override void Refresh(Transaction tx, string callerFile = null, int callerLine = 0, string callerMethod = null)

Parameters

tx Transaction

callerFile string

callerLine int

callerMethod string

Remarks

The three trailing caller… parameters are populated by [CallerFilePath] / [CallerLineNumber] / [CallerMemberName] at user call sites. When the runtime/scheduler invokes a refresh, it must use Typhon.Engine.ViewBase.RefreshFromScheduler(Typhon.Engine.Transaction) instead so engine-internal paths don't end up as the "user execution site" in the trace.