Struct exonum_middleware_service::Batch

pub struct Batch {
    pub inner: Vec<AnyTx>,
}

Transactions executed in a batch.

Examples

Batch is a mutable stub, which adds corresponding transactions on call:

// Suppose we have this interface defined.
mod token {
    #[exonum_interface]
    pub trait Token<Ctx> {
        type Output;
        #[interface_method(id = 0)]
        fn create_wallet(&self, ctx: Ctx, owner: String) -> Self::Output;
        #[interface_method(id = 1)]
        fn burn(&self, ctx: Ctx, amount: u64) -> Self::Output;
        // Other methods...
    }
}

use exonum_middleware_service::{
    ArtifactReq, Batch, MiddlewareInterfaceMut, MiddlewareService,
};
use token::{Token, TokenMut};

const TOKEN_ID: InstanceId = 100;

let mut batch = Batch::new();
batch.create_wallet(TOKEN_ID, "Alice".into());
batch.burn(TOKEN_ID, 50);
// Batch can include calls to multiple services. Let's add
// a checked call to the token service, which will be routed
// through a default middleware service instance.
let req: ArtifactReq = "exonum.Token@1".parse().unwrap();
let checked_call = req.burn(TOKEN_ID, 20);
batch.checked_call(MiddlewareService::INSTANCE_ID, checked_call);
assert_eq!(batch.inner.len(), 3);

Fields

inner: Vec<AnyTx>

Transactions included in the batch.

Methods

impl Batch

pub fn new() -> Self

Creates an empty batch.

pub fn with_call(self, call: AnyTx) -> Self

Appends a call into the batch.

Trait Implementations

impl BinaryValue for Batch

fn to_bytes(&self) -> Vec<u8>

Serializes the given value to the vector of bytes.

fn from_bytes(value: Cow<[u8]>) -> Result<Self, Error>

Deserializes the value from the given bytes array.

fn into_bytes(self) -> Vec<u8>

Consumes and serializes the given value to the vector of bytes. This method is faster with the wrapped values, thus if you wouldn't use value after serialization use it.

impl Clone for Batch

fn clone(&self) -> Batch

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Batch

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

Formats the value using the given formatter.

impl Default for Batch

fn default() -> Batch

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for Batch

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl GenericCallMut<u32> for Batch

type Output = ()

Type of values output by the stub.

fn generic_call_mut(
    &mut self,
    instance_id: InstanceId,
    method: MethodDescriptor,
    args: Vec<u8>
) -> Self::Output

Calls a stub method.

impl ProtobufConvert for Batch

type ProtoStruct = Batch

Type of the protobuf clone of Self

fn from_pb(pb: Self::ProtoStruct) -> Result<Self, Error>

ProtoStruct -> Struct

fn to_pb(&self) -> Self::ProtoStruct

Struct -> ProtoStruct

impl Serialize for Batch

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.