try {
    // Codi PROTEGIT: pot llancar excepcions
} catch (TipusDExcepcio e) {
    // GESTOR: s'executa nomes si el try ha llancat una excepcio
    // compatible amb TipusDExcepcio
}

package com.nexussoftware.bibliotech.presentacio;

public class PrimerTryCatch {

    public static void main(String[] args) {
        String entrada = "dotze";                      // el que va escriure l'usuari

        System.out.println("1. Abans del try");

        try {
            System.out.println("2. Dins del try, abans de convertir");
            int dies = Integer.parseInt(entrada);      // (*) llanca NumberFormatException
            System.out.println("3. Dies convertits: " + dies);    // NO s'executa
        } catch (NumberFormatException e) {
            System.out.println("4. Capturada: " + e.getMessage());
        }

        System.out.println("5. Despres del try-catch: el programa SEGUEIX VIU");
    }
}

1. Abans del try
2. Dins del try, abans de convertir
4. Capturada: For input string: "dotze"
5. Despres del try-catch: el programa SEGUEIX VIU

try {
    Integer.parseInt("dotze");                  // llanca NumberFormatException
} catch (ArithmeticException e) {               // tipus INCOMPATIBLE
    System.out.println("Mai no arriba aqui");
}
// La NumberFormatException es propaga igualment: el programa mor

package com.nexussoftware.bibliotech.presentacio;

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

public class QueEsSalta {

    public static void main(String[] args) {
        List<String> registrades = new ArrayList<>();
        String[] entrades = { "15", "20", "dotze", "30" };

        try {
            for (String entrada : entrades) {
                int dies = Integer.parseInt(entrada);
                registrades.add(entrada + " -> " + dies + " dies");
                System.out.println("Processada: " + entrada);
            }
            System.out.println("TOTES processades");            // no s'executa
        } catch (NumberFormatException e) {
            System.out.println("Fallada a: " + e.getMessage());
        }

        System.out.println("Registrades: " + registrades);
    }
}

Processada: 15
Processada: 20
Fallada a: For input string: "dotze"
Registrades: [15 -> 15 dies, 20 -> 20 dies]

for (String entrada : entrades) {
    try {
        int dies = Integer.parseInt(entrada);
        registrades.add(entrada + " -> " + dies + " dies");
    } catch (NumberFormatException e) {
        System.out.println("  Descartada entrada invalida: " + entrada);
        // continue implicit: la seguent iteracio segueix normalment
    }
}
// Resultat: [15 -> 15 dies, 20 -> 20 dies, 30 -> 30 dies]

package com.nexussoftware.bibliotech.presentacio;

public class AnatomiaDelCatch {

    public static void main(String[] args) {
        try {
            calcularMultaEmpleat("EMP-004", "quinze");
        } catch (NumberFormatException e) {

            System.out.println("getMessage()        : " + e.getMessage());
            System.out.println("toString()          : " + e);
            System.out.println("getClass().getName(): " + e.getClass().getName());
            System.out.println("getClass().getSimpleName(): " + e.getClass().getSimpleName());
            System.out.println("getCause()          : " + e.getCause());
            System.out.println("getSuppressed().length: " + e.getSuppressed().length);

            System.out.println("\n-- Marcs de la pila (getStackTrace) --");
            StackTraceElement[] marcs = e.getStackTrace();
            for (int i = 0; i < Math.min(4, marcs.length); i++) {
                StackTraceElement m = marcs[i];
                System.out.printf("  [%d] %s.%s (%s:%d)%n",
                        i, m.getClassName(), m.getMethodName(),
                        m.getFileName(), m.getLineNumber());
            }

            // Localitzar el nostre propi codi dins del trace
            for (StackTraceElement m : marcs) {
                if (m.getClassName().startsWith("com.nexussoftware")) {
                    System.out.println("\nPrimer marc propi: "
                            + m.getMethodName() + " a la linia " + m.getLineNumber());
                    break;
                }
            }
        }
    }

    static void calcularMultaEmpleat(String idEmpleat, String diesText) {
        int dies = Integer.parseInt(diesText);
        System.out.println("Multa: " + (dies * 0.25));
    }
}

getMessage()        : For input string: "quinze"
toString()          : java.lang.NumberFormatException: For input string: "quinze"
getClass().getName(): java.lang.NumberFormatException
getClass().getSimpleName(): NumberFormatException
getCause()          : null
getSuppressed().length: 0

-- Marcs de la pila (getStackTrace) --
  [0] java.lang.NumberFormatException.forInputString (NumberFormatException.java:67)
  [1] java.lang.Integer.parseInt (Integer.java:665)
  [2] java.lang.Integer.parseInt (Integer.java:781)
  [3] com.nexussoftware.bibliotech.presentacio.AnatomiaDelCatch.calcularMultaEmpleat (AnatomiaDelCatch.java:38)

Primer marc propi: calcularMultaEmpleat a la linia 38

String detall = (e.getMessage() != null) ? e.getMessage() : e.getClass().getSimpleName();

package com.nexussoftware.bibliotech.presentacio;

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

public class DiversosCatch {

    public static void main(String[] args) {
        processar(args.length > 0 ? args[0] : "1");
    }

