运算报表

报表制作完成后，还可进行各种运算。如读入报表、计算报表、展现报表等。

读入报表

必须通过ReportUtils.read()读入报表，read()方法提供两种读入报表的方式，第一种直接传入报表的绝对路径，另一种为构建一个文件输入流，如下：

◆ 文件方式读入：

String reportFile = “C:/api/reportFiles/wangge.rpx”;  //该文件名可以为绝对路径，也可以相对当前程序启动路径

ReportDefine rd = (ReportDefine)ReportUtils.read( reportFile );

◆ 文件流方式读入：

InputStream is = ……. ;  //获取一个报表输入流，如new FileInputStream(“报表路径”);

ReportDefine rd = (ReportDefine)ReportUtils.read(is);

计算报表

◆ 核心计算代码：

Context cxt = new Context();  //构建报表引擎计算环境

//.......................... //其它辅助代码，例如往报表引擎传递参数，传递数据库连接参数等，见后面的介绍

ReportDefine rd = (ReportDefine)ReportUtils.read( reportFile );

Engine engine = new Engine(rd, cxt);  //构造报表引擎

IReport iReport = engine.calc();  //运算报表

◆ 参数传递：

ParamMetaData pmd = rd.getParamMetaData();  //从报表定义中取得参数元对象ParamMetaData

String paramOrMocrName = "";

if(pmd != null){

for(int i = 0, count = pmd.getParamCount(); i < count; i ++ ) {   //讲究优化的写法

paramOrMocrName = pmd.getParam(i).getParamName();  //获取参数名

cxt.setParamValue(paramOrMocrName, request.getParameter(paramOrMocrName)); //设参数值

}}

◆添加JNDI的数据源配置

ReportServlet.addJNDIDsConfig("sqlsvr,sqlsvr,1,iso8859-1,GBK,0", "java:comp/env", true);

◆ 直接传递con，改变数据源连接：

//取得数据源

Connection connection = null;

try{

Driver driver = (Driver) Class.forName("org.hsqldb.jdbcDriver").newInstance();

DriverManager.registerDriver(driver);

con= DriverManager.getConnection("jdbc:hsqldb:hsql://localhost/demo","sa","");

}catch (Exception e){

e.printStackTrace();  }

String defDsName = cxt.getDefDataSourceName ();

if (defDsName != null) cxt.setConnection(defDsName, con);  //这样设定默认数据源

cxt.setConnection("dsName",con);   //也可以直接指定某个已经的数据源，设置其con

◆ 指定另一个系统数据源名称，从而改变数据源连接

cxt.setDefDataSourceName("demo");  //改变缺省数据源名称

◆ 通过数据源工厂改变数据源连接

IConnectionFactory connFactory=......;  //构造数据源工厂类，一般为自定义类

cxt.setConnectionFactory(sourceName,connFactory);

//其中connFactory这个类必须实现IConnectionFactory接口,并且实现他的public //java.sql.Connection getConnection() throws Exception 方法

◆ 直接传递数据库连接参数，改变数据源连接

DataSourceDefine dsoc=new DataSourceDefine();

dsoc.setDriver(......);  //设置jdbc的驱动

dsoc.setCaseSentence(......);  //设置sql的大小写是否无关，指表名字段名等

dsoc.setDSType(......);  //设置数据源类型，如DataSource.TYPE_RELATIONAL, DataSource.TYPE_ODBC等

dsoc.setExtend(......);  //设置数据库的扩展属性

dsoc.setName(......);  //设置数据源名

dsoc.setPassword(......);  //设置数据库连接密码

dsoc.setUser(......);  //设置数据库访问用户名

dsoc.setUrl(......);  //设置Jdbc的url

dsoc.setUseSchema(......);  //设置是否使用模式

dsoc.setClientCharset(......);  //设置客户端的字符集

dsoc.setDBCharset(......);  //设置数据库的字符集

dsoc.setDBType(......);  //设置数据库类型，如DBTypes.ORACLE, DBTypes.SQLSVR等

dsoc.setNeedTranContent(......);  //设置数据库返回值是否需要转码

