iReport & JasperReport配置及用户简明手册

关于iReport和JasperReport的简明手册

By Gem 伍子轩

1安装

1.1 iReport的安装

iReport直接解压后,将J2SDK/lib目录下的tools.jar拷贝到iReport/lib目录下,然后在iReport目录下运行iReport.bat即可。
需要注意的是tools.jar的版本必须要与本机安装的jre一致,也就是说,如果系统安装的是jre1.4.2就必须用jdk1.4.2tools.jar

1.2 JapserReport开发(运行)环境的搭建

JasperReport的开发环境必须要导入以下所有包:

1.  JasperReport包,如jasperreports-0.6.1.jar

2.  Aparche Common包,包括loggingdigesterbeanutilscollectionslogging-api

3.  iText包,包括itext-1.1.jariTextAsian.jar(用于输出中文字符到PDF文件)

以上所有包(除了iTextAsian.jar)都已经包含在iReport/lib目录下。

2 开发流程

iReport可视化编辑生成的文件是jrxml文档,这是一种xml文件,记录了一份report的详细信息,我们可以直接用写字板打开它编辑,iReport就是一个方便我们生成和编辑jrxml文件的工具,它也可以很方便地将jrxml文件编译成jasper报表文件。

jrxml文件通过Jasper编译之后就变成了jasper文件,这份文件才是真正在程序中调用生成报表的report文件。

但是有一点要注意的是,jasper的各个版本编译出来的jasper文件并不兼容,就是说用0.6.1版编译出来的文件用0.6.4版调用是会出错的,而iReport自带的Jasper版本是0.6.1,而jasper的最新版本是0.6.4。所以为了保持通用性,我建议只用iReport来开发编辑jrxml文件,而不编译成jasper文件,在我们的打印报表程序中再即时编译一次。虽然这样效率可能会低了一点,但是保证了不同版本的兼容性。

在我们的程序中,要调用Jasper的话,首先要得到一个数据库的Connection,形如:Connection con = ...

需要往JasperReport传参数的话只需要新建一个Map,以参数名作为key,需要传入的对象作为value,譬如:

Map props = new HashMap();

      props.put("name", new String("name"));

需要多个参数只需分别putMap里去就可以了。

JasperReport有如下几个主要的Manager

JasperCompileManager

jrxml文件编译成jasper文件或JasperReport对象

JasperFillManager

从数据源中获取数据并填充jasper文件或JasperReport对象,产生JasperPrint对象

JasperPrintManager

JasperPrint对象直接输出到打印机打印

JasperExportManager

JasperPrint对象导出成PDFHTML文件(或流)

JasperRunManager

运行一个jasper文件或JasperReport对象并输出到PDFHtml文件(或流)中,我的理解是等于集成了JasperFillManagerJasperExportManager的功能

对于上述对象的详细说明请参阅JasperReport的文档。

例程:

例程:

public static void main(String[] args) {

    try {

      Class.forName("org.gjt.mm.mysql.Driver");

      Connection con = DriverManager.getConnection(

          "jdbc:mysql://wes:3306/umpdb?useUnicode=true&characterEncoding=GBK", "root", "elite");

      File f1 = new File("Account.jrxml");

      File f2 = new File("Contact.jrxml");

      JasperReport main = JasperCompileManager.compileReport(f1

          .getAbsolutePath());

      JasperReport report = JasperCompileManager.compileReport(f2

          .getAbsolutePath());

      Map props = new HashMap();

      props.put("subreport", report);

      JasperPrint print = JasperFillManager.fillReport(main, props,con);

      //JasperPrintManager.printReport(print,true);

      JasperExportManager.exportReportToPdfFile(print, "a.pdf");

      //JasperRunManager.runReportToPdfFile("Account.jasper", "a.pdf", props, con);

    } catch (ClassNotFoundException e) {

      // TODO 自动生成 catch

      e.printStackTrace();

    } catch (SQLException e) {

      // TODO 自动生成 catch

      e.printStackTrace();

    } catch (JRException e) {

      // TODO 自动生成 catch

      e.printStackTrace();

    }

  }

3 注意事项

1iReport中新建中文报表的时候记得要输入XML编码GB2312

2iReport中定义中文字体的时候,要选择PDF Font NameSTSong-Light(宋体)、MHei-Medium(黑体)、MSung-Light,在PDF Encoding中选择GB-UCS2-H(Chinese Simplified),否则输出到PDF时会乱码。

3.用Report SQL查询之后,可能会出现某些字段没有自动建立Field,就需要在Field中手动定义了。

 

