// MALAMENT: captura on es produeix, sense poder decidir res
public Material cercar(String referencia) {
    try {
        return cataleg.obtenirPerReferencia(referencia);
    } catch (MaterialNoTrobatException e) {
        e.printStackTrace();       // no es una decisio
        return null;               // i ara retornem el null que tant va costar eliminar
    }
}

// BE: no es captura. Puja a qui pugui decidir.
public Material cercar(String referencia) {
    return cataleg.obtenirPerReferencia(referencia);
}

package com.nexussoftware.bibliotech.presentacio;

import java.util.logging.Level;
import java.util.logging.Logger;

import com.nexussoftware.bibliotech.domini.BiblioTechException;

/**
 * Punt d'entrada de BiblioTech amb frontera d'errors.
 *
 * Estructura de la frontera, del mes especific al mes general:
 *   1. BiblioTechException : fallada esperada del domini -> missatge net, sortida 1
 *   2. RuntimeException    : bug -> missatge generic amb incidencia, registre complet, sortida 2
 *   3. Error               : fallada de la JVM -> registre minim i sortida immediata, sortida 3
 */
public class BiblioTechApp {

    private static final Logger LOG = Logger.getLogger(BiblioTechApp.class.getName());

    public static void main(String[] args) {
        ConfiguracioLog.inicialitzar();
        installarGestorGlobal();

        LOG.info("BiblioTech arrencant");

        try {
            new MenuBiblioTech().arrencar();
            LOG.info("BiblioTech finalitzat correctament");

        } catch (BiblioTechException e) {
            // Fallada ESPERADA del domini que ningu no ha gestionat. Es rara, pero llegible.
            System.err.println();
            System.err.println("L'operacio no s'ha pogut completar: " + e.getMessage());
            LOG.log(Level.WARNING, "Excepcio de domini no gestionada [" + e.getCodi() + "]", e);
            System.exit(1);

        } catch (RuntimeException e) {
            // Fallada INESPERADA: es un bug. L'usuari no ha de veure els detalls.
            String incidencia = generarIdIncidencia();
            System.err.println();
            System.err.println("S'ha produit un error intern.");
            System.err.println("Incidencia: " + incidencia);
            System.err.println("Comuniqueu aquest codi a l'equip de suport de Nexus Software.");
            LOG.log(Level.SEVERE, "Error no controlat. Incidencia " + incidencia, e);
            System.exit(2);

        } catch (Error e) {
            // Fallada de la JVM: no es pot recuperar. Registrar el minim i sortir.
            // Es captura AQUI i nomes aqui, per deixar constancia abans de morir.
            System.err.println();
            System.err.println("Error irrecuperable de la maquina virtual: "
                    + e.getClass().getSimpleName());
            try {
                LOG.log(Level.SEVERE, "Error irrecuperable", e);
            } catch (Throwable ignorat) {
                // Si ni tan sols es pot registrar (p. ex. OutOfMemoryError),
                // no hi ha res mes a fer. No es propaga per no amagar l'Error.
            }
            System.exit(3);
        }
    }

    /** Identificador curt que l'usuari pot comunicar a suport. */
    private static String generarIdIncidencia() {
        return "INC-" + Long.toHexString(System.nanoTime()).toUpperCase().substring(0, 8);
    }

    private static void installarGestorGlobal() {
        Thread.setDefaultUncaughtExceptionHandler((fil, fallada) ->
                LOG.log(Level.SEVERE, "Excepcio no capturada al fil '"
                        + fil.getName() + "'", fallada));
    }
}

package com.nexussoftware.bibliotech.presentacio;

import java.util.logging.Level;
import java.util.logging.Logger;

public final class GestorGlobal {

    private static final Logger LOG = Logger.getLogger(GestorGlobal.class.getName());

    private GestorGlobal() { }

    public static void installar() {
        Thread.setDefaultUncaughtExceptionHandler((fil, fallada) -> {
            // Aquest codi s'executa quan una excepcio escapa de QUALSEVOL fil
            LOG.log(Level.SEVERE,
                    "Excepcio no capturada al fil '" + fil.getName()
                            + "' (id " + fil.threadId() + ")", fallada);

            if (fallada instanceof Error) {
                LOG.severe("Error irrecuperable: es sollicita l'aturada de l'aplicacio");
                System.exit(3);
            }
        });

        // Hook d'aturada: ultima oportunitat de neteja (06-05)
        Runtime.getRuntime().addShutdownHook(new Thread(() -> {
            LOG.info("BiblioTech aturant-se: consolidant estat");
            // Al modul 7, aqui es persistira el cataleg
        }, "aturada-bibliotech"));
    }

    public static void main(String[] args) {
        installar();

        Thread filSecundari = new Thread(() -> {
            throw new IllegalStateException("Fallada a la tasca de manteniment");
        }, "manteniment");

        filSecundari.start();

        try { filSecundari.join(); } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }

        System.out.println("El fil principal segueix viu, pero la fallada HA QUEDAT REGISTRADA");
    }
}

// El que veu l'usuari
System.err.println("No s'ha pogut completar el prestec.");
System.err.println("Incidencia: INC-A3F91C0B");
System.err.println("Comuniqueu aquest codi a l'equip de suport.");

// El que va al registre
LOG.log(Level.SEVERE, "Fallada en prestar LIB-0001 a EMP-001 el dia 12. Incidencia INC-A3F91C0B", e);

package com.nexussoftware.bibliotech.servei;

import java.util.logging.Level;
import java.util.logging.Logger;

/**
 * Arrencada de BiblioTech amb degradacio elegant: l'aplicacio funciona
 * encara que faltin components opcionals, i nomes avorta si falta alguna cosa essencial.
 */
public class ArrencadaBiblioTech {

    private static final Logger LOG = Logger.getLogger(ArrencadaBiblioTech.class.getName());

    private boolean avisosDisponibles = true;
    private boolean exportacioDisponible = true;

    public Cataleg arrencar(String camiCataleg) {
        Cataleg cataleg = new Cataleg();

        // --- Component OPCIONAL 1: cataleg previ ---
        try {
            carregarCataleg(cataleg, camiCataleg);
            LOG.info(() -> "Cataleg carregat: " + cataleg.mida() + " materials");

        } catch (CatalegNoAccessibleException e) {
            // DEGRADACIO: sense cataleg previ es pot treballar; es comenca buit.
            LOG.log(Level.WARNING,
                    "No s'ha pogut carregar el cataleg des de '" + e.getCami()
                            + "'. S'arrenca amb cataleg buit.", e);
            System.out.println("Avis: no hi havia cataleg previ. Es comenca de zero.");
        }

        // --- Component OPCIONAL 2: servei d'avisos ---
        try {
            connectarServeiAvisos();
            LOG.info("Servei d'avisos disponible");
        } catch (RuntimeException e) {
            avisosDisponibles = false;
            LOG.log(Level.WARNING, "Servei d'avisos no disponible; s'acumularan en cua", e);
            System.out.println("Avis: els avisos de venciment no s'enviaran en aquesta sessio.");
        }

        // --- Component ESSENCIAL: configuracio ---
        // Si aixo falla, NO es degrada: s'avorta. Continuar amb una tarifa
        // desconeguda produiria multes incorrectes, que es pitjor que no arrencar.
        int diesPrestec = llegirConfiguracioObligatoria("dies.prestec");
        LOG.config(() -> "Configuracio: dies.prestec=" + diesPrestec);

        return cataleg;
    }

    public boolean potEnviarAvisos()  { return avisosDisponibles; }
    public boolean potExportar()      { return exportacioDisponible; }

