Name

File::DataClass::Exception - Exception base class

Version

0.8.$Revision: 351 $

Synopsis

   use Moose;
   use Try::Tiny;

   extend qw(File::DataClass::Schema);

   sub some_method {
      my $self = shift;

      try   { this_will_fail }
      catch { $self->throw( $_ ) };
   }

Description

An exception class that inherits from a custom subclass of Exception::Class

Subroutines/Methods

new

Create an exception object. You probably do not want to call this directly, but indirectly through "catch" and "throw"

catch

   $e = File::DataClass::Exception->catch( $error );

Catches and returns a thrown exception or generates a new exception if EVAL_ERROR has been set

full_message

   $printable_string = $e->full_message

What an instance of this class stringifies to

stacktrace

   $lines = $e->stacktrace( $num_lines_to_skip );

Return the stack trace. Defaults to skipping one (the first) line of output

throw

   File::DataClass::Exception->throw( $error );

Create (or re-throw) an exception to be caught by the catch above. If the passed parameter is a reference it is re-thrown. If a single scalar is passed it is taken to be an error message code, a new exception is created with all other parameters taking their default values. If more than one parameter is passed the it is treated as a list and used to instantiate the new exception. The 'error' parameter must be provided in this case

throw_on_error

   File::DataClass::Exception->throw_on_error $error );

Calls "catch" and if the was an exception "throw"s it

Diagnostics

None

Configuration and Environment

The $IGNORE package variable is list of methods whose presence should be suppressed in the stack trace output

Dependencies

Exception::Class

File::DataClass::Constants

MRO::Compat

Scalar::Util

Incompatibilities

There are no known incompatibilities in this module

Bugs and Limitations

The default ignore package list should be configurable

There are no known bugs in this module. Please report problems to the address below. Patches are welcome

Author

Peter Flanigan <Support at RoxSoft.co.uk>

License and Copyright

Copyright (c) 2012 Peter Flanigan. All rights reserved

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic

This program is distributed in the hope that it will be useful, but WITHOUT WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE

cpanm File::DataClass

perl -MCPAN -e shell
install File::DataClass