NAME

Zing::Store - Storage Abstraction

ABSTRACT

Data Storage Abstraction

SYNOPSIS

use Zing::Store;

my $store = Zing::Store->new;

# $store->drop;

DESCRIPTION

This package provides a data persistence interface to be implemented by data storage abstractions.

INHERITS

This package inherits behaviors from:

Zing::Entity

LIBRARIES

This package uses type constraints from:

Zing::Types

ATTRIBUTES

This package has the following attributes:

encoder

encoder(Encoder)

This attribute is read-only, accepts (Encoder) values, and is optional.

METHODS

This package implements the following methods:

args

args(Str $env) : (Any)

The args method parses strings with key/value data (typically from an environment variable) meant to be used in object construction.

args example #1

# given: synopsis

[$store->args('port=0001,debug=0')]

args example #2

# given: synopsis

[$store->args('ports=0001|0002,debug=0')]

decode

decode(Str $data) : HashRef

The decode method should decode the data provided and returns the data as a hashref.

decode example #1

# given: synopsis

$store->decode('{ status => "ok" }');

# e.g.
# $ENV{ZING_ENCODER} # Zing::Encoder::Dump

drop

drop(Str $key) : Int

The drop method should remove items from the datastore by key.

drop example #1

# given: synopsis

$store->drop('model');

encode

encode(HashRef $data) : Str

The encode method should encode and return the data provided in a format suitable for the underlying storage mechanism.

encode example #1

# given: synopsis

$store->encode({ status => 'ok' });

keys

keys(Str @keys) : ArrayRef[Str]

The keys method should return a list of keys under the namespace provided including itself.

keys example #1

# given: synopsis

my $keys = $store->keys('zing:main:global:model:temp');

lpull

lpull(Str $key) : Maybe[HashRef]

The lpull method should pop data off of the top of a list in the datastore.

lpull example #1

# given: synopsis

$store->lpull('zing:main:global:model:items');

lpush

lpush(Str $key) : Int

The lpush method should push data onto the top of a list in the datastore.

lpush example #1

# given: synopsis

# $store->rpush('zing:main:global:model:items', { status => '1' });
# $store->rpush('zing:main:global:model:items', { status => '2' });

$store->lpush('zing:main:global:model:items', { status => '0' });

recv

recv(Str $key) : Maybe[HashRef]

The recv method should fetch and return data from the datastore by its key.

recv example #1

# given: synopsis

$store->recv('zing:main:global:model:temp');

rpull

rpull(Str $key) : Maybe[HashRef]

The rpull method should pop data off of the bottom of a list in the datastore.

rpull example #1

# given: synopsis

$store->rpull('zing:main:global:model:items');

rpush

rpush(Str $key, HashRef $val) : Int

The rpush method should push data onto the bottom of a list in the datastore.

rpush example #1

# given: synopsis

$store->rpush('zing:main:global:model:items', { status => 'ok' });

send

send(Str $key, HashRef $val) : Str

The send method should commit data to the datastore with its key and return truthy (or falsy if not).

send example #1

# given: synopsis

$store->send('zing:main:global:model:temp', { status => 'ok' });

size

size(Str $key) : Int

The size method should return the size of a list in the datastore.

size example #1

# given: synopsis

my $size = $store->size('zing:main:global:model:items');

slot

slot(Str $key, Int $pos) : Maybe[HashRef]

The slot method should return the data from a list in the datastore by its position in the list.

slot example #1

# given: synopsis

my $model = $store->slot('zing:main:global:model:items', 0);

test

test(Str $key) : Int

The test method should return truthy if the specific key exists in the datastore.

test example #1

# given: synopsis

# $store->rpush('zing:main:global:model:items', { status => 'ok' });

$store->test('zing:main:global:model:items');

AUTHOR

Al Newkirk, awncorp@cpan.org

LICENSE

This is free software; you can redistribute it and/or modify it under the terms of the The Apache License, Version 2.0, as elucidated in the "license file".