Formatowanie i składanie tekstu

import java.math.BigDecimal;
import java.math.RoundingMode;
import java.util.List;
import java.util.Locale;

/**
 * String.format, StringBuilder i bloki tekstu — skryptyJAVA.pl
 * Zapisz jako: FormatowanieTekstu.java
 */
public final class FormatowanieTekstu {

    private static final Locale POLSKI = Locale.forLanguageTag("pl-PL");

    /** Prosty, niezmienny wiersz danych do raportu. */
    public record Produkt(String nazwa, int ilosc, BigDecimal cena) {}

    private FormatowanieTekstu() {
        // Klasa narzędziowa nie wymaga obiektów.
    }

    /** Formatuje liczby zgodnie z polskim locale: grupowanie tysięcy i przecinek dziesiętny. */
    public static String etykieta(Produkt produkt) {
        return String.format(POLSKI, "%s — %,d szt. po %,.2f zł",
                produkt.nazwa(), produkt.ilosc(), produkt.cena());
    }

    /** Buduje tabelę bez tworzenia nowego pełnego napisu przy każdym obrocie pętli. */
    public static String tabela(List<Produkt> produkty) {
        StringBuilder wynik = new StringBuilder();
        wynik.append(String.format(POLSKI, "%-22s %8s %13s%n", "Produkt", "Ilość", "Wartość"));
        wynik.append("-".repeat(45)).append(System.lineSeparator());

        BigDecimal suma = BigDecimal.ZERO;
        for (Produkt produkt : produkty) {
            // Zaokrąglamy przed dodaniem, żeby stopka zgadzała się z sumą wydrukowanych wierszy.
            BigDecimal wartosc = produkt.cena()
                    .multiply(BigDecimal.valueOf(produkt.ilosc()))
                    .setScale(2, RoundingMode.HALF_UP);
            suma = suma.add(wartosc);
            wynik.append(String.format(POLSKI, "%-22s %8d %10.2f zł%n",
                    skroc(produkt.nazwa(), 22), produkt.ilosc(), wartosc));
        }

        wynik.append("-".repeat(45)).append(System.lineSeparator());
        wynik.append(String.format(POLSKI, "%-31s %10.2f zł%n", "Razem:", suma));
        return wynik.toString();
    }

    /**
     * Skraca tekst do zadanej liczby znaków i dopisuje wielokropek, zamiast uciąć po cichu.
     * Liczy punkty kodowe: nie rozrywa par zastępczych, ale może przeciąć flagę lub emoji ZWJ.
     */
    public static String skroc(String tekst, int limit) {
        if (limit < 1) {
            return "";
        }
        if (tekst.codePointCount(0, tekst.length()) <= limit) {
            return tekst;
        }
        return tekst.substring(0, tekst.offsetByCodePoints(0, limit - 1)) + "…";
    }

    /**
     * Wstawia dane do czytelnego bloku tekstu; treść jest wcześniej kodowana dla HTML-a.
     * Oba argumenty muszą być różne od null.
     */
    public static String stronaHtml(String tytul, String tresc) {
        String szablon = """
                <!doctype html>
                <html lang="pl">
                <head>
                    <meta charset="UTF-8">
                    <title>%s</title>
                </head>
                <body>
                    <h1>%s</h1>
                    <p>%s</p>
                </body>
                </html>
                """;

        String bezpiecznyTytul = kodujHtml(tytul);
        return szablon.formatted(bezpiecznyTytul, bezpiecznyTytul, kodujHtml(tresc));
    }

    /**
     * Minimalne kodowanie tekstu umieszczanego między znacznikami HTML.
     * Argument nie może być null — metoda nie sprawdza go i rzuci NullPointerException.
     */
    public static String kodujHtml(String tekst) {
        return tekst.replace("&", "&amp;")
                    .replace("<", "&lt;")
                    .replace(">", "&gt;")
                    .replace("\"", "&quot;")
                    .replace("'", "&#39;");
    }

    // ── PRZYKŁADY ───────────────────────────────────────────
    public static void main(String[] args) {
        List<Produkt> produkty = List.of(
                new Produkt("Kawa ziarnista", 2, new BigDecimal("39.90")),
                new Produkt("Kubek programisty", 12, new BigDecimal("24.50")),
                new Produkt("Zestaw kubków termicznych premium", 3, new BigDecimal("19.99")),
                new Produkt("Książka o Javie", 1_250, new BigDecimal("79.99")));

        System.out.println(etykieta(produkty.get(3)));
        System.out.println();
        System.out.print(tabela(produkty));
        System.out.println();
        System.out.println(stronaHtml("Java & tekst", "Bezpieczne <formatowanie>"));
    }
}