1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

use connection::{Connection, Cursor};
use query_builder::{Query, QueryFragment, AsQuery};
use query_source::Queriable;
use result::QueryResult;
use super::LimitDsl;

/// Methods to execute a query given a connection. These are automatically implemented for the
/// various query types.
pub trait LoadDsl: AsQuery + Sized {
    /// Executes the given query, returning an `Iterator` over the returned
    /// rows.
    fn load<U>(self, conn: &Connection) -> QueryResult<Cursor<Self::SqlType, U>> where
        U: Queriable<Self::SqlType>
    {
        conn.query_all(self)
    }

    /// Attempts to load a single record. Returns `Ok(record)` if found, and
    /// `Err(NotFound)` if no results are returned. If the query truly is
    /// optional, you can call `.optional()` on the result of this to get a
    /// `Result<Option<U>>`.
    fn first<U>(self, conn: &Connection) -> QueryResult<U> where
        U: Queriable<<<Self as LimitDsl>::Output as Query>::SqlType>,
        Self: LimitDsl,
    {
        conn.query_one(self.limit(1))
    }

    /// Runs the command, and returns the affected row. `Err(NotFound)` will be
    /// returned if the query affected 0 rows. You can call `.optional()` on the
    /// result of this if the command was optional to get back a
    /// `Result<Option<U>>`
    fn get_result<U>(self, conn: &Connection) -> QueryResult<U> where
        U: Queriable<Self::SqlType>,
    {
        conn.query_one(self)
    }

    /// Runs the command, returning an `Iterator` over the affected rows.
    fn get_results<U>(self, conn: &Connection) -> QueryResult<Cursor<Self::SqlType, U>> where
        U: Queriable<Self::SqlType>
    {
        self.load(conn)
    }
}

impl<T: AsQuery> LoadDsl for T {
}

pub trait ExecuteDsl: QueryFragment + Sized {
    /// Executes the given command, returning the number of rows affected. Used
    /// in conjunction with
    /// [`update`](../query_builder/fn.update.html) and
    /// [`delete`](../query_builder/fn.delete.html)
    fn execute(&self, conn: &Connection) -> QueryResult<usize> {
        conn.execute_returning_count(self)
    }
}

impl<T: QueryFragment> ExecuteDsl for T {
}