=back
+=head1 AUTHOR
+
+Adam Jacob <adam@stalecoffee.org>, with lots of help from mst and jrockway
+
+Marchex, Inc. paid me while I developed this module. (L<http://www.marchex.com>)
+
=head1 CONTRIBUTORS
Arthur Axel "fREW" Schmidt <frioux@gmail.com>
Tomas Doran (t0m) <bobtfish@bobtfish.net>
-=head1 AUTHOR
+=head1 COPYRIGHT
-Adam Jacob <adam@stalecoffee.org>, with lots of help from mst and jrockway
-
-Marchex, Inc. paid me while I developed this module. (L<http://www.marchex.com>)
+Copyright the above named AUTHOR and CONTRIBUTORS
=head1 LICENSE
=head1 SYNOPSIS
package Foo::Controller::Bar;
-
- use base 'Catalyst::Controller::REST';
+ use Moose;
+ use namespace::autoclean;
+
+ BEGIN { extends 'Catalyst::Controller::REST' }
sub thing : Local : ActionClass('REST') { }
To make your Controller RESTful, simply have it
- BEGIN {extends 'Catalyst::Controller::REST'; }
-
-Or if you use pre-Moose Catalyst versions,
-
- use parent 'Catalyst::Controller::REST';
-
+ BEGIN { extends 'Catalyst::Controller::REST' }
=head1 CONFIGURATION
See L<Catalyst::Action::Serialize/CONFIGURATION>. Note that the C<serialize>
key has been deprecated.
-
=head1 SERIALIZATION
Catalyst::Controller::REST will automatically serialize your
which serializer to use by mapping a content-type to a Serialization module.
We select the content-type based on:
-=over 2
+=over
=item B<The Content-Type Header>
=back
-
=head1 AVAILABLE SERIALIZERS
A given serialization mechanism is only available if you have the underlying
'text/html' => [ 'View', 'TT' ],
'text/xml' => [ 'View', 'XML' ],
}
- );
+ );
Your views should have a C<process> method like this:
sub process {
my ( $self, $c, $stash_key ) = @_;
-
+
my $output;
eval {
$output = $self->serialize( $c->stash->{$stash_key} );
};
return $@ if $@;
-
+
$c->response->body( $output );
return 1; # important
}
sub serialize {
my ( $self, $data ) = @_;
-
+
my $serialized = ... process $data here ...
-
+
return $serialized;
}
-
=back
content-type is made. You can ensure that something is always returned by
setting the C<default> config option:
- __PACKAGE__->config->{'default'} = 'text/x-yaml';
+ __PACKAGE__->config(default => 'text/x-yaml');
would make it always fall back to the serializer plugin defined for
C<text/x-yaml>.
These routines are all implemented as regular subroutines, and as
such require you pass the current context ($c) as the first argument.
-=over 4
+=over
=cut
The REST Wiki: http://rest.blueoxen.net/cgi-bin/wiki.pl?FrontPage
-=head1 AUTHOR
-
-Adam Jacob <adam@stalecoffee.org>, with lots of help from mst and jrockway
-
-Marchex, Inc. paid me while I developed this module. (http://www.marchex.com)
-
-=head1 MAINTAINER
+=head1 AUTHORS
-J. Shirley <jshirley@cpan.org>
+See L<Catalyst::Action::REST> for authors.
=head1 LICENSE