// Amb excepcions estandard
try {
    gestor.prestar("LIB-0001", "EMP-001", 12);
} catch (IllegalStateException e) {
    // Que ha passat? El material esta prestat? L'empleat ha arribat al limit?
    // El prestec ja estava retornat? Cal llegir el MISSATGE per saber-ho.
    if (e.getMessage().contains("limit")) {       // fragil, horrible, i es trenca en traduir
        // ...
    }
}

// Amb excepcions del domini
try {
    gestor.prestar("LIB-0001", "EMP-001", 12);
} catch (MaterialNoDisponibleException e) {
    oferirReserva(e.getReferencia(), e.getDiaPrevistDevolucio());
} catch (LimitPrestecsExceditException e) {
    mostrarPrestecsActius(e.getIdEmpleat());
}

throw new IllegalStateException(
        "L'empleat EMP-001 (Marta Ruiz) ja te 3 prestecs, el maxim es 3");

throw new LimitPrestecsExceditException(empleat, Empleat.MAX_PRESTECS_SIMULTANIS);

// I qui captura:
} catch (LimitPrestecsExceditException e) {
    String emp = e.getIdEmpleat();                // l'identificador, no el nom en una cadena
    int limit  = e.getLimit();                    // el numero, no un text
    int actuals = e.getPrestecsActuals();

    System.out.printf("%s te %d de %d prestecs.%n",
            emp, actuals, limit);
    oferirDevolucioAnticipada(emp);               // es pot USAR la dada
}

package com.nexussoftware.bibliotech.domini;

/** Versio minima: nomes el nom i el missatge. */
public class MaterialNoTrobatException extends RuntimeException {

    public MaterialNoTrobatException(String missatge) {
        super(missatge);
    }
}

throw new MaterialNoTrobatException("No existeix el material LIB-9999");

// MALAMENT: estendre Throwable directament
public class LaMevaExcepcio extends Throwable { }    // legal, pero mai correcte

// MALAMENT: estendre Error
public class LaMevaExcepcio extends Error { }        // Error es per a fallades de la JVM

// MALAMENT: estendre una excepcio estandard molt especifica sense motiu
public class LaMevaExcepcio extends NumberFormatException { }   // hereta una semantica aliena

package com.nexussoftware.bibliotech.domini;

/** Excepcio amb els quatre constructors canonics. */
public class BiblioTechException extends RuntimeException {

    /** 1. Sense missatge ni causa. Poc util, pero completa el contracte. */
    public BiblioTechException() {
        super();
    }

    /** 2. Amb missatge. El mes usat en ORIGINAR una fallada. */
    public BiblioTechException(String missatge) {
        super(missatge);
    }

    /** 3. Amb missatge i causa. El que has d'usar en EMBOLCALLAR (06-03). */
    public BiblioTechException(String missatge, Throwable causa) {
        super(missatge, causa);
    }

    /** 4. Nomes causa: el missatge es deriva de causa.toString(). */
    public BiblioTechException(Throwable causa) {
        super(causa);
    }
}

protected Throwable(String message, Throwable cause,
                    boolean enableSuppression, boolean writableStackTrace)

package com.nexussoftware.bibliotech.domini;

/**
 * El material sollicitat no existeix al cataleg.
 *
 * Transporta la referencia cercada perque qui la capturi pugui
 * oferir-la en un missatge, buscar alternatives o registrar-la, sense
 * haver de parsejar el missatge de text.
 */
public class MaterialNoTrobatException extends BiblioTechException {

    private static final long serialVersionUID = 1L;

    /** Els camps d'una excepcio han de ser final: una excepcio es immutable. */
    private final String referenciaCercada;
    private final int midaCataleg;

    public MaterialNoTrobatException(String referenciaCercada, int midaCataleg) {
        // El missatge es construeix a partir de les dades: una sola font de veritat
        super("No existeix cap material amb la referencia '" + referenciaCercada
                + "' (el cataleg te " + midaCataleg + " materials)");
        this.referenciaCercada = referenciaCercada;
        this.midaCataleg = midaCataleg;
    }

    /** Variant per a quan s'embolcalla una altra fallada. */
    public MaterialNoTrobatException(String referenciaCercada, int midaCataleg,
                                     Throwable causa) {
        super("No existeix cap material amb la referencia '" + referenciaCercada
                + "' (el cataleg te " + midaCataleg + " materials)", causa);
        this.referenciaCercada = referenciaCercada;
        this.midaCataleg = midaCataleg;
    }

    public String getReferenciaCercada() { return referenciaCercada; }
    public int getMidaCataleg()          { return midaCataleg; }

    /** Metode de conveniencia: l'excepcio pot aportar logica util. */
    public boolean catalegBuit() {
        return midaCataleg == 0;
    }
}

try {
    Material m = cataleg.obtenirPerReferencia(entradaUsuari);
    gestor.prestar(m.getReferencia(), "EMP-001", dia);
} catch (MaterialNoTrobatException e) {

    if (e.catalegBuit()) {
        System.out.println("El cataleg esta buit. Heu carregat el fitxer de materials?");
    } else {
        System.out.println("No s'ha trobat '" + e.getReferenciaCercada() + "'.");
        // Es poden usar les DADES per ajudar: suggeriments per prefix
        List<Material> semblants = cataleg.cercarPerPrefix(
                e.getReferenciaCercada().substring(0, 3));
        if (!semblants.isEmpty()) {
            System.out.println("Potser voliem dir algun d'aquests?");
            semblants.forEach(m -> System.out.println("  " + m.getReferencia()));
        }
    }
}

// Nivell 1: qualsevol fallada del domini BiblioTech (frontera d'errors)
catch (BiblioTechException e) { ... }

// Nivell 2: qualsevol fallada relacionada amb prestecs
catch (PrestecException e) { ... }

// Nivell 3: aquesta fallada concreta, amb les seves dades
catch (LimitPrestecsExceditException e) { usar(e.getLimit()); }

try {
    gestor.prestar(referencia, idEmpleat, dia);
} catch (LimitPrestecsExceditException e) {         // fulla
    oferirDevolucioAnticipada(e.getIdEmpleat());
} catch (PrestecException e) {                       // branca
    System.out.println("No s'ha pogut completar el prestec: " + e.getMessage());
} catch (BiblioTechException e) {                    // arrel
    System.out.println("Fallada de BiblioTech: " + e.getMessage());
}