    private void carregarCataleg(Cataleg cataleg, String cami) throws CatalegNoAccessibleException {
        throw new CatalegNoAccessibleException(cami,
                new java.io.FileNotFoundException(cami + " (No such file or directory)"));
    }

    private void connectarServeiAvisos() {
        throw new IllegalStateException("El servei d'avisos no respon al port 8080");
    }

    private int llegirConfiguracioObligatoria(String clau) {
        return 15;   // al modul 7 vindra d'un fitxer .properties
    }
}

// VALIDACIO PREVIA: barata, el cas es frequent i no hi ha cursa
if (cataleg.existeix(referencia)) {
    Material m = cataleg.obtenirPerReferencia(referencia);
    // ...
}

// Millor encara amb el metode que retorna Optional
cataleg.cercarPerReferencia(referencia)
       .ifPresent(m -> System.out.println(m.getTitol()));

// EXCEPCIO: la conversio no es pot validar sense fer-la
try {
    int dies = Integer.parseInt(entrada);
} catch (NumberFormatException e) {
    // Escriure un validador d'enters correcte (signe, rang, desbordament)
    // es mes propens a errors que capturar
}

// EXCEPCIO OBLIGATORIA: condicio de cursa
// Amb fitxers o recursos compartits, "comprovar i despres usar" no es atomic:
// entre l'exists() i l'open() un altre proces pot haver esborrat el fitxer.
try (BufferedReader r = new BufferedReader(new FileReader(cami))) {
    // ...
} catch (FileNotFoundException e) {
    // L'unica forma fiable
}

// Ja el fas servir a BiblioTech des de 06-03
public Optional<Material> cercarPerReferencia(String referencia) {
    return Optional.ofNullable(indexPerReferencia.get(referencia));
}

package com.nexussoftware.bibliotech.servei;

import java.util.ArrayList;
import java.util.List;

/**
 * Resultat d'una operacio que pot fallar, SENSE llancar.
 *
 * Util quan vols acumular DIVERSOS errors en comptes d'avortar al primer:
 * validar un formulari, importar un fitxer, comprovar regles de negoci.
 */
public class Resultat {

    private final boolean exit;
    private final List<String> errors;

    private Resultat(boolean exit, List<String> errors) {
        this.exit = exit;
        this.errors = List.copyOf(errors);
    }

    public static Resultat ok() {
        return new Resultat(true, List.of());
    }

    public static Resultat ambErrors(List<String> errors) {
        return new Resultat(false, errors);
    }

    public boolean esExit()        { return exit; }
    public List<String> getErrors() { return errors; }

    public String descriure() {
        if (exit) { return "OK"; }
        return "Rebutjat (" + errors.size() + " problemes):\n  - "
                + String.join("\n  - ", errors);
    }

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

    /** Exemple: validar una alta acumulant TOTS els problemes. */
    public static Resultat validarAlta(String referencia, String titol, int any, String isbn) {
        List<String> errors = new ArrayList<>();

        if (referencia == null || !referencia.matches("LIB-\\d{4}")) {
            errors.add("La referencia ha de tenir el format LIB-NNNN, i era: " + referencia);
        }
        if (titol == null || titol.isBlank()) {
            errors.add("El titol no pot estar buit");
        }
        if (any < 1450 || any > 2100) {
            errors.add("L'any ha d'estar entre 1450 i 2100, i era: " + any);
        }
        if (isbn == null || !isbn.matches("97[89]-\\d{10}")) {
            errors.add("L'ISBN ha de tenir el format 978-NNNNNNNNNN, i era: " + isbn);
        }

        return errors.isEmpty() ? ok() : ambErrors(errors);
    }

    public static void main(String[] args) {
        System.out.println(validarAlta("LIB-0001", "Java Eficac", 2018, "978-0000000001")
                .descriure());
        System.out.println();
        System.out.println(validarAlta("L-1", "", 1200, "12345").descriure());
    }
}

OK

Rebutjat (4 problemes):
  - La referencia ha de tenir el format LIB-NNNN, i era: L-1
  - El titol no pot estar buit
  - L'any ha d'estar entre 1450 i 2100, i era: 1200
  - L'ISBN ha de tenir el format 978-NNNNNNNNNN, i era: 12345

// NO idempotent: dues crides, dos prestecs
gestor.prestar("LIB-0001", "EMP-001", 12);

// Idempotent: la segona crida no fa res
sessio.close();
cuaReserves.cancellar("LIB-0001", "EMP-001");   // si no n'hi havia, no passa res

public Prestec prestar(String idOperacio, String referencia, String idEmpleat, int dia) {
    // Si aquesta operacio ja s'ha processat, es retorna el resultat anterior
    Prestec jaFet = operacionsProcessades.get(idOperacio);
    if (jaFet != null) {
        LOG.info(() -> "Operacio " + idOperacio + " ja processada; es retorna el resultat previ");
        return jaFet;
    }
    // ... proces normal ...
}

// System.out.println
System.out.println("AVIS: referencia duplicada");

AVIS: referencia duplicada

// Logger
LOG.warning("Alta rebutjada: referencia LIB-0001 duplicada, ja la fa servir 'Java Eficac'");

2026-08-05 11:42:07.312 [main] WARNING com.nexussoftware.bibliotech.servei.Cataleg registrar
  Alta rebutjada: referencia LIB-0001 duplicada, ja la fa servir 'Java Eficac'

package com.nexussoftware.bibliotech.servei;

import java.util.logging.Logger;

public class Cataleg {

    /**
     * Un Logger per classe, estatic i final, anomenat amb el nom complet
     * de la classe. Es la convencio universal, i permet filtrar per paquet:
     * activar el nivell FINE per a com.nexussoftware.bibliotech.servei i deixar
     * la resta a INFO.
     */
    private static final Logger LOG = Logger.getLogger(Cataleg.class.getName());

    // ...
}

LOG.severe("Missatge greu");
LOG.warning("Avis");
LOG.info("Informacio");
LOG.config("Configuracio");
LOG.fine("Detall de depuracio");

// Forma general, amb el nivell explicit
LOG.log(Level.INFO, "Missatge");

// AMB EXCEPCIO: la forma correcta de registrar una fallada
LOG.log(Level.SEVERE, "Missatge descriptiu", excepcio);

// MALAMENT: la concatenacio es fa SEMPRE, encara que FINE estigui desactivat
LOG.fine("Cercant " + referencia + " en un cataleg de " + materials.size()
        + " materials, index amb " + index.size() + " entrades");

// BE: la lambda nomes s'avalua si el nivell FINE esta actiu
LOG.fine(() -> "Cercant " + referencia + " en un cataleg de " + materials.size()
        + " materials, index amb " + index.size() + " entrades");

if (LOG.isLoggable(Level.FINE)) {
    LOG.fine("Missatge car: " + calcularDiagnostic());
}

// Activar el detall NOMES a la capa de servei
Logger.getLogger("com.nexussoftware.bibliotech.servei").setLevel(Level.FINE);
// La resta continua a INFO

package com.nexussoftware.bibliotech.presentacio;

import java.io.IOException;
import java.util.logging.ConsoleHandler;
import java.util.logging.FileHandler;
import java.util.logging.Formatter;
import java.util.logging.Handler;
import java.util.logging.Level;
import java.util.logging.LogRecord;
import java.util.logging.Logger;

/**
 * Configuracio del sistema de registre de BiblioTech.
 *
 * Dues destinacions:
 *   - CONSOLA: nomes INFO i superiors, en format compacte d'una linia.
 *   - FITXER: tot des de FINE, amb rotacio, per a diagnostic posterior.
 */
public final class ConfiguracioLog {

