NAME

RapidApp::Controller::DefaultRoot

DESCRIPTION

This controller is injected into the user's application unless they define a different controller that extends ModuleDispatcher. This is merely the default, if they didn't specify one.

CONFIGURATION

This module (like any other RapidApp module) needs to have a list of its sub-modules.

You can specify this using the Catalyst config system:

MyApp::Controller::RapidApp::Root:
  modules:
    main: MyApp::Modules::Main

along with any of the attributes for TopController.

EXTENDING

Rather than extending from this class (which would only save you a few lines), you can just as easily write your own controller which inherits from TopController:

package MyApp::Controller::Root;

use Moose;
use namespace::autoclean;
BEGIN { extends 'Catalyst::Controller', 'RapidApp::ModuleDispatcher'; }

__PACKAGE__->config( namespace => '' );

sub approot :Path {
  my ($self, $c, @args)= @_;
  $self->dispatch($c, @args);
}

sub end : ActionClass('RenderView') {}

no Moose;
__PACKAGE__->meta->make_immutable;
1;

The benefits you do gain from extending this default are the ability to plug in other RapidApp features like Direct Links or Exception Logging. However, these features could also be easily plugged into a custom top controller.