<dependencies>
    <!-- H2 — вбудована СУБД для розробки та навчання -->
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <version>2.3.232</version>
    </dependency>

    <!-- Flyway — автоматичне застосування міграцій при старті -->
    <dependency>
        <groupId>org.flywaydb</groupId>
        <artifactId>flyway-core</artifactId>
        <version>10.15.0</version>
    </dependency>
</dependencies>

CREATE TABLE authors (
    id         UUID          PRIMARY KEY,
    first_name VARCHAR(64)   NOT NULL,
    last_name  VARCHAR(64)   NOT NULL,
    bio        TEXT,
    image_path VARCHAR(2048)
);

package com.example.audiobook.domain;

import java.util.Objects;
import java.util.UUID;

/**
 * Доменна модель автора аудіокниги.
 * Клас не містить жодної залежності від JDBC, SQL або будь-якої
 * бібліотеки персистентності — це принципова вимога архітектури.
 */
public class Author {

    private final UUID id;
    private String firstName;
    private String lastName;
    private String bio;
    private String imagePath;

    /**
     * Конструктор для створення нового автора.
     * ID генерується автоматично — клієнтський код не повинен
     * піклуватися про генерацію ідентифікаторів.
     */
    public Author(String firstName, String lastName) {
        this.id = UUID.randomUUID();
        this.firstName = firstName;
        this.lastName = lastName;
    }

    /**
     * Конструктор для відновлення автора із сховища.
     * Використовується виключно DAO/Repository при читанні з БД.
     * ID передається явно — він вже існує у базі даних.
     */
    public Author(UUID id, String firstName, String lastName,
                  String bio, String imagePath) {
        this.id = id;
        this.firstName = firstName;
        this.lastName = lastName;
        this.bio = bio;
        this.imagePath = imagePath;
    }

    // --- Бізнес-методи ---

    /** Повертає повне ім'я автора у форматі "Прізвище Ім'я". */
    public String fullName() {
        return lastName + " " + firstName;
    }

    /** Перевіряє, чи заповнена біографія автора. */
    public boolean hasBio() {
        return bio != null && !bio.isBlank();
    }

    // --- Геттери та сеттери ---
    public UUID getId()          { return id; }
    public String getFirstName() { return firstName; }
    public String getLastName()  { return lastName; }
    public String getBio()       { return bio; }
    public String getImagePath() { return imagePath; }

    public void setFirstName(String firstName) { this.firstName = firstName; }
    public void setLastName(String lastName)   { this.lastName = lastName; }
    public void setBio(String bio)             { this.bio = bio; }
    public void setImagePath(String imagePath) { this.imagePath = imagePath; }

    /**
     * Рівність визначається виключно за первинним ключем —
     * узгодження з реляційною моделлю (стаття 09, Розбіжність 3).
     */
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (!(o instanceof Author other)) return false;
        return id != null && id.equals(other.id);
    }

    @Override
    public int hashCode() {
        return Objects.hashCode(id);
    }

    @Override
    public String toString() {
        return "Author{id=" + id + ", name='" + fullName() + "'}";
    }
}

package com.example.audiobook.dao;

import com.example.audiobook.domain.Author;

import java.sql.*;
import java.util.ArrayList;
import java.util.List;
import java.util.Optional;
import java.util.UUID;

/**
 * Найпростіша реалізація DAO для роботи з таблицею authors.
 * УВАГА: цей клас навмисно написаний "наївно" і містить
 * кілька критичних проблем, які будуть виявлені та виправлені далі.
 */
public class AuthorNaiveDao {

    // URL підключення до H2 у файловому режимі з PostgreSQL-сумісністю
    private static final String DB_URL =
        "jdbc:h2:./data/audiobook_db;MODE=PostgreSQL;DB_CLOSE_DELAY=-1";
    private static final String DB_USER = "sa";
    private static final String DB_PASS = "";

