/ 
Catmandu-FedoraCommons-0.3
River stage zero No dependents
/ Catmandu::Store::File::FedoraCommons::Index

NAME

Catmandu::Store::File::FedoraCommons::Index - Index of all "Folders" in a Catmandu::Store::File::FedoraCommons

SYNOPSIS

use Catmandu;

my $store = Catmandu->store('File::FedoraCommons'
                    , baseurl   => 'http://localhost:8080/fedora'
                    , username  => 'fedoraAdmin'
                    , password  => 'fedoraAdmin'
                    , namespace => 'demo'
                    , purge     => 1);

my $index = $store->index;

# List all containers
$index->each(sub {
    my $container = shift;

    print "%s\n" , $container->{_id};
});

# Add a new folder
$index->add({_id => '1234'});

# Delete a folder
$index->delete(1234);

# Get a folder
my $folder = $index->get(1234);

# Get the files in an folder
my $files = $index->files(1234);

$files->each(sub {
    my $file = shift;

    my $name         = $file->_id;
    my $size         = $file->size;
    my $content_type = $file->content_type;
    my $created      = $file->created;
    my $modified     = $file->modified;

    $file->stream(IO::File->new(">/tmp/$name"), file);
});

# Add a file
$files->upload(IO::File->new("<data.dat"),"data.dat");

# Retrieve a file
my $file = $files->get("data.dat");

# Stream a file to an IO::Handle
$files->stream(IO::File->new(">data.dat"),$file);

# Delete a file
$files->delete("data.dat");

# Delete a folders
$index->delete("1234");

DESCRIPTION

A Catmandu::Store::File::FedoraCommons::Index contains all "folders" available in a Catmandu::Store::File::FedoraCommons FileStore. All methods of Catmandu::Bag, Catmandu::FileBag::Index and Catmandu::Droppable are implemented.

Every Catmandu::Bag is also an Catmandu::Iterable.

FOLDERS

All files in a Catmandu::Store::File::FedoraCommons are organized in "folders". To add a "folder" a new record needs to be added to the Catmandu::Store::File::FedoraCommons::Index :

$index->add({_id => '1234'});

The _id field is the only metadata available in FedoraCommons stores. To add more metadata fields to a FedoraCommons store a Catmandu::Plugin::SideCar is required.

FILES

Files can be accessed via the "folder" identifier:

my $files = $index->files('1234');

Use the upload method to add new files to a "folder". Use the download method to retrieve files from a "folder".

$files->upload(IO::File->new("</tmp/data.txt"),'data.txt');

my $file = $files->get('data.txt');

$files->download(IO::File->new(">/tmp/data.txt"),$file);

METHODS

each(\&callback)

Execute callback on every "folder" in the FedoraCommons store. See Catmandu::Iterable for more iterator functions

exists($id)

Returns true when a "folder" with identifier $id exists.

add($hash)

Adds a new "folder" to the FedoraCommons store. The $hash must contain an _id field.

get($id)

Returns a hash containing the metadata of the folder. In the FedoraCommons store this hash will contain only the "folder" idenitifier.

files($id)

Return the Catmandu::Store::File::FedoraCommons::Bag that contains all "files" in the "folder" with identifier $id.

delete($id)

Delete the "folder" with identifier $id, if exists.

delete_all()

Delete all folders in this store.

drop()

Delete the store.

SEE ALSO

Catmandu::Store::File::FedoraCommons::Bag , Catmandu::Store::File::FedoraCommons , Catmandu::FileBag::Index , Catmandu::Plugin::SideCar , Catmandu::Bag , Catmandu::Droppable , Catmandu::Iterable