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".