diesel/query_builder/update_statement/
target.rs

Help
1use crate::associations::{HasTable, Identifiable};
2use crate::dsl::Find;
3use crate::query_dsl::methods::FindDsl;
4use crate::query_source::Table;
5
6#[doc(hidden)]
7#[derive(Debug)]
8pub struct UpdateTarget<Table, WhereClause> {
9    pub table: Table,
10    pub where_clause: WhereClause,
11}
12
13/// A type which can be passed to [`update`] or [`delete`].
14///
15/// Apps will never need to implement this type directly. There are three kinds
16/// which implement this trait. Tables, queries which have only had `filter`
17/// called on them, and types which implement `Identifiable`.
18///
19/// When a table is passed to `update`, every row in the table will be updated.
20/// You can scope this down by calling [`filter`] which will
21/// result in `UPDATE your_table SET ... WHERE args_to_filter`. Passing a type
22/// which implements `Identifiable` is the same as passing
23/// `SomeStruct::table().find(some_struct)`.
24///
25/// [`update`]: crate::update()
26/// [`delete`]: crate::delete()
27/// [`filter`]: crate::query_builder::UpdateStatement::filter()
28pub trait IntoUpdateTarget: HasTable {
29    /// What is the `WHERE` clause of this target?
30    type WhereClause;
31
32    /// Decomposes `self` into the table and where clause.
33    fn into_update_target(self) -> UpdateTarget<Self::Table, Self::WhereClause>;
34}
35
36impl<T, Tab, V> IntoUpdateTarget for T
37where
38    T: Identifiable<Table = Tab>,
39    Tab: Table + FindDsl<T::Id>,
40    Find<Tab, T::Id>: IntoUpdateTarget<Table = Tab, WhereClause = V>,
41{
42    type WhereClause = V;
43
44    fn into_update_target(self) -> UpdateTarget<Self::Table, Self::WhereClause> {
45        T::table().find(self.id()).into_update_target()
46    }
47}
diesel/query_builder/update_statement/target.rs

diesel/query_builder/update_statement/
target.rs
