Trait QueryId

Source

pub trait QueryId {
    type QueryId: Any;

    const HAS_STATIC_QUERY_ID: bool = true;

    // Provided method
    fn query_id() -> Option<TypeId> { ... }
}

Expand description

Uniquely identifies queries by their type for the purpose of prepared statement caching.

All types which implement QueryFragment should also implement this trait (It is not an actual supertrait of QueryFragment for boxing purposes).

See the documentation of the QueryId type and HAS_STATIC_QUERY_ID for more details.

§Deriving

This trait can be automatically derived by Diesel. For example, given this struct:

If the SQL generated by a struct is not uniquely identifiable by its type, meaning that HAS_STATIC_QUERY_ID should always be false, you should not derive this trait. In that case you should manually implement it instead.

Provided Associated Constants§

Source

const HAS_STATIC_QUERY_ID: bool = true

Can the SQL generated by Self be uniquely identified by its type?

Typically this question can be answered by looking at whether unsafe_to_cache_prepared is called in your implementation of QueryFragment::walk_ast. In Diesel itself, the only type which has false here, but is potentially safe to store in the prepared statement cache is a boxed query.

Required Associated Types§

Source

type QueryId: Any

A type which uniquely represents Self in a SQL query.

Typically this will be a re-construction of Self using the QueryId type of each of your type parameters. For example, the type And<Left, Right> would have type QueryId = And<Left::QueryId, Right::QueryId>.

The exception to this is when one of your type parameters does not affect whether the same prepared statement can be used or not. For example, a bind parameter is represented as Bound<SqlType, RustType>. The actual Rust type we are serializing does not matter for the purposes of prepared statement reuse, but a query which has identical SQL but different types for its bind parameters requires a new prepared statement. For this reason, Bound would have type QueryId = Bound<SqlType::QueryId, ()>.

If HAS_STATIC_QUERY_ID is false, you can put any type here (typically ()).

Provided Methods§

Source

fn query_id() -> Option<TypeId>

Returns the type id of Self::QueryId if Self::HAS_STATIC_QUERY_ID. Returns None otherwise.

You should never need to override this method.

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Trait QueryIdCopy item path

§Deriving

Provided Associated Constants§

const HAS_STATIC_QUERY_ID: bool = true

Required Associated Types§

type QueryId: Any

Provided Methods§

fn query_id() -> Option<TypeId>

Dyn Compatibility§

Implementations on Foreign Types§

impl QueryId for ()

const HAS_STATIC_QUERY_ID: bool = true

type QueryId = ()

impl<'a, T: QueryId + ?Sized> QueryId for &'a T

const HAS_STATIC_QUERY_ID: bool = T::HAS_STATIC_QUERY_ID

type QueryId = <T as QueryId>::QueryId

impl<T0: QueryId> QueryId for (T0,)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId,)

impl<T0: QueryId, T1: QueryId> QueryId for (T0, T1)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId, <T1 as QueryId>::QueryId)

impl<T0: QueryId, T1: QueryId, T2: QueryId> QueryId for (T0, T1, T2)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId, <T1 as QueryId>::QueryId, <T2 as QueryId>::QueryId)

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId> QueryId for (T0, T1, T2, T3)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId, <T1 as QueryId>::QueryId, <T2 as QueryId>::QueryId, <T3 as QueryId>::QueryId)

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId> QueryId for (T0, T1, T2, T3, T4)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId, <T1 as QueryId>::QueryId, <T2 as QueryId>::QueryId, <T3 as QueryId>::QueryId, <T4 as QueryId>::QueryId)

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId> QueryId for (T0, T1, T2, T3, T4, T5)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId, <T1 as QueryId>::QueryId, <T2 as QueryId>::QueryId, <T3 as QueryId>::QueryId, <T4 as QueryId>::QueryId, <T5 as QueryId>::QueryId)

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId, T6: QueryId> QueryId for (T0, T1, T2, T3, T4, T5, T6)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId, <T1 as QueryId>::QueryId, <T2 as QueryId>::QueryId, <T3 as QueryId>::QueryId, <T4 as QueryId>::QueryId, <T5 as QueryId>::QueryId, <T6 as QueryId>::QueryId)

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId, T6: QueryId, T7: QueryId> QueryId for (T0, T1, T2, T3, T4, T5, T6, T7)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId, <T1 as QueryId>::QueryId, <T2 as QueryId>::QueryId, <T3 as QueryId>::QueryId, <T4 as QueryId>::QueryId, <T5 as QueryId>::QueryId, <T6 as QueryId>::QueryId, <T7 as QueryId>::QueryId)

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId, T6: QueryId, T7: QueryId, T8: QueryId> QueryId for (T0, T1, T2, T3, T4, T5, T6, T7, T8)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId, <T1 as QueryId>::QueryId, <T2 as QueryId>::QueryId, <T3 as QueryId>::QueryId, <T4 as QueryId>::QueryId, <T5 as QueryId>::QueryId, <T6 as QueryId>::QueryId, <T7 as QueryId>::QueryId, <T8 as QueryId>::QueryId)

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId, T6: QueryId, T7: QueryId, T8: QueryId, T9: QueryId> QueryId for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9)

const HAS_STATIC_QUERY_ID: bool = _

type QueryId = (<T0 as QueryId>::QueryId, <T1 as QueryId>::QueryId, <T2 as QueryId>::QueryId, <T3 as QueryId>::QueryId, <T4 as QueryId>::QueryId, <T5 as QueryId>::QueryId, <T6 as QueryId>::QueryId, <T7 as QueryId>::QueryId, <T8 as QueryId>::QueryId, <T9 as QueryId>::QueryId)

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId, T6: QueryId, T7: QueryId, T8: QueryId, T9: QueryId, T10: QueryId> QueryId for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10)

const HAS_STATIC_QUERY_ID: bool = _

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId, T6: QueryId, T7: QueryId, T8: QueryId, T9: QueryId, T10: QueryId, T11: QueryId> QueryId for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11)

const HAS_STATIC_QUERY_ID: bool = _

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId, T6: QueryId, T7: QueryId, T8: QueryId, T9: QueryId, T10: QueryId, T11: QueryId, T12: QueryId> QueryId for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12)

const HAS_STATIC_QUERY_ID: bool = _

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId, T6: QueryId, T7: QueryId, T8: QueryId, T9: QueryId, T10: QueryId, T11: QueryId, T12: QueryId, T13: QueryId> QueryId for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13)

const HAS_STATIC_QUERY_ID: bool = _

impl<T0: QueryId, T1: QueryId, T2: QueryId, T3: QueryId, T4: QueryId, T5: QueryId, T6: QueryId, T7: QueryId, T8: QueryId, T9: QueryId, T10: QueryId, T11: QueryId, T12: QueryId, T13: QueryId, T14: QueryId> QueryId for (T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14)

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

const HAS_STATIC_QUERY_ID: bool = _

impl<T: QueryId + ?Sized> QueryId for Box<T>

const HAS_STATIC_QUERY_ID: bool = T::HAS_STATIC_QUERY_ID

type QueryId = <T as QueryId>::QueryId

Implementors§

impl QueryId for now

const HAS_STATIC_QUERY_ID: bool = true

type QueryId = now

Trait QueryId