    /**
     * Зберігає нового автора у базі даних.
     * ПРОБЛЕМА: створює нове з'єднання при кожному виклику.
     */
    public void save(Author author) {
        // Проблема 1: рядок SQL конкатенується — небезпечно!
        String sql = "INSERT INTO authors (id, first_name, last_name, bio, image_path) " +
                     "VALUES ('" + author.getId() + "', '" +
                     author.getFirstName() + "', '" +
                     author.getLastName() + "', '" +
                     author.getBio() + "', '" +
                     author.getImagePath() + "')";
        try {
            // Проблема 2: Connection створюється і НЕ закривається
            Connection conn = DriverManager.getConnection(DB_URL, DB_USER, DB_PASS);
            Statement stmt = conn.createStatement();
            stmt.executeUpdate(sql);
            // Проблема 3: stmt і conn не закриваються → витік ресурсів
        } catch (SQLException e) {
            // Проблема 4: помилка "проковтується" — silent failure
            System.err.println("Помилка збереження: " + e.getMessage());
        }
    }

    /**
     * Знаходить автора за ідентифікатором.
     */
    public Optional<Author> findById(UUID id) {
        String sql = "SELECT id, first_name, last_name, bio, image_path " +
                     "FROM authors WHERE id = '" + id + "'"; // Проблема 1 знову
        try {
            Connection conn = DriverManager.getConnection(DB_URL, DB_USER, DB_PASS);
            Statement stmt = conn.createStatement();
            ResultSet rs = stmt.executeQuery(sql);

            if (rs.next()) {
                Author author = mapRow(rs);
                // Проблема 3: rs, stmt, conn не закриваються
                return Optional.of(author);
            }
        } catch (SQLException e) {
            System.err.println("Помилка пошуку: " + e.getMessage());
        }
        return Optional.empty();
    }

    /**
     * Повертає всіх авторів.
     */
    public List<Author> findAll() {
        String sql = "SELECT id, first_name, last_name, bio, image_path FROM authors";
        List<Author> authors = new ArrayList<>();
        try {
            Connection conn = DriverManager.getConnection(DB_URL, DB_USER, DB_PASS);
            Statement stmt = conn.createStatement();
            ResultSet rs = stmt.executeQuery(sql);
            while (rs.next()) {
                authors.add(mapRow(rs));
            }
        } catch (SQLException e) {
            System.err.println("Помилка отримання списку: " + e.getMessage());
        }
        return authors;
    }

    /**
     * Перетворює поточний рядок ResultSet на об'єкт Author.
     * Маппінг зібраний в одному місці — це єдине правильне рішення тут.
     */
    private Author mapRow(ResultSet rs) throws SQLException {
        return new Author(
            rs.getObject("id", UUID.class),     // UUID напряму з H2
            rs.getString("first_name"),
            rs.getString("last_name"),
            rs.getString("bio"),                 // може бути null — OK
            rs.getString("image_path")           // може бути null — OK
        );
    }
}

String sql = "INSERT INTO authors ... VALUES ('" + author.getFirstName() + "', '" + ...