    private static final String CAMI_LOG = "bibliotech-%g.log";   // %g = numero de rotacio
    private static final int MIDA_MAXIMA = 1_000_000;             // 1 MB per fitxer
    private static final int FITXERS_ROTACIO = 5;                 // 5 fitxers com a maxim

    private static boolean inicialitzat = false;

    private ConfiguracioLog() { }

    public static synchronized void inicialitzar() {
        if (inicialitzat) {
            return;                          // idempotent (06-06)
        }
        inicialitzat = true;

        Logger arrel = Logger.getLogger("");

        // 1. Treure els handlers per defecte: els substituim pels nostres
        for (Handler h : arrel.getHandlers()) {
            arrel.removeHandler(h);
        }

        // 2. El logger arrel accepta tot; cada handler filtra pel seu compte
        arrel.setLevel(Level.ALL);

        // 3. CONSOLA: nomes el que es important, format compacte
        ConsoleHandler consola = new ConsoleHandler();
        consola.setLevel(Level.INFO);
        consola.setFormatter(new FormatCompacte());
        arrel.addHandler(consola);

        // 4. FITXER: tot el detall, amb rotacio
        try {
            FileHandler fitxer = new FileHandler(CAMI_LOG, MIDA_MAXIMA, FITXERS_ROTACIO, true);
            fitxer.setLevel(Level.FINE);
            fitxer.setFormatter(new FormatDetallat());
            arrel.addHandler(fitxer);
        } catch (IOException e) {
            // Si no es pot crear el fitxer, l'aplicacio NO ha de caure:
            // es degrada a nomes consola i s'avisa. Degradacio elegant.
            arrel.log(Level.WARNING,
                    "No s'ha pogut crear el fitxer de log; nomes hi haura registre en consola", e);
        }

        // 5. Nivell especific per paquet
        Logger.getLogger("com.nexussoftware.bibliotech.servei").setLevel(Level.FINE);
        Logger.getLogger("com.nexussoftware.bibliotech.domini").setLevel(Level.INFO);

        Logger.getLogger(ConfiguracioLog.class.getName()).config("Sistema de registre inicialitzat");
    }

    /** Una linia per esdeveniment: nivell, classe curta i missatge. */
    private static class FormatCompacte extends Formatter {
        @Override
        public String format(LogRecord registre) {
            String classe = registre.getSourceClassName();
            String curta = (classe == null) ? "?" : classe.substring(classe.lastIndexOf('.') + 1);

            StringBuilder sb = new StringBuilder();
            sb.append(String.format("[%-7s] %-18s %s%n",
                    registre.getLevel().getName(), curta, formatMessage(registre)));

            if (registre.getThrown() != null) {
                sb.append("          causa: ").append(registre.getThrown()).append('\n');
            }
            return sb.toString();
        }
    }

    /** Format complet per al fitxer, amb marca de temps, fil i stack trace. */
    private static class FormatDetallat extends Formatter {
        @Override
        public String format(LogRecord registre) {
            StringBuilder sb = new StringBuilder();

            // Marca de temps. S'usa l'instant en millisegons i es formata
            // sense java.time, que es materia de 10-05.
            sb.append(String.format("%tF %<tT.%<tL", registre.getMillis()));
            sb.append(String.format(" [%-6d] %-7s ",
                    registre.getLongThreadID(), registre.getLevel().getName()));
            sb.append(registre.getSourceClassName()).append('.')
              .append(registre.getSourceMethodName()).append(" - ");
            sb.append(formatMessage(registre)).append('\n');

            // El stack trace complet, sagnat
            Throwable t = registre.getThrown();
            if (t != null) {
                sb.append("    ").append(t).append('\n');
                for (StackTraceElement marc : t.getStackTrace()) {
                    sb.append("        at ").append(marc).append('\n');
                }
                // Causes i suprimides (06-01, 06-06)
                Throwable causa = t.getCause();
                int nivell = 1;
                while (causa != null && nivell <= 5) {
                    sb.append("    Caused by: ").append(causa).append('\n');
                    causa = causa.getCause();
                    nivell++;
                }
                for (Throwable suprimida : t.getSuppressed()) {
                    sb.append("    Suppressed: ").append(suprimida).append('\n');
                }
            }
            return sb.toString();
        }
    }
}

# logging.properties de BiblioTech

# Handlers globals
handlers = java.util.logging.ConsoleHandler, java.util.logging.FileHandler

# Nivell del logger arrel: deixa passar tot, els handlers filtren
.level = ALL

# --- Consola: nomes INFO i superiors ---
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter

# --- Fitxer: tot des de FINE, amb rotacio ---
java.util.logging.FileHandler.pattern = bibliotech-%g.log
java.util.logging.FileHandler.limit = 1000000
java.util.logging.FileHandler.count = 5
java.util.logging.FileHandler.append = true
java.util.logging.FileHandler.level = FINE
java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter

# Format de SimpleFormatter: data, nivell, classe.metode, missatge, excepcio
java.util.logging.SimpleFormatter.format = %1$tF %1$tT.%1$tL %4$-7s [%2$s] %5$s%6$s%n

# --- Nivells per paquet ---
com.nexussoftware.bibliotech.level = INFO
com.nexussoftware.bibliotech.servei.level = FINE
com.nexussoftware.bibliotech.domini.level = INFO

java -Djava.util.logging.config.file=logging.properties \
     -cp . com.nexussoftware.bibliotech.presentacio.BiblioTechApp

try {
    gestor.prestar(referencia, idEmpleat, dia);

} catch (BiblioTechException e) {

    // ==================== CORRECTE ====================
    // El Throwable va com a TERCER argument: el Formatter imprimeix el stack
    // trace complet, amb les seves causes i suprimides, al mateix esdeveniment de log.
    LOG.log(Level.WARNING, "No s'ha pogut prestar " + referencia + " a " + idEmpleat, e);

    // ==================== INCORRECTE ====================

    // 1. printStackTrace: va a System.err, sense nivell, sense data, sense filtre
    e.printStackTrace();

    // 2. Nomes el missatge: perd el stack trace i totes les causes
    LOG.warning("Error: " + e.getMessage());

    // 3. Concatenar l'excepcio: dona nomes toString(), sense pila
    LOG.warning("Error: " + e);

    // 4. Registrar I rellancar: la mateixa fallada apareixera dues vegades
    LOG.log(Level.SEVERE, "Error", e);
    throw e;
}

// Avui: Empleat.toString() retorna "EMP-001 (Marta Ruiz)". Sembla inofensiu.
LOG.fine(() -> "Processant " + empleat);

// D'aqui a un any algu afegeix el DNI i el telefon al toString()...
// i de sobte estas registrant dades personals a tots els fitxers de log,
// sense que ningu hagi tocat aquesta linia.

LOG.fine(() -> "Processant empleat " + empleat.getIdentificador());

/** Deixa visibles els ultims 4 caracters: 978-0000000001 -> ***0001 */
private static String emmascarar(String valor) {
    if (valor == null || valor.length() <= 4) {
        return "****";
    }
    return "***" + valor.substring(valor.length() - 4);
}

LOG.info(() -> "[" + idOperacio + "] Prestec " + referenciaPrestec + " completat");

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Cataleg {

    private static final Logger LOG = LoggerFactory.getLogger(Cataleg.class);

    public void registrar(Material material) {
        // Sintaxi de marcadors {}: sense concatenacio i sense lambda.
        // El missatge nomes es compon si el nivell esta actiu.
        LOG.debug("Registrant {} en un cataleg de {} materials",
                  material.getReferencia(), materials.size());
        // ...
    }
}

