NAME

Zing::Dropbox - Transient Store

ABSTRACT

Transient Key/Value Store

SYNOPSIS

use Zing::Dropbox;

my $dropbox = Zing::Dropbox->new;

DESCRIPTION

This package provides a general-purpose key/value store for transient data.

INHERITS

This package inherits behaviors from:

Zing::KeyVal

LIBRARIES

This package uses type constraints from:

Zing::Types

METHODS

This package implements the following methods:

poll

poll(Str $name, Int $secs) : Maybe[HashRef]

The poll method watches (i.e. polls) the key specified for n seconds and either a) returns the data once it's received and drops the key, or b) returns undefined.

poll example #1

# given: synopsis

$dropbox->poll(ephemeral => 0);

poll example #2

# given: synopsis

# some other process places the data
$dropbox->send(ephemeral => { data => '...' });

# poll "ephemeral" for 10 secs, except the data was already placed
$dropbox->poll(ephemeral => 10);

poll example #3

# given: synopsis

# poll "ephemeral" for 10 secs
$dropbox->poll(ephemeral => 10);

# some other process places the data
$dropbox->send(ephemeral => { data => '...' });

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