try {
    aplicacio.arrencar();
} catch (BiblioTechException e) {
    // Fallada ESPERADA del domini: missatge net per a l'usuari
    System.out.println("Operacio no completada: " + e.getMessage());
} catch (RuntimeException e) {
    // Fallada INESPERADA: es un bug. Missatge generic + registre complet
    System.out.println("Error intern. Consulteu el registre (incidencia " + id + ").");
    logger.log(Level.SEVERE, "Fallada no controlada", e);
}

public abstract class BiblioTechException extends RuntimeException {

    /** Codi estable per al log i per a la documentacio de suport. */
    public String getCodi() {
        return getClass().getSimpleName().replace("Exception", "").toUpperCase();
    }

    /**
     * Es una fallada que l'usuari pot corregir per si mateix?
     * Les subclasses ho redefineixen quan no sigui aixi.
     */
    public boolean esCorregiblePerUsuari() {
        return true;
    }

    /** Missatge apte per mostrar en pantalla, sense detalls interns. */
    public String getMissatgePerUsuari() {
        return getMessage();
    }
}

// Que + dada + esperat
"L'empleat EMP-001 (Marta Ruiz) te 3 prestecs actius i el limit es 3"

// Que + dada + context util per actuar
"El material LIB-0001 ('Java Eficac') esta prestat a EMP-002 des del dia 12"

// Que + les dues dades que colliseixen
"Ja existeix un material amb la referencia LIB-0001: 'Java Eficac'"

warning: [serial] serializable class MaterialNoTrobatException has no definition
of serialVersionUID

public class MaterialNoTrobatException extends BiblioTechException {
    private static final long serialVersionUID = 1L;
    // ...
}

// PROBLEMATIC si l'excepcio viatja per xarxa i Empleat no es Serializable
private final Empleat empleat;

// SEGUR: String i int sempre son serialitzables
private final String idEmpleat;
private final int limit;

// ESTANDARD: validacio tecnica sense significat de negoci
Objects.requireNonNull(referencia, "La referencia no pot ser nulla");
if (dia < 1) {
    throw new IllegalArgumentException("El dia ha de ser 1 o posterior, i era: " + dia);
}
if (!referencia.matches("LIB-\\d{4}")) {
    throw new IllegalArgumentException("Format de referencia invalid: " + referencia);
}

// PROPIA: regla de negoci amb nom i amb dades
if (!material.estaDisponible()) {
    throw new MaterialNoDisponibleException(referencia, material.getTitol(),
                                            material.getDiaPrevistDevolucio());
}

protected Throwable(String message, Throwable cause,
                    boolean enableSuppression,      // admet excepcions suprimides? (06-06)
                    boolean writableStackTrace)     // captura la pila?

package com.nexussoftware.bibliotech.servei;

/**
 * Excepcio de senyal, sense stack trace.
 *
 * ADVERTENCIA: usar NOMES quan es compleixin les tres condicions:
 *   1. Es llanca en un bucle molt calent (milers de vegades per segon).
 *   2. Es captura immediatament al mateix metode o molt a prop.
 *   3. El stack trace no aporta RES, perque el punt de llancament es unic.
 *
 * Si no es compleixen les tres, aquesta optimitzacio nomes aconsegueix que una
 * fallada real sigui impossible de diagnosticar. Es la definicio d'optimitzacio prematura.
 */
public class CercaInterrompudaException extends RuntimeException {

    private static final long serialVersionUID = 1L;

    private final int posicio;

    public CercaInterrompudaException(int posicio) {
        //     missatge, causa, supressio, stackTrace
        super("Cerca interrompuda a la posicio " + posicio, null, false, false);
        this.posicio = posicio;
    }

    public int getPosicio() { return posicio; }
}

/** Una unica instancia reutilitzada: zero assignacions de memoria. */
private static final CercaInterrompudaException SENYAL =
        new CercaInterrompudaException(-1);

// ...
throw SENYAL;                         // no construeix res

package com.nexussoftware.bibliotech.domini;

/**
 * Arrel de totes les excepcions del domini de BiblioTech.
 *
 * Es abstracta perque ningu no l'ha de llancar directament: seria tan poc
 * informativa com el 'false' mut que aquest modul esta eliminant.
 *
 * Es NO COMPROVADA (esten RuntimeException) perque representa regles de
 * negoci que qui crida normalment no pot resoldre al lloc, i perque
 * obligar a declarar-les contaminaria tota l'aplicacio, incloses les lambdes.
 */
public abstract class BiblioTechException extends RuntimeException {

    private static final long serialVersionUID = 1L;

    protected BiblioTechException(String missatge) {
        super(missatge);
    }

    protected BiblioTechException(String missatge, Throwable causa) {
        super(missatge, causa);
    }

    /**
     * Codi estable de la fallada, derivat del nom de la classe.
     * Serveix per al log i per a la documentacio de suport:
     * MATERIALNOTROBAT, LIMITPRESTECSEXCEDIT, etc.
     */
    public String getCodi() {
        return getClass().getSimpleName()
                .replace("Exception", "")
                .toUpperCase();
    }

    /**
     * Pot l'usuari corregir aixo per si mateix?
     * Per defecte si; les subclasses que representin fallades del sistema ho redefineixen.
     */
    public boolean esCorregiblePerUsuari() {
        return true;
    }
}

package com.nexussoftware.bibliotech.domini;

/** Fallades relacionades amb el cataleg de materials. */
public abstract class CatalegException extends BiblioTechException {

    private static final long serialVersionUID = 1L;

    protected CatalegException(String missatge) { super(missatge); }

    protected CatalegException(String missatge, Throwable causa) { super(missatge, causa); }
}

package com.nexussoftware.bibliotech.domini;

/** Fallades relacionades amb prestecs i devolucions. */
public abstract class PrestecException extends BiblioTechException {

    private static final long serialVersionUID = 1L;

    protected PrestecException(String missatge) { super(missatge); }

    protected PrestecException(String missatge, Throwable causa) { super(missatge, causa); }
}

package com.nexussoftware.bibliotech.domini;

/** No existeix cap material amb la referencia cercada. */
public class MaterialNoTrobatException extends CatalegException {

    private static final long serialVersionUID = 1L;

    private final String referenciaCercada;
    private final int midaCataleg;

