应用场景
在一些特殊应用场合,客户希望在服务器上生成文档的同时并填充数据,客户端的页面不显示打开文档。
目前服务器上生成文档第一种就是方案是采用Jacob, 但是局限于windows平台,往往许多Java程序运行于Linux等其他操作系统,在此不讨论该方案。
第二是POI,但是服务器上生成文档对服务器压力很大,而且它的Excel处理勉强可以, Word模块还局限于读取Word的文本内容,写Word文件的功能就更弱;另一个致命的问题是,处理doc格式和处理docx格式的类几乎完全不同,要分开针对不同的格式写不同的代码,这就意味着用户上传的docx格式文件如果使用了doc的扩展名,程序马上崩溃。而且POI结构混,编码比较复杂,开发过程非常消耗时间和精力。
所以针对这一系列的问题,PageOffice开发出来了FileMakerCtrl组件,该组件完全符合PageOffice的架构设计,FileMakerCtrl在客户端生成Office或PDF文档并上传到服务器,但是并不在Web网页里显示Office文档。
FileMakerCtrl对象使用说明
FileMakerCtrl 类是PageOffice开发平台中的核心类。和PageOfficeCtrl控件不同,FileMakerCtrl在Web网页里不显示Office文档,而是直接在线生成Office文档或将Office文档转换成PDF文档,或动态生成PDF文档。
注:以下代码以word为例
1.动态填充word文档并上传到服务器
请参考PageOffice产品开发包中Samples4的示例:
二、13、FileMaker转换单个文档(以Word为例)(专业版、企业版)
FileMakerCtrl fmCtrl = new FileMakerCtrl(request); fmCtrl.setServerPage(request.getContextPath()+"/poserver.zz"); WordDocument doc = new WordDocument(); //给数据区域赋值,即把数据填充到模板中相应的位置 doc.openDataRegion("PO_company").setValue("北京卓正志远软件有限公司"); fmCtrl.setWriter(doc); fmCtrl.setSaveFilePage("SaveMaker.jsp"); //OnProgressComplete为回调函数,文档生成之后在页面里触发此js事件。 //如果您需要响应此事件,您需要在当前 JSP 页面里定义一个 JavaScript 函数。 fmCtrl.setJsFunction_OnProgressComplete("OnProgressComplete()"); fmCtrl.fillDocument("doc/template.doc", DocumentOpenType.Word);
OnProgressComplete的使用: 比如需要实现文件生成后弹出另存为对话框,让用户保存文件到本地电脑,那么js可以这样写:
function OnProgressComplete() { document.getElementById("FileMakerCtrl1").ShowDialog(2); //弹出另存对话框}
2.动态将word文档转换为pdf文档并上传到服务器
请参考PageOffice产品开发包中Samples4的示例:
二、34、FileMaker转换单个文档为PDF(以Word为例) (专业版、企业版)
FileMakerCtrl fmCtrl = new FileMakerCtrl(request); fmCtrl.setServerPage(request.getContextPath()+"/poserver.zz"); WordDocument doc = new WordDocument(); doc.openDataRegion("PO_company").setValue("北京卓正志远软件有限公司"); fmCtrl.setWriter(doc); fmCtrl.setSaveFilePage("SaveMaker.jsp"); fmCtrl.setJsFunction_OnProgressComplete("OnProgressComplete()"); fmCtrl.fillDocumentAsPDF("doc/template.doc",DocumentOpenType.Word, "a.pdf");
3.批量生成文档并上传到服务器
请参考PageOffice产品开发包中Samples4的示例:
三、1、FileMaker批量转换文档(以Word为例)(专业版、企业版)
批量生成文档就是基于FileMaker转换单个文档所使用的技术,在OnProgressComplete事件中执行js方法刷新页面中的iframe页面循环的加载生成不同的文件。
FileMakerCtrl和PageOfficeCtrl的区别
FileMakerCtrl本质上就是一个没有界面的PageOfficeCtrl,也是调用客户端Office程序处理文件的,都可以实现对文档进行动态填充、动态转PDF等功能,唯一的区别就是FileMakerCtrl在线打开填充和转换文档的时候客户端页面不显示打开的文档内容,而PageOfficeCtrl显示打开的文档内容。