cdrs-async 0.1.0-alpha.0

Asynchronous driver for Apache Cassandra
Documentation 
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

use std::pin::Pin;

use async_trait::async_trait;
use cassandra_proto::{
  error,
  frame::Frame,
  query::{QueryParams, QueryParamsBuilder, QueryValues},
};

/// Traits that provides methods for immediate query execution.
#[async_trait]
pub trait QueryExecutor: Send {
  async fn query_with_params_tw<Q: ToString + Send>(
    mut self: Pin<&mut Self>,
    query: Q,
    query_params: QueryParams,
    with_tracing: bool,
    with_warnings: bool,
  ) -> error::Result<Frame>;

  /// Executes a query with default parameters:
  /// * TDB
  async fn query<Q: ToString + Send>(mut self: Pin<&mut Self>, query: Q) -> error::Result<Frame> {
    self.query_tw(query, false, false).await
  }

  /// Executes a query with ability to trace it and see warnings, and default parameters:
  /// * TBD
  async fn query_tw<Q: ToString + Send>(
    mut self: Pin<&mut Self>,
    query: Q,
    with_tracing: bool,
    with_warnings: bool,
  ) -> error::Result<Frame> {
    let query_params = QueryParamsBuilder::new().finalize();
    self
      .query_with_params_tw(query, query_params, with_tracing, with_warnings)
      .await
  }

  /// Executes a query with bounded values (either with or without names).
  async fn query_with_values<Q: ToString + Send, V: Into<QueryValues> + Send>(
    mut self: Pin<&mut Self>,
    query: Q,
    values: V,
  ) -> error::Result<Frame> {
    self.query_with_values_tw(query, values, false, false).await
  }

  /// Executes a query with bounded values (either with or without names)
  /// and ability to see warnings, trace a request and default parameters.
  async fn query_with_values_tw<Q: ToString + Send, V: Into<QueryValues> + Send>(
    mut self: Pin<&mut Self>,
    query: Q,
    values: V,
    with_tracing: bool,
    with_warnings: bool,
  ) -> error::Result<Frame> {
    let query_params_builder = QueryParamsBuilder::new();
    let query_params = query_params_builder.values(values.into()).finalize();
    self
      .query_with_params_tw(query, query_params, with_tracing, with_warnings)
      .await
  }

  /// Executes a query with query params without warnings and tracing.
  async fn query_with_params<Q: ToString + Send>(
    mut self: Pin<&mut Self>,
    query: Q,
    query_params: QueryParams,
  ) -> error::Result<Frame> {
    self
      .query_with_params_tw(query, query_params, false, false)
      .await
  }
}