added docs for engine/dispatcher
[catagits/Catalyst-Runtime.git] / lib / Catalyst / DispatchType.pm
1 package Catalyst::DispatchType;
2
3 use strict;
4 use base 'Class::Accessor::Fast';
5
6 =head1 NAME
7
8 Catalyst::DispatchType - DispatchType Base Class
9
10 =head1 SYNOPSIS
11
12 See L<Catalyst>.
13
14 =head1 DESCRIPTION
15
16 =head1 METHODS
17
18 =head2 $self->list($c)
19
20 abstract method, to be implemented by dispatchtypes. Called to display
21 info in debug log.
22
23 =cut
24
25 sub list { }
26
27 =head2 $self->match( $c, $path )
28
29 abstract method, to be implemented by dispatchtypes. Returns true if the
30 dispatch type matches the given path
31
32 =cut
33
34 sub match { die "Abstract method!" }
35
36 =head2 $self->register( $c, $action )
37
38 abstract method, to be implemented by dispatchtypes. Takes a
39 context object and a L<Catalyst::Action> object. 
40
41 Should return true if it registers something, or false otherwise.
42
43 =cut
44
45 sub register { }
46
47 =head1 AUTHOR
48
49 Matt S Trout
50 Sebastian Riedel, C<sri@cpan.org>
51
52 =head1 COPYRIGHT
53
54 This program is free software, you can redistribute it and/or modify it under
55 the same terms as Perl itself.
56
57 =cut
58
59 1;