INSERT INTO authors ... VALUES ('O'Brien', ...)
--                                 ^ Синтаксична помилка!

INSERT INTO authors ... VALUES (''); DROP TABLE authors; --', ...)
-- Перший запит — порожній INSERT
-- Другий запит — видалення таблиці authors!

// Безпечно: SQL компілюється окремо від даних
String sql = "INSERT INTO authors (id, first_name, last_name, bio, image_path) " +
             "VALUES (?, ?, ?, ?, ?)";
PreparedStatement stmt = conn.prepareStatement(sql);
stmt.setObject(1, author.getId());       // UUID передається як Object
stmt.setString(2, author.getFirstName()); // рядок — безпечно
stmt.setString(3, author.getLastName());
stmt.setString(4, author.getBio());      // може бути null — setString обробляє це
stmt.setString(5, author.getImagePath());
stmt.executeUpdate();

// try-with-resources: ресурси закриваються у зворотному порядку
// після виходу з блоку try — навіть при виключенні
try (Connection conn = DriverManager.getConnection(DB_URL, DB_USER, DB_PASS);
     PreparedStatement stmt = conn.prepareStatement(sql)) {

    stmt.setObject(1, author.getId());
    stmt.setString(2, author.getFirstName());
    // ...
    stmt.executeUpdate();

} // conn.close() та stmt.close() викликаються автоматично тут

package com.example.audiobook.db;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

/**
 * Централізований менеджер з'єднань з базою даних.
 * Єдине місце у проєкті, де знають URL та облікові дані БД.
 * У наступних статтях цей клас еволюціонує до повноцінного Connection Pool.
 */
public class ConnectionManager {

    private final String url;
    private final String user;
    private final String password;

    public ConnectionManager(String url, String user, String password) {
        this.url = url;
        this.user = user;
        this.password = password;
    }

    /**
     * Повертає нове з'єднання з базою даних.
     * Викликач зобов'язаний закрити з'єднання після використання
     * (найкраще — через try-with-resources).
     */
    public Connection getConnection() {
        try {
            return DriverManager.getConnection(url, user, password);
        } catch (SQLException e) {
            throw new DatabaseException("Неможливо встановити з'єднання з БД: " + url, e);
        }
    }

    /** Стандартний URL для H2 з PostgreSQL-сумісністю */
    public static ConnectionManager forH2(String dbPath) {
        String url = "jdbc:h2:" + dbPath + ";MODE=PostgreSQL;DB_CLOSE_DELAY=-1";
        return new ConnectionManager(url, "sa", "");
    }
}

package com.example.audiobook.db;

/**
 * Unchecked виняток для помилок рівня бази даних.
 * Обгортає checked SQLException, звільняючи клієнтський код
 * від обов'язкових try-catch блоків.
 */
public class DatabaseException extends RuntimeException {

    public DatabaseException(String message, Throwable cause) {
        super(message, cause);
    }
}

} catch (SQLException e) {
    System.err.println("Помилка збереження: " + e.getMessage());
    // Метод повертає normally — але збереження не відбулося!
}

public void save(Author author) {
    String sql = "INSERT INTO authors (id, first_name, last_name, bio, image_path) " +
                 "VALUES (?, ?, ?, ?, ?)";
    try (Connection conn = connectionManager.getConnection();
         PreparedStatement stmt = conn.prepareStatement(sql)) {

        stmt.setObject(1, author.getId());
        stmt.setString(2, author.getFirstName());
        stmt.setString(3, author.getLastName());
        stmt.setString(4, author.getBio());
        stmt.setString(5, author.getImagePath());
        stmt.executeUpdate();

    } catch (SQLException e) {
        // Перетворюємо checked на unchecked — збій не замовчується
        throw new DatabaseException("Помилка збереження автора: " + author, e);
    }
}

package com.example.audiobook.dao;

import com.example.audiobook.db.ConnectionManager;
import com.example.audiobook.db.DatabaseException;
import com.example.audiobook.domain.Author;

import java.sql.*;
import java.util.ArrayList;
import java.util.List;
import java.util.Optional;
import java.util.UUID;

/**
 * DAO для роботи з таблицею authors.
 * Виправлена версія: PreparedStatement, try-with-resources,
 * централізоване підключення, правильна обробка помилок.
 */
public class AuthorDao {

    private final ConnectionManager connectionManager;

    public AuthorDao(ConnectionManager connectionManager) {
        this.connectionManager = connectionManager;
    }