package com.nexussoftware.bibliotech.servei;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Optional;
import java.util.logging.Level;
import java.util.logging.Logger;

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, versio final del modul 6.
 *
 * Canvis respecte a 06-04:
 *   - Zero System.out.println: tot el diagnostic va al Logger.
 *   - Els missatges de log porten identificadors, no noms de persones.
 *   - Els missatges cars usen Supplier per no construir-se si el nivell esta desactivat.
 */
public class Cataleg {

    private static final Logger LOG = Logger.getLogger(Cataleg.class.getName());

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

    private String propietariDelBloqueig = null;

    public void registrar(Material material) {
        Objects.requireNonNull(material, "El material a registrar no pot ser nul");
        String referencia = material.getReferencia();

        // FINE: detall de depuracio, desactivat en produccio.
        // Amb Supplier, la concatenacio no s'executa si FINE esta apagat.
        LOG.fine(() -> "Registrant " + referencia + " (cataleg actual: "
                + materials.size() + " materials)");

        Material existent = indexPerReferencia.get(referencia);
        if (existent != null) {
            // Es registra a nivell FINE i es LLANCA. No es registra a nivell superior
            // perque qui capturi decidira la seva gravetat: en una importacio massiva
            // un duplicat es rutina, en una alta manual es un avis.
            LOG.fine(() -> "Alta rebutjada: referencia " + referencia + " duplicada");
            throw new ReferenciaDuplicadaException(
                    ReferenciaDuplicadaException.Tipus.REFERENCIA, referencia,
                    existent.getTitol());
        }

        if (material instanceof Llibre llibre) {
            String titolExistent = titolsPerIsbn.get(llibre.getIsbn());
            if (titolExistent != null) {
                LOG.fine(() -> "Alta rebutjada: ISBN duplicat a " + referencia);
                throw new ReferenciaDuplicadaException(
                        ReferenciaDuplicadaException.Tipus.ISBN, llibre.getIsbn(), titolExistent);
            }
            titolsPerIsbn.put(llibre.getIsbn(), llibre.getTitol());
        }

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

        // INFO: fita de negoci. Es llegeix com la historia del que fa l'aplicacio.
        LOG.info(() -> "Material registrat: " + referencia
                + " (total " + materials.size() + ")");
    }

    public Material obtenirPerReferencia(String referencia) {
        Objects.requireNonNull(referencia, "La referencia no pot ser nulla");

        Material trobat = indexPerReferencia.get(referencia);
        if (trobat == null) {
            LOG.fine(() -> "Referencia no trobada: " + referencia);
            throw new MaterialNoTrobatException(referencia, materials.size());
        }
        return trobat;
    }

    public Optional<Material> cercarPerReferencia(String referencia) {
        if (referencia == null) { return Optional.empty(); }
        return Optional.ofNullable(indexPerReferencia.get(referencia));
    }

    public void bloquejar(String idPropietari) {
        if (propietariDelBloqueig != null && !propietariDelBloqueig.equals(idPropietari)) {
            LOG.warning(() -> "Bloqueig denegat a " + idPropietari
                    + ": el te " + propietariDelBloqueig);
            throw new IllegalStateException(
                    "El cataleg esta bloquejat per " + propietariDelBloqueig);
        }
        propietariDelBloqueig = idPropietari;
        LOG.fine(() -> "Bloqueig del cataleg adquirit per " + idPropietari);
    }

    public void desbloquejar(String idPropietari) {
        if (!Objects.equals(propietariDelBloqueig, idPropietari)) {
            // WARNING: passa alguna cosa rara, pero no impedeix continuar
            LOG.warning(() -> "Intent de desbloqueig per " + idPropietari
                    + " sense ser el propietari (" + propietariDelBloqueig + ")");
            return;
        }
        propietariDelBloqueig = null;
        LOG.fine(() -> "Bloqueig del cataleg alliberat per " + idPropietari);
    }

    public boolean estaBloquejat()     { return propietariDelBloqueig != null; }
    public boolean existeix(String r)  { return r != null && indexPerReferencia.containsKey(r); }
    public int mida()                  { return materials.size(); }
    public List<Material> llistar()    { return List.copyOf(materials); }
}

package com.nexussoftware.bibliotech.servei;

import java.util.HashMap;
import java.util.Map;
import java.util.Objects;
import java.util.logging.Level;
import java.util.logging.Logger;

import com.nexussoftware.bibliotech.domini.*;

/** Orquestra prestecs amb registre complet i estat coherent. */
public class GestorPrestecs {

    private static final Logger LOG = Logger.getLogger(GestorPrestecs.class.getName());

    private final Cataleg cataleg;
    private final Map<String, Empleat> empleats = new HashMap<>();
    private final Map<String, Prestec> prestecs = new HashMap<>();

    private int comptador = 0;

    public GestorPrestecs(Cataleg cataleg) {
        this.cataleg = Objects.requireNonNull(cataleg, "El cataleg no pot ser nul");
    }

    public void donarAlta(Empleat empleat) {
        Objects.requireNonNull(empleat, "L'empleat no pot ser nul");
        empleats.put(empleat.getIdentificador(), empleat);
        // Es registra l'IDENTIFICADOR, no el nom: el nom es una dada personal
        LOG.info(() -> "Empleat donat d'alta: " + empleat.getIdentificador());
    }

    public Prestec prestar(String idOperacio, String referencia, String idEmpleat, int dia) {
        Objects.requireNonNull(idOperacio, "L'identificador d'operacio no pot ser nul");
        Objects.requireNonNull(referencia, "La referencia no pot ser nulla");
        Objects.requireNonNull(idEmpleat, "L'identificador d'empleat no pot ser nul");
        if (dia < 1) {
            throw new IllegalArgumentException("El dia ha de ser 1 o posterior, i era: " + dia);
        }

        LOG.fine(() -> "[" + idOperacio + "] Iniciant prestec de " + referencia
                + " a " + idEmpleat + " el dia " + dia);

        // --- Fase 1: lectura i validacio (no modifica res) ---
        Material material = cataleg.obtenirPerReferencia(referencia);
        Empleat empleat = empleats.get(idEmpleat);
        if (empleat == null) {
            throw new MaterialNoTrobatException(idEmpleat, empleats.size());
        }
        if (!material.estaDisponible()) {
            throw new MaterialNoDisponibleException(referencia, material.getTitol(),
                    "un altre empleat", dia + Prestec.DIES_PRESTEC);
        }
        if (!empleat.potPrendrePrestat()) {
            throw new LimitPrestecsExceditException(idEmpleat, empleat.getNom(),
                    empleat.getPrestecsAcumulats(), Empleat.MAX_PRESTECS_SIMULTANIS);
        }

        // --- Fase 2: modificacio amb compensacio (06-05) ---
        boolean materialMarcat = false;
        boolean quotaConsumida = false;
        boolean completat = false;
        String referenciaPrestec = seguentReferencia();

        try {
            material.prestar();
            materialMarcat = true;

            empleat.registrarPrestec();
            quotaConsumida = true;

            Prestec prestec = new Prestec(referenciaPrestec, material, empleat, dia);
            prestecs.put(referenciaPrestec, prestec);
            completat = true;

            LOG.info(() -> "[" + idOperacio + "] Prestec " + referenciaPrestec
                    + " registrat: " + referencia + " -> " + idEmpleat + " (dia " + dia + ")");
            return prestec;

        } finally {
            if (!completat) {
                // WARNING, no SEVERE: la compensacio es el comportament previst
                LOG.warning(() -> "[" + idOperacio + "] Prestec incomplet de " + referencia
                        + "; compensant");
                try {
                    if (quotaConsumida)  { empleat.registrarDevolucio(); }
                    if (materialMarcat)  { material.retornar(); }
                    LOG.fine(() -> "[" + idOperacio + "] Estat restaurat");
                } catch (RuntimeException fallada) {
                    // SEVERE de debo: la compensacio ha fallat i l'estat pot
                    // haver quedat incoherent. Aixo SI que requereix intervencio.
                    LOG.log(Level.SEVERE, "[" + idOperacio
                            + "] LA COMPENSACIO HA FALLAT. Estat possiblement incoherent a "
                            + referencia, fallada);
                }
            }
        }
    }