    public MaterialNoTrobatException(String referenciaCercada, int midaCataleg) {
        super("No existeix cap material amb la referencia '" + referenciaCercada
                + "' (el cataleg te " + midaCataleg + " materials)");
        this.referenciaCercada = referenciaCercada;
        this.midaCataleg = midaCataleg;
    }

    public String getReferenciaCercada() { return referenciaCercada; }
    public int getMidaCataleg()          { return midaCataleg; }
    public boolean catalegBuit()         { return midaCataleg == 0; }
}

package com.nexussoftware.bibliotech.domini;

/** S'intenta registrar un material amb una referencia o un ISBN que ja existeixen. */
public class ReferenciaDuplicadaException extends CatalegException {

    private static final long serialVersionUID = 1L;

    /** Tipus d'identificador que colliseix. Un enum (04-07) evita cadenes magiques. */
    public enum Tipus { REFERENCIA, ISBN }

    private final Tipus tipus;
    private final String valorDuplicat;
    private final String titolExistent;

    public ReferenciaDuplicadaException(Tipus tipus, String valorDuplicat, String titolExistent) {
        super("Ja existeix un material amb " + (tipus == Tipus.ISBN ? "l'ISBN " : "la referencia ")
                + valorDuplicat + ": '" + titolExistent + "'");
        this.tipus = tipus;
        this.valorDuplicat = valorDuplicat;
        this.titolExistent = titolExistent;
    }

    public Tipus getTipus()          { return tipus; }
    public String getValorDuplicat() { return valorDuplicat; }
    public String getTitolExistent() { return titolExistent; }
}

package com.nexussoftware.bibliotech.domini;

/** El material existeix pero esta prestat a un altre empleat. */
public class MaterialNoDisponibleException extends PrestecException {

    private static final long serialVersionUID = 1L;

    private final String referencia;
    private final String titol;
    private final String idTitularActual;
    private final int diaPrevistDevolucio;

    public MaterialNoDisponibleException(String referencia, String titol,
                                         String idTitularActual, int diaPrevistDevolucio) {
        super("El material " + referencia + " ('" + titol + "') esta prestat a "
                + idTitularActual + " i s'espera la seva devolucio el dia " + diaPrevistDevolucio);
        this.referencia = referencia;
        this.titol = titol;
        this.idTitularActual = idTitularActual;
        this.diaPrevistDevolucio = diaPrevistDevolucio;
    }

    public String getReferencia()       { return referencia; }
    public String getTitol()            { return titol; }
    public String getIdTitularActual()  { return idTitularActual; }
    public int getDiaPrevistDevolucio() { return diaPrevistDevolucio; }

    /** Dies que falten perque el material torni a estar lliure. */
    public int diesEspera(int diaActual) {
        return Math.max(0, diaPrevistDevolucio - diaActual);
    }
}

package com.nexussoftware.bibliotech.domini;

/** L'empleat ha assolit el maxim de prestecs simultanis. */
public class LimitPrestecsExceditException extends PrestecException {

    private static final long serialVersionUID = 1L;

    private final String idEmpleat;
    private final String nomEmpleat;
    private final int prestecsActuals;
    private final int limit;

    public LimitPrestecsExceditException(String idEmpleat, String nomEmpleat,
                                         int prestecsActuals, int limit) {
        super("L'empleat " + idEmpleat + " (" + nomEmpleat + ") te "
                + prestecsActuals + " prestecs actius i el limit es " + limit);
        this.idEmpleat = idEmpleat;
        this.nomEmpleat = nomEmpleat;
        this.prestecsActuals = prestecsActuals;
        this.limit = limit;
    }

    public String getIdEmpleat()    { return idEmpleat; }
    public String getNomEmpleat()   { return nomEmpleat; }
    public int getPrestecsActuals() { return prestecsActuals; }
    public int getLimit()           { return limit; }

    /** Quants materials ha de retornar per poder prendre'n un altre en prestec. */
    public int devolucionsNecessaries() {
        return Math.max(1, prestecsActuals - limit + 1);
    }
}

package com.nexussoftware.bibliotech.domini;

/** S'intenta retornar un prestec que ja s'havia retornat. */
public class PrestecJaRetornatException extends PrestecException {

    private static final long serialVersionUID = 1L;

    private final String referenciaPrestec;
    private final int diaDevolucioOriginal;

    public PrestecJaRetornatException(String referenciaPrestec, int diaDevolucioOriginal) {
        super("El prestec " + referenciaPrestec + " ja es va retornar el dia "
                + diaDevolucioOriginal);
        this.referenciaPrestec = referenciaPrestec;
        this.diaDevolucioOriginal = diaDevolucioOriginal;
    }

    public String getReferenciaPrestec()  { return referenciaPrestec; }
    public int getDiaDevolucioOriginal()  { return diaDevolucioOriginal; }

    /**
     * Aquesta fallada gairebe sempre indica un problema de sequencia al codi
     * o un doble clic de l'usuari, no una cosa que l'usuari pugui "corregir".
     */
    @Override
    public boolean esCorregiblePerUsuari() {
        return false;
    }
}

package com.nexussoftware.bibliotech.servei;

/**
 * El cataleg persistit no es pot llegir o escriure.
 *
 * Es COMPROVADA perque representa una fallada de l'entorn (disc, permisos,
 * fitxer absent) de la qual l'aplicacio SI que te una alternativa raonable:
 * arrencar amb el cataleg buit. Obligar a decidir-ho explicitament es
 * justament el que es vol.
 *
 * No esten BiblioTechException perque aquella arrel es no comprovada i
 * representa regles de negoci; aixo es una fallada d'infraestructura.
 * El modul 7 desenvolupara la part d'E/S.
 */
public class CatalegNoAccessibleException extends Exception {

    private static final long serialVersionUID = 1L;

    private final String cami;

    public CatalegNoAccessibleException(String cami, Throwable causa) {
        super("No s'ha pogut accedir al cataleg a '" + cami + "'", causa);
        this.cami = cami;
    }

    public String getCami() { return cami; }
}

package com.nexussoftware.bibliotech.servei;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Optional;
import java.util.Set;

import com.nexussoftware.bibliotech.domini.Llibre;
import com.nexussoftware.bibliotech.domini.Material;
import com.nexussoftware.bibliotech.domini.MaterialNoTrobatException;
import com.nexussoftware.bibliotech.domini.ReferenciaDuplicadaException;