    static void processar(String cas) {
        List<String> cataleg = new ArrayList<>(List.of("Java Eficac", "Patrons de Disseny"));

        try {
            switch (cas) {
                case "1" -> System.out.println(Integer.parseInt("dotze"));  // NumberFormat
                case "2" -> System.out.println(cataleg.get(9));             // IndexOutOfBounds
                case "3" -> System.out.println(30 / 0);                     // Arithmetic
                default  -> System.out.println(((String) null).length());   // NullPointer
            }
        } catch (NumberFormatException e) {
            System.out.println("Entrada no numerica: " + e.getMessage());
        } catch (IndexOutOfBoundsException e) {
            System.out.println("Index fora de rang: " + e.getMessage());
        } catch (ArithmeticException e) {
            System.out.println("Error aritmetic: " + e.getMessage());
        } catch (RuntimeException e) {
            // Xarxa de seguretat per a la resta de no comprovades
            System.out.println("Una altra fallada en execucio: " + e);
        }
    }
}

try {
    Integer.parseInt("dotze");
} catch (RuntimeException e) {              // MES GENERAL primer
    System.out.println("General");
} catch (NumberFormatException e) {         // error de compilacio
    System.out.println("Especific");
}

error: exception NumberFormatException has already been caught
    } catch (NumberFormatException e) {
      ^

catch (IllegalArgumentException e) { ... }
catch (NumberFormatException e)    { ... }   // ja capturada per l'anterior

try {
    int dies = Integer.parseInt(entrada);
    Material m = materials.get(dies);
    processar(m);
} catch (NumberFormatException | IndexOutOfBoundsException e) {
    System.out.println("Entrada invalida (" + e.getClass().getSimpleName() + "): " + e.getMessage());
}

// NO COMPILA
catch (NumberFormatException | IllegalArgumentException e) { ... }
// error: Alternatives in a multi-catch statement cannot be related by subclassing
//        Alternative NumberFormatException is a subclass of IllegalArgumentException

try {
    // ...
} catch (NumberFormatException | ArithmeticException e) {
    e = new RuntimeException("una altra cosa");   // NO COMPILA
    // error: multi-catch parameter e may not be assigned
}

} catch (NumberFormatException | java.io.IOException e) {
    // Aqui el tipus comu es Exception: nomes metodes de Throwable
    System.out.println(e.getMessage());

    // Si necessites alguna cosa especifica:
    if (e instanceof java.io.IOException io) {
        System.out.println("Fallada d'E/S, es reintentara mes tard");
    }
}

package com.nexussoftware.bibliotech.presentacio;

public class TryImbricats {

    public static void main(String[] args) {
        String[] linies = { "LIB-0001;15", "LIB-0002;dotze", "LIB-0003" };

        try {
            System.out.println("== Importacio del cataleg ==");

            for (String linia : linies) {
                String[] parts = linia.split(";");
                String referencia = parts[0];

                // TRY INTERN: un dia invalid no ha d'avortar la importacio
                int dies;
                try {
                    dies = Integer.parseInt(parts[1]);
                } catch (NumberFormatException e) {
                    System.out.println("  " + referencia + ": dies invalids, s'usa 15 per defecte");
                    dies = 15;
                }

                System.out.println("  " + referencia + " -> " + dies + " dies");
            }

            System.out.println("Importacio acabada");
        } catch (ArrayIndexOutOfBoundsException e) {
            // TRY EXTERN: una linia sense ';' SI que avorta la importacio (format corrupte)
            System.out.println("FITXER CORRUPTE: falta un camp. " + e.getMessage());
        }
    }
}

== Importacio del cataleg ==
  LIB-0001 -> 15 dies
  LIB-0002: dies invalids, s'usa 15 per defecte
  LIB-0002 -> 15 dies
FITXER CORRUPTE: falta un camp. Index 1 out of bounds for length 1

try {
    int dies = Integer.parseInt(entrada);       // declarada DINS del try
} catch (NumberFormatException e) {
    System.out.println("Fallada");
}
System.out.println(dies);   // NO COMPILA: cannot find symbol

int dies;                                        // declarada fora
try {
    dies = Integer.parseInt(entrada);            // assignada dins
} catch (NumberFormatException e) {
    dies = DIES_PRESTEC;                         // valor per defecte al catch
}
System.out.println("Dies: " + dies);             // compila i funciona

int dies;
try {
    dies = Integer.parseInt(entrada);
} catch (NumberFormatException e) {
    System.out.println("Fallada");               // el catch NO assigna dies
}
System.out.println(dies);   // error: variable dies might not have been initialized

// A) Inicialitzar a la declaracio
int dies = DIES_PRESTEC;
try { dies = Integer.parseInt(entrada); } catch (NumberFormatException e) { /* es queda el default */ }

// B) Assignar tambe al catch
int dies;
try { dies = Integer.parseInt(entrada); } catch (NumberFormatException e) { dies = DIES_PRESTEC; }

// C) Sortir del metode al catch (return o throw): llavors no hi ha cami sense assignar
int dies;
try { dies = Integer.parseInt(entrada); } catch (NumberFormatException e) { return; }
System.out.println(dies);   // compila: si arribem aqui, dies te valor

package com.nexussoftware.bibliotech.presentacio;

/** Conversio tolerant per a l'entrada per consola de BiblioTech. */
public final class EntradaSegura {

    private EntradaSegura() { }   // classe d'utilitat: no s'instancia