    public void retornar(String idOperacio, String referenciaPrestec, int dia) {
        Prestec prestec = prestecs.get(referenciaPrestec);
        if (prestec == null) {
            throw new MaterialNoTrobatException(referenciaPrestec, prestecs.size());
        }
        if (prestec.estaRetornat()) {
            throw new PrestecJaRetornatException(referenciaPrestec, prestec.getDiaInici());
        }

        prestec.registrarDevolucio(dia);
        prestec.getTitular().registrarDevolucio();

        int retard = prestec.calcularDiesRetard(dia);
        if (retard > 0) {
            LOG.info(() -> "[" + idOperacio + "] Devolucio de " + referenciaPrestec
                    + " amb " + retard + " dies de retard");
        } else {
            LOG.info(() -> "[" + idOperacio + "] Devolucio de " + referenciaPrestec + " en termini");
        }
    }

    private String seguentReferencia() {
        comptador++;
        return String.format("PR-%04d", comptador);
    }

    public int prestecsRegistrats() { return prestecs.size(); }
}

package com.nexussoftware.bibliotech.presentacio;

import java.util.logging.Level;
import java.util.logging.Logger;

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

/**
 * Capa de presentacio: la UNICA que captura per a l'usuari, l'unica que
 * imprimeix per consola el que l'usuari ha demanat veure, i l'unica que decideix
 * quin missatge mostrar en cada cas.
 */
public class OperacionsConsola {

    private static final Logger LOG = Logger.getLogger(OperacionsConsola.class.getName());

    private final GestorPrestecs gestor;
    private int comptadorOperacions = 0;

    public OperacionsConsola(GestorPrestecs gestor) {
        this.gestor = gestor;
    }

    /**
     * Executa un prestec traduint cada fallada a un missatge comprensible.
     *
     * Aqui SI que es captura: es la frontera amb l'usuari i hi ha decisions a prendre.
     */
    public void prestar(String referencia, String idEmpleat, int dia) {
        String idOperacio = seguentIdOperacio();

        try {
            gestor.prestar(idOperacio, referencia, idEmpleat, dia);
            // SORTIDA del programa, no log: es el que l'usuari ha demanat veure
            System.out.println("Prestat " + referencia + " a " + idEmpleat
                    + ". Devolucio prevista: dia " + (dia + Prestec.DIES_PRESTEC));

        } catch (MaterialNoTrobatException e) {
            // Fallada esperada i corregible: missatge amable, log de baix nivell
            System.out.println("No existeix el material '" + e.getReferenciaCercada() + "'.");
            if (e.catalegBuit()) {
                System.out.println("El cataleg esta buit: carregueu primer els materials.");
            }
            LOG.fine(() -> "[" + idOperacio + "] Referencia inexistent: "
                    + e.getReferenciaCercada());

        } catch (MaterialNoDisponibleException e) {
            System.out.println("'" + e.getTitol() + "' esta prestat.");
            System.out.println("Disponible previsiblement en " + e.diesEspera(dia) + " dies.");
            System.out.println("El podeu reservar amb l'opcio 5.");
            LOG.fine(() -> "[" + idOperacio + "] Material no disponible: " + e.getReferencia());

        } catch (LimitPrestecsExceditException e) {
            System.out.printf("Heu assolit el limit de %d prestecs simultanis.%n",
                    e.getLimit());
            System.out.printf("Heu de retornar %d material(s) abans de prendre'n un altre.%n",
                    e.devolucionsNecessaries());
            LOG.fine(() -> "[" + idOperacio + "] Limit excedit per " + e.getIdEmpleat());

        } catch (BiblioTechException e) {
            // Xarxa de seguretat del domini: capturable gracies a l'arrel comuna (06-04)
            System.out.println("No s'ha pogut completar l'operacio: " + e.getMessage());
            LOG.log(Level.WARNING, "[" + idOperacio + "] Fallada de domini no prevista ["
                    + e.getCodi() + "]", e);

        } catch (RuntimeException e) {
            // BUG: l'usuari no veu els detalls, el registre els veu tots
            System.out.println("S'ha produit un error intern.");
            System.out.println("Incidencia: " + idOperacio);
            LOG.log(Level.SEVERE, "[" + idOperacio + "] Error no controlat en prestar "
                    + referencia + " a " + idEmpleat, e);
        }
    }

    private String seguentIdOperacio() {
        comptadorOperacions++;
        return String.format("OP-%05d", comptadorOperacions);
    }

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

    public static void main(String[] args) {
        ConfiguracioLog.inicialitzar();

        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"));

        OperacionsConsola consola = new OperacionsConsola(gestor);

        System.out.println("\n----- Operacions -----");
        consola.prestar("LIB-0001", "EMP-001", 10);
        consola.prestar("LIB-0001", "EMP-002", 11);    // no disponible
        consola.prestar("LIB-9999", "EMP-001", 11);    // no trobat
        consola.prestar("LIB-0002", "EMP-001", 11);
        consola.prestar("LIB-0003", "EMP-001", 11);
        consola.prestar("LIB-0002", "EMP-001", 12);    // no disponible (ja el te)
    }
}

[INFO   ] Cataleg            Material registrat: LIB-0001 (total 1)
[INFO   ] Cataleg            Material registrat: LIB-0002 (total 2)
[INFO   ] Cataleg            Material registrat: LIB-0003 (total 3)
[INFO   ] GestorPrestecs     Empleat donat d'alta: EMP-001
[INFO   ] GestorPrestecs     Empleat donat d'alta: EMP-002

----- Operacions -----
[INFO   ] GestorPrestecs     [OP-00001] Prestec PR-0001 registrat: LIB-0001 -> EMP-001 (dia 10)
Prestat LIB-0001 a EMP-001. Devolucio prevista: dia 25
'Java Eficac' esta prestat.
Disponible previsiblement en 14 dies.
El podeu reservar amb l'opcio 5.
No existeix el material 'LIB-9999'.
[INFO   ] GestorPrestecs     [OP-00004] Prestec PR-0002 registrat: LIB-0002 -> EMP-001 (dia 11)
Prestat LIB-0002 a EMP-001. Devolucio prevista: dia 26
[INFO   ] GestorPrestecs     [OP-00005] Prestec PR-0003 registrat: LIB-0003 -> EMP-001 (dia 11)
Prestat LIB-0003 a EMP-001. Devolucio prevista: dia 26
'Patrons de Disseny' esta prestat.
Disponible previsiblement en 14 dies.
El podeu reservar amb l'opcio 5.

2026-08-05 11:42:07.104 [1     ] CONFIG  ...ConfiguracioLog.inicialitzar - Sistema de registre inicialitzat
2026-08-05 11:42:07.118 [1     ] FINE    ...Cataleg.registrar - Registrant LIB-0001 (cataleg actual: 0 materials)
2026-08-05 11:42:07.119 [1     ] INFO    ...Cataleg.registrar - Material registrat: LIB-0001 (total 1)
...
2026-08-05 11:42:07.201 [1     ] FINE    ...GestorPrestecs.prestar - [OP-00002] Iniciant prestec de LIB-0001 a EMP-002 el dia 11
2026-08-05 11:42:07.202 [1     ] FINE    ...OperacionsConsola.prestar - [OP-00002] Material no disponible: LIB-0001
2026-08-05 11:42:07.205 [1     ] FINE    ...Cataleg.obtenirPerReferencia - Referencia no trobada: LIB-9999
2026-08-05 11:42:07.206 [1     ] FINE    ...OperacionsConsola.prestar - [OP-00003] Referencia inexistent: LIB-9999

