Print Builder

From PlcWiki

Current revision as of 13:00, 5 June 2012

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 (odkazuje se na něj web.xml) obsahovat správné cesty k TTF fontům OS a popis jejich metrik včetně příslušných xml souborů. Pokud používáte Linux a nemáte české TTF fonty, můžete si je stáhnout z adresy http://corefonts.sourceforge.net/.

Příklad odkazu na konfiguraci FOPu - web.xml

 <init-param>
	        <param-name>fopconfig</param-name>
		<param-value>conf/fop.xconf</param-value>
 </init-param>

Příklad cest k fontům v systému MS Windows ve fop.xconf

 <!ENTITY fop.home "file:///C:/Program Files/Apache Software Foundation/Tomcat 7.0/webapps/PrintBuilder/">
 <!ENTITY fonts.dir "file:///c:/Windows/Fonts">

První řádek říká FOPu kde má hledat adresář conf se soubory metrik.

Odkazy

• http://www.kosek.cz/xml/xslt/vyrazy.htm
• http://xmlgraphics.apache.org/fop/examples.html