    /**
     * Converteix text a enter. Si no es convertible, retorna el valor per defecte.
     *
     * Aquesta es la versio "tolerant", pensada per a la CAPA DE PRESENTACIO,
     * on una entrada dolenta de l'usuari es una cosa normal i no una fallada del sistema.
     * A la capa de domini la politica sera la contraria: llancar (06-03).
     */
    public static int aEnterODefecte(String text, int perDefecte) {
        if (text == null || text.isBlank()) {
            return perDefecte;
        }
        try {
            return Integer.parseInt(text.trim());
        } catch (NumberFormatException e) {
            // Recuperacio: el valor per defecte es una resposta VALIDA aqui.
            // S'informa l'usuari perque no cregui que la seva dada s'ha usat.
            System.out.println("  [avis] '" + text + "' no es un numero. S'usa " + perDefecte);
            return perDefecte;
        }
    }

    public static double aDecimalODefecte(String text, double perDefecte) {
        if (text == null || text.isBlank()) {
            return perDefecte;
        }
        try {
            // S'accepta la coma decimal, molt habitual en teclejar en catala
            return Double.parseDouble(text.trim().replace(',', '.'));
        } catch (NumberFormatException e) {
            System.out.println("  [avis] '" + text + "' no es un decimal. S'usa " + perDefecte);
            return perDefecte;
        }
    }

    public static void main(String[] args) {
        System.out.println(aEnterODefecte("15", 15));          // 15
        System.out.println(aEnterODefecte("dotze", 15));       // avis + 15
        System.out.println(aEnterODefecte("  20  ", 15));      // 20 (trim)
        System.out.println(aEnterODefecte(null, 15));          // 15
        System.out.println(aDecimalODefecte("0,25", 0.25));    // 0.25 (coma admesa)
    }
}

package com.nexussoftware.bibliotech.servei;

/**
 * Reintent amb espera creixent (backoff) per a una operacio transitoria.
 *
 * Nota: l'operacio se simula. El cas real (llegir un fitxer, cridar un
 * servei) arriba als moduls 7 i 9; el que importa aqui es l'ESTRUCTURA.
 */
public class SincronitzadorCataleg {

    private static final int MAX_INTENTS = 4;
    private static final long ESPERA_BASE_MS = 200;

    private int crides = 0;

    /** Simula una operacio que falla les dues primeres vegades i despres funciona. */
    private String descarregarCatalegRemot() {
        crides++;
        if (crides < 3) {
            throw new IllegalStateException("Servidor no disponible (intent " + crides + ")");
        }
        return "3 materials sincronitzats";
    }

    public String sincronitzar() {
        IllegalStateException ultimaFallada = null;

        for (int intent = 1; intent <= MAX_INTENTS; intent++) {
            try {
                String resultat = descarregarCatalegRemot();
                System.out.println("OK a l'intent " + intent + ": " + resultat);
                return resultat;                         // exit: se surt del bucle
            } catch (IllegalStateException e) {
                ultimaFallada = e;                       // es guarda per a la fallada definitiva
                System.out.println("Intent " + intent + " fallit: " + e.getMessage());

                if (intent == MAX_INTENTS) {
                    break;                               // no esperar despres de l'ultim intent
                }

                long espera = ESPERA_BASE_MS * (1L << (intent - 1));   // 200, 400, 800 ms
                System.out.println("  Esperant " + espera + " ms abans de reintentar...");
                try {
                    Thread.sleep(espera);
                } catch (InterruptedException ie) {
                    // Bona practica del modul 8: restaurar el marcador d'interrupcio
                    // i abandonar. Mai no s'ha d'empassar una InterruptedException.
                    Thread.currentThread().interrupt();
                    throw new IllegalStateException("Sincronitzacio interrompuda", ie);
                }
            }
        }

        // Esgotats els intents: fallar de manera clara, conservant la causa (06-03)
        throw new IllegalStateException(
                "No s'ha pogut sincronitzar el cataleg despres de " + MAX_INTENTS + " intents",
                ultimaFallada);
    }

    public static void main(String[] args) {
        System.out.println(new SincronitzadorCataleg().sincronitzar());
    }
}

Intent 1 fallit: Servidor no disponible (intent 1)
  Esperant 200 ms abans de reintentar...
Intent 2 fallit: Servidor no disponible (intent 2)
  Esperant 400 ms abans de reintentar...
OK a l'intent 3: 3 materials sincronitzats
3 materials sincronitzats

// A la capa de servei de BiblioTech
public Material carregarMaterialDesDeLinia(String linia) {
    try {
        String[] camps = linia.split(";");
        String referencia = camps[0];
        int any = Integer.parseInt(camps[2]);
        return new Llibre(referencia, camps[1], any);
    } catch (NumberFormatException | ArrayIndexOutOfBoundsException e) {
        // TRADUCCIO: qui crida no te per que saber que a dins
        // hi havia un split ni un parseInt. El que li importa es que
        // aquesta linia del cataleg esta mal formada.
        throw new IllegalArgumentException(
                "Linia de cataleg mal formada: '" + linia + "'", e);    // <-- la causa, conservada
    }
}

public void processarDevolucio(String referencia, int dia) {
    try {
        registre.retornar(referencia, dia);
    } catch (RuntimeException e) {
        // Es deixa constancia AMB el context que nomes es coneix aqui...
        System.err.println("Fallada en retornar " + referencia + " el dia " + dia);
        // ...i es deixa pujar perque a dalt decideixin.
        throw e;                              // rellancar la MATEIXA excepcio
    }
}

package com.nexussoftware.bibliotech.presentacio;

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

public class DemoCatchBuit {

    static List<String> registrats = new ArrayList<>();