/** Cataleg de BiblioTech amb excepcions del domini. */
public class Cataleg {

    private final List<Material> materials = new ArrayList<>();
    private final Map<String, Material> indexPerReferencia = new HashMap<>();
    private final Map<String, String> titolsPerIsbn = new HashMap<>();

    /**
     * Registra un material.
     *
     * @throws NullPointerException          si el material es nul (fallada tecnica)
     * @throws ReferenciaDuplicadaException  si la referencia o l'ISBN ja existeixen
     */
    public void registrar(Material material) {
        // Validacio tecnica: excepcio ESTANDARD
        Objects.requireNonNull(material, "El material a registrar no pot ser nul");

        String referencia = material.getReferencia();

        // Regla de negoci: excepcio PROPIA, amb dades
        Material existent = indexPerReferencia.get(referencia);
        if (existent != null) {
            throw new ReferenciaDuplicadaException(
                    ReferenciaDuplicadaException.Tipus.REFERENCIA,
                    referencia, existent.getTitol());
        }

        if (material instanceof Llibre llibre) {
            String titolAmbAquestIsbn = titolsPerIsbn.get(llibre.getIsbn());
            if (titolAmbAquestIsbn != null) {
                throw new ReferenciaDuplicadaException(
                        ReferenciaDuplicadaException.Tipus.ISBN,
                        llibre.getIsbn(), titolAmbAquestIsbn);
            }
            titolsPerIsbn.put(llibre.getIsbn(), llibre.getTitol());
        }

        materials.add(material);
        indexPerReferencia.put(referencia, material);
    }

    /**
     * Obte un material EXIGINT que existeixi. Mai no retorna null.
     *
     * @throws MaterialNoTrobatException si no existeix
     */
    public Material obtenirPerReferencia(String referencia) {
        Objects.requireNonNull(referencia, "La referencia no pot ser nulla");

        Material trobat = indexPerReferencia.get(referencia);
        if (trobat == null) {
            throw new MaterialNoTrobatException(referencia, materials.size());
        }
        return trobat;
    }

    /** Cerca ADMETENT que no existeixi. Mai no retorna null: retorna Optional. */
    public Optional<Material> cercarPerReferencia(String referencia) {
        if (referencia == null) { return Optional.empty(); }
        return Optional.ofNullable(indexPerReferencia.get(referencia));
    }

    public List<Material> cercarPerPrefix(String prefix) {
        List<Material> resultat = new ArrayList<>();
        for (Material m : materials) {
            if (m.getReferencia().startsWith(prefix)) {
                resultat.add(m);
            }
        }
        return resultat;
    }

    public boolean existeix(String referencia) {
        return referencia != null && indexPerReferencia.containsKey(referencia);
    }

    public int mida()                { return materials.size(); }
    public List<Material> llistar()  { return List.copyOf(materials); }
}

package com.nexussoftware.bibliotech.presentacio;

import com.nexussoftware.bibliotech.domini.*;
import com.nexussoftware.bibliotech.servei.Cataleg;
import com.nexussoftware.bibliotech.servei.GestorPrestecs;

/**
 * Demostra la diferencia entre capturar per TIPUS amb dades estructurades
 * i capturar tipus estandard llegint el missatge.
 */
public class DemoExcepcionsDomini {

    public static void main(String[] args) {
        Cataleg cataleg = new Cataleg();
        cataleg.registrar(new Llibre("LIB-0001", "Java Eficac", "Bloch", 2018, "978-0000000001"));
        cataleg.registrar(new Llibre("LIB-0002", "Patrons de Disseny", "GoF", 1994, "978-0000000002"));
        cataleg.registrar(new Llibre("LIB-0003", "Refactoritzacio", "Fowler", 1999, "978-0000000003"));

        GestorPrestecs gestor = new GestorPrestecs(cataleg);
        gestor.donarAlta(new Empleat("Marta Ruiz", "EMP-001"));
        gestor.donarAlta(new Empleat("Diego Alonso", "EMP-002"));

        // Marta esgota la seva quota
        gestor.prestar("LIB-0001", "EMP-001", 10);
        gestor.prestar("LIB-0002", "EMP-001", 10);
        gestor.prestar("LIB-0003", "EMP-001", 10);

        System.out.println("=== Fallades, cadascuna amb EL SEU gestor ===\n");

        operar(gestor, cataleg, "LIB-9999", "EMP-001", 12);   // no trobat
        operar(gestor, cataleg, "LIB-0001", "EMP-002", 12);   // no disponible
        operar(gestor, cataleg, "LIB-0001", "EMP-001", 12);   // no disponible (i limit)

        System.out.println("\n=== Duplicats ===\n");
        registrar(cataleg, new Llibre("LIB-0001", "Altre titol", "X", 2020, "978-0000000009"));
        registrar(cataleg, new Llibre("LIB-0004", "Copia", "Bloch", 2018, "978-0000000001"));

        System.out.println("\n=== Captura per l'ARREL: tot el domini d'una vegada ===\n");
        try {
            cataleg.obtenirPerReferencia("LIB-7777");
        } catch (BiblioTechException e) {
            System.out.println("Codi: " + e.getCodi());
            System.out.println("Missatge: " + e.getMessage());
            System.out.println("Corregible per l'usuari? " + e.esCorregiblePerUsuari());
        }
    }

    /** Cada tipus de fallada es gestiona de manera DIFERENT usant les seves dades. */
    private static void operar(GestorPrestecs gestor, Cataleg cataleg,
                               String referencia, String idEmpleat, int dia) {
        System.out.println("--- prestar(" + referencia + ", " + idEmpleat + ") ---");
        try {
            gestor.prestar(referencia, idEmpleat, dia);
            System.out.println("  OK");

        } catch (MaterialNoTrobatException e) {
            // Usa les DADES de l'excepcio per ajudar l'usuari
            System.out.println("  No s'ha trobat '" + e.getReferenciaCercada() + "'.");
            if (e.catalegBuit()) {
                System.out.println("  El cataleg esta buit: carregueu primer els materials.");
            } else {
                var semblants = cataleg.cercarPerPrefix(
                        e.getReferenciaCercada().substring(0, 4));
                System.out.println("  Materials amb prefix similar: " + semblants.size());
            }

        } catch (MaterialNoDisponibleException e) {
            System.out.println("  '" + e.getTitol() + "' el te " + e.getIdTitularActual() + ".");
            System.out.println("  Torna en " + e.diesEspera(dia) + " dies.");
            System.out.println("  -> S'afegeix a la cua de reserves de " + e.getReferencia());

        } catch (LimitPrestecsExceditException e) {
            System.out.println("  " + e.getNomEmpleat() + " te "
                    + e.getPrestecsActuals() + "/" + e.getLimit() + " prestecs.");
            System.out.println("  Ha de retornar " + e.devolucionsNecessaries()
                    + " material(s) abans de prendre'n un altre.");
        }
    }

