JasperReport檢視和列印報告


報表填充過程JasperPrint物件的輸出可以使用內建的瀏覽器元件來檢視,列印或匯出到更多的流行的檔案格式,如PDF,HTML,RTF,XLS,ODT,CSV或XML。Jasper檔案檢視和列印將包括在本章中。匯出將包括在下一章匯出報表.

檢視報表

JasperReport提供了一個內建的瀏覽器觀看原始格式生成的報表。這是一個基於Swing的元件和其他Java應用程式可以無需將文件匯出為其他格式,以便檢視或列印此整合元件。net.sf.jasperreports.view.JRViewer類表示這個可視元件。這個類也可以被客製化為每個應用程式的需要,通過繼承它。

JasperReports也有用來檢視報表的視覺化元件Swing應用程式。此應用程式可以幫助在相同的格式檢視報表為*.jrprint就產生了。這個Swing應用程式是在類net.sf.jasperreports.view.JasperViewer實現。要使用此功能,我們可以把這個包成一個Ant目標,以檢視報表。

檢視生成的報告

下面的範例演示如何檢視使用JasperViewer類的報表。

讓我們來寫一個報告模板。在JRXML檔案(C: oolsjasperreports-5.0.1 estjasper_report_template.jrxml)的內容如下:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN"
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">
<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="jasper_report_template" language="groovy" pageWidth="595"
pageHeight="842" columnWidth="555" leftMargin="20" rightMargin="20"
topMargin="20" bottomMargin="20">

    <queryString>
	<![CDATA[]]>
    </queryString>
    <field name="country" class="java.lang.String">
        <fieldDescription><![CDATA[country]]></fieldDescription>
    </field>
    <field name="name" class="java.lang.String">
        <fieldDescription><![CDATA[name]]></fieldDescription>
    </field>
    <columnHeader>
     <band height="23">
	<staticText>
	    <reportElement mode="Opaque" x="0" y="3" width="535"
		 height="15" backcolor="#70A9A9" />
	    <box>
	        <bottomPen lineWidth="1.0" lineColor="#CCCCCC" />
	    </box>
	    <textElement />
	    <text><![CDATA[]]> </text>
	</staticText>
	<staticText>
	    <reportElement x="414" y="3" width="121" height="15" />
	    <textElement textAlignment="Center"
	        verticalAlignment="Middle">
		<font isBold="true" />
	    </textElement>
	    <text><![CDATA[Country]]></text>
	</staticText>
	<staticText>
	    <reportElement x="0" y="3" width="136" height="15" />
	    <textElement textAlignment="Center"
	        verticalAlignment="Middle">
		<font isBold="true" />
	    </textElement>
	    <text><![CDATA[Name]]></text>
	</staticText>
     </band>
    </columnHeader>
    <detail>
        <band height="16">
	 <staticText>
	     <reportElement mode="Opaque" x="0" y="0" width="535"
		 height="14" backcolor="#E5ECF9" />
	     <box>
	            <bottomPen lineWidth="0.25" lineColor="#CCCCCC" />
	     </box>
	     <textElement />
	     <text><![CDATA[]]> </text>
	 </staticText>
	 <textField>
	     <reportElement x="414" y="0" width="121" height="15" />
	     <textElement textAlignment="Center"
	         verticalAlignment="Middle">
		 <font size="9" />
	     </textElement>
	     <textFieldExpression class="java.lang.String">
	         <![CDATA[$F{country}]]>
		</textFieldExpression>
	 </textField>
	 <textField>
	     <reportElement x="0" y="0" width="136" height="15" />
	     <textElement textAlignment="Center"
	         verticalAlignment="Middle" />
	         <textFieldExpression class="java.lang.String">
			<![CDATA[$F{name}]]>
	         </textFieldExpression>
	 </textField>
        </band>
    </detail>
</jasperReport>

接下來,讓我們通過Java資料物件(Java bean)的集合,到Jasper報表引擎,填補了這一編譯報告。

寫一個POJO DataBean.java表示資料物件(的Java bean)。這個類定義了兩個字串物件name和country。把它儲存到目錄 C: oolsjasperreports-5.0.1 estsrccomyiibai.

package com.yiibai;

public class DataBean {
   private String name;
   private String country;

   public String getName() {
      return name;
   }

   public void setName(String name) {
      this.name = name;
   }

   public String getCountry() {
      return country;
   }

   public void setCountry(String country) {
      this.country = country;
   }
}

編寫一個類DataBeanList.java具有業務邏輯生成java bean物件的集合。這是進一步傳遞到Jasper 報表引擎,生成報告。在這裡,我們新增在列表中的4個DataBean進行物件。把它儲存到目錄C: oolsjasperreports-5.0.1 estsrccomyiibai.

package com.yiibai;

import java.util.ArrayList;

public class DataBeanList {
   public ArrayList<DataBean> getDataBeanList() {
      ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>();

      dataBeanList.add(produce("Manisha", "India"));
      dataBeanList.add(produce("Dennis Ritchie", "USA"));
      dataBeanList.add(produce("V.Anand", "India"));
      dataBeanList.add(produce("Shrinath", "California"));

      return dataBeanList;
   }

   /**
    * This method returns a DataBean object,
    * with name and country set in it.
    */
   private DataBean produce(String name, String country) {
      DataBean dataBean = new DataBean();
      dataBean.setName(name);
      dataBean.setCountry(country);
      return dataBean;
   }
}