    /** VERSIO DOLENTA: el catch buit destrueix la informacio de la fallada. */
    static void registrarMalament(String linia) {
        try {
            String[] parts = linia.split(";");
            int copies = Integer.parseInt(parts[1]);
            for (int i = 0; i < copies; i++) {
                registrats.add(parts[0] + "-" + i);
            }
        } catch (Exception e) {
            // buit a proposit
        }
    }

    public static void main(String[] args) {
        registrarMalament("LIB-0001;2");
        registrarMalament("LIB-0002;dos");   // falla... i NINGU no se n'assabenta
        registrarMalament("LIB-0003");       // falla... i NINGU no se n'assabenta
        registrarMalament("LIB-0004;1");

        System.out.println("Registrats: " + registrats);
        System.out.println("Total esperat: 6 exemplars. Total real: " + registrats.size());
    }
}

Registrats: [LIB-0001-0, LIB-0001-1, LIB-0004-0]
Total esperat: 6 exemplars. Total real: 3

// MALAMENT: la xarxa s'endu peixos que no voliem pescar
try {
    Material m = cataleg.cercarPerReferencia(referencia);
    int dies = Integer.parseInt(entradaUsuari);
    gestor.prestar(m, empleat, dies);
} catch (Exception e) {
    System.out.println("Entrada invalida, torneu-ho a provar");
}

try {
    Material m = cataleg.cercarPerReferencia(referencia);
    int dies = Integer.parseInt(entradaUsuari);
    gestor.prestar(m, empleat, dies);
} catch (NumberFormatException e) {
    System.out.println("El nombre de dies no es valid: " + entradaUsuari);
}
// Un NullPointerException puja i es veu. Es un bug, i s'ha de notar.

// PROHIBIT: recorrer provocant l'excepcio de final
try {
    int i = 0;
    while (true) {
        System.out.println(materials.get(i++).getTitol());
    }
} catch (IndexOutOfBoundsException fi) {
    // "ja hem acabat"
}

package com.nexussoftware.bibliotech.presentacio;

/**
 * Comparativa illustrativa: comprovar amb if enfront de provocar i capturar.
 * ATENCIO: es un mesurament casola. Per mesurar de debo cal JMH (11-07),
 * perque el JIT distorsiona els micro-benchmarks manuals.
 */
public class CostDeLesExcepcions {

    private static final int VOLTES = 1_000_000;

    public static void main(String[] args) {
        String[] entrades = new String[VOLTES];
        for (int i = 0; i < VOLTES; i++) {
            entrades[i] = (i % 2 == 0) ? String.valueOf(i) : "no-numero";   // 50% invalides
        }

        // A) Comprovar abans amb una validacio manual
        long t0 = System.nanoTime();
        int validsA = 0;
        for (String s : entrades) {
            if (esEnterSimple(s)) { validsA++; }
        }
        long tA = (System.nanoTime() - t0) / 1_000_000;

        // B) Intentar i capturar l'excepcio
        long t1 = System.nanoTime();
        int validsB = 0;
        for (String s : entrades) {
            try {
                Integer.parseInt(s);
                validsB++;
            } catch (NumberFormatException e) {
                // ignorat a proposit per al mesurament
            }
        }
        long tB = (System.nanoTime() - t1) / 1_000_000;

        // C) Excepcio SENSE stack trace (veure 06-04): quant costa nomes el mecanisme
        long t2 = System.nanoTime();
        int validsC = 0;
        for (String s : entrades) {
            try {
                if (!esEnterSimple(s)) { throw SENSE_TRACA; }
                validsC++;
            } catch (RuntimeException e) {
                // ignorat
            }
        }
        long tC = (System.nanoTime() - t2) / 1_000_000;

        System.out.println("A) if previ                      : " + tA + " ms (" + validsA + ")");
        System.out.println("B) try/catch amb parseInt        : " + tB + " ms (" + validsB + ")");
        System.out.println("C) excepcio sense stack trace    : " + tC + " ms (" + validsC + ")");
    }

    /** Excepcio preconstruida i SENSE stack trace: gairebe gratis de llancar. */
    private static final RuntimeException SENSE_TRACA =
            new RuntimeException("no numeric", null, false, false);

    private static boolean esEnterSimple(String s) {
        if (s == null || s.isEmpty()) { return false; }
        for (int i = 0; i < s.length(); i++) {
            char c = s.charAt(i);
            if (i == 0 && (c == '-' || c == '+') && s.length() > 1) { continue; }
            if (c < '0' || c > '9') { return false; }
        }
        return true;
    }
}

A) if previ                      : 12 ms (500000)
B) try/catch amb parseInt        : 890 ms (500000)
C) excepcio sense stack trace    : 18 ms (500000)

// Versio del modul 2: l'usuari escriu "dotze" i l'aplicacio MOR
System.out.print("Opcio: ");
int opcio = Integer.parseInt(scanner.nextLine());    // NumberFormatException -> adeu

package com.nexussoftware.bibliotech.presentacio;

import java.util.Scanner;

/**
 * Menu de BiblioTech resistent a l'entrada de l'usuari.
 *
 * Politica d'errors d'aquesta classe (capa de presentacio):
 *  - Opcio del menu invalida  -> reintentar fins que sigui valida.
 *  - Dada numerica invalida   -> reintentar amb limit; si s'esgota, cancellar l'operacio.
 *  - Qualsevol altra fallada  -> es deixa pujar (encara). A 06-07 es gestionara a la frontera.
 */
