NAME

Error::Hierarchy::Container - Container for hierarchical exceptions

VERSION

version 1.103530

SYNOPSIS

    my $my_exception = create_some_exception();
    my %exception_args = (foo => 'bar');
    my $uuid1 = gen_some_uuid();
    my $uuid2 = gen_some_uuid();

    my $container = Error::Hierarchy::Container->new;
    $container->items_set_push($my_exception);
    $container->record('Some::Exception', %exception_args);
    $container->delete_by_uuid($uuid1, $uuid2);

DESCRIPTION

This class implements a container for hierarchical exception objects. It is effectively a Data::Container but also has the following methods.

METHODS

record

Takes an exception class name (a string) and a hash of arguments. First the exception is constructed with the given arguments, then it is added - using items_set_push() - to the container. It's really a shortcut that saves you from having to record the exception and then adding it to the container yourself.

delete_by_uuid

Takes a list of uuid values and deletes all those exceptions from the container whose uuid appears in the given list.

delete_duplicate_exceptions

Deletes duplicate exceptions. Two exceptions are considered to be the same if they are of the same class and have the same properties, as defined by the exception's properties_as_hash() method.

items_push

Overrides Data::Container's items_push() method by calling the before_push trigger before pushing. The list of items to be pushed is passed to the trigger. One possible use might be to warn if you try to push any items that are not derived from Error::Hierarchy. The trigger mechanism is based on Class::Trigger.

items_set_push

Similar to items_push().

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=Error-Hierarchy.

AVAILABILITY

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see http://search.cpan.org/dist/Error-Hierarchy/.

The development version lives at http://github.com/hanekomu/Error-Hierarchy and may be cloned from git://github.com/hanekomu/Error-Hierarchy. Instead of sending patches, please fork this project using the standard git and github infrastructure.

AUTHOR

Marcel Gruenauer <marcel@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2004 by Marcel Gruenauer.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.