Struct dgraph_tonic::Mutation

pub struct Mutation {
    pub set_json: Vec<u8>,
    pub delete_json: Vec<u8>,
    pub set_nquads: Vec<u8>,
    pub del_nquads: Vec<u8>,
    pub set: Vec<NQuad>,
    pub del: Vec<NQuad>,
    pub cond: String,
    pub commit_now: bool,
}

Fields

set_json: Vec<u8>

delete_json: Vec<u8>

set_nquads: Vec<u8>

del_nquads: Vec<u8>

set: Vec<NQuad>

del: Vec<NQuad>

cond: String

This is being used for upserts.

commit_now: bool

This field is a duplicate of the one in Request and placed here for convenience.

Implementations

impl Mutation

pub fn new() -> Self

Create new Dgraph Mutation object.

Mutation represent required modification of data in DB. Mutation provides two main ways to set data: JSON and RDF N-Quad. You can choose whichever way is convenient. JSON way has implemented to helper functions.

pub fn set_set_json<T: ?Sized>(&mut self, value: &T) -> Result<(), Error> where
    T: Serialize, 

Set set JSON data in Mutation.

Arguments

• value - ref to struct which can be serialized into JSON

Errors

Return serde_json:Error when value cannot be serialized to JSON format

Examples

use dgraph_tonic::Mutation;
use serde::Serialize;

#[derive(Serialize)]
struct Person {
  uid: String,
  name: String,
}

let p = Person {
  uid:  "_:alice".into(),
  name: "Alice".into(),
};

let mut mu = Mutation::new();
mu.set_set_json(&p).expect("JSON");

pub fn set_delete_json<T: ?Sized>(&mut self, value: &T) -> Result<(), Error> where
    T: Serialize, 

Set delete JSON data in Mutation.

Arguments

• value - ref to struct which can be serialized into JSON

Errors

Return serde_json:Error when value cannot be serialized to JSON format

Examples

use dgraph_tonic::Mutation;
use serde::Serialize;

#[derive(Serialize)]
struct Person {
  uid: String,
  name: Option<String>,
}

let p = Person {
  uid:  "_:0x1".into(),
  name: None,
};

let mut mu = Mutation::new();
//remove name predicate
mu.set_delete_json(&p).expect("JSON");

pub fn set_set_nquads<S: Into<String>>(&mut self, nquads: S)

Set set Nquads in Mutation.

Arguments

• nquads - set nquads

Examples

use dgraph_tonic::Mutation;

let mut mu = Mutation::new();
//remove name predicate
mu.set_set_nquads(r#"uid(user) <email> "correct_email@dgraph.io" ."#);

pub fn set_delete_nquads<S: Into<String>>(&mut self, nquads: S)

Set delete Nquads in Mutation.

Arguments

• nquads - delete nquads

Examples

use dgraph_tonic::Mutation;

let mut mu = Mutation::new();
//remove name predicate
mu.set_set_nquads(r#"uid(user) <email> * ."#);

pub fn set_cond<S: Into<String>>(&mut self, cond: S)

Set set condition in Mutation.

Arguments

• cond - set nquads

Examples

use dgraph_tonic::Mutation;

let mut mu = Mutation::new();
//remove name predicate
mu.set_cond("@if(eq(len(user), 1))");

Trait Implementations

impl Clone for Mutation

fn clone(&self) -> Mutation

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Mutation

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

Formats the value using the given formatter.

impl Default for Mutation

fn default() -> Mutation

Returns the "default value" for a type.

impl Message for Mutation

fn encode_raw<B>(&self, buf: &mut B) where
    B: BufMut, 

fn merge_field<B>(
    &mut self,
    tag: u32,
    wire_type: WireType,
    buf: &mut B,
    ctx: DecodeContext
) -> Result<(), DecodeError> where
    B: Buf, 

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode<B>(&self, buf: &mut B) -> Result<(), EncodeError> where
    B: BufMut, 

Encodes the message to a buffer.

fn encode_length_delimited<B>(&self, buf: &mut B) -> Result<(), EncodeError> where
    B: BufMut, 

Encodes the message with a length-delimiter to a buffer.

fn decode<B>(buf: B) -> Result<Self, DecodeError> where
    B: Buf,
    Self: Default, 

Decodes an instance of the message from a buffer.

fn decode_length_delimited<B>(buf: B) -> Result<Self, DecodeError> where
    B: Buf,
    Self: Default, 

Decodes a length-delimited instance of the message from the buffer.

fn merge<B>(&mut self, buf: B) -> Result<(), DecodeError> where
    B: Buf, 

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited<B>(&mut self, buf: B) -> Result<(), DecodeError> where
    B: Buf, 

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq<Mutation> for Mutation

fn eq(&self, other: &Mutation) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for Mutation