历史版本3 :引擎API 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

1. 基本知识编辑

大家知道,FineReport设计器与服务器已经能够满足大部分的需求,但不可能满足所有的需求,某些个性化需求可能无法实现。FineReport开放了大量的API接口供应用开发人员进行深入的开发与控制。想要了解我们内核结构及api的使用,首先我们必须掌握一些基本的概念,下图就是我们内核的最基本图示。
6.5中模板与结果是分离的(6.5之前不分离)。没有执行过的工作薄或者报表就是模板,而执行过的就是结果。
我们在设计器中新建一个工作薄就是建了一个WorkBook,WorkBook相当于一个容器,里面可以放任意个WorkSheet,就相当于我们在设计器的一个工作薄中新建了多个sheet。而每个WorkSheet是由任意个单元格CellElement组成,因此CellElement是一个模板的最小元素。我们获得WorkBook后,必须取得其中的某个WorkSheet才能对这个报表中的CellElement进行操作,这对于模板还是结果都是一样的,如果我们以模板为例,最基本的内核结构就是如下面这张图
由于每个部分各自包含了很多属性,比如可以设置单元格的前景、背景、边框、字体、字号等;又比如每个WorkSheet中可以添加,删除单元格、可以设置每个sheet的页面属性、可以给每个sheet中添加图表悬浮元素等;再比如可以对WorkBook进行执行获得结果并导出成各种格式、可以进行打印、添加工具栏等等。正是这样,FineReport提供了丰富的API供程序员进行调用,对报表进行深入的控制,来实现其个性化的需求。以下我们用简图来说明FineReport包含的所有开放的api。

2. 开放的API 编辑

由图我们可以看出FineReport主要有以下功能点开放给用户进行深入二次开发。

3. 报表数据源编辑

FineReport设计器本身已经提供了数据库数据源、文本数据源、xml数据源等多种数据来源方式,同时程序员还可以通过java程序自行生成数据来源,只需要实现TableData接口便可以了。

4. 输入输出报表编辑

在程序中您可以新建一个报表对象同时也可以直接读取一个cpt模板来生成,经过处理的报表最终可以导出成多种形式,可以保存为程序网络报表在web端直接访问,也可以导出为excel、pdf、word、cpt等多种格式文件。

5. 设置单元格属性及报表属性编辑

您可以对报表对象的单元格属性、web属性、参数、页面设置等多个属性进行控制,可以自由控制单元格的显示样式、工具栏的按钮、参数面板的展示、参数的赋值等等。全方位地实现您的个性化需求。

6. 自定义填报编辑

FineReport开放的填报api接口能够是您根据自己的需要来定义填报入库方式,通过填报接口,您可以往数据库中保存用户操作日志、您可以在填报成功与失败时进行各种处理等等。

索引: