Skip to main content

OwnedValidationContext

Struct OwnedValidationContext 

pub struct OwnedValidationContext<'a> { /* private fields */ }
Expand description

Context for Stage 2 (owned) validation.

This context is used when validating owned metadata through CilObject, which contains fully resolved type information and cross-references. CilObject provides access to both raw and resolved metadata through its public API.

§Caching

The context maintains a ValidationCache that lazily computes expensive data structures on first access. This eliminates redundant computations across validators while ensuring unused caches have zero overhead.

Available cached data:

  • target_assembly_types() - Types from the target assembly
  • all_types() - All types including external references
  • method_type_mapping() - Method-to-type ownership mappings

Implementations§

§

impl<'a> OwnedValidationContext<'a>

pub fn new( object: &'a CilObject, scanner: &'a ReferenceScanner, config: &'a ValidationConfig, thread_pool: &'a ThreadPool, ) -> Self

Creates a new owned validation context.

§Arguments
  • object - The CilObject containing both raw and resolved metadata
  • scanner - Shared reference scanner
  • config - Validation configuration
  • thread_pool - Dedicated thread pool for parallel validation
§Caching

The context initializes an empty ValidationCache that will lazily compute expensive data structures on first access by any validator.

pub fn object(&self) -> &CilObject

Returns a reference to the CilObject.

This provides access to both raw and fully resolved metadata including type registries, method maps, and other resolved structures through CilObject’s public API.

pub fn thread_pool(&self) -> &ThreadPool

Returns a reference to the dedicated thread pool for this validation session.

This thread pool should be used for all parallel operations within validators to avoid interference with other concurrent validation sessions.

§Returns

Returns a reference to the ThreadPool for this validation session.

§

impl OwnedValidationContext<'_>

pub fn target_assembly_types(&self) -> &Vec<CilTypeRc>

Get types that belong to the assembly being validated (cached).

This method returns only the types that should be validated for the current assembly, filtering out external assembly types that should not be subject to local validation rules.

The result is cached on first access and shared across all validators.

§Returns

Cached reference to types from the target assembly that should be validated.

§Performance

First call: O(n) where n is the total number of types (filters by assembly) Subsequent calls: O(1) (returns cached reference)

pub fn all_types(&self) -> &Vec<CilTypeRc>

Get all types including external references (cached).

This method returns all types known to the type system, including types from external assemblies. This is needed by validators that must examine cross-assembly relationships (e.g., field type validation).

The result is cached on first access and shared across all validators.

§Returns

Cached reference to all types in the type system.

§Performance

First call: O(n) where n is the total number of types Subsequent calls: O(1) (returns cached reference)

pub fn method_type_mapping(&self) -> &MethodTypeMapping

Get method-to-type ownership mapping (cached).

This method returns a mapping structure that provides O(1) lookups for:

  • Which type owns a given method
  • All methods belonging to a given type
  • Method lookup by address

The mapping is built from all types (not just target assembly types) to support cross-assembly method inheritance validation.

The result is cached on first access and shared across all validators.

§Returns

Cached reference to the MethodTypeMapping structure.

§Performance

First call: O(n*m) where n is types and m is average methods per type Subsequent calls: O(1) (returns cached reference)

§Usage
let mapping = context.method_type_mapping();
let type_addr = Arc::as_ptr(&some_type) as usize;
for &method_addr in mapping.get_type_methods(type_addr) {
    if let Some(method) = mapping.get_method(method_addr) {
        // Use method...
    }
}

pub fn interface_relationships(&self) -> &FxHashMap<usize, Vec<usize>>

Get interface implementation relationships (cached).

This method returns a mapping from type tokens to the tokens of interfaces they implement. This is used by circularity validators to detect cycles in interface implementation chains.

The result is cached on first access and shared across all validators.

§Returns

Cached reference to a FxHashMap mapping type Arc pointers (as usize) to implemented interface Arc pointers (as usize). Using Arc pointers instead of tokens avoids token collisions in multi-assembly scenarios where different types from different assemblies may share the same token value.

§Performance

First call: O(n*m) where n is types and m is average interfaces per type Subsequent calls: O(1) (returns cached reference)

pub fn nested_relationships(&self) -> &FxHashMap<Token, Vec<Token>>

Get nested type relationships (cached).

This method returns a mapping from parent type tokens to the tokens of their nested types. This is used by circularity validators to detect cycles in nested type containment.

The result is cached on first access and shared across all validators.

§Returns

Cached reference to a FxHashMap mapping type tokens to nested type tokens.

§Performance

First call: O(n*m) where n is types and m is average nested types per type Subsequent calls: O(1) (returns cached reference)

Trait Implementations§

§

impl ValidationContext for OwnedValidationContext<'_>

§

fn validation_stage(&self) -> ValidationStage

Returns the validation stage this context represents. Read more
§

fn reference_scanner(&self) -> &ReferenceScanner

Returns a reference to the shared reference scanner. Read more
§

fn config(&self) -> &ValidationConfig

Returns a reference to the validation configuration. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> AsAny for T
where T: Any,

Source§

fn as_any(&self) -> &(dyn Any + 'static)

Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Source§

fn type_name(&self) -> &'static str

Gets the type name of self
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> Downcast for T
where T: AsAny + ?Sized,

Source§

fn is<T>(&self) -> bool
where T: AsAny,

Returns true if the boxed type is the same as T. Read more
Source§

fn downcast_ref<T>(&self) -> Option<&T>
where T: AsAny,

Forward to the method defined on the type Any.
Source§

fn downcast_mut<T>(&mut self) -> Option<&mut T>
where T: AsAny,

Forward to the method defined on the type Any.
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, A> IntoAst<A> for T
where T: Into<A>, A: Ast,

Source§

fn into_ast(self, _a: &A) -> A

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<F, T> IntoSample<T> for F
where T: FromSample<F>,

Source§

fn into_sample(self) -> T

Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

Source§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
Source§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
Source§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
Source§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more