<<

NAME

Koha::Schema::Util::ExceptionTranslator - Centralized DBIx::Class exception translation

SYNOPSIS

    use Koha::Schema::Util::ExceptionTranslator;

    try {
        # DBIx::Class operation that might fail
        $schema->resultset('SomeTable')->create(\%data);
    } catch {
        Koha::Schema::Util::ExceptionTranslator->translate_exception($_, \%columns_info);
    };

DESCRIPTION

This utility class provides centralized exception translation from DBIx::Class exceptions to Koha-specific exceptions. This eliminates the need for duplicated exception handling code throughout the codebase.

METHODS

translate_exception

    Koha::Schema::Util::ExceptionTranslator->translate_exception($exception, $columns_info);

Translates a DBIx::Class exception into an appropriate Koha exception and throws it. If the exception cannot be translated, it rethrows the original exception.

Parameters

• $exception - The caught exception object
• $columns_info (optional) - Hash reference of column information for enhanced error reporting

Exception Types Handled

• Foreign key constraint violations → Koha::Exceptions::Object::FKConstraint
• Duplicate key violations → Koha::Exceptions::Object::DuplicateID
• Invalid data type values → Koha::Exceptions::Object::BadValue
• Data truncation for enum columns → Koha::Exceptions::Object::BadValue

FUTURE ENHANCEMENTS

This utility is designed to be extended to support:

• Multiple database engines (PostgreSQL, SQLite, etc.)
• Additional exception types as they are identified
• Enhanced error reporting with more context

AUTHOR

Koha Development Team

<<