    private static void registrar(Cataleg cataleg, Material material) {
        try {
            cataleg.registrar(material);
            System.out.println("Registrat: " + material.getReferencia());
        } catch (ReferenciaDuplicadaException e) {
            // El TIPUS del duplicat permet un missatge precis, sense parsejar text
            String queColliseix = (e.getTipus() == ReferenciaDuplicadaException.Tipus.ISBN)
                    ? "L'ISBN" : "La referencia";
            System.out.println(queColliseix + " " + e.getValorDuplicat()
                    + " ja la fa servir '" + e.getTitolExistent() + "'. Alta rebutjada.");
        }
    }
}

=== Fallades, cadascuna amb EL SEU gestor ===

--- prestar(LIB-9999, EMP-001) ---
  No s'ha trobat 'LIB-9999'.
  Materials amb prefix similar: 0
--- prestar(LIB-0001, EMP-002) ---
  'Java Eficac' el te EMP-001.
  Torna en 13 dies.
  -> S'afegeix a la cua de reserves de LIB-0001
--- prestar(LIB-0001, EMP-001) ---
  'Java Eficac' el te EMP-001.
  Torna en 13 dies.
  -> S'afegeix a la cua de reserves de LIB-0001

=== Duplicats ===

La referencia LIB-0001 ja la fa servir 'Java Eficac'. Alta rebutjada.
L'ISBN 978-0000000001 ja la fa servir 'Java Eficac'. Alta rebutjada.

=== Captura per l'ARREL: tot el domini d'una vegada ===

Codi: MATERIALNOTROBAT
Missatge: No existeix cap material amb la referencia 'LIB-7777' (el cataleg te 3 materials)
Corregible per l'usuari? true

public class ErrorReserva extends Throwable {
    public ErrorReserva() { }
}

public class ReservaNoValida extends ErrorReserva {
    public String missatge;
    public ReservaNoValida(String m) { this.missatge = m; }
}

public class ErrorDataReserva extends Exception {
    public ErrorDataReserva(String m) { super(m); }
}

public class ReservaDuplicadaError extends ReservaNoValida {
    public ReservaDuplicadaError() { super("Error"); }
}

// Us tipic al codi:
// try {
//     cuaReserves.reservar(referencia, idEmpleat, dia);
// } catch (Throwable t) {
//     if (t.getMessage() != null && t.getMessage().startsWith("Error")) {
//         System.out.println("Fallada de reserva");
//     }
// }

package com.nexussoftware.bibliotech.domini;

import java.util.List;

/**
 * L'empleat ha acumulat una multa que li impedeix prendre mes prestecs
 * fins a saldar-la.
 *
 * Transporta el desglossament complet perque la capa de presentacio pugui
 * mostrar un rebut, i perque la de servei pugui decidir si aplica
 * una excepcio a la regla.
 */
public class MultaExcessivaException extends PrestecException {

    private static final long serialVersionUID = 1L;

    public static final double MULTA_MAXIMA = 20.0;

    private final String idEmpleat;
    private final String nomEmpleat;
    private final double quantitatAcumulada;
    private final double llindarPermes;
    private final List<String> materialsAmbMulta;

    public MultaExcessivaException(String idEmpleat, String nomEmpleat,
                                   double quantitatAcumulada, double llindarPermes,
                                   List<String> materialsAmbMulta) {
        super(construirMissatge(idEmpleat, nomEmpleat, quantitatAcumulada,
                llindarPermes, materialsAmbMulta));
        this.idEmpleat = idEmpleat;
        this.nomEmpleat = nomEmpleat;
        this.quantitatAcumulada = quantitatAcumulada;
        this.llindarPermes = llindarPermes;
        // Copia defensiva: l'excepcio ha de ser immutable encara que la llista
        // original canvii despres (03-07)
        this.materialsAmbMulta = List.copyOf(materialsAmbMulta);
    }

    public MultaExcessivaException(String idEmpleat, String nomEmpleat,
                                   double quantitatAcumulada, double llindarPermes,
                                   List<String> materialsAmbMulta, Throwable causa) {
        super(construirMissatge(idEmpleat, nomEmpleat, quantitatAcumulada,
                llindarPermes, materialsAmbMulta), causa);
        this.idEmpleat = idEmpleat;
        this.nomEmpleat = nomEmpleat;
        this.quantitatAcumulada = quantitatAcumulada;
        this.llindarPermes = llindarPermes;
        this.materialsAmbMulta = List.copyOf(materialsAmbMulta);
    }

    /**
     * El missatge es construeix en un metode estatic perque cal cridar-lo
     * al super(...), abans que els camps existeixin.
     */
    private static String construirMissatge(String idEmpleat, String nomEmpleat,
                                            double quantitat, double llindar,
                                            List<String> materials) {
        return String.format(
                "L'empleat %s (%s) acumula %.2f EUR de multa, per sobre del llindar de %.2f EUR, "
                        + "en %d material(s)",
                idEmpleat, nomEmpleat, quantitat, llindar, materials.size());
    }

    public String getIdEmpleat()          { return idEmpleat; }
    public String getNomEmpleat()         { return nomEmpleat; }
    public double getQuantitatAcumulada() { return quantitatAcumulada; }
    public double getLlindarPermes()      { return llindarPermes; }

    /** Ja es immutable per List.copyOf, pero es retorna explicitament aixi. */
    public List<String> getMaterialsAmbMulta() {
        return materialsAmbMulta;
    }

    // ---------- Metodes de conveniencia ----------

    /** Quant cal pagar com a minim per tornar a estar per sota del llindar. */
    public double getExces() {
        return Math.max(0.0, quantitatAcumulada - llindarPermes);
    }

