METHODS

$obj->process

process() is an eval, but one which expects and understands exceptions generated by Log::Report. Any messages will be logged as normal in accordance with the dispatchers, but any fatal exceptions will be caught and handled gracefully. This allows much simpler error handling, rather than needing to test for lots of different scenarios.

In a module, it is enough to simply use the error keyword in the event of a fatal error.

The return value will be 1 for success or 0 if a fatal exception occurred.

See the DETAILS for an example of how this is expected to be used.

This module is configured only once in your application. The other modules which make your website do not need to require this plugin, instead they can use Log::Report to get useful functions like error and fault.

Handlers

All the standard Log::Report functions are available to use. Please see the The Reason for the report for details of when each one should be used.

Log::Report class functionality to class messages (which can then be tested later):

  notice __x"Class me up", _class => 'label';
  ...
  if ($msg->inClass('label')) ...

Dancer2::Plugin::LogReport has a special message class, no_session, which prevents the message from being saved to the messages session variable. This is useful, for example, if you are writing messages within the session hooks, in which case recursive loops can be experienced.

$obj->alert
$obj->assert
$obj->error
$obj->failure
$obj->fault
$obj->info
$obj->mistake
$obj->notice
$obj->panic
$obj->success

This is a special additional type, equivalent to notice. The difference is that messages using this keyword will have the class success added, which can be used to color the messages differently to the end user. For example, manual Dancer2::Plugin::LogReport::Message#bootstrap_color uses this to display the message in green.

$obj->trace
$obj->warning