Florian Ragwitz > Catalyst-Controller-DBIC-API-2.002001 > Catalyst::Controller::DBIC::API::REST

Download:
Catalyst-Controller-DBIC-API-2.002001.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
Stalled  1
View/Report Bugs
Module Version: 2.002001   Source   Latest Release: Catalyst-Controller-DBIC-API-2.006002

NAME ^

Catalyst::Controller::DBIC::API::REST - Provides a REST interface to DBIx::Class

VERSION ^

version 2.002001

DESCRIPTION ^

Provides a REST style API interface to the functionality described in Catalyst::Controller::DBIC::API.

By default provides the following endpoints:

  $base (operates on lists of objects and accepts GET, PUT, POST and DELETE)
  $base/[identifier] (operates on a single object and accepts GET, PUT, POST and DELETE)

Where $base is the URI described by "setup", the chain root of the controller, and the request type will determine the Catalyst::Controller::DBIC::API method to forward.

PROTECTED_METHODS ^

setup

Chained: override PathPart: override CaptureArgs: 0

As described in "setup" in Catalyst::Controller::DBIC::API, this action is the chain root of the controller but has no pathpart or chain parent defined by default, so these must be defined in order for the controller to function. The neatest way is normally to define these using the controller's config.

  __PACKAGE__->config
    ( action => { setup => { PathPart => 'track', Chained => '/api/rest/rest_base' } },
        ...
  );

no_id

Chained: "objects_no_id" PathPart: none CaptureArgs: 0

Calls list level methods described in Catalyst::Controller::DBIC::API as follows:

DELETE: "delete" in Catalyst::Controller::DBIC::API POST/PUT: "update_or_create" in Catalyst::Controller::DBIC::API GET: forwards to "list" in Catalyst::Controller::DBIC::API

with_id

Chained: "object_with_id" PathPart: none CaptureArgs: 0

Forwards to list level methods described in Catalyst::Controller::DBIC::API as follows:

DELETE: "delete" in Catalyst::Controller::DBIC::API POST/PUT: "update_or_create" in Catalyst::Controller::DBIC::API GET: forwards to "item" in Catalyst::Controller::DBIC::API

AUTHORS ^

  Nicholas Perez <nperez@cpan.org>
  Luke Saunders <luke.saunders@gmail.com>
  Alexander Hartmaier <abraxxa@cpan.org>
  Florian Ragwitz <rafl@debian.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2010 by Luke Saunders, Nicholas Perez, et al..

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

syntax highlighting: