Struct ViewDelegate 

pub struct ViewDelegate<'a, V: 'static, PK: 'static> { /* private fields */ }

View delegate for views that declared an @id field. Exposes find_many + find_unique (and refresh() on materialized views). Views declared @@no_unique get ViewDelegateNoUnique instead, which omits find_unique at the type level so a call like runtime.views().<v>().find_unique(()) is a compile error rather than a runtime “WHERE = $1” footgun.

Implementations

impl<'a, V: 'static, PK: 'static> ViewDelegate<'a, V, PK>

pub fn new( runtime: &'a SqlxRuntime, descriptor: &'static ViewDescriptor<V, PK>, ) -> Self

pub fn descriptor(&self) -> &'static ViewDescriptor<V, PK>

The typed descriptor the delegate was constructed with. Useful for callers that need to inspect view metadata (e.g. is_materialized, source_tables) without going through the runtime.

pub fn find_many(&self) -> FindMany<'a, V, PK>

pub fn find_unique(&self, id: PK) -> FindUnique<'a, V, PK>

Single-row lookup by primary key. Only available on views with an @id field — @@no_unique views get ViewDelegateNoUnique, which doesn’t expose this method.

pub async fn refresh(&self) -> Result<(), CoolError>

REFRESH MATERIALIZED VIEW CONCURRENTLY <name> — only valid on @@materialized views. Concurrent refresh holds an ACCESS SHARE lock (instead of the ACCESS EXCLUSIVE non-concurrent refresh takes), letting readers continue against the previous snapshot while the rebuild runs.

Returns a Forbidden error if called on a non-materialized view — the macro emits this method unconditionally for ViewDescriptor consumers, with the gate enforced at runtime so the wire contract is uniform. (At codegen time the macro can also choose to omit the method entirely on non-materialized descriptors; the runtime gate is the safety net.)

Trait Implementations

impl<'a, V: Clone + 'static, PK: Clone + 'static> Clone for ViewDelegate<'a, V, PK>

fn clone(&self) -> ViewDelegate<'a, V, PK>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, V: Copy + 'static, PK: Copy + 'static> Copy for ViewDelegate<'a, V, PK>