Trait Execute

pub trait Execute<'q, DB>: Sized + Send
where
    DB: Database,
{
    // Required methods
    fn sql(&self) -> &'q str;
    fn statement(&self) -> Option<&<DB as Database>::Statement<'q>>;
    fn take_arguments(
        &mut self,
    ) -> Result<Option<<DB as Database>::Arguments<'q>>, Box<dyn Error + Send + Sync>>;
    fn persistent(&self) -> bool;
}

A type that may be executed against a database connection.

Implemented for the following:

• &str
• Query

Required Methods

fn sql(&self) -> &'q str

Gets the SQL that will be executed.

fn statement(&self) -> Option<&<DB as Database>::Statement<'q>>

Gets the previously cached statement, if available.

fn take_arguments( &mut self, ) -> Result<Option<<DB as Database>::Arguments<'q>>, Box<dyn Error + Send + Sync>>

Returns the arguments to be bound against the query string.

Returning Ok(None) for Arguments indicates to use a “simple” query protocol and to not prepare the query. Returning Ok(Some(Default::default())) is an empty arguments object that will be prepared (and cached) before execution.

Returns Err if encoding any of the arguments failed.

fn persistent(&self) -> bool

Returns true if the statement should be cached.

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.

Implementations on Foreign Types

impl<'q, DB> Execute<'q, DB> for &'q str

where DB: Database,

fn sql(&self) -> &'q str

fn statement(&self) -> Option<&<DB as Database>::Statement<'q>>

fn take_arguments( &mut self, ) -> Result<Option<<DB as Database>::Arguments<'q>>, Box<dyn Error + Send + Sync>>

fn persistent(&self) -> bool

impl<'q, DB> Execute<'q, DB> for (&'q str, Option<<DB as Database>::Arguments<'q>>)

where DB: Database,

fn sql(&self) -> &'q str

fn statement(&self) -> Option<&<DB as Database>::Statement<'q>>

fn take_arguments( &mut self, ) -> Result<Option<<DB as Database>::Arguments<'q>>, Box<dyn Error + Send + Sync>>

fn persistent(&self) -> bool

Implementors

impl<'q, DB> Execute<'q, DB> for RawSql<'q>

where DB: Database,

impl<'q, DB, A> Execute<'q, DB> for Query<'q, DB, A>

where DB: Database, A: Send + IntoArguments<'q, DB>,

impl<'q, DB, F, A> Execute<'q, DB> for Map<'q, DB, F, A>

where F: Send, A: Send + IntoArguments<'q, DB>, DB: Database,

impl<'q, DB, O, A> Execute<'q, DB> for QueryAs<'q, DB, O, A>

where O: Send, A: Send + 'q + IntoArguments<'q, DB>, DB: Database,

impl<'q, DB, O, A> Execute<'q, DB> for QueryScalar<'q, DB, O, A>

where DB: Database, O: Send, A: Send + 'q + IntoArguments<'q, DB>,