    /** S'ha assolit el sostre absolut de multa del sistema? */
    public boolean superaLaMultaMaxima() {
        return quantitatAcumulada >= MULTA_MAXIMA;
    }

    /** Desglossament llegible, una linia per material. */
    public String getResum() {
        StringBuilder sb = new StringBuilder();
        sb.append(String.format("Multa de %s: %.2f EUR (llindar %.2f, exces %.2f)%n",
                nomEmpleat, quantitatAcumulada, llindarPermes, getExces()));
        for (String referencia : materialsAmbMulta) {
            sb.append("  - ").append(referencia).append('\n');
        }
        if (superaLaMultaMaxima()) {
            sb.append(String.format("  ATENCIO: s'ha assolit la multa maxima (%.2f EUR)%n",
                    MULTA_MAXIMA));
        }
        return sb.toString();
    }

    /** L'empleat ho pot resoldre pagant: es corregible per ell. */
    @Override
    public boolean esCorregiblePerUsuari() {
        return true;
    }

    // ---------- Demostracio ----------

    public static void main(String[] args) {
        try {
            throw new MultaExcessivaException(
                    "EMP-001", "Marta Ruiz",
                    23.75, 10.0,
                    List.of("LIB-0001", "LIB-0002", "REV-0007"));

        } catch (MultaExcessivaException e) {
            System.out.println("=== Captura especifica ===");
            System.out.println("Codi                : " + e.getCodi());
            System.out.println("Missatge            : " + e.getMessage());
            System.out.println("Empleat             : " + e.getIdEmpleat()
                    + " (" + e.getNomEmpleat() + ")");
            System.out.printf ("Quantitat acumulada : %.2f EUR%n", e.getQuantitatAcumulada());
            System.out.printf ("Llindar permes      : %.2f EUR%n", e.getLlindarPermes());
            System.out.printf ("Exces a pagar       : %.2f EUR%n", e.getExces());
            System.out.println("Supera el maxim     : " + e.superaLaMultaMaxima());
            System.out.println("Materials           : " + e.getMaterialsAmbMulta());
            System.out.println("Corregible per l'usuari: " + e.esCorregiblePerUsuari());

            System.out.println("\n=== Resum per al rebut ===");
            System.out.print(e.getResum());

            // Demostracio que la llista es IMMUTABLE
            System.out.println("=== Immutabilitat ===");
            try {
                e.getMaterialsAmbMulta().add("LIB-9999");
            } catch (UnsupportedOperationException uoe) {
                System.out.println("La llista de materials no es pot modificar. Correcte.");
            }
        }

        // Captura per la branca i per l'arrel
        System.out.println("\n=== Captura per la branca PrestecException ===");
        try {
            throw new MultaExcessivaException("EMP-002", "Diego Alonso",
                    12.5, 10.0, List.of("LIB-0003"));
        } catch (PrestecException e) {
            System.out.println("Fallada de prestec [" + e.getCodi() + "]: " + e.getMessage());
        }
    }
}

=== Captura especifica ===
Codi                : MULTAEXCESSIVA
Missatge            : L'empleat EMP-001 (Marta Ruiz) acumula 23,75 EUR de multa, per sobre del llindar de 10,00 EUR, en 3 material(s)
Empleat             : EMP-001 (Marta Ruiz)
Quantitat acumulada : 23,75 EUR
Llindar permes      : 10,00 EUR
Exces a pagar       : 13,75 EUR
Supera el maxim     : true
Materials           : [LIB-0001, LIB-0002, REV-0007]
Corregible per l'usuari: true

=== Resum per al rebut ===
Multa de Marta Ruiz: 23,75 EUR (llindar 10,00, exces 13,75)
  - LIB-0001
  - LIB-0002
  - REV-0007
  ATENCIO: s'ha assolit la multa maxima (20,00 EUR)
=== Immutabilitat ===
La llista de materials no es pot modificar. Correcte.

=== Captura per la branca PrestecException ===
Fallada de prestec [MULTAEXCESSIVA]: L'empleat EMP-002 (Diego Alonso) acumula 12,50 EUR de multa, per sobre del llindar de 10,00 EUR, en 1 material(s)

package com.nexussoftware.bibliotech.domini;

/** Arrel de les fallades del subsistema de reserves. */
public abstract class ReservaException extends BiblioTechException {

    private static final long serialVersionUID = 1L;

    private final String referencia;
    private final String idEmpleat;

    protected ReservaException(String missatge, String referencia, String idEmpleat) {
        super(missatge);
        this.referencia = referencia;
        this.idEmpleat = idEmpleat;
    }

    protected ReservaException(String missatge, String referencia, String idEmpleat,
                               Throwable causa) {
        super(missatge, causa);
        this.referencia = referencia;
        this.idEmpleat = idEmpleat;
    }

    /** Dades comunes a tota la familia: es declaren una sola vegada, a l'arrel. */
    public String getReferencia() { return referencia; }
    public String getIdEmpleat()  { return idEmpleat; }
}

package com.nexussoftware.bibliotech.domini;

/** L'empleat ja te una reserva activa d'aquell material. */
public class ReservaDuplicadaException extends ReservaException {

    private static final long serialVersionUID = 1L;

    private final int posicioActual;

    public ReservaDuplicadaException(String referencia, String idEmpleat, int posicioActual) {
        super("L'empleat " + idEmpleat + " ja te una reserva de " + referencia
                + " a la posicio " + posicioActual + " de la cua",
                referencia, idEmpleat);
        this.posicioActual = posicioActual;
    }

    public int getPosicioActual() { return posicioActual; }
}

package com.nexussoftware.bibliotech.domini;

/** El dia de la reserva no es valid per a aquell material. */
public class DiaReservaInvalidException extends ReservaException {

    private static final long serialVersionUID = 1L;

    private final int diaSollicitat;
    private final int diaMinim;

    public DiaReservaInvalidException(String referencia, String idEmpleat,
                                      int diaSollicitat, int diaMinim) {
        super("La reserva de " + referencia + " es va sollicitar per al dia " + diaSollicitat
                + ", pero el material no estara disponible fins al dia " + diaMinim,
                referencia, idEmpleat);
        this.diaSollicitat = diaSollicitat;
        this.diaMinim = diaMinim;
    }

