This example shows how to use a framework event to intercept, cancel and redirect controller routing.

Features covered by this example:

• Controllers - route URL requests to code
• Definitions - coded config files
• ROUTE()) - define a route
• ON('controller') - intercept controller requests
• controller.cancel() - cancel a request
• controller.redirect() - redirect a request
• controller.url - determine request path
• controller.transfer() - transfer a request
• controller.isTransfer - detect a transfer

The controller (/controllers/default.js) defines two routes:

ROUTE( '/',        view_index);
ROUTE( '/cancel/', view_cancel);

We're going to make / route to view_cancel instead of view_index. The hard way (:

We'll put our code in a definition file (/definitions/cancel.js) - definitions are initialised just before controllers as shown below:

First, we need to listen to the framework event for controllers: ON('controller'):

ON('controller', function(controller, name) {
	// this will be triggered on every request to the controller
});

The most simplistic (and disastrous) way to redirect to /cancel/ is as follows:

ON('controller', function( controller, name ) {
	controller.cancel().redirect('/cancel/');
});

This cancels any request in the controller, regardless of route, and then redirects to /cancel/ ...which is itself a request and so it too will be intercepted, cancelled and redirected to /cancel/... over and over again.

Let's fix that:

ON('controller', function( controller, name ) {
	if (controller.url === '/')
		controller.cancel().redirect('/cancel/');
});

Now, only requests to / will be redirected to /cancel/, and requests to /cancel/ will be successful.

At first glance, transfers work just the same as redirects:

ON('controller', function(controller, name) {
	if (controller.url === '/')
		controller.cancel().transfer( '/cancel/' );
});

However, there's a major benefit to using .transfer(): You can identify them using .isTransfer.

Let's say you wanted to temporarilly cancel any route in your controller, for example due to site maintenance. You could do something like this:

ON('controller', function( controller, name ) {

	if (!controller.isTransfer) // <-- exclude existing transfers
		controller.cancel().transfer('/cancel/');

});