public class MenuBiblioTech {

    public void arrencar() {
        while (true) {
            try {
                System.out.print("Opcio: ");
                int opcio = Integer.parseInt(new Scanner(System.in).nextLine());
                switch (opcio) {
                    case 1: prestar(); break;
                    case 2: retornar(); break;
                    case 0: System.exit(0);
                }
            } catch (Throwable t) {
                t.printStackTrace();
            }
        }
    }

    private void prestar() throws Exception {
        Scanner sc = new Scanner(System.in);
        System.out.print("Referencia: ");
        String ref = sc.nextLine();
        System.out.print("Empleat: ");
        String emp = sc.nextLine();

        try {
            gestor.prestar(ref, emp, 1);
        } catch (Exception e) {
            System.out.println("Error: " + e.getMessage());
            System.out.println(e.getStackTrace()[0]);
            throw e;
        } finally {
            sc.close();
        }
    }

    private void retornar() {
        try {
            gestor.retornar(llegirReferencia(), 1);
        } catch (Exception e) {
        }
        System.out.println("Devolucio processada");
    }
}

package com.nexussoftware.bibliotech.servei;

import java.io.IOException;
import java.util.NoSuchElementException;
import java.util.logging.Level;

import com.nexussoftware.bibliotech.domini.BiblioTechException;

/**
 * Classifica un Throwable i recomana com tractar-lo.
 * Materialitza la taula de decisions d'aquesta llico.
 */
public final class PoliticaErrors {

    /** Recomanacio completa per a una fallada concreta (record, 04-07). */
    public record Recomanacio(Level nivell, boolean missatgeAptePerUsuari,
                              boolean requereixIncidencia, String accio) {

        @Override
        public String toString() {
            return String.format("nivell=%-7s | usuari=%-5s | incidencia=%-5s | %s",
                    nivell.getName(), missatgeAptePerUsuari, requereixIncidencia, accio);
        }
    }

    private PoliticaErrors() { }

    public static Recomanacio decidir(Throwable t) {
        if (t == null) {
            return new Recomanacio(Level.INFO, false, false, "Res a fer");
        }

        // 1. Error de la JVM: irrecuperable
        if (t instanceof Error) {
            return new Recomanacio(Level.SEVERE, false, true,
                    "Registrar (protegit) i acabar de manera ordenada. NO continuar.");
        }

        // 2. Excepcio del domini: fallada esperada, missatge ja escrit per a l'usuari
        if (t instanceof BiblioTechException bte) {
            if (bte.esCorregiblePerUsuari()) {
                return new Recomanacio(Level.FINE, true, false,
                        "Mostrar el missatge tal qual i permetre reintentar.");
            }
            return new Recomanacio(Level.WARNING, true, false,
                    "Mostrar el missatge i indicar que no depen de l'usuari.");
        }

        // 3. Fallades d'E/S: condicio de l'entorn
        if (t instanceof IOException) {
            return new Recomanacio(Level.SEVERE, false, true,
                    "Degradar si hi ha alternativa; si no, avortar l'operacio. Avisar operacions.");
        }

        // 4. Validacions tecniques frequents a la frontera amb l'usuari
        if (t instanceof NumberFormatException) {
            return new Recomanacio(Level.FINE, true, false,
                    "Demanar la dada de nou indicant el format esperat.");
        }
        if (t instanceof NoSuchElementException) {
            return new Recomanacio(Level.FINE, true, false,
                    "Informar que no s'ha trobat i oferir alternatives.");
        }

        // 5. Fallades de programacio: l'usuari no ha de veure detalls
        if (t instanceof NullPointerException
                || t instanceof IndexOutOfBoundsException
                || t instanceof ClassCastException) {
            return new Recomanacio(Level.SEVERE, false, true,
                    "BUG: missatge generic amb incidencia, stack trace complet al registre.");
        }

        // 6. Resta de no comprovades: probablement tambe un bug
        if (t instanceof RuntimeException) {
            return new Recomanacio(Level.SEVERE, false, true,
                    "Tractar com a bug fins que es demostri el contrari.");
        }

        // 7. Comprovades no contemplades
        return new Recomanacio(Level.WARNING, false, true,
                "Condicio externa: registrar amb detall i decidir a la capa superior.");
    }

    public static void main(String[] args) {
        Throwable[] casos = {
                new NumberFormatException("For input string: \"dotze\""),
                new IllegalArgumentException("L'any ha d'estar entre 1450 i 2100, i era: 1200"),
                new IOException("cataleg.txt (No such file or directory)"),
                new NullPointerException("Cannot invoke \"Empleat.getNom()\""),
                new OutOfMemoryError("Java heap space"),
                new NoSuchElementException("No line found")
        };

        System.out.printf("%-32s %s%n", "EXCEPCIO", "RECOMANACIO");
        System.out.println("-".repeat(120));
        for (Throwable t : casos) {
            System.out.printf("%-32s %s%n", t.getClass().getSimpleName(), decidir(t));
        }
    }
}

EXCEPCIO                         RECOMANACIO
------------------------------------------------------------------------------------------------------------------------
NumberFormatException            nivell=FINE    | usuari=true  | incidencia=false | Demanar la dada de nou indicant el format esperat.
IllegalArgumentException         nivell=SEVERE  | usuari=false | incidencia=true  | Tractar com a bug fins que es demostri el contrari.
IOException                      nivell=SEVERE  | usuari=false | incidencia=true  | Degradar si hi ha alternativa; si no, avortar l'operacio. Avisar operacions.
NullPointerException             nivell=SEVERE  | usuari=false | incidencia=true  | BUG: missatge generic amb incidencia, stack trace complet al registre.
OutOfMemoryError                 nivell=SEVERE  | usuari=false | incidencia=true  | Registrar (protegit) i acabar de manera ordenada. NO continuar.
NoSuchElementException           nivell=FINE    | usuari=true  | incidencia=false | Informar que no s'ha trobat i oferir alternatives.

package com.nexussoftware.bibliotech.servei;

import java.util.HashMap;
import java.util.Map;
import java.util.function.Supplier;
import java.util.logging.Level;
import java.util.logging.Logger;

import com.nexussoftware.bibliotech.domini.BiblioTechException;

/**
 * Embolcalla operacions de BiblioTech aportant registre, mesurament i
 * politica uniforme d'errors.
 *
 * Es un exemple del patro "decorador de serveis" que al modul 11
 * fan els frameworks amb aspectes i anotacions.
 */
public class RegistreOperacions {

    private static final Logger LOG = Logger.getLogger(RegistreOperacions.class.getName());

    /** Estadistiques acumulades d'una operacio (mutable a proposit). */
    private static class Estadistica {
        int execucions;
        int exits;
        int fallades;
        long nanosTotals;

        double mitjanaMs() {
            return (execucions == 0) ? 0.0 : (nanosTotals / 1_000_000.0) / execucions;
        }
    }

    private final Map<String, Estadistica> estadistiques = new HashMap<>();
    private int comptador = 0;

