ninja

Class NinjaDefault

java.lang.Object

ninja.NinjaDefault

All Implemented Interfaces:

Ninja

public class NinjaDefault
extends java.lang.Object
implements Ninja

Field Summary

Fields

Modifier and Type	Field and Description
protected LifecycleService	lifecycleService
protected ResultHandler	resultHandler
protected Router	router

Constructor Summary

Constructors

Constructor and Description
NinjaDefault()

Method Summary

Modifier and Type	Method and Description
Result	getBadRequestResult(Context context, java.lang.Exception exception) Should handle cases where the client sent strange date that led to an error.
Result	getForbiddenResult(Context context) Should handle cases where access is forbidden Should lead to a html error 403 - forbidden (and be used with the same mindset).
Result	getInternalServerErrorResult(Context context, java.lang.Exception exception) Should handle cases where an exception is thrown when handling a route that let to an internal server error.
Result	getNotFoundResult(Context context) Should handle cases where no route can be found for a given request.
Result	getUnauthorizedResult(Context context) Should handle cases where access is unauthorized Should lead to a html error 401 - unauthorized (and be used with the same mindset).
Result	onException(Context context, java.lang.Exception exception) This result should be used when an error occurs.
void	onFrameworkShutdown() Invoked when the server hosting Ninja is being stopped.
void	onFrameworkStart() Invoked when the framework starts.
void	onRouteRequest(Context.Impl context) When a route is requested this method is called.
void	renderErrorResultAndCatchAndLogExceptions(Result result, Context context) Should be used to render an error.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

lifecycleService

@Inject
protected LifecycleService lifecycleService

router

@Inject
protected Router router

resultHandler

@Inject
protected ResultHandler resultHandler

Constructor Detail

NinjaDefault

public NinjaDefault()

Method Detail

onRouteRequest

public void onRouteRequest(Context.Impl context)

Description copied from interface: Ninja

When a route is requested this method is called.

Specified by:

onRouteRequest in interface Ninja

renderErrorResultAndCatchAndLogExceptions

public void renderErrorResultAndCatchAndLogExceptions(Result result,
                                                      Context context)

Description copied from interface: Ninja

Should be used to render an error. Any errors should be catched and not reported in any way to the request. For instance if your application catches a sever internal computation error use this method and its implementations to render out an error html page.

Specified by:

renderErrorResultAndCatchAndLogExceptions in interface Ninja

onFrameworkStart

public void onFrameworkStart()

Description copied from interface: Ninja

Invoked when the framework starts. Usually inits stuff like the scheduler and so on.

Specified by:

onFrameworkStart in interface Ninja

onFrameworkShutdown

public void onFrameworkShutdown()

Description copied from interface: Ninja

Invoked when the server hosting Ninja is being stopped. Usually shuts down the guice injector and stopps all services.

Specified by:

onFrameworkShutdown in interface Ninja

onException

public Result onException(Context context,
                          java.lang.Exception exception)

Description copied from interface: Ninja

This result should be used when an error occurs.

Specified by:

onException in interface Ninja

Parameters:

context - The context for this request

exception - The exception to handle. Can be used to customize error message.

Returns:

a result you can use to render the error.

getInternalServerErrorResult

public Result getInternalServerErrorResult(Context context,
                                           java.lang.Exception exception)

Description copied from interface: Ninja

Should handle cases where an exception is thrown when handling a route that let to an internal server error. Should lead to a html error 500 - internal sever error (and be used with the same mindset). Usually used by onRouteRequest(...).

Specified by:

getInternalServerErrorResult in interface Ninja

getNotFoundResult

public Result getNotFoundResult(Context context)

Description copied from interface: Ninja

Should handle cases where no route can be found for a given request. Should lead to a html error 404 - not found (and be used with the same mindset). Usually used by onRouteRequest(...).

Specified by:

getNotFoundResult in interface Ninja

getBadRequestResult

public Result getBadRequestResult(Context context,
                                  java.lang.Exception exception)

Description copied from interface: Ninja

Should handle cases where the client sent strange date that led to an error. Should lead to a html error 400 - bad request (and be used with the same mindset). Usually used by onRouteRequest(...).

Specified by:

getBadRequestResult in interface Ninja

getUnauthorizedResult

public Result getUnauthorizedResult(Context context)

Description copied from interface: Ninja

Should handle cases where access is unauthorized Should lead to a html error 401 - unauthorized (and be used with the same mindset). By default, WWW-Authenticate is set to None. Usually used by BasicAuthFilter for instance(...).

Specified by:

getUnauthorizedResult in interface Ninja

getForbiddenResult

public Result getForbiddenResult(Context context)

Description copied from interface: Ninja

Should handle cases where access is forbidden Should lead to a html error 403 - forbidden (and be used with the same mindset). Usually used by SecureFilter for instance(...).

Specified by:

getForbiddenResult in interface Ninja