NAME

Plack::App::Catmandu::SRU - drop in replacement for Dancer::Plugin::Catmandu::SRU

SYNOPSIS

use Plack::Builder;
Plack::App::Catmandu::SRU;

builder {
    enable 'ReverseProxy';
    enable '+Dancer::Middleware::Rebase', base  => Catmandu->config->{uri_base}, strip => 1;
    mount "/sru" => Plack::App::Catmandu::SRU->new(
        store => 'search',
        bag   => 'publication',
        cql_filter => 'type = dataset',
        limit  => 100,
        maximum_limit => 500,
        record_schemas => [
            {
                identifier => "info:srw/schema/1/mods-v3.6",
                title => "MODS",
                name => "mods_36",
                template => "views/export/mods_36.tt",
                fix => 'fixes/pub.fix'
            },
        ],
    )->to_app;
};

CONSTRUCTOR ARGUMENTS

store

Name of Catmandu store in your catmandu store configuration

Default: default

bag

Name of Catmandu bag in your catmandu store configuration

Default: data

This must be a bag that implements Catmandu::CQLSearchable, and that configures a cql_mapping

cql_filter

A CQL query to find all records in the database that should be made available to SRU

default_record_schema

default metadata schema all records are shown in, when SRU parameter recordSchema is not gi en . Should be one listed in record_schemas

limit

The default number of records to be returned in each SRU request, when SRU parameter maximumRecords is not given during a searchRetrieve request.

When not provided in the constructor, it is derived from the default limit of your catmandu bag (see Catmandu::Searchable#default_limit)

maximum_limit

The maximum value allowed for request parameter maximumRecords.

When not provided in the constructor, it is derived from the maximum limit of your catmandu bag (see Catmandu::Searchable#maximum_limit)

record_schemas

An array of all supported record schemas. Each item in the array is an object with attributes:

* identifier - The SRU identifier for the schema (see http://www.loc.gov/standards/sru/recordSchemas/)

* name - A short descriptive name for the schema

* fix - Optionally an array of fixes to apply to the records before they are transformed into XML

* template - The path to a Template Toolkit file to transform your records into this format

template_options

An optional hash of configuration options that will be passed to Catmandu::Exporter::Template or Template

content_type

Set a custom content type header, the default is text/xml.

title

Title shown in databaseInfo

description

Description shown in databaseInfo

default_search_params

Extra search parameters added during search in your catmandu bag:

$bag->search(
    %{$self->default_search_params},
    cql_query    => $cql,
    sru_sortkeys => $request->sortKeys,
    limit        => $limit,
    start        => $first - 1,
);

Must be a hash reference

Note that search parameter cql_query, sru_sortkeys, limit and start are overwritten

As this is meant as a drop in replacement for Dancer::Plugin::Catmandu::SRU all arguments should be the same.

So all arguments can be taken from your previous dancer plugin configuration, if necessary:

use Dancer;
use Catmandu;
use Plack::Builder;
use Plack::App::Catmandu::SRU;

my $dancer_app = sub {
    Dancer->dance(Dancer::Request->new(env => $_[0]));
};

builder {
    enable 'ReverseProxy';
    enable '+Dancer::Middleware::Rebase', base  => Catmandu->config->{uri_base}, strip => 1;

    mount "/sru" => Plack::App::Catmandu::SRU->new(
        %{config->{plugins}->{'Catmandu::SRU'}}
    )->to_app;

    mount "/" => builder {
        # only create session cookies for dancer application
        enable "Session";
        mount '/' => $dancer_app;
    };
};

METHODS

to_app

returns Plack application that can be mounted. Path rebasements are taken into account

AUTHOR

Nicolas Franck, <nicolas.franck at ugent.be>

IMPORTANT

This module is still a work in progress, and needs further testing before using it in a production system

LICENSE AND COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.