public class MenuBiblioTech {

    private static final int MAX_REINTENTS = 3;
    private static final int DIES_PRESTEC = 15;

    private final Scanner scanner = new Scanner(System.in);

    public void arrencar() {
        boolean sortir = false;
        while (!sortir) {
            mostrarMenu();
            int opcio = llegirOpcio(0, 4);

            switch (opcio) {
                case 1 -> llistarCataleg();
                case 2 -> prestarMaterial();
                case 3 -> retornarMaterial();
                case 4 -> calcularMulta();
                case 0 -> { sortir = true; System.out.println("Fins aviat."); }
                default -> System.out.println("Opcio no contemplada.");
            }
        }
    }

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

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

    /**
     * Llegeix una opcio valida, reintentant indefinidament.
     *
     * El reintent sense limit es acceptable AQUI perque hi ha una persona a l'altra
     * banda que pot corregir. En un proces per lots seria un bucle infinit:
     * la mateixa linia invalida es rellegiria per sempre.
     */
    private int llegirOpcio(int min, int max) {
        while (true) {
            System.out.print("Opcio: ");
            String linia = scanner.nextLine();

            try {
                int valor = Integer.parseInt(linia.trim());
                if (valor < min || valor > max) {
                    System.out.println("  Ha d'estar entre " + min + " i " + max + ". Reintenteu.");
                    continue;                       // dada valida com a numero, invalida com a opcio
                }
                return valor;
            } catch (NumberFormatException e) {
                // RECUPERACIO PER REINTENT: s'informa amb la dada culpable
                System.out.println("  '" + linia + "' no es un numero. Escriviu un digit de "
                        + min + " a " + max + ".");
            }
        }
    }

    /**
     * Llegeix un enter amb limit de reintents.
     * Retorna -1 si l'usuari esgota els intents, perque qui el cridi cancelli.
     *
     * (Aquest -1 encara es un "codi de retorn" dels que va criticar 06-01. Es
     *  acceptable dins d'una mateixa classe de presentacio; a la capa de
     *  servei se substituira per excepcions de domini a 06-04.)
     */
    private int llegirEnterAmbLimit(String peticio, int min, int max) {
        for (int intent = 1; intent <= MAX_REINTENTS; intent++) {
            System.out.print(peticio + ": ");
            String linia = scanner.nextLine();

            try {
                int valor = Integer.parseInt(linia.trim());
                if (valor < min || valor > max) {
                    System.out.printf("  Fora de rang [%d..%d]. Intent %d de %d.%n",
                            min, max, intent, MAX_REINTENTS);
                    continue;
                }
                return valor;
            } catch (NumberFormatException e) {
                System.out.printf("  '%s' no es un numero. Intent %d de %d.%n",
                        linia, intent, MAX_REINTENTS);
            }
        }
        System.out.println("  Massa intents fallits. Operacio cancellada.");
        return -1;
    }

    private double llegirDecimalODefecte(String peticio, double perDefecte) {
        System.out.print(peticio + " [" + perDefecte + "]: ");
        String linia = scanner.nextLine().trim();

        if (linia.isEmpty()) {
            return perDefecte;                       // Enter directe: accepta el valor proposat
        }
        try {
            return Double.parseDouble(linia.replace(',', '.'));
        } catch (NumberFormatException e) {
            System.out.println("  Valor no numeric. S'usa " + perDefecte);
            return perDefecte;
        }
    }

    private void llistarCataleg() {
        System.out.println("  (cataleg: 3 materials)");
    }

    private void prestarMaterial() {
        System.out.print("Referencia del material: ");
        String referencia = scanner.nextLine().trim();

        int dies = llegirEnterAmbLimit("Dies de prestec (1-30)", 1, 30);
        if (dies == -1) {
            return;                                  // cancellat: no es toca l'estat
        }
        System.out.println("  Prestat " + referencia + " durant " + dies + " dies.");
    }

    private void retornarMaterial() {
        System.out.print("Referencia a retornar: ");
        String referencia = scanner.nextLine().trim();

        int dia = llegirEnterAmbLimit("Dia de devolucio (1-365)", 1, 365);
        if (dia == -1) {
            return;
        }
        System.out.println("  Retornat " + referencia + " el dia " + dia + ".");
    }

    private void calcularMulta() {
        int diesRetard = llegirEnterAmbLimit("Dies de retard (0-200)", 0, 200);
        if (diesRetard == -1) {
            return;
        }
        double tarifa = llegirDecimalODefecte("Tarifa diaria", 0.25);

        double multa = Math.min(diesRetard * tarifa, 20.0);    // MULTA_MAXIMA
        System.out.printf("  Multa: %.2f EUR (termini estandard %d dies)%n", multa, DIES_PRESTEC);
    }

    public static void main(String[] args) {
        new MenuBiblioTech().arrencar();
    }
}

===== BiblioTech - Nexus Software =====
1. Llistar cataleg
...
Opcio: dos
  'dos' no es un numero. Escriviu un digit de 0 a 4.
Opcio: 9
  Ha d'estar entre 0 i 4. Reintenteu.
Opcio: 4
Dies de retard (0-200): molts
  'molts' no es un numero. Intent 1 de 3.
Dies de retard (0-200): 22
Tarifa diaria [0.25]:
  Multa: 5.50 EUR (termini estandard 15 dies)

