Struct toql::query::Query

pub struct Query {
    pub distinct: bool,
    pub roles: BTreeSet<String>,
    // some fields omitted
}

A Query contains fields and wildcards. It can be turned into SQL using the SQL Builder.

To build a big query simple add fields and wildcards with and resp. or function.

Watch out: Logical AND has precendence over OR. So a AND b OR c is the same as a AND (b OR c). To insert parens in a query, build a separate query and add it with or. This will add parens automatically.

let q1 = Query::new().and(Field("b").eq(3)).and(Field("c").eq(2));
let q2 = Query::new().and(Field("a").eq(1)).or(q1);

assert_eq!("a eq 1; (b eq 3, c eq 2)", q2.to_string())

Fields

distinct: bool

roles: BTreeSet<String>

Methods

impl Query

pub fn new() -> Query

Create a new empty query.

pub fn wildcard() -> Query

Create a new query that select all top fields.

pub fn double_wildcard() -> Query

Create a new query that select all top fields and all dependend fields. This is the best :)

pub fn and<T>(self, query: T) -> Query where
    T: Into<Query>, 

Concatenate field or query with AND to query

pub fn or<T>(self, query: T) -> Query where
    T: Into<Query>, 

Concatenate field or query with OR to query. Puts parens around queries with more than one field.

pub fn prepend<T>(self, query: T) -> Query where
    T: Into<Query>, 

Trait Implementations

impl Debug for Query

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl Clone for Query

fn clone(&self) -> Query

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl From<Field> for Query

fn from(field: Field) -> Query

Performs the conversion.

impl<'_> From<&'_ str> for Query

fn from(string: &str) -> Query

Performs the conversion.

impl From<Wildcard> for Query

fn from(wildcard: Wildcard) -> Query

Performs the conversion.

impl Display for Query

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.