Trait msql_srv::MysqlShim

pub trait MysqlShim<W: Read + Write> {
    type Error: From<Error>;

    fn on_prepare(
        &mut self,
        query: &str,
        info: StatementMetaWriter<'_, W>
    ) -> Result<(), Self::Error>;
    fn on_execute(
        &mut self,
        id: u32,
        params: ParamParser<'_>,
        results: QueryResultWriter<'_, W>
    ) -> Result<(), Self::Error>;
    fn on_close(&mut self, stmt: u32);
    fn on_query(
        &mut self,
        query: &str,
        results: QueryResultWriter<'_, W>
    ) -> Result<(), Self::Error>;

    fn on_init(
        &mut self,
        _: &str,
        _: InitWriter<'_, W>
    ) -> Result<(), Self::Error> { ... }
    fn tls_config(&self) -> Option<Arc<ServerConfig>> { ... }
    fn after_authentication(
        &mut self,
        _context: &AuthenticationContext<'_>
    ) -> Result<(), Self::Error> { ... }
}

Implementors of this trait can be used to drive a MySQL-compatible database backend.

Required Associated Types

type Error: From<Error>

The error type produced by operations on this shim.

Must implement From<io::Error> so that transport-level errors can be lifted.

Required Methods

fn on_prepare(
    &mut self,
    query: &str,
    info: StatementMetaWriter<'_, W>
) -> Result<(), Self::Error>

Called when the client issues a request to prepare query for later execution.

The provided StatementMetaWriter should be used to notify the client of the statement id assigned to the prepared statement, as well as to give metadata about the types of parameters and returned columns.

fn on_execute(
    &mut self,
    id: u32,
    params: ParamParser<'_>,
    results: QueryResultWriter<'_, W>
) -> Result<(), Self::Error>

Called when the client executes a previously prepared statement.

Any parameters included with the client’s command is given in params. A response to the query should be given using the provided QueryResultWriter.

fn on_close(&mut self, stmt: u32)

Called when the client wishes to deallocate resources associated with a previously prepared statement.

fn on_query(
    &mut self,
    query: &str,
    results: QueryResultWriter<'_, W>
) -> Result<(), Self::Error>

Called when the client issues a query for immediate execution.

Results should be returned using the given QueryResultWriter.

Provided Methods

fn on_init(&mut self, _: &str, _: InitWriter<'_, W>) -> Result<(), Self::Error>

Called when client switches database.

fn tls_config(&self) -> Option<Arc<ServerConfig>>

Provides the TLS configuration, if we want to support TLS.

fn after_authentication(
    &mut self,
    _context: &AuthenticationContext<'_>
) -> Result<(), Self::Error>

Called after successful authentication (including TLS if applicable) passing relevant information to allow additional logic in the MySqlShim implementation.

Implementors