寫一個主類檔案JasperReportFill.java,它從類(DataBeanList)得到的java bean的集合,並將其傳遞到Jasper報表引擎,填補了報告模板。把它儲存到目錄 C: oolsjasperreports-5.0.1 estsrccomyiibai.

package com.yiibai;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;

import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperFillManager;
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;

public class JasperReportFill {
   @SuppressWarnings("unchecked")
   public static void main(String[] args) {
      String sourceFileName =
         "c://tools/jasperreports-5.0.1/test/jasper_report_template.jasper";
      DataBeanList DataBeanList = new DataBeanList();
      ArrayList<DataBean> dataList = DataBeanList.getDataBeanList();

      JRBeanCollectionDataSource beanColDataSource =
      new JRBeanCollectionDataSource(dataList);

      Map parameters = new HashMap();
      try {
         JasperFillManager.fillReportToFile(
         sourceFileName,
         parameters,
         beanColDataSource);
      } catch (JRException e) {
         e.printStackTrace();
      }
   }
}
讓我們來寫一個目標viewFillReport的build.xml檔案。 build.xml檔案如下所示:
匯入檔案 - baseBuild.xml環境設定,並應放置在同一目錄中的build.xml。
<?xml version="1.0" encoding="UTF-8"?>
<project name="JasperReportTest" default="viewFillReport" basedir=".">
   <import file="baseBuild.xml"/>

   <target name="viewFillReport" depends="compile,compilereportdesing,run"
      description="Launches the report viewer
      to preview the report stored in the .JRprint file.">
      <java classname="net.sf.jasperreports.view.JasperViewer" fork="true">
         <arg value="-F${file.name}.JRprint" />
         <classpath refid="classpath" />
      </java>
   </target>
   <target name="compilereportdesing"
      description="Compiles the JXML file and
      produces the .jasper file.">
      <taskdef name="jrc"
      classname="net.sf.jasperreports.ant.JRAntCompileTask">
         <classpath refid="classpath" />
      </taskdef>
      <jrc destdir=".">
         <src>
         <fileset dir=".">
            <include name="*.jrxml" />
         </fileset>
         </src>
         <classpath refid="classpath" />
      </jrc>
   </target>
</project>

接下來,讓我們開啟命令列視窗並轉到build.xml檔案放置的目錄。最後執行的命令 ant -Dmain-class=com.yiibai.JasperReportFill(viewFillReport是預設的目標)。因此,我們看到一個JasperViewer視窗,如下面的螢幕:

Jasper Report Viewer

列印報表

我們可以使用net.sf.jasperreports.engine.JasperPrintManager類列印的JasperReports類庫生成的檔案(在他們的專有格式i.eJasperPrint物件)。這是依賴於Java2 API列印一個假象類。我們還可以列印文件,一旦JasperReport的文件匯出為其他格式,如HTML或PDF。

列印生成的報告

下面的程式碼演示報表的列印。讓我們更新現有的類JasperReportFill。我們將使用JasperPrintManager.printReport()方法。此方法需要原始檔名.jrprint(這裡我們通過我們在上一步生成的使用方法JasperFillManager.fillReportToFile())作為第一個引數。第二個引數是布林值,用於顯示標準列印對話方塊(我們將其設定為true這裡)。

package com.yiibai;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;

import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperFillManager;
import net.sf.jasperreports.engine.JasperPrintManager;
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;

public class JasperReportFill {
   @SuppressWarnings("unchecked")
   public static void main(String[] args) {
      String sourceFileName = "c://tools/jasperreports-5.0.1/" +
      		"test/jasper_report_template.jasper";
      String printFileName = null;
      DataBeanList DataBeanList = new DataBeanList();
      ArrayList dataList = DataBeanList.getDataBeanList();

      JRBeanCollectionDataSource beanColDataSource =
      new JRBeanCollectionDataSource(dataList);

      Map parameters = new HashMap();
      try {
    	  printFileName = JasperFillManager.fillReportToFile(
         sourceFileName,
         parameters,
         beanColDataSource);
         if(printFileName != null){
           JasperPrintManager.printReport(
               printFileName, true);
      }
      } catch (JRException e) {
         e.printStackTrace();
      }
   }
}

現在,讓我們將此檔案儲存到目錄C: oolsjasperreports-5.0.1 estsrccomyiibai. 我們將使用ANT編譯並執行此檔案.build.xml檔案的內容如下:

<?xml version="1.0" encoding="UTF-8"?>
<project name="JasperReportTest" default="executereport" basedir=".">
   <import file="baseBuild.xml"/>

   <target name="executereport"
   depends="compile,compilereportdesing,run">
        <echo message="Im here"/>
   </target>
    <target name="compilereportdesing"
         description="Compiles the JXML file and
         produces the .jasper file.">
         <taskdef name="jrc"
         classname="net.sf.jasperreports.ant.JRAntCompileTask">
            <classpath refid="classpath" />
         </taskdef>
         <jrc destdir=".">
            <src>
            <fileset dir=".">
               <include name="*.jrxml" />
            </fileset>
            </src>
            <classpath refid="classpath" />
         </jrc>
   </target>
</project>

接下來,讓我們開啟命令提示字元並轉到build.xml檔案放置的目錄。最後,執行命令 ant -Dmain-class=com.yiibai.JasperReportPrint. 因此,會出現一個列印對話方塊。單擊確定以列印文件。