    /**
     * Executa una operacio registrant inici, final, durada i fallades.
     *
     * @param nomOperacio nom logic (PRESTAR, RETORNAR, IMPORTAR...)
     * @param idEmpleat   IDENTIFICADOR de l'empleat, mai el seu nom
     * @param operacio    l'operacio a executar
     */
    public <T> T executar(String nomOperacio, String idEmpleat, Supplier<T> operacio) {
        String idOperacio = seguentId();
        long inici = System.nanoTime();
        boolean exit = false;

        // Forma mandrosa: si FINE esta desactivat, la cadena no es construeix
        LOG.fine(() -> "[" + idOperacio + "] INICI " + nomOperacio
                + " (empleat " + idEmpleat + ")");

        try {
            T resultat = operacio.get();
            exit = true;
            return resultat;

        } catch (BiblioTechException e) {
            // Fallada ESPERADA del domini: WARNING amb l'excepcio com a
            // tercer argument, i es RELLANCA perque decideixi qui cridi.
            LOG.log(Level.WARNING, "[" + idOperacio + "] " + nomOperacio
                    + " rebutjada [" + e.getCodi() + "]", e);
            throw e;

        } catch (RuntimeException e) {
            // Fallada INESPERADA: es un bug. SEVERE amb l'identificador com a
            // incidencia, i s'EMBOLCALLA conservant la causa (06-03).
            LOG.log(Level.SEVERE, "[" + idOperacio + "] Error no controlat a "
                    + nomOperacio, e);
            throw new IllegalStateException(
                    "Error intern a " + nomOperacio + ". Incidencia: " + idOperacio, e);

        } finally {
            // La durada es registra SEMPRE, amb exit i amb fallada (06-05)
            long duracio = System.nanoTime() - inici;
            acumular(nomOperacio, exit, duracio);

            final boolean hiHaHagutExit = exit;
            final double ms = duracio / 1_000_000.0;

            if (hiHaHagutExit) {
                LOG.info(() -> String.format("[%s] FI %s OK (%.2f ms)",
                        idOperacio, nomOperacio, ms));
            } else {
                LOG.fine(() -> String.format("[%s] FI %s FALLIDA (%.2f ms)",
                        idOperacio, nomOperacio, ms));
            }
        }
    }

    /** Variant sense resultat. */
    public void executarSenseResultat(String nomOperacio, String idEmpleat, Runnable operacio) {
        executar(nomOperacio, idEmpleat, () -> {
            operacio.run();
            return null;
        });
    }

    private synchronized void acumular(String nom, boolean exit, long nanos) {
        Estadistica e = estadistiques.computeIfAbsent(nom, n -> new Estadistica());
        e.execucions++;
        e.nanosTotals += nanos;
        if (exit) { e.exits++; } else { e.fallades++; }
    }

    private synchronized String seguentId() {
        comptador++;
        return String.format("OP-%05d", comptador);
    }

    public void bolcarEstadistiques() {
        System.out.println();
        System.out.printf("%-14s %-12s %-9s %-9s %s%n",
                "OPERACIO", "EXECUCIONS", "EXITS", "FALLADES", "MITJANA (ms)");
        System.out.println("-".repeat(62));

        estadistiques.forEach((nom, e) ->
                System.out.printf("%-14s %-12d %-9d %-9d %.2f%n",
                        nom, e.execucions, e.exits, e.fallades, e.mitjanaMs()));
    }

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

    public static void main(String[] args) {
        com.nexussoftware.bibliotech.presentacio.ConfiguracioLog.inicialitzar();

        Cataleg cataleg = new Cataleg();
        cataleg.registrar(new com.nexussoftware.bibliotech.domini.Llibre(
                "LIB-0001", "Java Eficac", "Bloch", 2018, "978-0000000001"));
        cataleg.registrar(new com.nexussoftware.bibliotech.domini.Llibre(
                "LIB-0002", "Patrons de Disseny", "GoF", 1994, "978-0000000002"));

        RegistreOperacions registre = new RegistreOperacions();

        System.out.println("\n----- Operacions -----");

        // 1 i 2: correctes
        registre.executar("CONSULTAR", "EMP-001",
                () -> cataleg.obtenirPerReferencia("LIB-0001").getTitol());
        registre.executar("CONSULTAR", "EMP-002",
                () -> cataleg.obtenirPerReferencia("LIB-0002").getTitol());

        // 3: fallada de domini esperada, es rellanca tal qual
        try {
            registre.executar("CONSULTAR", "EMP-001",
                    () -> cataleg.obtenirPerReferencia("LIB-9999").getTitol());
        } catch (BiblioTechException e) {
            System.out.println("Rebutjada: " + e.getMessage());
        }

        // 4: alta correcta
        registre.executarSenseResultat("ALTA", "EMP-003", () ->
                cataleg.registrar(new com.nexussoftware.bibliotech.domini.Llibre(
                        "LIB-0003", "Refactoritzacio", "Fowler", 1999, "978-0000000003")));

        // 5: alta duplicada, fallada de domini
        try {
            registre.executarSenseResultat("ALTA", "EMP-003", () ->
                    cataleg.registrar(new com.nexussoftware.bibliotech.domini.Llibre(
                            "LIB-0001", "Copia", "X", 2020, "978-0000000009")));
        } catch (BiblioTechException e) {
            System.out.println("Rebutjada: " + e.getMessage());
        }

        // 6: BUG simulat, s'embolcalla amb incidencia
        try {
            registre.executar("INFORME", "EMP-001", () -> {
                String nul = null;
                return nul.length();           // NullPointerException
            });
        } catch (IllegalStateException e) {
            System.out.println("Error intern: " + e.getMessage());
            System.out.println("  causa registrada: " + e.getCause().getClass().getSimpleName());
        }

        registre.bolcarEstadistiques();
    }
}

----- Operacions -----
[INFO   ] RegistreOperacions [OP-00001] FI CONSULTAR OK (0,08 ms)
[INFO   ] RegistreOperacions [OP-00002] FI CONSULTAR OK (0,01 ms)
[WARNING] RegistreOperacions [OP-00003] CONSULTAR rebutjada [MATERIALNOTROBAT]
          causa: com.nexussoftware.bibliotech.domini.MaterialNoTrobatException: No existeix...
Rebutjada: No existeix cap material amb la referencia 'LIB-9999' (el cataleg te 2 materials)
[INFO   ] Cataleg            Material registrat: LIB-0003 (total 3)
[INFO   ] RegistreOperacions [OP-00004] FI ALTA OK (0,15 ms)
[WARNING] RegistreOperacions [OP-00005] ALTA rebutjada [REFERENCIADUPLICADA]
Rebutjada: Ja existeix un material amb la referencia LIB-0001: 'Java Eficac'
[SEVERE ] RegistreOperacions [OP-00006] Error no controlat a INFORME
Error intern: Error intern a INFORME. Incidencia: OP-00006
  causa registrada: NullPointerException

OPERACIO       EXECUCIONS   EXITS     FALLADES  MITJANA (ms)
--------------------------------------------------------------
CONSULTAR      3            2         1         0.04
ALTA           2            1         1         0.09
INFORME        1            0         1         0.05

package com.nexussoftware.bibliotech.presentacio;

import java.util.NoSuchElementException;
import java.util.Scanner;
import java.util.logging.Level;
import java.util.logging.Logger;

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

/**
 * Menu principal de BiblioTech, versio final del modul 6.
 *
 * Politica d'errors:
 *   - Un unic Scanner d'instancia sobre System.in, que MAI no es tanca.
 *   - Es captura per TIPUS, del mes especific al mes general.
 *   - Les fallades de domini produeixen missatges per a l'usuari i log FINE.
 *   - Els bugs produeixen un missatge generic amb incidencia i log SEVERE.
 *   - No es captura Throwable: els Error pugen a la frontera del main.
 *   - Zero System.out.println de diagnostic.
 */
