Trait exonum_merkledb::BinaryValue

pub trait BinaryValue: Sized {
    fn to_bytes(&self) -> Vec<u8>;
    fn from_bytes(bytes: Cow<[u8]>) -> Result<Self, Error>;

    fn into_bytes(self) -> Vec<u8> { ... }
}

A type that can be (de)serialized as a value in the blockchain storage.

If you need to implement BinaryValue for your types, use little-endian encoding for integer types for compatibility with modern architectures.

Examples

Implementing BinaryValue for the type:

use std::{borrow::Cow, io::{Read, Write}};
use byteorder::{LittleEndian, ReadBytesExt, ByteOrder};
use failure;
use exonum_merkledb::BinaryValue;

#[derive(Clone)]
struct Data {
    a: i16,
    b: u32,
}

impl BinaryValue for Data {
    fn to_bytes(&self) -> Vec<u8> {
        let mut buf = vec![0_u8; 6];
        LittleEndian::write_i16(&mut buf[0..2], self.a);
        LittleEndian::write_u32(&mut buf[2..6], self.b);
        buf
    }

    fn from_bytes(bytes: Cow<[u8]>) -> Result<Self, failure::Error> {
        let mut buf = bytes.as_ref();
        let a = buf.read_i16::<LittleEndian>()?;
        let b = buf.read_u32::<LittleEndian>()?;
        Ok(Self { a, b })
    }
}

Required methods

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

Serializes the given value to the vector of bytes.

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

Deserializes the value from the given bytes array.

Loading content...

Provided methods

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.

Loading content...

Implementations on Foreign Types

impl BinaryValue for u8

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

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

impl BinaryValue for u16

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

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

impl BinaryValue for u32

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

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

impl BinaryValue for u64

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

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

impl BinaryValue for u128

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

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

impl BinaryValue for i8

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

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

impl BinaryValue for i16

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

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

impl BinaryValue for i32

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

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

impl BinaryValue for i64

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

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

impl BinaryValue for i128

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

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

impl BinaryValue for ()

No-op implementation.

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

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

impl BinaryValue for bool

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

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

impl BinaryValue for Vec<u8>

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

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

impl BinaryValue for String

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

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

impl BinaryValue for Hash

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

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

impl BinaryValue for PublicKey

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

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

impl BinaryValue for DateTime<Utc>

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

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

impl BinaryValue for Uuid

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

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

impl BinaryValue for Decimal

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

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

impl BinaryValue for [u8; 32]

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

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

Loading content...

Implementors

Loading content...