    /**
     * Зберігає нового автора у таблиці authors.
     * Якщо автор з таким id вже існує — викидає виключення (порушення PK).
     */
    public void save(Author author) {
        String sql = """
            INSERT INTO authors (id, first_name, last_name, bio, image_path)
            VALUES (?, ?, ?, ?, ?)
            """;
        try (Connection conn = connectionManager.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql)) {

            stmt.setObject(1, author.getId());        // UUID → java.util.UUID
            stmt.setString(2, author.getFirstName());
            stmt.setString(3, author.getLastName());
            stmt.setString(4, author.getBio());       // null-safe: setString(i, null) → SQL NULL
            stmt.setString(5, author.getImagePath()); // null-safe

            int rowsAffected = stmt.executeUpdate();
            if (rowsAffected != 1) {
                throw new DatabaseException("Очікувався 1 рядок, вставлено: " + rowsAffected, null);
            }

        } catch (SQLException e) {
            throw new DatabaseException("Помилка збереження автора: " + author.getId(), e);
        }
    }

    /**
     * Знаходить автора за UUID-ідентифікатором.
     * Повертає Optional.empty() якщо автора не знайдено.
     */
    public Optional<Author> findById(UUID id) {
        String sql = """
            SELECT id, first_name, last_name, bio, image_path
            FROM authors
            WHERE id = ?
            """;
        try (Connection conn = connectionManager.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql)) {

            stmt.setObject(1, id);

            try (ResultSet rs = stmt.executeQuery()) {
                // ResultSet відкривається всередині try-with-resources stmt,
                // тому його закриваємо окремим вкладеним блоком
                if (rs.next()) {
                    return Optional.of(mapRow(rs));
                }
                return Optional.empty();
            }

        } catch (SQLException e) {
            throw new DatabaseException("Помилка пошуку автора за id=" + id, e);
        }
    }

    /**
     * Повертає всіх авторів, відсортованих за прізвищем та ім'ям.
     */
    public List<Author> findAll() {
        String sql = """
            SELECT id, first_name, last_name, bio, image_path
            FROM authors
            ORDER BY last_name, first_name
            """;
        List<Author> authors = new ArrayList<>();

        try (Connection conn = connectionManager.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql);
             ResultSet rs = stmt.executeQuery()) {
            // ResultSet без параметрів можна відкрити одразу у try-with-resources

            while (rs.next()) {
                authors.add(mapRow(rs));
            }

        } catch (SQLException e) {
            throw new DatabaseException("Помилка отримання списку авторів", e);
        }
        return authors;
    }

    /**
     * Знаходить авторів за частиною прізвища (регістр-незалежний пошук).
     */
    public List<Author> findByLastName(String lastNamePart) {
        String sql = """
            SELECT id, first_name, last_name, bio, image_path
            FROM authors
            WHERE LOWER(last_name) LIKE LOWER(?)
            ORDER BY last_name, first_name
            """;
        List<Author> authors = new ArrayList<>();

        try (Connection conn = connectionManager.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql)) {

            // % — SQL-шаблон "будь-яка кількість символів"
            stmt.setString(1, "%" + lastNamePart + "%");

            try (ResultSet rs = stmt.executeQuery()) {
                while (rs.next()) {
                    authors.add(mapRow(rs));
                }
            }

        } catch (SQLException e) {
            throw new DatabaseException("Помилка пошуку авторів за прізвищем: " + lastNamePart, e);
        }
        return authors;
    }

    /**
     * Оновлює дані існуючого автора.
     * Оновлює всі поля, крім незмінного id.
     */
    public void update(Author author) {
        String sql = """
            UPDATE authors
            SET first_name = ?,
                last_name  = ?,
                bio        = ?,
                image_path = ?
            WHERE id = ?
            """;
        try (Connection conn = connectionManager.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql)) {

            stmt.setString(1, author.getFirstName());
            stmt.setString(2, author.getLastName());
            stmt.setString(3, author.getBio());
            stmt.setString(4, author.getImagePath());
            stmt.setObject(5, author.getId()); // id — в умові WHERE, останній параметр

            int rowsAffected = stmt.executeUpdate();
            if (rowsAffected == 0) {
                // Автор з таким id не існує — це логічна помилка клієнтського коду
                throw new DatabaseException(
                    "Автора з id=" + author.getId() + " не знайдено для оновлення", null
                );
            }

        } catch (SQLException e) {
            throw new DatabaseException("Помилка оновлення автора: " + author.getId(), e);
        }
    }

    /**
     * Видаляє автора за ідентифікатором.
     * Завдяки ON DELETE CASCADE у схемі, всі пов'язані audiobooks
     * також будуть видалені автоматично.
     *
     * @return true — якщо автора було знайдено та видалено
     */
    public boolean deleteById(UUID id) {
        String sql = "DELETE FROM authors WHERE id = ?";

        try (Connection conn = connectionManager.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql)) {

            stmt.setObject(1, id);
            int rowsAffected = stmt.executeUpdate();
            return rowsAffected > 0; // false якщо автора з таким id не існувало

        } catch (SQLException e) {
            throw new DatabaseException("Помилка видалення автора з id=" + id, e);
        }
    }

    /**
     * Перевіряє існування автора за id без завантаження всіх даних.
     * Ефективніше за findById() + isPresent() — не передає дані по мережі.
     */
    public boolean existsById(UUID id) {
        String sql = "SELECT 1 FROM authors WHERE id = ? LIMIT 1";

        try (Connection conn = connectionManager.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql)) {

            stmt.setObject(1, id);
            try (ResultSet rs = stmt.executeQuery()) {
                return rs.next(); // true — якщо хоча б один рядок є
            }

        } catch (SQLException e) {
            throw new DatabaseException("Помилка перевірки існування автора: " + id, e);
        }
    }

    /**
     * Повертає кількість авторів у таблиці.
     * Використовує COUNT(*) — найефективніший спосіб підрахунку рядків.
     */
    public long count() {
        String sql = "SELECT COUNT(*) FROM authors";

        try (Connection conn = connectionManager.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql);
             ResultSet rs = stmt.executeQuery()) {

            rs.next();
            return rs.getLong(1); // Перший (і єдиний) стовпець результату

        } catch (SQLException e) {
            throw new DatabaseException("Помилка підрахунку авторів", e);
        }
    }

    /**
     * Приватний метод маппінгу ResultSet → Author.
     * Централізований у одному місці — зміна структури таблиці
     * вимагає зміни лише тут.
     */
    private Author mapRow(ResultSet rs) throws SQLException {
        return new Author(
            rs.getObject("id", UUID.class),  // Типізований getObject для UUID
            rs.getString("first_name"),
            rs.getString("last_name"),
            rs.getString("bio"),             // Повертає null якщо стовпець NULL
            rs.getString("image_path")       // Повертає null якщо стовпець NULL
        );
    }
}