public class MenuBiblioTech {

    private static final Logger LOG = Logger.getLogger(MenuBiblioTech.class.getName());

    private static final int DIES_PRESTEC = 15;

    /** UN SOL Scanner, creat una vegada i mai tancat (06-06). */
    private final Scanner scanner = new Scanner(System.in);

    private final GestorPrestecs gestor;
    private int comptadorOperacions = 0;
    private boolean sortir = false;

    public MenuBiblioTech(GestorPrestecs gestor) {
        this.gestor = gestor;
    }

    public void arrencar() {
        LOG.info("Menu de BiblioTech iniciat");

        while (!sortir) {
            mostrarMenu();
            int opcio = llegirOpcio(0, 3);

            // Cada opcio gestiona ELS SEUS PROPIS errors: aqui no hi ha xarxa que
            // capturi de tot, perque una xarxa aixi amagaria bugs.
            switch (opcio) {
                case 1 -> prestar();
                case 2 -> retornar();
                case 3 -> llistar();
                case 0 -> sortir();
                default -> System.out.println("Opcio no reconeguda: " + opcio);
            }
        }
        LOG.info("Menu de BiblioTech finalitzat");
    }

    private void mostrarMenu() {
        System.out.println("""

                ===== BiblioTech - Nexus Software =====
                1. Prestar material
                2. Retornar material
                3. Llistar cataleg
                0. Sortir
                =======================================""");
    }

    /** Reintent indefinit: hi ha una persona davant que pot corregir (06-02). */
    private int llegirOpcio(int min, int max) {
        while (true) {
            System.out.print("Opcio: ");
            String linia = scanner.nextLine().trim();
            try {
                int valor = Integer.parseInt(linia);
                if (valor < min || valor > max) {
                    System.out.printf("Ha d'estar entre %d i %d.%n", min, max);
                    continue;
                }
                return valor;
            } catch (NumberFormatException e) {
                System.out.println("'" + linia + "' no es un numero. Escriviu un digit de "
                        + min + " a " + max + ".");
                LOG.fine(() -> "Entrada no numerica al menu: '" + linia + "'");
            }
        }
    }

    private void prestar() {
        String idOperacio = seguentIdOperacio();

        System.out.print("Referencia del material: ");
        String referencia = scanner.nextLine().trim();
        System.out.print("Identificador de l'empleat: ");
        String idEmpleat = scanner.nextLine().trim();
        int dia = llegirEnterAmbLimit("Dia del prestec (1-365)", 1, 365);
        if (dia == -1) {
            System.out.println("Operacio cancellada.");
            return;
        }

        try {
            gestor.prestar(idOperacio, referencia, idEmpleat, dia);
            // SORTIDA del programa (el que l'usuari ha demanat veure), no log
            System.out.println("Prestat " + referencia + ". Devolucio prevista: dia "
                    + (dia + DIES_PRESTEC));

        } catch (MaterialNoTrobatException e) {
            System.out.println("No existeix el material '" + e.getReferenciaCercada() + "'.");
            LOG.fine(() -> "[" + idOperacio + "] Referencia inexistent: "
                    + e.getReferenciaCercada());

        } catch (MaterialNoDisponibleException e) {
            System.out.println("'" + e.getTitol() + "' esta prestat.");
            System.out.println("Disponible d'aqui a uns " + e.diesEspera(dia) + " dies.");
            LOG.fine(() -> "[" + idOperacio + "] Material no disponible: " + e.getReferencia());

        } catch (LimitPrestecsExceditException e) {
            System.out.printf("Limit de %d prestecs assolit. Retorneu %d material(s).%n",
                    e.getLimit(), e.devolucionsNecessaries());
            LOG.fine(() -> "[" + idOperacio + "] Limit excedit per " + e.getIdEmpleat());

        } catch (BiblioTechException e) {
            System.out.println("No s'ha pogut completar el prestec: " + e.getMessage());
            LOG.log(Level.WARNING, "[" + idOperacio + "] Fallada de domini no prevista ["
                    + e.getCodi() + "]", e);

        } catch (RuntimeException e) {
            // BUG. L'usuari veu una incidencia; el registre, tot el detall.
            System.out.println("Error intern. Incidencia: " + idOperacio);
            LOG.log(Level.SEVERE, "[" + idOperacio + "] Error no controlat en prestar "
                    + referencia + " a " + idEmpleat, e);
        }
        // NO es captura Throwable: un Error ha de pujar a la frontera del main.
    }

    private void retornar() {
        String idOperacio = seguentIdOperacio();

        System.out.print("Referencia del prestec (PR-NNNN): ");
        String referenciaPrestec = scanner.nextLine().trim();
        int dia = llegirEnterAmbLimit("Dia de la devolucio (1-365)", 1, 365);
        if (dia == -1) {
            System.out.println("Operacio cancellada.");
            return;
        }

        try {
            gestor.retornar(idOperacio, referenciaPrestec, dia);
            // DINS del try: nomes s'afirma l'exit si de debo n'hi ha hagut
            System.out.println("Devolucio de " + referenciaPrestec + " processada.");

        } catch (PrestecJaRetornatException e) {
            System.out.println("Aquell prestec ja es va retornar el dia "
                    + e.getDiaDevolucioOriginal() + ".");
            LOG.fine(() -> "[" + idOperacio + "] Devolucio duplicada de "
                    + e.getReferenciaPrestec());

        } catch (MaterialNoTrobatException e) {
            System.out.println("No existeix el prestec '" + e.getReferenciaCercada() + "'.");
            LOG.fine(() -> "[" + idOperacio + "] Prestec inexistent: "
                    + e.getReferenciaCercada());

        } catch (BiblioTechException e) {
            System.out.println("No s'ha pogut completar la devolucio: " + e.getMessage());
            LOG.log(Level.WARNING, "[" + idOperacio + "] Fallada de domini a la devolucio", e);

        } catch (RuntimeException e) {
            System.out.println("Error intern. Incidencia: " + idOperacio);
            LOG.log(Level.SEVERE, "[" + idOperacio + "] Error no controlat en retornar "
                    + referenciaPrestec, e);
        }
    }

    private void llistar() {
        System.out.println("(llistat del cataleg)");
    }

    /**
     * Sortida ORDENADA: es marca el marcador i el bucle acaba sol.
     * Res de System.exit aqui: aixo saltaria els finally i la neteja (06-05).
     */
    private void sortir() {
        sortir = true;
        System.out.println("Fins aviat.");
    }

    private int llegirEnterAmbLimit(String peticio, int min, int max) {
        for (int intent = 1; intent <= 3; intent++) {
            System.out.print(peticio + ": ");
            String linia;
            try {
                linia = scanner.nextLine().trim();
            } catch (NoSuchElementException e) {
                // Passa si System.in es tanca o arriba al final (entrada redirigida)
                LOG.log(Level.WARNING, "Entrada estandard esgotada; es cancella l'operacio", e);
                return -1;
            }
            try {
                int valor = Integer.parseInt(linia);
                if (valor < min || valor > max) {
                    System.out.printf("Fora de rang [%d..%d]. Intent %d de 3.%n",
                            min, max, intent);
                    continue;
                }
                return valor;
            } catch (NumberFormatException e) {
                System.out.printf("'%s' no es un numero. Intent %d de 3.%n", linia, intent);
            }
        }
        return -1;
    }

    private String seguentIdOperacio() {
        comptadorOperacions++;
        return String.format("OP-%05d", comptadorOperacions);
    }
}