/ 
Data-Hive-0.054
River stage one • 1 direct dependent • 1 total dependent
/ Data::Hive::Store

NAME

Data::Hive::Store - a backend storage driver for Data::Hive

VERSION

version 0.054

DESCRIPTION

Data::Hive::Store is a generic interface to a backend store for Data::Hive.

METHODS

All methods are passed at least a 'path' (arrayref of namespace pieces). Store classes exist to operate on the entities found at named paths.

get

print $store->get(\@path, \%opt);

Return the resource represented by the given path.

set

$store->set(\@path, $value, \%opt);

Analogous to get.

name

print $store->name(\@path, \%opt);

Return a store-specific name for the given path. This is primarily useful for stores that may be accessed independently of the hive.

exists

if ($store->exists(\@path, \%opt)) { ... }

Returns true if the given path exists in the store.

delete

$store->delete(\@path, \%opt);

Delete the given path from the store. Return the previous value, if any.

keys

my @keys = $store->keys(\@path, \%opt);

This returns a list of next-level path elements that exist. For example, given a hive with values for the following paths:

foo
foo/bar
foo/bar/baz
foo/xyz/abc
foo/xyz/def
foo/123

This shows the expected results:

keys of      | returns
-------------+------------
foo          | bar, xyz, 123
foo/bar      | baz
foo/bar/baz  |
foo/xyz      | abc, def
foo/123      |

AUTHORS

  • Hans Dieter Pearcey <hdp@cpan.org>

  • Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2006 by Hans Dieter Pearcey.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.