Struct hdk::prelude::QueryFilter

pub struct QueryFilter {
    pub sequence_range: ChainQueryFilterRange,
    pub entry_type: Option<Vec<EntryType>>,
    pub entry_hashes: Option<HashSet<HoloHash<Entry>>>,
    pub action_type: Option<Vec<ActionType>>,
    pub include_entries: bool,
    pub order_descending: bool,
}

Specifies arguments to a query of the source chain, including ordering and filtering.

This struct is used to construct an actual SQL query on the database, and also has methods to allow filtering in-memory.

Fields

sequence_range: ChainQueryFilterRange

Limit the results to a range of records according to their actions.

entry_type: Option<Vec<EntryType>>

Filter by EntryType

entry_hashes: Option<HashSet<HoloHash<Entry>>>

Filter by a list of EntryHash.

action_type: Option<Vec<ActionType>>

Filter by ActionType

include_entries: bool

Include the entries in the records

order_descending: bool

The query should be ordered in descending order (default is ascending), when run as a database query. There is no provisioning for in-memory ordering.

Implementations

impl ChainQueryFilter

pub fn new() -> ChainQueryFilter

Create a no-op ChainQueryFilter which returns everything.

pub fn sequence_range( self, sequence_range: ChainQueryFilterRange ) -> ChainQueryFilter

Filter on sequence range.

pub fn entry_type(self, entry_type: EntryType) -> ChainQueryFilter

Filter on entry type. This function can be called multiple times to create an OR query on all provided entry types.

pub fn entry_hashes( self, entry_hashes: HashSet<HoloHash<Entry>> ) -> ChainQueryFilter

Filter on entry hashes.

pub fn action_type(self, action_type: ActionType) -> ChainQueryFilter

Filter on action type. This function can be called multiple times to create an OR query on all provided action types.

pub fn include_entries(self, include_entries: bool) -> ChainQueryFilter

Include the entries in the RecordsVec that is returned.

pub fn ascending(self) -> ChainQueryFilter

Set the order to ascending.

pub fn descending(self) -> ChainQueryFilter

Set the order to ascending.

pub fn disambiguate_forks( &self, actions: Vec<HoloHashed<Action>> ) -> Vec<HoloHashed<Action>>

If the sequence range supports fork disambiguation, apply it to remove actions that are not in the correct branch. Numerical range bounds do NOT support fork disambiguation, and neither does unbounded, but everything hash bounded does.

pub fn filter_actions( &self, actions: Vec<HoloHashed<Action>> ) -> Vec<HoloHashed<Action>>

Filter a vector of hashed actions according to the query.

pub fn filter_records(&self, records: Vec<Record>) -> Vec<Record>

Filter a vector of records according to the query.

Trait Implementations

impl Clone for ChainQueryFilter

fn clone(&self) -> ChainQueryFilter

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ChainQueryFilter

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

Formats the value using the given formatter.

impl Default for ChainQueryFilter

fn default() -> ChainQueryFilter

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ChainQueryFilter

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ChainQueryFilter

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ChainQueryFilter

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&ChainQueryFilter> for SerializedBytes

type Error = SerializedBytesError

The type returned in the event of a conversion error.

fn try_from( t: &ChainQueryFilter ) -> Result<SerializedBytes, SerializedBytesError>

Performs the conversion.

impl TryFrom<ChainQueryFilter> for SerializedBytes

type Error = SerializedBytesError

The type returned in the event of a conversion error.

fn try_from( t: ChainQueryFilter ) -> Result<SerializedBytes, SerializedBytesError>

Performs the conversion.

impl TryFrom<SerializedBytes> for ChainQueryFilter

type Error = SerializedBytesError

The type returned in the event of a conversion error.

fn try_from( sb: SerializedBytes ) -> Result<ChainQueryFilter, SerializedBytesError>

Performs the conversion.

impl StructuralPartialEq for ChainQueryFilter