Query

Struct Query 

Source
pub struct Query<QB> { /* private fields */ }
Expand description

Struct representing a SQL-like query for QuickBooks entities

Implementations§

Source§

impl<QB: QBItem> Query<QB>

Source

pub fn new() -> Self

Create a new empty query

Source

pub unsafe fn condition(self, condition: WhereClause) -> Self

Add a condition to the query

§Safety

This function is unsafe because it accepts a raw WhereClause. The caller must ensure that the WhereClause is valid and corresponds to the QuickBooks entity.

Source

pub fn typed_condition(self, condition: TypedWhereClause<QB>) -> Self

Add a typed condition to the query

This is safe because the typed where clause ensures that the field and values are valid for the QuickBooks entity.

Source

pub unsafe fn order(self, field: &'static str, order: Order) -> Self

Add an order clause to the query

§Safety

This function is unsafe because it accepts a raw string slice as the field name. The caller must ensure that the field name is valid and corresponds to a field in the QuickBooks entity.

Source

pub fn limit(self, number: u32, offset: Option<u32>) -> Self

Set a limit on the number of results returned by the query

Source

pub fn query_string(&self) -> String

Generate the query string

Source

pub fn execute( &self, qb: &QBContext, client: &Agent, ) -> Result<Vec<QB>, APIError>

Execute the query against the QuickBooks API, returning a vector of results or an error

§Errors

This function will return an error if the API request fails or if the response cannot be parsed.

Trait Implementations§

Source§

impl<QB: Clone> Clone for Query<QB>

Source§

fn clone(&self) -> Query<QB>

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<QB: Debug> Debug for Query<QB>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<QB: QBItem> Default for Query<QB>

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<QB: QBItem> Display for Query<QB>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<QB: PartialEq> PartialEq for Query<QB>

Source§

fn eq(&self, other: &Query<QB>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl<QB> StructuralPartialEq for Query<QB>

Auto Trait Implementations§

§

impl<QB> Freeze for Query<QB>

§

impl<QB> RefUnwindSafe for Query<QB>
where QB: RefUnwindSafe,

§

impl<QB> Send for Query<QB>
where QB: Send,

§

impl<QB> Sync for Query<QB>
where QB: Sync,

§

impl<QB> Unpin for Query<QB>
where QB: Unpin,

§

impl<QB> UnwindSafe for Query<QB>
where QB: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.