t/lib/TestApp/Controller/Action/Chained.pm

   1 package TestApp::Controller::Action::Chained;
   2
   3 use strict;
   4 use warnings;
   5
   6 use base qw/Catalyst::Controller/;
   7
   8 sub begin :Private { }
   9
  10 #
  11 #   TODO
  12 #   :Chained('') means what?
  13 #
  14
  15 #
  16 #   Simple parent/child action test
  17 #
  18 sub foo  :PathPart('chained/foo')  :CaptureArgs(1) :Chained('/') {
  19     my ( $self, $c, @args ) = @_;
  20     die "missing argument" unless @args;
  21     die "more than 1 argument" if @args > 1;
  22 }
  23 sub endpoint  :PathPart('end')  :Chained('/action/chained/foo')  :Args(1) { }
  24
  25 #
  26 #   Parent/child test with two args each
  27 #
  28 sub foo2 :PathPart('chained/foo2') :CaptureArgs(2) :Chained('/') { }
  29 sub endpoint2 :PathPart('end2') :Chained('/action/chained/foo2') :Args(2) { }
  30
  31 #
  32 #   Relative specification of parent action
  33 #
  34 sub bar :PathPart('chained/bar') :Chained('/') :CaptureArgs(0) { }
  35 sub finale :PathPart('') :Chained('bar') :Args { }
  36
  37 #
  38 #   three chain with concurrent endpoints
  39 #
  40 sub one   :PathPart('chained/one') :Chained('/')                   :CaptureArgs(1) { }
  41 sub two   :PathPart('two')         :Chained('/action/chained/one') :CaptureArgs(2) { }
  42 sub three_end :PathPart('three')       :Chained('two') :Args(3) { }
  43 sub one_end   :PathPart('chained/one') :Chained('/')   :Args(1) { }
  44 sub two_end   :PathPart('two')         :Chained('one') :Args(2) { }
  45
  46 #
  47 #   Dispatch on number of arguments
  48 #
  49 sub multi1 :PathPart('chained/multi') :Chained('/') :Args(1) { }
  50 sub multi2 :PathPart('chained/multi') :Chained('/') :Args(2) { }
  51
  52 #
  53 #   Roots in an action defined in a higher controller
  54 #
  55 sub higher_root :PathPart('bar') :Chained('/action/chained/foo/higher_root') :Args(1) { }
  56
  57 #
  58 #   Controller -> subcontroller -> controller
  59 #
  60 sub pcp1 :PathPart('chained/pcp1')  :Chained('/')                        :CaptureArgs(1) { }
  61 sub pcp3 :Chained('/action/chained/foo/pcp2') :Args(1)     { }
  62
  63 #
  64 #   Dispatch on capture number
  65 #
  66 sub multi_cap1 :PathPart('chained/multi_cap') :Chained('/') :CaptureArgs(1) { }
  67 sub multi_cap2 :PathPart('chained/multi_cap') :Chained('/') :CaptureArgs(2) { }
  68 sub multi_cap_end1 :PathPart('baz') :Chained('multi_cap1') :Args(0) { }
  69 sub multi_cap_end2 :PathPart('baz') :Chained('multi_cap2') :Args(0) { }
  70
  71 #
  72 #   Priority: Slurpy args vs. chained actions
  73 #
  74 sub priority_a1 :PathPart('chained/priority_a') :Chained('/') :Args { }
  75 sub priority_a2 :PathPart('chained/priority_a') :Chained('/') :CaptureArgs(1) { }
  76 sub priority_a2_end :PathPart('end') :Chained('priority_a2') :Args(1) { }
  77
  78
  79 #
  80 #   Priority: Fixed args vs. chained actions
  81 #
  82 sub priority_b1 :PathPart('chained/priority_b') :Chained('/') :Args(3) { }
  83 sub priority_b2 :PathPart('chained/priority_b') :Chained('/') :CaptureArgs(1) { }
  84 sub priority_b2_end :PathPart('end') :Chained('priority_b2') :Args(1) { }
  85
  86 #
  87 #   Priority: With no Args()
  88 #
  89 sub priority_c1 :PathPart('chained/priority_c') :Chained('/') :CaptureArgs(1) { }
  90 sub priority_c2 :PathPart('') :Chained('priority_c1') { }
  91 sub priority_c2_xyz :PathPart('xyz') :Chained('priority_c1')  { }
  92
  93
  94 #
  95 #   Optional specification of :Args in endpoint
  96 #
  97 sub opt_args :PathPart('chained/opt_args') :Chained('/') { }
  98
  99 #
 100 #   Optional PathPart test -> /chained/optpp/*/opt_pathpart/*
 101 #
 102 sub opt_pp_start :Chained('/') :PathPart('chained/optpp') :CaptureArgs(1) { }
 103 sub opt_pathpart :Chained('opt_pp_start') :Args(1) { }
 104
 105 #
 106 #   Optional Args *and* PathPart -> /chained/optall/*/oa/...
 107 #
 108 sub opt_all_start :Chained('/') :PathPart('chained/optall') :CaptureArgs(1) { }
 109 sub oa :Chained('opt_all_start') { }
 110
 111 #
 112 #   :Chained is the same as :Chained('/')
 113 #
 114 sub rootdef :Chained :PathPart('chained/rootdef') :Args(1) { }
 115
 116 #
 117 #   the ParentChain controller chains to this action by
 118 #   specifying :Chained('.')
 119 #
 120 sub parentchain :Chained('/') :PathPart('chained/parentchain') :CaptureArgs(1) { }
 121
 122 #
 123 #   This is just for a test that a loose end is not callable
 124 #
 125 sub loose :Chained :PathPart('chained/loose') CaptureArgs(1) { }
 126
 127 #
 128 #   Forwarding out of the middle of a chain.
 129 #
 130 sub chain_fw_a :Chained :PathPart('chained/chain_fw') :CaptureArgs(1) {
 131     $_[1]->forward( '/action/chained/fw_dt_target' );
 132 }
 133 sub chain_fw_b :Chained('chain_fw_a') :PathPart('end') :Args(1) { }
 134
 135 #
 136 #   Detaching out of the middle of a chain.
 137 #
 138 sub chain_dt_a :Chained :PathPart('chained/chain_dt') :CaptureArgs(1) {
 139     $_[1]->detach( '/action/chained/fw_dt_target' );
 140 }
 141 sub chain_dt_b :Chained('chain_dt_a') :PathPart('end') :Args(1) { }
 142
 143 #
 144 #   Target for former forward and chain tests.
 145 #
 146 sub fw_dt_target :Private { }
 147
 148 #
 149 #   Test multiple chained actions with no captures
 150 #
 151 sub empty_chain_a : Chained('/')             PathPart('chained/empty') CaptureArgs(0) { }
 152 sub empty_chain_b : Chained('empty_chain_a') PathPart('')              CaptureArgs(0) { }
 153 sub empty_chain_c : Chained('empty_chain_b') PathPart('')              CaptureArgs(0) { }
 154 sub empty_chain_d : Chained('empty_chain_c') PathPart('')              CaptureArgs(1) { }
 155 sub empty_chain_e : Chained('empty_chain_d') PathPart('')              CaptureArgs(0) { }
 156 sub empty_chain_f : Chained('empty_chain_e') PathPart('')              Args(1)        { }
 157
 158 sub mult_nopp_base  : Chained('/') PathPart('chained/mult_nopp') CaptureArgs(0) { }
 159 sub mult_nopp_all   : Chained('mult_nopp_base') PathPart('') Args(0) { }
 160 sub mult_nopp_new   : Chained('mult_nopp_base') PathPart('new') Args(0) { }
 161 sub mult_nopp_id    : Chained('mult_nopp_base') PathPart('') CaptureArgs(1) { }
 162 sub mult_nopp_idall : Chained('mult_nopp_id') PathPart('') Args(0) { }
 163 sub mult_nopp_idnew : Chained('mult_nopp_id') PathPart('new') Args(0) { }
 164
 165 #
 166 #       Test Choice between branches and early return logic
 167 #   Declaration order is important for $children->{$*}, since this is first match best.
 168 #
 169 sub cc_base     : Chained('/')           PathPart('chained/choose_capture') CaptureArgs(0) { }
 170 sub cc_link     : Chained('cc_base') PathPart('')                                               CaptureArgs(0) { }
 171 sub cc_anchor   : Chained('cc_link') PathPart('anchor.html')                    Args(0)            { }
 172 sub cc_all      : Chained('cc_base') PathPart('')                                               Args()             { }
 173
 174 sub cc_a                : Chained('cc_base')    PathPart('')    CaptureArgs(1) { }
 175 sub cc_a_link   : Chained('cc_a')               PathPart('a')   CaptureArgs(0) { }
 176 sub cc_a_anchor : Chained('cc_a_link')  PathPart('')    Args()             { }
 177
 178 sub cc_b                : Chained('cc_base')    PathPart('b')                           CaptureArgs(0) { }
 179 sub cc_b_link   : Chained('cc_b')               PathPart('')                            CaptureArgs(1) { }
 180 sub cc_b_anchor : Chained('cc_b_link')  PathPart('anchor.html')         Args()             { }
 181
 182 #
 183 #   Test static paths vs. captures
 184 #
 185
 186 sub apan        : Chained('/')     CaptureArgs(0) PathPrefix   { }
 187 sub korv        : Chained('apan')  CaptureArgs(0) PathPart('') { }
 188 sub wurst       : Chained('apan')  CaptureArgs(1) PathPart('') { }
 189 sub static_end  : Chained('korv')  Args(0)                     { }
 190 sub capture_end : Chained('wurst') Args(0)        PathPart('') { }
 191
 192
 193 # */search vs doc/*
 194 sub view : Chained('/') PathPart('chained') CaptureArgs(1) {}
 195 sub star_search : Chained('view') PathPart('search') Args(0) { }
 196 sub doc_star : Chained('/') PathPart('chained/doc') Args(1) {}
 197
 198 sub return_arg : Chained('/') PathPart('chained/return_arg') Args(1) {}
 199
 200 sub end :Private {
 201   my ($self, $c) = @_;
 202   return if $c->stash->{no_end};
 203   my $out = join('; ', map { join(', ', @$_) }
 204                          ($c->req->captures, $c->req->args));
 205   $c->res->body($out);
 206 }
 207
 208 1;