1安装

1.1 iReport的安装

iReport直接解压后,将 J2SDK/lib目录下的 tools.jar拷贝到 iReport/lib目录下,然后在 iReport目录下运行 iReport.bat即可。
需要注意的是 tools.jar的版本必须要与本机安装的 jre一致,也就是说,如果系统安装的是 jre1.4.2就必须用 jdk1.4.2tools.jar

1.2 JapserReport开发(运行)环境的搭建

JasperReport的开发环境必须要导入以下所有包:

1.  JasperReport包,如jasperreports-0.6.1.jar

2.  Aparche Common包,包括loggingdigesterbeanutilscollectionslogging-api

3.  iText包,包括itext-1.1.jariTextAsian.jar(用于输出中文字符到PDF文件)

以上所有包(除了iTextAsian.jar)都已经包含在iReport/lib目录下。

2 开发流程

iReport可视化编辑生成的文件是jrxml文档,这是一种xml文件,记录了一份report的详细信息,我们可以直接用写字板打开它编辑,iReport就是一个方便我们生成和编辑jrxml文件的工具,它也可以很方便地将jrxml文件编译成jasper报表文件。

jrxml文件通过Jasper编译之后就变成了jasper文件,这份文件才是真正在程序中调用生成报表的report文件。

但是有一点要注意的是,jasper的各个版本编译出来的jasper文件并不兼容,就是说用0.6.1版编译出来的文件用0.6.4版调用是会出错的,而iReport自带的Jasper版本是0.6.1,而jasper的最新版本是0.6.4。所以为了保持通用性,我建议只用iReport来开发编辑jrxml文件,而不编译成jasper文件,在我们的打印报表程序中再即时编译一次。虽然这样效率可能会低了一点,但是保证了不同版本的兼容性。

在我们的程序中,要调用Jasper的话,首先要得到一个数据库的Connection,形如:Connection con = ...

需要往JasperReport传参数的话只需要新建一个Map,以参数名作为key,需要传入的对象作为value,譬如:

Map props = new HashMap();

      props.put("name", new String("name"));

需要多个参数只需分别putMap里去就可以了。

JasperReport有如下几个主要的Manager

JasperCompileManager

jrxml文件编译成jasper文件或JasperReport对象

JasperFillManager

从数据源中获取数据并填充jasper文件或JasperReport对象,产生JasperPrint对象

JasperPrintManager

JasperPrint对象直接输出到打印机打印

JasperExportManager

JasperPrint对象导出成PDFHTML文件(或流)

JasperRunManager

运行一个jasper文件或JasperReport对象并输出到PDFHtml文件(或流)中,我的理解是等于集成了JasperFillManagerJasperExportManager的功能

对于上述对象的详细说明请参阅JasperReport的文档。

例程:

例程:

public static void main(String[] args) {

    try {

      Class.forName("org.gjt.mm.mysql.Driver");

      Connection con = DriverManager.getConnection(

          "jdbc:mysql://wes:3306/umpdb?useUnicode=true&characterEncoding=GBK", "root", "elite");

      File f1 = new File("Account.jrxml");

      File f2 = new File("Contact.jrxml");

      JasperReport main = JasperCompileManager.compileReport(f1

          .getAbsolutePath());

      JasperReport report = JasperCompileManager.compileReport(f2

          .getAbsolutePath());

      Map props = new HashMap();

      props.put("subreport", report);

      JasperPrint print = JasperFillManager.fillReport(main, props,con);

      //JasperPrintManager.printReport(print,true);

      JasperExportManager.exportReportToPdfFile(print, "a.pdf");

      //JasperRunManager.runReportToPdfFile("Account.jasper", "a.pdf", props, con);

    } catch (ClassNotFoundException e) {

      // TODO 自动生成 catch

      e.printStackTrace();

    } catch (SQLException e) {

      // TODO 自动生成 catch

      e.printStackTrace();

    } catch (JRException e) {

      // TODO 自动生成 catch

      e.printStackTrace();

    }

  }

3 注意事项

1iReport中新建中文报表的时候记得要输入XML编码GB2312

2iReport中定义中文字体的时候,要选择PDF Font NameSTSong-Light(宋体)、MHei-Medium(黑体)、MSung-Light,在PDF Encoding中选择GB-UCS2-H(Chinese Simplified),否则输出到PDF时会乱码。

3.用Report SQL查询之后,可能会出现某些字段没有自动建立Field,就需要在Field中手动定义了。

 

你可能感兴趣的:(开源项目,report,hashmap,collections,报表,file,string)