Struct mongod::query::Insert

pub struct Insert<C: Collection> { /* fields omitted */ }

A querier to insert documents into a MongoDB collection.

Examples

Insert a document into a collection.

#[derive(Bson, Mongo)]
#[mongo(collection="users", field, filter, update)]
pub struct User {
    name: String,
}

let client = mongod::Client::new();

let user = User { name: "foo".to_owned() };

let result = mongod::query::Insert::<User>::new()
    .query(&client, vec![user])
    .await
    .unwrap();

println!("(index: oid) {:?}", result);

Implementations

impl<C: Collection> Insert<C>

pub fn new() -> Self

Constructs a Insert querier.

pub fn bypass_document_validation(mut self: Self, enable: bool) -> Self

Opt out of document-level validation.

pub fn ordered(mut self: Self, enable: bool) -> Self

If true, when an insert fails, return without performing the remaining writes. If false, when a write fails, continue with the remaining writes, if any.

Defaults to true.

pub fn write_concern(mut self: Self, write_concern: WriteConcern) -> Self

The write concern for the operation.

pub async fn query(
    self,
    client: &Client,
    documents: Vec<C>
) -> Result<HashMap<usize, Bson>, Error> where
    C: Collection, 

Query the database with this querier.

Errors

This method fails if:

• any of the documents could not be converted into a BSON Document.
• the mongodb encountered an error.

pub fn blocking(
    self,
    client: &Client,
    documents: Vec<C>
) -> Result<HashMap<usize, Bson>, Error> where
    C: Collection, 

Query the database with this querier in a blocking context.

Optional

This requires the optional blocking feature to be enabled.

Errors

This method fails if:

• any of the documents could not be converted into a BSON Document.
• the mongodb encountered an error.

Trait Implementations

impl<C: Clone + Collection> Clone for Insert<C>

fn clone(&self) -> Insert<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C: Collection> Default for Insert<C>

fn default() -> Self

Returns the "default value" for a type.