Print Builder

From PlcWiki

Contents 1 Popis 2 Integrace 3 Vytvoření PDF 3.1 Fonty

Popis

Webové řešení tvorby souborů PDF postavené na základě projektu Apache FOP (Formatting Objects Processor).

svn+ssh://user@oko.clever.cz: java/PrintBuilder

Cílem je umožnit tvorbu HTML formulářů, jejichž položky se pouze odešlou jako URL parametry na servlet a "voilá" dokument PDF je hotov a připraven k vytisknutí.

Integrace

Příklady použití

• Volání servletu metodou POST, který je nasazen samostatně na nějakém dostupném serveru
• Integrace pomocí forwardu - RequestDispatcher (obě aplikace jsou nasazeny na stejném Tomcatu)

context.xml

<Context crossContext="true">

Vytvoření PDF

• Vytvoření šablony XSL a její umístění do adresáře na který se odkazuje web.xml parametrem "templatedir"
• Název šablony (název souboru) figuruje v parametru URL "templatename" (bez extenze)
• Data určená k vyplnění šablony se posílají buď přímo v URL paramentru "xmldata" formou xml dokumentu, nebo jsou použity všechny parametry URL, kde potom klíčem je tag a hodnotou je text

Příklad URL:

localhost:8080/PrintBuilder/Untitled?templatename=my_template
&singleTAG=first&singleTAG=second
&food[0]=milk&food[0]=egg&vehicle[0]=renault&vehicle[0]=mercedes
&food[1]=onion&food[1]=potato&vehicle[1]=fiat&vehicle[1]=subaru

Ilustrace jak by toto URL vypadalo v Javě:

map.put("singleTAG", new String[] { "first", "second" });
map.put("food[0]", new String[] { "milk", "egg" });
map.put("vehicle[0]", new String[] { "renault", "mercedes" });
map.put("food[1]", new String[] { "onion", "potato" });
map.put("vehicle[1]", new String[] { "fiat", "subaru" });

Výsledné XML na serveru:

<root>
  <list>
    <singleTAG>first</singleTAG>
    <part><vehicle>fiat</vehicle><food>onion</food></part>
    <part><food>milk</food><vehicle>renault</vehicle></part>
  </list>
  <list>
    <singleTAG>second</singleTAG>
    <part><vehicle>subaru</vehicle><food>potato</food></part>
    <part><food>egg</food><vehicle>mercedes</vehicle></part>
  </list>
</root>

Tag "list" představuje jednu stránku v PDF a tag "part" je výčet hodnot.

V šabloně by se iterovalo přibližně takto:

<xsl:for-each select="list">
  <xsl:value-of select="singleTAG"/>
  <xsl:for-each select="part">
    <xsl:value-of select="vehicle"/>
    ...
  </xsl:for-each>
</xsl:for-each>

Fonty

Aby fungovala správně česká diakritika, musí konfigurační soubor fop.xconf obsahovat správné cesty k ttf fontům OS a popis jejich metrik včetně příslušných xml souborů.