Hlavní navigace

HTML report v jazyce Java na pár řádků (dokončení)

1. 5. 2021 8:00 Pavel Ponec

V minulém blogu jsem prezentoval tvorbu tabulkového HTML reportu s AJAX filtrováním a uživatelským řazením sloupců – pomocí několika málo řádků kódu zapsaných do jediného příkazu jazyka Java. Využil jsem k tomu třídu ReportBuilder z frameworku Ujorm. Dnes bych vám rád ukázal, jak lze do buněk takové tabulky vkládat formátovaný obsah a přidám k tomu některá další vylepšení. Jak bude výsledná tabulka vypadat?

Ve filtru přibylo nové vstupní pole pro omezení počtu zobrazených řádků, v tabulce přibyl nový sloupec s pořadovým číslem řádku a odkaz na domovskou stránku hotelu. Hvězdičkovou klasifikaci hotelu vyjádříme výčtem vhodných znaků s tooltipem. Původní chování tabulky zůstalo beze změny, doplněný zdrojový kód je tady:

Poznámky:

  1. Metoda setFormItem() slouží pro vkládání dalších položek do pro formuláře filtru a tady přidáme vstup pro vkládání maximálního počtu řádků.  
  2. Pokud buňka tabulky obsahuje pouze přímý atribut doménového objektu, můžeme využít alternativní zápis funkce podle vzoru: Hotel::getName .
  3. Poslední sloupec tabulky obsahuje aktivní odkaz na internetovou stránku hotelu. Její obsah implementujeme (pomocí lambda výrazu) v metodě write(element, value) rozhraní Column. První parametr metody poskytuje element buňky, druhý parametr poskytuje doménový objekt. Implementace obsahu je tu na nás.
  4. Formátovanou hlavičky vytvoříme překrytím metody write(element) z rozhraní Injector. Metoda poskytuje pouze jeden argument obsahující element buňky. Také v tomto případě lze využít lambda-výraz. Obrázek by šlo přidat do hlavičky nepochybně také vhodným CSS stylem, tahle ukázka však naznačuje obecné řešení.
  5. Jednoduchý sloupec s pořadovým číslem přidáme nejrychleji metodou addOrder(), ale i zde je možné připravit svoji vlastní implementaci využívající metody addColumn().  
  6. Metoda setHtmlHeader() vkládá další kód do HTML hlavičky, doplníme externí referenci kaskádovýh stylů (CSS).
  7. Filtrování pomocí AJAX je defaultně aktivní, metodou setAjaxEnabled() ho však lze vypnout. Změny filtru lze potvrzovat klávesou Enter, ale k položkám filtru lze doplnit i nové submit tlačítko.

Třída TableBuilder umožňuje vkládat do konstruktoru vlastní konfiguraci, která ovlivňuje některé vlastnosti výstupního HTML kódu. Pokud to nestačí, zkuste překrýt některou z metod třídy TableBuilder.

Závěr

Původní inspirací pro API byla třída ListDataProvider, která byla v roce 2014 přidána do  projektu Ujorm – pro tvorbu tabulek frameworku Apache Wicket. Alternativní implementace (bez jakýchkoli závislostí) mi však přišla tak natolik zajímavá, že jsem neodolal pokušení napsat nějakou ukázku řešení. Pokud by měl kdokoli chuť stávající řešení doplnit nějakým vlastním kódem, pro případnou komunikaci doporučuji využít issue na stránce projektu.

Celý projekt je volně dostupný na GitHub. Pro spuštění projektu je třeba JDK verze 8 a webový prohlížeč s podporu Javascript Vanilla ES6, použitý Javascript však už nevyžaduje žádné knihovny.  Projekt se spouští ve Windows skriptem run.cmd (na Linuxu skriptem: run.sh), při prvním startu dojde ke stažení potřebných knihoven.

Užitečné odkazy:

  • Zdrojový kód na GitHub.
  • Odkaz na úvodní blog k tabulkovému reportu.
  • Jednoduché webové stránky s AJAX v jazyce Java na třídě Element (starší blog)
  • JavaDoc třídy Element

Sdílet