    public int getDiaSollicitat() { return diaSollicitat; }
    public int getDiaMinim()      { return diaMinim; }
    public int getDiesEspera()    { return Math.max(0, diaMinim - diaSollicitat); }
}

try {
    int posicio = cuaReserves.reservar(referencia, idEmpleat, dia);
    System.out.println("Reservat. Posicio a la cua: " + posicio);

} catch (ReservaDuplicadaException e) {
    // Es fan servir les DADES, no el text
    System.out.println("Ja tenia una reserva de " + e.getReferencia()
            + ", a la posicio " + e.getPosicioActual() + ". No s'ha duplicat.");

} catch (DiaReservaInvalidException e) {
    System.out.println("Aquell material no estara lliure fins d'aqui a "
            + e.getDiesEspera() + " dies.");
    System.out.println("Voleu reservar-lo per al dia " + e.getDiaMinim() + "? (s/n)");

} catch (ReservaException e) {
    // Xarxa de seguretat de la BRANCA, no de Throwable
    System.out.println("No s'ha pogut completar la reserva [" + e.getCodi() + "]: "
            + e.getMessage());
}

package com.nexussoftware.bibliotech.domini;

/** Arrel de les fallades de la cua de reserves. */
public abstract class ReservaException extends BiblioTechException {
    private static final long serialVersionUID = 1L;
    protected ReservaException(String missatge) { super(missatge); }
}

package com.nexussoftware.bibliotech.domini;

public class ReservaDuplicadaException extends ReservaException {

    private static final long serialVersionUID = 1L;

    private final String referencia;
    private final String idEmpleat;
    private final int posicioActual;

    public ReservaDuplicadaException(String referencia, String idEmpleat, int posicioActual) {
        super("L'empleat " + idEmpleat + " ja te reservat " + referencia
                + " (posicio " + posicioActual + " de la cua)");
        this.referencia = referencia;
        this.idEmpleat = idEmpleat;
        this.posicioActual = posicioActual;
    }

    public String getReferencia()  { return referencia; }
    public String getIdEmpleat()   { return idEmpleat; }
    public int getPosicioActual()  { return posicioActual; }
}

package com.nexussoftware.bibliotech.domini;

public class CuaReservesPlenaException extends ReservaException {

    private static final long serialVersionUID = 1L;

    private final String referencia;
    private final int maxim;
    private final int diaEstimatDisponibilitat;

    public CuaReservesPlenaException(String referencia, int maxim,
                                     int diaEstimatDisponibilitat) {
        super("La cua de reserves de " + referencia + " esta plena (" + maxim
                + " reserves). Disponibilitat estimada: dia " + diaEstimatDisponibilitat);
        this.referencia = referencia;
        this.maxim = maxim;
        this.diaEstimatDisponibilitat = diaEstimatDisponibilitat;
    }

    public String getReferencia()            { return referencia; }
    public int getMaxim()                    { return maxim; }
    public int getDiaEstimatDisponibilitat() { return diaEstimatDisponibilitat; }

    @Override
    public boolean esCorregiblePerUsuari() {
        return false;   // l'usuari no pot fer res: la cua esta plena
    }
}

package com.nexussoftware.bibliotech.domini;

public class ReservaNoTrobadaException extends ReservaException {

    private static final long serialVersionUID = 1L;

    private final String referencia;
    private final String idEmpleat;

    public ReservaNoTrobadaException(String referencia, String idEmpleat) {
        super("L'empleat " + idEmpleat + " no te cap reserva de " + referencia);
        this.referencia = referencia;
        this.idEmpleat = idEmpleat;
    }

    public String getReferencia() { return referencia; }
    public String getIdEmpleat()  { return idEmpleat; }
}

package com.nexussoftware.bibliotech.servei;

import java.util.ArrayDeque;
import java.util.Deque;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import java.util.Objects;
import java.util.Optional;

import com.nexussoftware.bibliotech.domini.CuaReservesPlenaException;
import com.nexussoftware.bibliotech.domini.ReservaDuplicadaException;
import com.nexussoftware.bibliotech.domini.ReservaException;
import com.nexussoftware.bibliotech.domini.ReservaNoTrobadaException;

/**
 * Cua FIFO de reserves per material (recupera l'ArrayDeque de 05-07).
 *
 * Politica d'errors:
 *  - Arguments invalids       -> excepcions ESTANDARD (NPE, IllegalArgument).
 *  - Regles de negoci         -> excepcions PROPIES amb dades.
 */
public class CuaReserves {

    public static final int MAX_RESERVES_PER_MATERIAL = 5;
    private static final int DIES_ESTIMATS_PER_TORN = 15;

    /** Reserva d'un empleat sobre un material (record, 04-07). */
    public record Reserva(String referencia, String idEmpleat, int dia) { }

    private final Map<String, Deque<Reserva>> cuesPerMaterial = new HashMap<>();

    /**
     * Afegeix una reserva al final de la cua del material.
     *
     * @return posicio a la cua, sent 1 el seguent a ser ates
     * @throws NullPointerException        si algun argument es nul
     * @throws IllegalArgumentException    si el dia es menor que 1
     * @throws ReservaDuplicadaException   si aquell empleat ja va reservar aquell material
     * @throws CuaReservesPlenaException   si la cua va assolir el maxim
     */
    public int reservar(String referencia, String idEmpleat, int dia) {
        // Validacio tecnica: excepcions estandard
        Objects.requireNonNull(referencia, "La referencia no pot ser nulla");
        Objects.requireNonNull(idEmpleat, "L'identificador de l'empleat no pot ser nul");
        if (dia < 1) {
            throw new IllegalArgumentException("El dia ha de ser 1 o posterior, i era: " + dia);
        }

        Deque<Reserva> cua = cuesPerMaterial.computeIfAbsent(referencia, r -> new ArrayDeque<>());

        // Regla de negoci 1: no duplicar
        int jaHiEs = posicioA(cua, idEmpleat);
        if (jaHiEs > 0) {
            throw new ReservaDuplicadaException(referencia, idEmpleat, jaHiEs);
        }

        // Regla de negoci 2: cua plena
        if (cua.size() >= MAX_RESERVES_PER_MATERIAL) {
            int diaEstimat = dia + cua.size() * DIES_ESTIMATS_PER_TORN;
            throw new CuaReservesPlenaException(referencia, MAX_RESERVES_PER_MATERIAL, diaEstimat);
        }

        cua.addLast(new Reserva(referencia, idEmpleat, dia));
        return cua.size();
    }

