Převod souboru JSPX do PDF

Java webová aplikace může potřebovat doručit report vygenerovaný pomocí JSPX jako pevný soubor pro tisk, sdílení nebo archivaci. Stránka musí být nejprve vykreslena jejím Java serverem; přejmenování zdrojového souboru na .pdf jej nepřevede.

Co je formát JSPX

JSPX je syntaxe založená na XML pro dokument JavaServer Pages (JSP). Může obsahovat značky XML, prvky JSP, výrazový jazyk, prvky vlastních knihoven značek a odkazy na CSS, JavaScript, obrázky a data aplikace. Java webové aplikace používají soubory .jspx pro stránky generované serverem, včetně projektů vytvořených pomocí Java EE, Jakarta EE a nástrojů, jako je Oracle JDeveloper.

Soubor obvykle zpracovává servletový kontejner, jako je Apache Tomcat nebo Jetty, případně kompletní server Jakarta EE. Server vyhodnotí prvky JSP, přistoupí k datům aplikace a vrátí prohlížeči HTML. Přímé otevření zdrojového souboru JSPX obvykle zobrazí XML nebo stáhne zdrojový kód, místo aby zobrazilo dokončenou stránku.

Co je formát PDF

PDF ukládá vykreslený text, grafiku, fonty a rozvržení stránky v přenosném formátu dokumentu, který je do značné míry nezávislý na operačním systému a aplikaci, ve které byl vytvořen. Je vhodný pro distribuci reportu, když příjemci potřebují stabilní soubor pro tisk, kontrolu, evidenci nebo offline přístup.

Výsledný PDF obsahuje stránku v podobě, v jaké byla vykreslena v době převodu; nezachovává serverovou logiku JSP, připojení k databázi, relace, zpracování požadavků ani interaktivní chování původní aplikace. HTML formuláře, ovládací prvky JavaScriptu a odkazy vyžadující aktivní přihlášení se mohou stát statickými nebo nepoužitelnými.

Jak převést stránku JSPX do PDF

Vytiskněte vykreslenou stránku z prohlížeče

1. Nasaďte aplikaci obsahující soubor JSPX na určený server, například Tomcat, Jetty nebo server Jakarta EE, a tento server spusťte.
2. Otevřete úplnou adresu URL stránky, například http://localhost:8080/app/report.jspx. Před tiskem se přihlaste a vyberte parametry nebo filtry reportu.
3. V prohlížeči Chrome nebo jiném prohlížeči založeném na Chromiu zvolte Menu → Print, vyberte Save to PDF, nastavte velikost papíru, orientaci, okraje a měřítko, v případě potřeby povolte Background graphics a soubor uložte.

Firefox poskytuje podobný postup Print → Print to File. Tisk z prohlížeče je obvykle nejpraktičtější desktopovou metodou, protože prohlížeč před vytvořením PDF spustí JavaScript stránky a použije její CSS.

Vykreslete ji pomocí headless Chromia

U veřejně přístupné stránky nebo stránky bez ověřování může prohlížeč založený na Chromiu vytvořit PDF bez otevření okna:

chromium --headless --print-to-pdf=report.pdf http://localhost:8080/app/report.jspx

Použijte URL aplikace, která se již úspěšně načítá v běžném prohlížeči. Stránky vyžadující přihlášení, session cookies, data POST nebo interakci uživatele potřebují browser automation, například Playwright nebo Selenium, aby bylo možné provést ověření, navigaci, počkat na načtení stránky a vyvolat funkci prohlížeče pro vytváření PDF. Nevystavujte přihlašovací údaje ani soukromá data aplikace v příkazovém řádku nebo v URL.

Použijte online službu pro převod URL do PDF

Renomovaná služba pro vykreslování URL, jako je PDFCrowd nebo PDFShift, může zpracovat stránku JSPX pouze tehdy, když je stránka dostupná ze serverů této služby, obvykle prostřednictvím veřejné URL. Tyto služby zpravidla nemohou přistupovat k místnímu nasazení localhost nebo k internímu serveru, pokud není záměrně zpřístupněn. Nemusí také podporovat autentizační procesy, stav relace, reporty dostupné pouze prostřednictvím POST nebo stránky vyžadující interakci uživatele.

U důvěrných reportů, chráněných stránek nebo soukromých URL aplikace použijte místní tisk z prohlížeče nebo místní headless Chromium. Nenahrávejte zdroj JSPX, přihlašovací údaje, session cookies ani citlivé URL reportů do konvertoru třetí strany.

Omezení kvality a kompatibility

PDF odráží to, co server a vykreslující prohlížeč vytvoří v době převodu. Chybějící webové fonty, zablokované obrázky, nesprávné relativní cesty, nepodporované CSS, neúspěšné síťové požadavky a neúplný asynchronní obsah mohou změnit výstup. Před tiskem počkejte na grafy, obrázky a data načtená pomocí AJAX; automatizované workflow by mělo čekat na konkrétní selektor nebo na vhodný stav network-idle.

Pro řízení stránkování přidejte CSS určené pro tisk, například @media print, break-before, break-after a break-inside. Pokud jsou barevné panely nebo pozadí součástí návrhu, povolte background graphics. PDF vytvořená prohlížečem mohou nahradit proprietární fonty, rozdělit tabulky nebo obsah mezi stránky a vynechat chování závislé na aktivní serverové relaci.