Skip to main content

QuerySession

Struct QuerySession 

Source
pub struct QuerySession<'db, S: Schema> { /* private fields */ }
Expand description

One isolated owner-branded query authoring session.

Every binding call allocates a fresh binding identity; bindings are lightweight Copy values valid only for the session that created them. Bindings from another session fail before I/O with cross_session_handle.

Implementations§

Source§

impl<'db, S: Schema> QuerySession<'db, S>

Source

pub fn close(&self)

Explicitly close this authoring session.

Closing is idempotent. Existing query lineages retain their immutable values but reject later composition and execution before provider I/O.

Source

pub fn is_closed(&self) -> bool

Return whether this session was explicitly closed.

Source

pub fn with_query_limits(self, limits: QueryLimits) -> Result<Self>

Validate, encode, and execute every query of this session under limits instead of the canonical query limits.

Call this before creating any binding: bindings belong to the limits they were created under. limits is admitted by the shared engine, so an unsupported value fails here rather than at the first query.

Source

pub fn exact<M>(&mut self) -> Result<Binding<S, M, Exact>>
where M: ThingModel<Schema = S> + CompleteModel,

Allocate a fresh exact-match binding for one concrete complete generated model. Abstract models have no exact binding constructor.

Source

pub fn subtypes<M>(&mut self) -> Result<Binding<S, M, Subtypes>>
where M: ThingModel<Schema = S> + SubtypeRootModel,

Allocate a fresh subtype-inclusive binding for one generated subtype root; results materialize as the generated leaf or closed family.

Source§

impl<'db, S: Schema> QuerySession<'db, S>

Source

pub fn reachable<R, FromOwner, FromPlayers, ToOwner, ToPlayers, Source, SourceMode, Target, TargetMode>( &self, relation: TypeToken<R>, role_from: RoleToken<FromOwner, FromPlayers>, role_to: RoleToken<ToOwner, ToPlayers>, source: Binding<S, Source, SourceMode>, target: Binding<S, Target, TargetMode>, min_depth: u8, max_depth: u8, ) -> Result<Predicate<S>>
where R: RelationModel<Schema = S> + CompleteModel + RoleTokenCompatible<FromOwner, FromPlayers> + RoleTokenCompatible<ToOwner, ToPlayers>, FromOwner: RelationModel<Schema = S>, ToOwner: RelationModel<Schema = S>, FromPlayers: RolePlayerBinding<Source, SourceMode>, ToPlayers: RolePlayerBinding<Target, TargetMode>, Source: ThingModel<Schema = S>, SourceMode: SelectionMode, Target: ThingModel<Schema = S>, TargetMode: SelectionMode,

Require a bounded directed walk between two generated endpoint bindings through one exact generated relation.

Each hop follows role_from -> role_to. Bounds are inclusive and a zero-hop branch requires identical endpoint concepts. Generated role compatibility and player-union evidence reject inactive roles and invalid endpoint models at compile time; bounds, session ownership, and installed-schema compatibility are validated before provider I/O.

Source§

impl<'db, S: Schema> QuerySession<'db, S>

Source

pub fn query<Shape: SelectedShape<S>>( &self, selection: Shape, ) -> Result<Query<'_, 'db, S, Shape>>

Begin one persistent query lineage from a singular selected shape.

Trait Implementations§

Source§

impl<S: Schema> Debug for QuerySession<'_, S>

Source§

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<'db, S> !Freeze for QuerySession<'db, S>

§

impl<'db, S> !RefUnwindSafe for QuerySession<'db, S>

§

impl<'db, S> !UnwindSafe for QuerySession<'db, S>

§

impl<'db, S> Send for QuerySession<'db, S>
where QueryExecution<'db, S>: Send, PhantomData<fn() -> S>: Send,

§

impl<'db, S> Sync for QuerySession<'db, S>
where QueryExecution<'db, S>: Sync, PhantomData<fn() -> S>: Sync,

§

impl<'db, S> Unpin for QuerySession<'db, S>
where QueryExecution<'db, S>: Unpin, PhantomData<fn() -> S>: Unpin,

§

impl<'db, S> UnsafeUnpin for QuerySession<'db, S>
where QueryExecution<'db, S>: UnsafeUnpin, PhantomData<fn() -> S>: UnsafeUnpin,

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> 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<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> 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<T> IntoRequest<T> for T

Source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
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> Same for T

Source§

type Output = T

Should always be Self
Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

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