Budowanie adresów URL i kodowanie parametrów

import java.net.URI;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.LinkedHashMap;
import java.util.Map;

/**
 * Budowanie adresów URL i kodowanie parametrów — skryptyJAVA.pl
 * Zapisz jako: AdresyUrl.java
 */
public class AdresyUrl {

    /**
     * Skleja adres bazowy z parametrami zapytania. Klucz i wartość kodowane są osobno —
     * dopiero wtedy znaki "=" oraz "&" wstawione przez nas pozostają separatorami,
     * a te same znaki wpisane przez użytkownika zamieniają się w %3D i %26.
     *
     * @param bazowy    adres bez znaku zapytania albo z gotowym początkiem query;
     *                  adres z kotwicą "#" się nie nada — parametry wylądowałyby za nią
     * @param parametry pary klucz-wartość; wpis o wartości null jest pomijany
     */
    public static String zbudujAdres(String bazowy, Map<String, String> parametry) {
        StringBuilder adres = new StringBuilder(bazowy);
        char separator = bazowy.contains("?") ? '&' : '?';
        for (Map.Entry<String, String> wpis : parametry.entrySet()) {
            if (wpis.getValue() == null) { continue; }  // null to nie to samo co pusty napis
            adres.append(separator)
                 .append(kodujParametr(wpis.getKey()))
                 .append('=')
                 .append(kodujParametr(wpis.getValue()));
            separator = '&';
        }
        return adres.toString();
    }

    /** Kodowanie do query stringu: spacja zamienia się na "+", dokładnie jak w formularzu HTML. */
    public static String kodujParametr(String tekst) {
        return URLEncoder.encode(tekst, StandardCharsets.UTF_8);
    }

    /**
     * Kodowanie POJEDYNCZEGO segmentu ścieżki. W ścieżce "+" znaczy dosłownie plus,
     * więc spacja musi być zapisana jako %20. Podmiana jest bezpieczna: prawdziwy plus
     * z tekstu został wcześniej zamieniony przez URLEncoder na %2B.
     */
    public static String kodujSegmentSciezki(String segment) {
        return URLEncoder.encode(segment, StandardCharsets.UTF_8).replace("+", "%20");
    }

    /** Skleja ścieżkę z osobnych segmentów; ukośniki wstawiamy my, więc nie znikną w kodowaniu. */
    public static String zbudujSciezke(String... segmenty) {
        StringBuilder sciezka = new StringBuilder();
        for (String segment : segmenty) {
            sciezka.append('/').append(kodujSegmentSciezki(segment));
        }
        return sciezka.toString();
    }

    /**
     * Rozbija surowy query string na mapę. Parametr bez znaku "=" dostaje pusty napis,
     * tak samo jak parametr z pustą wartością — w adresie te dwa zapisy wyglądają inaczej,
     * ale w praktyce znaczą to samo. LinkedHashMap zachowuje kolejność z adresu.
     * Powtórzony klucz (tag=a&tag=b) nadpisuje poprzedni — w mapie zostaje ostatnia wartość.
     */
    public static Map<String, String> rozbijQuery(String query) {
        Map<String, String> parametry = new LinkedHashMap<>();
        if (query == null || query.isEmpty()) { return parametry; }
        String tresc = query.startsWith("?") ? query.substring(1) : query;
        for (String para : tresc.split("&")) {
            if (para.isEmpty()) { continue; }
            int rownosc = para.indexOf('=');
            String klucz = rownosc < 0 ? para : para.substring(0, rownosc);
            String wartosc = rownosc < 0 ? "" : para.substring(rownosc + 1);
            parametry.put(URLDecoder.decode(klucz, StandardCharsets.UTF_8),
                          URLDecoder.decode(wartosc, StandardCharsets.UTF_8));
        }
        return parametry;
    }

    /** Rozkłada adres na części przez java.net.URI; getRaw... oddaje wersję jeszcze zakodowaną. */
    public static String opiszAdres(String adres) {
        URI uri = URI.create(adres);
        int port = uri.getPort();  // -1 oznacza brak portu w adresie, czyli 80 albo 443
        return "schemat=" + uri.getScheme()
                + " | host=" + uri.getHost()
                + " | port=" + (port == -1 ? "domyślny" : String.valueOf(port))
                + " | ścieżka=" + uri.getRawPath()
                + " | query=" + uri.getRawQuery();
    }

    /** Dokleja adres względny, ale odrzuca zmianę schematu lub serwera bazowego. */
    public static String doklejSciezke(String bazowy, String wzgledny) {
        URI baza = URI.create(bazowy);
        URI wynik = baza.resolve(wzgledny);
        if (!baza.isAbsolute() || baza.getRawAuthority() == null
                || !baza.getScheme().equalsIgnoreCase(wynik.getScheme())
                || !baza.getRawAuthority().equalsIgnoreCase(wynik.getRawAuthority())) {
            throw new IllegalArgumentException("Adres względny prowadzi poza serwer bazowy.");
        }
        return wynik.toString();
    }

    // ── PRZYKŁADY ───────────────────────────────────────────
    public static void main(String[] args) {
        Map<String, String> parametry = new LinkedHashMap<>();
        parametry.put("fraza", "żółw ćma");
        parametry.put("miasto", "Łódź");
        parametry.put("sortuj", "cena rosnąco");
        parametry.put("strona", "2");

        String adres = zbudujAdres("https://przyklad.pl/szukaj", parametry);
        System.out.println("adres:    " + adres);
        System.out.println("dopisany: " + zbudujAdres(adres, Map.of("format", "json")));

        // Ten sam tekst w ścieżce wygląda inaczej: %20 zamiast "+"
        System.out.println("parametr: " + kodujParametr("raport marzec 2026.pdf"));
        System.out.println("segment:  " + kodujSegmentSciezki("raport marzec 2026.pdf"));
        System.out.println("ścieżka:  " + zbudujSciezke("pliki", "Łódź", "raport marzec.pdf"));

        // Do rozbierania bierzemy getRawQuery(), czyli wersję jeszcze nie zdekodowaną
        String query = URI.create(adres).getRawQuery() + "&debug&pusty=";
        System.out.println("parametry z adresu:");
        for (Map.Entry<String, String> wpis : rozbijQuery(query).entrySet()) {
            System.out.println("    " + wpis.getKey() + " -> [" + wpis.getValue() + "]");
        }

        System.out.println(opiszAdres("https://api.przyklad.pl:8443/v1/klienci?limit=20&od=2026-01-01"));
        System.out.println(opiszAdres("https://przyklad.pl/szukaj"));

        String katalog = "https://przyklad.pl/dokumenty/2026/";
        System.out.println("względny: " + doklejSciezke(katalog, "raport.pdf"));
        System.out.println("od korzenia: " + doklejSciezke(katalog, "/cennik.pdf"));
        System.out.println("poziom wyżej: " + doklejSciezke(katalog, "../2025/raport.pdf"));
    }
}