public double calcularMultaTotal(List<String> referencies, Map<String, Integer> diesRetard) {
    double total = 0;
    try {
        for (String ref : referencies) {
            try {
                int dies = diesRetard.get(ref);
                if (dies > 0) {
                    total += dies * 0.25;
                }
            } catch (Exception e) {
            }
        }
        int mitjana = (int) total / referencies.size();
        System.out.println("Mitjana: " + mitjana);
    } catch (Throwable t) {
        t.printStackTrace();
        return 0;
    }
    return total;
}

package com.nexussoftware.bibliotech.servei;

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

/**
 * Importa linies de cataleg tolerant errors linia a linia.
 *
 * Clau del disseny: el try va DINS del bucle, perque una linia
 * defectuosa no avorti la importacio completa.
 */
public class ImportadorCataleg {

    /** Resultat de la importacio (record: 04-07). */
    public record InformeImportacio(int processades, int acceptades,
                                    int rebutjades, List<String> motius) {

        public String resum() {
            StringBuilder sb = new StringBuilder();
            sb.append("=== INFORME D'IMPORTACIO ===\n");
            sb.append("Processades: ").append(processades).append('\n');
            sb.append("Acceptades : ").append(acceptades).append('\n');
            sb.append("Rebutjades : ").append(rebutjades).append('\n');
            if (!motius.isEmpty()) {
                sb.append("--- Motius de rebuig ---\n");
                for (String m : motius) {
                    sb.append("  * ").append(m).append('\n');
                }
            }
            return sb.toString();
        }
    }

    private static final int ANY_MIN = 1450;
    private static final int ANY_MAX = 2100;

    private final List<String> acceptats = new ArrayList<>();

    public InformeImportacio importar(String[] linies) {
        List<String> motius = new ArrayList<>();
        int processades = 0;
        int acceptades = 0;

        for (String linia : linies) {
            processades++;                      // s'incrementa SEMPRE, falli o no

            // Validacio previa: una linia buida no mereix ni intentar-se.
            // Regla general: si es pot comprovar amb un if barat, no usis excepcio.
            if (linia == null || linia.isBlank()) {
                motius.add("Linia " + processades + ": buida");
                continue;
            }

            try {
                String[] camps = linia.split(";");

                // Si falten camps, aquest acces llanca ArrayIndexOutOfBoundsException
                String referencia = camps[0].trim();
                String titol      = camps[1].trim();
                int any           = Integer.parseInt(camps[2].trim());
                int exemplars     = Integer.parseInt(camps[3].trim());

                // Validacions de negoci: NO llancen, es comproven amb if.
                // Un valor fora de rang no es una fallada tecnica, es una dada incorrecta.
                if (any < ANY_MIN || any > ANY_MAX) {
                    motius.add("Linia " + processades + " (" + referencia + "): any fora de rang ["
                            + ANY_MIN + ".." + ANY_MAX + "]: " + any);
                    continue;
                }
                if (exemplars <= 0) {
                    motius.add("Linia " + processades + " (" + referencia
                            + "): exemplars ha de ser positiu, era " + exemplars);
                    continue;
                }
                if (referencia.isEmpty() || titol.isEmpty()) {
                    motius.add("Linia " + processades + ": referencia o titol buits");
                    continue;
                }

                acceptats.add(referencia + " | " + titol + " | " + any + " | " + exemplars);
                acceptades++;

            } catch (ArrayIndexOutOfBoundsException e) {
                // CATCH ESPECIFIC 1: falten camps. Missatge diferent de l'altre cas.
                motius.add("Linia " + processades + ": falten camps (se n'esperaven 4). Contingut: '"
                        + linia + "'");

            } catch (NumberFormatException e) {
                // CATCH ESPECIFIC 2: camps numerics mal escrits.
                // e.getMessage() ja diu quin era el text ofensiu.
                motius.add("Linia " + processades + ": camp numeric invalid -> " + e.getMessage());
            }
        }

        return new InformeImportacio(processades, acceptades, processades - acceptades, motius);
    }

    public List<String> getAcceptats() {
        return List.copyOf(acceptats);          // copia immutable: encapsulament (03-07)
    }

    public static void main(String[] args) {
        String[] linies = {
                "LIB-0001;Java Eficac;2018;3",              // correcta
                "LIB-0002;Patrons de Disseny",              // falten camps
                "LIB-0003;Refactoritzacio;mil nou-cents;2", // any no numeric
                "LIB-0004;Llibre Antic;1200;1",             // any fora de rang
                "LIB-0005;Sense Exemplars;2020;0",          // exemplars invalids
                "",                                          // buida
                "LIB-0006;Java Concurrent;2021;dos",        // exemplars no numerics
                "LIB-0007;Clean Code;2008;5"                // correcta
        };

        ImportadorCataleg importador = new ImportadorCataleg();
        InformeImportacio informe = importador.importar(linies);

        System.out.println(informe.resum());
        System.out.println("--- Acceptats ---");
        importador.getAcceptats().forEach(a -> System.out.println("  " + a));
    }
}

