Beispiel: Ausdrucken mittels JasperReports

Anlegen einer Report-Definition

<?xml version="1.0" encoding="UTF-8"?>
<jasperReport ...
	....
	<field name="nachname" class="java.lang.String">
	</field>
	<field name="vorname" class="java.lang.String">
	</field>

Report goes Programm

      net.sf.jasperreports.engine.JasperReport js = 
        net.sf.jasperreports.engine.JasperCompileManager.compileReport("beandatasourcereport.jrxml");

<project name="JasperReportsTeste" default="compile" basedir=".">
	<description>Compiliert *.jasper-Dateien aus allen *.jrxml-Dateien.</description>

	<path id="classpath">
		<!--Alle JASPER-Jars einbinden! -->
		<fileset dir="C:/temp/jasperreports/lib">
			<include name="**/*.jar"/>
		</fileset>
		<fileset dir="C:/temp/jasperreports/dist">
			<include name="**/*.jar"/>
		</fileset>
	</path>


	<target name="compile">
		<taskdef name="jrc" classname="net.sf.jasperreports.ant.JRAntCompileTask"> 
			<classpath refid="classpath"/>
		</taskdef>
		<jrc 
			destdir="."
			tempdir="."
			keepjava="false">
			<src>
				<fileset dir=".">
					<include name="**/*.jrxml"/>
				</fileset>
			</src>
			<classpath refid="classpath"/>
		</jrc>
	</target>
</project>

      net.sf.jasperreports.engine.JasperPrint jp = 
          net.sf.jasperreports.engine.JasperFillManager.fillReport("beandatasourcereport.jasper", new HashMap(), dataSource);

      net.sf.jasperreports.engine.JasperCompileManager.compileReportToFile("beandatasourcereport.jrxml","beandatasourcereport.jasper");

Beispiel 1: JavaBean als Datenquelle

Beispiel 2: XML-DataSource

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<questioncatalogue CREATOR_ID="42" ID="73537353" NAME="Romane">
  <questionset ID="13371337">
    <question>Wie heißen die Autoren von Märchenmond?</question>
    <answers>
      <answer ID="17841234___37" TRUTH="false">Die Gebrüder Grimm - 13371337</answer>
      <answer ID="12341454___37" TRUTH="true">Wolfgang und Heike Hohlbein - 13371337</answer>
      <answer ID="123445634___37" TRUTH="false">Richard von Weizäcker - 13371337</answer>
      <answer ID="121234___37" TRUTH="false">Terry Pratchett - 13371337</answer>
    </answers>
  </questionset>
   <questionset ID="13371338">
    <question>...</question>
	...

<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
		xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports http://jasperreports.sourceforge.net/xsd/jasperreport.xsd" 
		name="romanereport"...">
	...
	<queryString language="xPath"><![CDATA[/questioncatalogue/questionset]]></queryString>

	<field name="question" class="java.lang.String">
		<fieldDescription><![CDATA[question]]></fieldDescription>
	</field>

	<field name="questionsetid" class="java.lang.String">
		<fieldDescription><![CDATA[@ID]]></fieldDescription>
	</field>
	...
	

	<textField isStretchWithOverflow="true">
		<reportElement positionType="Float" x="0" y="0" width="200" height="20"/>
		<textElement/>
		<textFieldExpression class="java.lang.String"><![CDATA[$F{answerid}]]></textFieldExpression>
	</textField>

	<subreport isUsingCache="false">
		<reportElement x="32" y="25" width="445" height="20" key="subreport-1" />
		
		<subreportParameter name="XML_DATA_DOCUMENT">
			<subreportParameterExpression>$P{XML_DATA_DOCUMENT}</subreportParameterExpression>
		</subreportParameter>


		<subreportParameter name="QuestionSetID">
			<subreportParameterExpression>$F{questionsetid}</subreportParameterExpression>
		</subreportParameter>


		<subreportExpression class="java.lang.String"><![CDATA["answerreport.jasper"]]></subreportExpression>
	</subreport>

• Der Subreport wird über ein Element "subreport" deklariert.
  
  
• Dieses hat ein Unterelement "reportElement", das x/y-Position und Höhe definiert. Wie man im Beispiel sieht, vergrößert er sich automatisch, wenn er mehr Daten hat, als auf "20 Pixel" gehen.
  
  
• Wichtig ist, dass man dem dem Subreport zwei Parameter mitgibt:
  
  • Parameter 1 ist ist die Datenquelle. Diese wird programmatisch gesetzt (siehe weiter unten), und ist als Parameter namens "XML_DATA_DOCUMENT" im Report zu finden:

    <subreportParameterExpression>$P{XML_DATA_DOCUMENT}</subreportParameterExpression>

    Wichtig ist, dass man diesen Parameter unter dem gleichen Namen "XML_DATA_DOCUMENT" weitergibt.
    
    Eine Liste dieser Parameter findet man z.B. im IReport im Fenster "Report Inspector":
    
    
    
  • Parameter 2 ist sozusagen der Primary Key des aktuellen Detail-Elements, also die ID des aktuellen QuestionSet, und dieses holen wir aus dem entsprechenden Field:

    <subreportParameterExpression>$F{questionsetid}</subreportParameterExpression>

    
    
• Außerdem muss die Reportdatei (".jasper", NICHT ".jrxml") des Subreports definiert werden:
  

  <subreportExpression class="java.lang.String"><![CDATA["answerreport.jasper"]]></subreportExpression>

• Es wird ein Parameter "QuestionSetID" definiert, der den Primärschlüssel angibt, anhand derer der Subreport seine Daten ermittelt:
  

    <parameter name="QuestionSetID" class="java.lang.String"/>

• Der Query-String sicht hier explizit das QuestionSet mit dieser übergebenen ID (Parameter-Referenz). Innerhalb dieses Elements werden die "answers" durchlaufen, und hiervon die Elemente "answer" (genauso wie im Hauptreport wird hier also der Pfad inklusive des Childelements angegeben, über das wir laufen wollen:
  pre><queryString language="xPath"><![CDATA[/questioncatalogue/questionset[@ID='$P{QuestionSetID}']/answers/answer]]></queryString>
• Die aktuelle Antwort ist der Textinhalt von "answer", also dem aktuellen XPath-Element. Deshalb ist der XPath-Ausdruck nur ein Punkt, also "aktueller Pfad":
  

  	<field name="answer" class="java.lang.String">
  		<fieldDescription><![CDATA[.]]></fieldDescription>
  	</field>

• Und die Antwort hat ein Attribut "ID", das wir ausgeben wollen:
  

  	<field name="answerid" class="java.lang.String">
  		<fieldDescription><![CDATA[@ID]]></fieldDescription>
  	</field>
    

      Map<String, Object> params = new HashMap<String, Object>();
      Document document = JRXmlUtils.parse(JRLoader.getLocationInputStream("romane.xml"));
      params.put(JRXPathQueryExecuterFactory.PARAMETER_XML_DATA_DOCUMENT, document);
      
      JasperPrint print = JasperFillManager.fillReport("romanereport.jasper", params);
      
      JRViewer viewer = new JRViewer(print);