dsoc.setNeedTranSentence(......);  //设置sql是否需要转码

cxt.setDataSourceConfig("jdbc/default", dsoc);

◆ 集算器数据源的连接

DBConfig dc=new DBConfig();

dc.setDriver(……);    //设置jdbc的驱动

dc.setUrl(……);  //设置Jdbc的url

dc.setUser(……);  //设置数据库访问用户名

dc.setPassword(……);  //设置数据库连接密码

dc.setUseSchema(……);  //设置是否使用模式

dc.setInfo(……);  //设置属性

dc.setCaseSentence(……);  //设置sql的大小写是否无关，指表名字段名等

dc.setAddTilde(……);  //设置是否使用代字号

dc.setExtend(……);  //设置数据库的扩展属性

ISessionFactory SessFactory= new DBSessionFactory(dc)；

Env.setDBSessionFactory(dsName, SessFactory);  //设置数据源名称以及数据库连接工厂

读取计算后的报表

报表计算完后，返回的是一个IReport对象，可以将该对象保存为rat文件。下次需要时，可以直接读取，然后输出展现。

if (fileName.endsWith(GC.FILE_RAT)) {  //根据文件名判断是否是rat文件

FileInputStream in = new FileInputStream(fileName);  //根据文件名新建文件输入流

ObjectInputStream ois = new ObjectInputStream(in); //新建对象输入流

IReport r = (IReport) ois.readObject();  //强制转换为IReport实体对象

in.close();  //关闭文件输入流

…

}

展现报表

◆ 分页

PageBuilder pb = null;

IReport  iReport =......;  //计算报表的相关代码，获得一个IReport

pb = new PageBuilder(iReport,800,100);  //对报表进行分页，PageBuilder还有别的构造方法

int currentPage=......;  //获得当前页号

IReport iReporTemp = pb.getPage(currentPage);  //根据当前页号返回当前页对象

String htmlText = ReportUtils.toHTMLString(iReporTemp,"report2",request);  //把当前页对象输出html语法

out.println(htmlText);  //输出html语法至网页

 

◆ 输出到网页

String htmlText = ReportUtils.toHTMLString(iReport,"report1",request);  //生成html语法

out.print(htmlText);  //输出报表到网页

 

◆ 缓存

背景说明：

润乾报表提供了先进的缓存机制，正常的使用中，tag标签自动进行处理。如果调用API接口计算报表，如何使用缓存呢？

 

代码示例1：

Context ctx = new Context();

ctx.setMainDir("C:\\......\\reportFiles\\ ");  //报表模板的存放路径

CacheManager manager = CacheManager.getInstance();  //获取系统缓存管理器

manager.setCachePath("C:\\Temp");  //设置缓存报表在硬盘中的存放路径

//manager.setCompressMode(false);  // 默认压缩，压缩主要是为了提高存盘效率

//manager.setRealtimeReload(true);  // 设置实时读取报表定义, 默认不实时读取报表定义

ReportCache rc = manager.getReportCache("1.rpx", ctx, 0);  //把报表模板名赋给缓存管理器，系统即自动加载该报表，并建立一系列的缓存管理机制

IReport report = rc.getReport(ctx);  //从缓存中获取报表对象

 

代码示例2：

String reportFile = “C:/api/reportFiles/wangge.rpx”;  //必须为绝对路径

ReportDefine rd = (ReportDefine)ReportUtils.read( reportFile );

//......  //其它代码，例如对rd动态设置一系列属性等

CacheManager manager = CacheManager.getInstance();  //获取系统缓存管理器

//.................  //其它代码，例如对manager设置各种属性等

ReportEntry re=manager.cacheReportDefine("reportName", rd);  //将ReportDefine赋给缓存管理器

Context ctx = new Context();  //构建报表运算环境

//......  //其它代码，例如对ctx设置各种属性等

long timeout=10000;

ReportCache rc=re.getReportCache(ctx, timeout); 

IReport report = rc.getReport(ctx);  //从缓存中获取报表对象

 

 

代码示例3：

Context cxt = new Context();  //构建报表引擎计算环境