package com.example.audiobook;

import com.example.audiobook.dao.AuthorDao;
import com.example.audiobook.db.ConnectionManager;
import com.example.audiobook.domain.Author;

import java.util.List;
import java.util.Optional;
import java.util.UUID;

public class Main {

    public static void main(String[] args) {
        // 1. Ініціалізація ConnectionManager — єдиний екземпляр на весь додаток
        ConnectionManager connectionManager =
            ConnectionManager.forH2("./data/audiobook_db");

        // 2. DAO отримує ConnectionManager через конструктор
        AuthorDao authorDao = new AuthorDao(connectionManager);

        // === CREATE ===
        Author hesse = new Author("Герман", "Гессе");
        hesse.setBio("Нобелівський лауреат, автор «Степового вовка» та «Гри в бісер»");

        Author kafka = new Author("Франц", "Кафка");
        kafka.setBio("Майстер абсурду та екзистенційної прози");

        authorDao.save(hesse);
        authorDao.save(kafka);
        System.out.println("✓ Збережено: " + hesse.fullName() + ", " + kafka.fullName());

        // === READ ===
        Optional<Author> found = authorDao.findById(hesse.getId());
        found.ifPresent(a ->
            System.out.println("✓ Знайдено: " + a.fullName() + " | Bio: " + a.getBio())
        );

        List<Author> all = authorDao.findAll();
        System.out.println("✓ Всього авторів у БД: " + all.size());

        List<Author> byName = authorDao.findByLastName("ка");
        byName.forEach(a -> System.out.println("  → Пошук 'ка': " + a.fullName()));

        // === UPDATE ===
        hesse.setBio("Нобелівська премія з літератури 1946 року. Роман «Сіддхартха».");
        authorDao.update(hesse);
        System.out.println("✓ Оновлено біографію: " + hesse.fullName());

        // === EXISTS / COUNT ===
        System.out.println("✓ Гессе існує: " + authorDao.existsById(hesse.getId()));
        System.out.println("✓ Загальна кількість: " + authorDao.count());

        // === DELETE ===
        boolean deleted = authorDao.deleteById(kafka.getId());
        System.out.println("✓ Кафку видалено: " + deleted);
        System.out.println("✓ Кількість після видалення: " + authorDao.count());
    }
}

✓ Збережено: Гессе Герман, Кафка Франц
✓ Знайдено: Гессе Герман | Bio: Нобелівський лауреат, автор «Степового вовка» та «Гри в бісер»
✓ Всього авторів у БД: 2
  → Пошук 'ка': Кафка Франц
✓ Оновлено біографію: Гессе Герман
✓ Гессе існує: true
✓ Загальна кількість: 2
✓ Кафку видалено: true
✓ Кількість після видалення: 1