Struct sn_data_types::register::Register

pub struct Register { /* fields omitted */ }

Object storing the Register

Implementations

impl Register

pub fn new_public(
    authority: PublicKey,
    name: XorName,
    tag: u64,
    policy: Option<PublicPolicy>
) -> Self

Construct a new Public Register. The ‘authority’ is assumed to be the PK which the messages were and will be signed with. If a policy is not provided, a default policy will be set where the ‘authority’ is the owner along with an empty users permissions set.

pub fn new_private(
    authority: PublicKey,
    name: XorName,
    tag: u64,
    policy: Option<PrivatePolicy>
) -> Self

Construct a new Private Register. The ‘authority’ is assumed to be the PK which the messages were and will be signed with. If a policy is not provided, a default policy will be set where the ‘authority’ is the owner along with an empty users permissions set.

pub fn address(&self) -> &Address

Return the address.

pub fn kind(&self) -> Kind

Return the kind.

pub fn name(&self) -> &XorName

Return the name.

pub fn tag(&self) -> u64

Return the tag.

pub fn is_public(&self) -> bool

Return true if public.

pub fn is_private(&self) -> bool

Return true if private.

pub fn size(&self, requester: Option<PublicKey>) -> Result<u64>

Return the number of items held in the register, optionally verifying read permissions if a pk is provided

pub fn is_empty(&self, requester: Option<PublicKey>) -> Result<bool>

Return true if the register is empty.

pub fn get(
    &self,
    hash: EntryHash,
    requester: Option<PublicKey>
) -> Result<Option<&Entry>>

Return a value corresponding to the provided ‘hash’, if present.

pub fn read(
    &self,
    requester: Option<PublicKey>
) -> Result<BTreeSet<(EntryHash, Entry)>>

Read the last entry, or entries when there are branches, if the register is not empty.

pub fn write(
    &mut self,
    entry: Entry,
    parents: BTreeSet<EntryHash>
) -> Result<(EntryHash, RegisterOp<Entry>)>

Write an entry to the Register, returning the generated unsigned CRDT operation so the caller can sign and broadcast it to other replicas, along with the hash of the entry just written.

pub fn apply_op(&mut self, op: RegisterOp<Entry>) -> Result<()>

Apply a signed data CRDT operation.

pub fn permissions(
    &self,
    user: User,
    requester: Option<PublicKey>
) -> Result<Permissions>

Return user permissions, if applicable.

pub fn policy(&self, requester: Option<PublicKey>) -> Result<&Policy>

Return the policy.

pub fn check_permission(
    &self,
    action: Action,
    requester: Option<PublicKey>
) -> Result<()>

Helper to check permissions for given action for the given requester’s public key.

Returns: Ok(()) if the permissions are valid, Err::AccessDenied if the action is not allowed.

pub fn owner(&self) -> PublicKey

Return the owner of the data.

pub fn replica_authority(&self) -> PublicKey

Return the PK which the messages are expected to be signed with by this replica.

Trait Implementations

impl Clone for Register

fn clone(&self) -> Register

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Register

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Register

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

Deserialize this value from the given Serde deserializer.

impl Eq for Register

impl From<Register> for Data

fn from(data: Register) -> Self

Performs the conversion.

impl Hash for Register

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Register> for Register

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

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

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

This method tests for !=.

impl PartialOrd<Register> for Register

fn partial_cmp(&self, other: &Register) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

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

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

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

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Register

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

Serialize this value into the given Serde serializer.

impl StructuralEq for Register

impl StructuralPartialEq for Register