//.......................... //其它辅助代码，例如往报表引擎传递参数，传递数据库连接参数等

ReportDefine rd = (ReportDefine)ReportUtils.read( reportFile );

Engine engine = new Engine(rd, cxt);  //构造报表引擎

IReport iReport = engine.calc();  //运算报表

CacheManager manager = CacheManager.getInstance();  //获取系统缓存管理器

//.................  //其它代码，例如对manager设置各种属性等

ReportCache rc=manager.cacheReport("reportName",iReport);  //将结果报表缓存起来

String cacheId=rc.getId();  //取报表缓存号，以便下次从缓存中调用时利用该号获取缓存报表

 

 

◆ swing中展现

背景说明：

java应用有不少是C/S的模式，在C/S的模式下，同样可以调用API接口运算报表，并且把结果报表在JFrame窗口中进行展现，还可以进行打印。

 

代码示例：

ExtCellSet.readLicense(xml); //设置润乾报表授权文件

//................  //其它代码

IReport iReport = ......;  //运算代码，获得一个IReport对象

CSReport csReport = new CSReport(iReport);  //构造CSReport控件

JFrame jf = new JFrame("润乾报表");  //构造JFrame界面

jf.getContentPane().add(csReport.getDisplayPane());  //设置JFrame的相关属性并展现

jf.setSize(600, 400);

jf.setLocation(200, 100);

jf.show();

//................  //其它代码

//csReport.print();  //打印，该代码可以写在某个按钮的相关事件中

注意：

如下情况也需要通过API设置授权：

1.  不重启服务器，在应用正常运行过程中，修改授权文件，则不会自动重新装载，此时需要调用API手动设置授权

2.  在C/S应用中，没有授权文件的配置机制，此时必须调用API接口，进行装载

参考文件：CalculateReport.java

 

◆ 自定义Swing报表打印属性

背景说明：

 基于Swing开发项目的用户，不仅仅满足于把结果报表在JFrame窗口中展现、打印，他们还希望自己能够设置从指定页打印、指定范围页打印，调整页面的页边距，细化打印比例，调整默认的打印显示比例等等以实现灵活的进行打印。为了满足用户的需求润乾报表提供了报表打印对话框API供用户调用以实现以上功能。

 

代码示例：

IReport iReport = ......;  //运算代码，获得一个IReport对象

CSReport csReport = new CSReport(iReport);  //构造CSReport控件

JFrame jf = new JFrame("润乾报表");  //构造JFrame界面

jf.getContentPane().add(csReport.getDisplayPane());  //设置JFrame的相关属性并展现

......

PrintFrame pf=new PrintFrame(iReport,jf); //定义一个报表打印对话框类对象

pf.setColumns(2);  //设置报表的分栏数为2

//pf.setPrintablePages(2);  //设置要打印的页号为:2

pf.setPrintablePages(2,6);  //设置要打印的页号范围为:第2页到第6页

……

关于PrintFrame包含的方法介绍请参考打印。

 

计算字间距

背景说明：

由于不同的字体与字号对应不同的浏览器字间距不同。导致web端展现与报表出现误差。调用此方法可调整字间距。需在raqsoftConfig.xml中进行配置，指定用户这个类的名称（包括包名）。

代码示例：

package api;

import com.raqsoft.report.usermodel.ILetterSpacing;

public class LetterSpacing implements ILetterSpacing

{

int browser;//浏览器

String font;// 字体名称

int fontSize;// 字体大小，单位象素

int cellWidth;// 单元格大小，单位象素 

public int calc(int browser, String font, int fontSize, int cellWidth)

{

//浏览器为IE

if(browser==0){

if(font=="宋体"||fontSize%2==0){

return 0;

}

if(font!="宋体"||fontSize%2==1){

return -1;

}

}else{

//其他浏览器

return 0;

}

return 0;

}

}

参考文件：LetterSpacing.java

 

导出报表

普通导出报表

背景说明：

报表制作完成后，不仅能够实现展现及打印的功能，还能够根据用户的不同需求，以不同的形式导出。润乾报表为用户提供的导出方式有Excel， PDF，Text，Xml，Word，html，csv，OFD，方便了用户的使用。