=== INFORME D'IMPORTACIO ===
Processades: 8
Acceptades : 2
Rebutjades : 6
--- Motius de rebuig ---
  * Linia 2: falten camps (se n'esperaven 4). Contingut: 'LIB-0002;Patrons de Disseny'
  * Linia 3: camp numeric invalid -> For input string: "mil nou-cents"
  * Linia 4 (LIB-0004): any fora de rang [1450..2100]: 1200
  * Linia 5 (LIB-0005): exemplars ha de ser positiu, era 0
  * Linia 6: buida
  * Linia 7: camp numeric invalid -> For input string: "dos"

--- Acceptats ---
  LIB-0001 | Java Eficac | 2018 | 3
  LIB-0007 | Clean Code | 2008 | 5

package com.nexussoftware.bibliotech.servei;

import java.util.List;
import java.util.Map;
import java.util.Objects;

public class CalculadoraMultes {

    private static final double TARIFA_DIARIA = 0.25;
    private static final double MULTA_MAXIMA  = 20.0;

    /**
     * Suma la multa de les referencies indicades.
     *
     * Politica d'errors:
     *  - Arguments nuls: fallada de programacio, es llanca (fail-fast, 06-03).
     *  - Referencia sense dada de retard: es considera 0 dies, comprovant-ho
     *    amb un if. No es una fallada: es un cas normal (encara no ha vencut).
     *  - No es captura RES aqui: aquest metode no sap que fer amb una fallada.
     *    Qui el cridi decidira.
     */
    public double calcularMultaTotal(List<String> referencies, Map<String, Integer> diesRetard) {
        Objects.requireNonNull(referencies, "La llista de referencies no pot ser nulla");
        Objects.requireNonNull(diesRetard, "El mapa de dies de retard no pot ser nul");

        double total = 0;
        for (String ref : referencies) {
            // getOrDefault evita el desempaquetatge de null: es un if disfressat,
            // i es MILLOR que capturar el NullPointerException que provocaria get().
            int dies = diesRetard.getOrDefault(ref, 0);

            if (dies > 0) {
                double multa = Math.min(dies * TARIFA_DIARIA, MULTA_MAXIMA);
                total += multa;
            }
        }
        return total;
    }

    /**
     * Mitjana de multa per material. Separada del calcul total: cada metode, una cosa.
     * La llista buida es comprova explicitament: es un cas previsible, no una fallada.
     */
    public double calcularMultaMitjana(List<String> referencies, Map<String, Integer> diesRetard) {
        Objects.requireNonNull(referencies, "La llista de referencies no pot ser nulla");

        if (referencies.isEmpty()) {
            return 0.0;                 // mitjana d'un conjunt buit: 0 es la resposta correcta
        }
        return calcularMultaTotal(referencies, diesRetard) / referencies.size();
    }

    public static void main(String[] args) {
        CalculadoraMultes calc = new CalculadoraMultes();

        List<String> refs = List.of("LIB-0001", "LIB-0002", "LIB-0003", "LIB-0004");
        Map<String, Integer> retards = Map.of(
                "LIB-0001", 4,          // 1.00 EUR
                "LIB-0002", 0,          // sense retard
                "LIB-0003", 120);       // 30.00 -> limitat a 20.00
        // LIB-0004 no apareix al mapa: getOrDefault retorna 0

        System.out.printf("Total: %.2f EUR%n", calc.calcularMultaTotal(refs, retards));
        System.out.printf("Mitjana: %.2f EUR%n", calc.calcularMultaMitjana(refs, retards));
        System.out.printf("Mitjana de llista buida: %.2f EUR%n",
                calc.calcularMultaMitjana(List.of(), retards));
    }
}

Total: 21.00 EUR
Mitjana: 5.25 EUR
Mitjana de llista buida: 0.00 EUR

package com.nexussoftware.bibliotech.servei;

import java.util.HashMap;
import java.util.Map;
import java.util.Set;

/**
 * Lectura de configuracio amb politica d'error PER PARAMETRE.
 *
 * La llico de disseny: no existeix "la forma correcta" de gestionar un error.
 * Depen de si el programa pot continuar sense aquesta dada.
 */
public class ConfiguracioBiblioTech {

    private final Map<String, String> propietats;

    private static final Set<String> CERTS  = Set.of("true", "si", "cert", "1", "s", "yes");
    private static final Set<String> FALSOS = Set.of("false", "no", "0", "n");

    public ConfiguracioBiblioTech(Map<String, String> propietats) {
        // Copia defensiva: ningu no modificara la configuracio per l'esquena (03-07)
        this.propietats = new HashMap<>(propietats);
    }

    /**
     * POLITICA A: parametre OBLIGATORI.
     * Sense ell, el programa no pot funcionar correctament: es llanca.
     * Es conserva la causa quan existeix, per no perdre el detall (06-03).
     */
    public int llegirEnterObligatori(String clau) {
        String valor = propietats.get(clau);

        if (valor == null) {
            throw new IllegalStateException(
                    "Falta el parametre obligatori '" + clau + "' a la configuracio");
        }
        try {
            return Integer.parseInt(valor.trim());
        } catch (NumberFormatException e) {
            // TRADUCCIO amb causa: qui crida no ha de saber que a dins
            // hi havia un parseInt, pero el stack trace conservara el detall.
            throw new IllegalStateException(
                    "El parametre obligatori '" + clau + "' ha de ser un enter, i val '"
                            + valor + "'", e);
        }
    }

    /**
     * POLITICA B: parametre OPCIONAL.
     * Hi ha un valor per defecte raonable: es recupera i s'informa.
     */
    public int llegirEnterOpcional(String clau, int perDefecte) {
        String valor = propietats.get(clau);

        if (valor == null) {
            System.out.println("  [config] '" + clau + "' absent. S'usa " + perDefecte);
            return perDefecte;
        }
        try {
            return Integer.parseInt(valor.trim());
        } catch (NumberFormatException e) {
            System.out.println("  [config] '" + clau + "' = '" + valor
                    + "' no es un enter. S'usa " + perDefecte);
            return perDefecte;
        }
    }

    /**
     * POLITICA C: valor per defecte AMB validacio de rang.
     * Distingeix dos motius de rebuig diferents, perque per diagnosticar
     * no es el mateix "has escrit lletres" que "has escrit un numero absurd".
     */
    public double llegirDecimalAmbRang(String clau, double min, double max, double perDefecte) {
        String valor = propietats.get(clau);

        if (valor == null) {
            System.out.println("  [config] '" + clau + "' absent. S'usa " + perDefecte);
            return perDefecte;
        }

        double convertit;
        try {
            convertit = Double.parseDouble(valor.trim().replace(',', '.'));
        } catch (NumberFormatException e) {
            System.out.println("  [config] '" + clau + "' = '" + valor
                    + "' no es un decimal. S'usa " + perDefecte);
            return perDefecte;
        }

        // La validacio de rang va FORA del try: no es una fallada de conversio,
        // i posar-la a dins faria que una futura fallada de l'if es confongues.
        if (convertit < min || convertit > max) {
            System.out.printf("  [config] '%s' = %.2f fora de [%.2f..%.2f]. S'usa %.2f%n",
                    clau, convertit, min, max, perDefecte);
            return perDefecte;
        }
        return convertit;
    }

    /**
     * POLITICA D: boolea tolerant.
     * No hi ha excepcio que capturar: no existeix cap Boolean.parseBoolean que falli
     * (retorna false davant de qualsevol cosa, que es justament el problema).
     * Es resol amb conjunts i validacio explicita.
     */
    public boolean llegirBoolea(String clau, boolean perDefecte) {
        String valor = propietats.get(clau);

        if (valor == null) {
            System.out.println("  [config] '" + clau + "' absent. S'usa " + perDefecte);
            return perDefecte;
        }

        String normalitzat = valor.trim().toLowerCase();
        if (CERTS.contains(normalitzat))  { return true; }
        if (FALSOS.contains(normalitzat)) { return false; }

        System.out.println("  [config] '" + clau + "' = '" + valor
                + "' no es un boolea reconeixible. S'usa " + perDefecte);
        return perDefecte;
    }

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

    public static void main(String[] args) {
        Map<String, String> props = new HashMap<>();
        props.put("dies.prestec",   "15");
        props.put("tarifa.diaria",  "zero");        // invalid
        props.put("multa.maxima",   "999");         // fora de rang
        props.put("avisos.actius",  "SI");          // valid, en majuscules
        props.put("max.prestecs",   "3");
        // "llindar.lleu" deliberadament absent

        ConfiguracioBiblioTech config = new ConfiguracioBiblioTech(props);

        System.out.println("== Lectura de configuracio de BiblioTech ==");

        int dies = config.llegirEnterObligatori("dies.prestec");
        System.out.println("DIES_PRESTEC    = " + dies);

        double tarifa = config.llegirDecimalAmbRang("tarifa.diaria", 0.0, 5.0, 0.25);
        System.out.println("TARIFA_DIARIA   = " + tarifa);

        double maxima = config.llegirDecimalAmbRang("multa.maxima", 0.0, 100.0, 20.0);
        System.out.println("MULTA_MAXIMA    = " + maxima);

        int llindar = config.llegirEnterOpcional("llindar.lleu", 7);
        System.out.println("LLINDAR_LLEU    = " + llindar);

        boolean avisos = config.llegirBoolea("avisos.actius", false);
        System.out.println("AVISOS_ACTIUS   = " + avisos);

        // Demostracio de la politica A quan el parametre obligatori falta
        System.out.println("\n== Parametre obligatori absent ==");
        try {
            config.llegirEnterObligatori("port.servidor");
        } catch (IllegalStateException e) {
            System.out.println("ERROR DE CONFIGURACIO: " + e.getMessage());
            System.out.println("Causa subjacent: " + e.getCause());
        }

        // Demostracio de la politica A quan el valor es invalid: hi ha causa
        System.out.println("\n== Parametre obligatori invalid ==");
        try {
            config.llegirEnterObligatori("tarifa.diaria");
        } catch (IllegalStateException e) {
            System.out.println("ERROR DE CONFIGURACIO: " + e.getMessage());
            System.out.println("Causa subjacent: " + e.getCause());
        }
    }
}

== Lectura de configuracio de BiblioTech ==
DIES_PRESTEC    = 15
  [config] 'tarifa.diaria' = 'zero' no es un decimal. S'usa 0.25
TARIFA_DIARIA   = 0.25
  [config] 'multa.maxima' = 999.00 fora de [0.00..100.00]. S'usa 20.00
MULTA_MAXIMA    = 20.0
  [config] 'llindar.lleu' absent. S'usa 7
LLINDAR_LLEU    = 7
AVISOS_ACTIUS   = true

== Parametre obligatori absent ==
ERROR DE CONFIGURACIO: Falta el parametre obligatori 'port.servidor' a la configuracio
Causa subjacent: null

== Parametre obligatori invalid ==
ERROR DE CONFIGURACIO: El parametre obligatori 'tarifa.diaria' ha de ser un enter, i val 'zero'
Causa subjacent: java.lang.NumberFormatException: For input string: "zero"