    /**
     * Cancella la reserva d'un empleat sobre un material.
     *
     * @throws ReservaNoTrobadaException si no hi havia aquella reserva
     */
    public void cancellar(String referencia, String idEmpleat) {
        Objects.requireNonNull(referencia, "La referencia no pot ser nulla");
        Objects.requireNonNull(idEmpleat, "L'identificador de l'empleat no pot ser nul");

        Deque<Reserva> cua = cuesPerMaterial.get(referencia);
        if (cua == null) {
            throw new ReservaNoTrobadaException(referencia, idEmpleat);
        }

        // removeIf sobre un Deque: forma segura d'eliminar mentre s'itera (05-04)
        boolean eliminada = cua.removeIf(r -> r.idEmpleat().equals(idEmpleat));
        if (!eliminada) {
            throw new ReservaNoTrobadaException(referencia, idEmpleat);
        }
        if (cua.isEmpty()) {
            cuesPerMaterial.remove(referencia);        // no deixar cues buides al mapa
        }
    }

    /**
     * Treu el primer de la cua. Retorna Optional buit si no hi ha ningu
     * esperant: aqui l'absencia es un cas NORMAL, no una fallada.
     */
    public Optional<Reserva> atendreSeguent(String referencia) {
        Deque<Reserva> cua = cuesPerMaterial.get(referencia);
        if (cua == null || cua.isEmpty()) {
            return Optional.empty();
        }
        Reserva primera = cua.pollFirst();
        if (cua.isEmpty()) {
            cuesPerMaterial.remove(referencia);
        }
        return Optional.of(primera);
    }

    /** Posicio de l'empleat a la cua d'aquell material, o -1 si no hi es. */
    public int posicioDe(String referencia, String idEmpleat) {
        Deque<Reserva> cua = cuesPerMaterial.get(referencia);
        if (cua == null) { return -1; }
        int p = posicioA(cua, idEmpleat);
        return (p > 0) ? p : -1;
    }

    /** Retorna la posicio 1..n, o 0 si no hi es. */
    private int posicioA(Deque<Reserva> cua, String idEmpleat) {
        int posicio = 1;
        for (Iterator<Reserva> it = cua.iterator(); it.hasNext(); posicio++) {
            if (it.next().idEmpleat().equals(idEmpleat)) {
                return posicio;
            }
        }
        return 0;
    }

    public int midaCua(String referencia) {
        Deque<Reserva> cua = cuesPerMaterial.get(referencia);
        return (cua == null) ? 0 : cua.size();
    }

    // ------------------------------------------------------------------

    public static void main(String[] args) {
        CuaReserves cues = new CuaReserves();
        String LLIBRE = "LIB-0001";

        System.out.println("=== Reserves correctes ===");
        System.out.println("Marta -> posicio " + cues.reservar(LLIBRE, "EMP-001", 10));
        System.out.println("Diego -> posicio " + cues.reservar(LLIBRE, "EMP-002", 11));
        System.out.println("Nuria -> posicio " + cues.reservar(LLIBRE, "EMP-003", 12));

        System.out.println("\n=== Fallades ===");
        intentar("Reserva duplicada", () -> cues.reservar(LLIBRE, "EMP-001", 13));
        intentar("Cancellar inexistent", () -> cues.cancellar(LLIBRE, "EMP-009"));
        intentar("Dia invalid", () -> cues.reservar(LLIBRE, "EMP-004", 0));
        intentar("Referencia nulla", () -> cues.reservar(null, "EMP-004", 5));

        // Omplir la cua fins al maxim
        cues.reservar(LLIBRE, "EMP-004", 13);
        cues.reservar(LLIBRE, "EMP-005", 14);
        System.out.println("\nCua de " + LLIBRE + ": " + cues.midaCua(LLIBRE)
                + "/" + MAX_RESERVES_PER_MATERIAL);
        intentar("Cua plena", () -> cues.reservar(LLIBRE, "EMP-006", 15));

        System.out.println("\n=== Atencio FIFO ===");
        Optional<Reserva> seguent;
        while ((seguent = cues.atendreSeguent(LLIBRE)).isPresent()) {
            Reserva r = seguent.get();
            System.out.println("  Ates " + r.idEmpleat() + " (va reservar el dia " + r.dia() + ")");
        }
        System.out.println("Cua buida: " + (cues.midaCua(LLIBRE) == 0));
    }

    /** Gestor que captura per la BRANCA i usa getCodi() de l'arrel. */
    private static void intentar(String descripcio, Runnable accio) {
        try {
            accio.run();
            System.out.println("[" + descripcio + "] -> no ha fallat (inesperat)");
        } catch (ReservaException e) {
            System.out.println("[" + descripcio + "] [" + e.getCodi() + "] " + e.getMessage()
                    + " | corregible: " + e.esCorregiblePerUsuari());
        } catch (NullPointerException | IllegalArgumentException e) {
            System.out.println("[" + descripcio + "] [TECNIC] "
                    + e.getClass().getSimpleName() + ": " + e.getMessage());
        }
    }
}

=== Reserves correctes ===
Marta -> posicio 1
Diego -> posicio 2
Nuria -> posicio 3

=== Fallades ===
[Reserva duplicada] [RESERVADUPLICADA] L'empleat EMP-001 ja te reservat LIB-0001 (posicio 1 de la cua) | corregible: true
[Cancellar inexistent] [RESERVANOTROBADA] L'empleat EMP-009 no te cap reserva de LIB-0001 | corregible: true
[Dia invalid] [TECNIC] IllegalArgumentException: El dia ha de ser 1 o posterior, i era: 0
[Referencia nulla] [TECNIC] NullPointerException: La referencia no pot ser nulla

Cua de LIB-0001: 5/5
[Cua plena] [CUARESERVESPLENA] La cua de reserves de LIB-0001 esta plena (5 reserves). Disponibilitat estimada: dia 90 | corregible: false

=== Atencio FIFO ===
  Ates EMP-001 (va reservar el dia 10)
  Ates EMP-002 (va reservar el dia 11)
  Ates EMP-003 (va reservar el dia 12)
  Ates EMP-004 (va reservar el dia 13)
  Ates EMP-005 (va reservar el dia 14)
Cua buida: true