代码示例：

◆ 导出Excel

IReport ireport = ......;     //运算代码，获得一个IReport对象

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_EXCEL);  //导出为Excel

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_EXCEL_PAGE);   //导出为分页的Excel

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_EXCEL_FORMULA);  //导出为带公式的Excel

re.export(ireport );  //导出

◆ 导出Pdf

IReport iReport = ......;  //运算代码，获得一个IReport对象

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_PDF);  //导出为PDF

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_PDF_PAGE);  //导出为分页的PDF

re.export(ireport );  //导出

◆ 导出OFD

IReport iReport = ......;  //运算代码，获得一个IReport对象

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_OFD);  //导出为OFD

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_OFD_PAGE);  //导出为分页的OFD

re.export(ireport );  //导出

◆ 导出Text

IReport iReport = ......;  //运算代码，获得一个IReport对象

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_TEXT);  //导出为txt

re.export(ireport );  //导出

◆ 导出xml

IReport iReport = ......;  //运算代码，获得一个IReport对象

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_XML);  //导出为xml

re.export(ireport );  //导出

◆ 导出html

IReport iReport = ......;   //运算代码，获得一个IReport对象

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_HTML);  //导出为html

re.export(ireport );  //导出

◆ 导出Word

IReport iReport = ......;  //运算代码，获得一个IReport对象

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_WORD_OPENXML);  //导出为Word

re.export(ireport );  //导出

◆ 导出图片

IReport iReport = ......;  //运算代码，获得一个IReport对象

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_PICTURE);  //导出为不分页的图片

ReportExporter re = new ReportExporter(java.lang.String fileName,ReportExporter. EXPORT_PICTURE_PAGE);  //导出为分页的图片

re.setPictureFormat("JPG");  //设置导出的图片格式，默认为PNG，支持的图形格式有PNG、JPG、GIF、SVG、TIFF

re.export(ireport );  //导出

注意：程序会将图片（集合）压缩为zip格式，导出的文件名后缀要使用zip。

 

◆ 导出csv

TextFile tf = new TextFile( IReport report, String separator, String lineBreak );  //设置分隔符和换行符，一般是： \t \n和空格。

tf.setType("csv");  //两种type，还可以是txt。

tf.fileWrite( java.ioFile f, java.lang.String exportDisp);  //导出到文件f。exportDisp是否导出显示值。

 

导出报表到服务器

背景说明：

报表制作完成后，不仅可以导出到本地，还可以导出到服务器中的某个目录下。

页面中展现报表时，会生成一个导出到服务器的js函数，函数名为save2server (reportName, saveClass)，[reportName]是tag标签中指定的报表name，参数saveClass是用户写的保存类全名，此类要实现接口com.raqsoft.report.usermodel.ISave2Server。

用户可在页面中放一个按钮来调用此js函数，或者在tag的userFuncBarElements属性中添加按钮到报表的工具条中。

 

示例：

JSP页面：

<report:html name="report1" reportFileName="<%=file%>"

……

modifiable="yes"

userFuncBarElements="<input type=button value='导出Excel到服务器' onclick=save2server ('report1','test.MySave2Server')>"

/>

 

参考文件：SavetoServer.jsp

 

MySave2Server类代码：

package api;

import java.io.FileOutputStream;

import java.io.PrintWriter;

import javax.servlet.ServletContext;

import javax.servlet.http.HttpServletResponse;

import com.raqsoft.report.usermodel.IReport;

import com.raqsoft.report.usermodel.ISave2Server;

import com.raqsoft.report.util.ReportUtils;

public class MySave2Server implements ISave2Server {

public void save(IReport report, String fileName, ServletContext application, HttpServletResponse response ) throws Throwable {

... ...

fileName = application.getRealPath( "/export/" + fileName + ".xls" );

FileOutputStream fos = null;

try {

fos = new FileOutputStream( fileName );

ReportUtils.exportToExcel (fos, report, true);

}

finally {

... ...

}

... ...

}

}

 

参考文件：MySave2Server.java