CN108197095A - 一种基于poi的word模板生成方法 - Google Patents

Abstract

本发明公开了一种基于poi的word模板生成方法，其特征在于，本发明通过设置占位字符并建立占位字符与数据的关联性，使用户在Word模板编辑时直接填充占位字符，完成Word模板内容的设置和排版。达到通过设置占位字符并建立占位字符与数据的关联性，使用户在Word模板编辑时直接利用填充占位字符的方式，完成Word模板内容的设置和排版，提供用户在Word编辑过程自主性和参与度，极大满足用户的个性化需求，提升用户体验效果的效果。

Description

一种基于poi的word模板生成方法

技术领域

本发明涉及计算机软件领域，特别是涉及一种基于poi的word模板生成方法。

背景技术

ApachePoi(Poor Obfuscation Implementatio)是由Apache基金会开发的开放源码函式库，是用于操作符合微软Open XML标准以及微软OLE2复合文档格式的Java工具，是用Java编写的免费开源的跨平台的Java API，具备提供API给Java程式对MicrosoftOffice格式档案读和写的功能。

网络平台提供商每天面对着需求各不同的用户，在用户使用网络平台时对“数据套打”均抱有强烈的需求，所述数据套打是指给定一个打印模板，将数据填充在模板的固定位置，然后将带有数据的模板打印的过程。如今多数网络平台提供商还只是提供固定格式的文本信息，并不能直接满足用户对文件编辑的个性化需求，少有网络平台实现用户自主地对文本信息编辑。现有网络平台的数据套打方法采用：(1)由网络平台自己开发网页端的模板编辑工具；(2)通过网络平台输出模板，即由系统提供商(平台)给定模板，用户使用此模板输出订单信息，输出格式固定，不受用户控制；(3)平台输出主要信息，人工进行二次编辑，即由系统提供商(平台)提供订单的主要信息，如产品价格、订单总价、买家名称等，再由人工将信息添加到自定义的模板中；然而上述三种方法都存在一定局限性：方法1开发成本过高，开发难度大且实际用户体验效果差；方法2是完全按照网络平台方的思维开发文件信息，并不能满足用户自定义的个性化需求；方法3需要用户二次编辑，对用户来说使用成本过高。

综上，就目前的技术和方法来看，还不能完全实现用户自由编辑文字模板，满足其个性化编辑需求，这无疑也成为当前值得探究的技术问题。

发明内容

本发明所要解决的技术问题是克服现有技术的不足，提供一种通过设置占位字符并建立占位字符与数据的关联性，使用户在Word模板编辑时直接利用填充占位字符的方式，完成Word模板内容的设置和排版，提供用户在Word编辑过程自主性和参与度，极大满足用户的个性化需求，提升用户体验效果的基于poi的word模板生成方法。其中普通占位字符，用于表示单一内容在word文件中的位置标注；列表占位字符，用于表示多个内容在word文件中的位置标注及内容呈现形式。

为解决上述技术问题，本发明提供一种基于poi的word模板生成方法，其特征在于，本发明通过设置占位字符并建立占位字符与数据的关联性，使用户在Word模板编辑时直接填充占位字符，完成Word模板内容的设置和排版，具体步骤包括：

步骤1：设置占位字符，用于标识相匹配数据在word模板中的位置占用，在word模板中占位字符的前后设置识别标志；

步骤2：建立与占位字符相对应的字典表，所述字典表用于保存占位字符与相匹配数据的关联性，以用于在最终文件生成过程中，数据在相对应位置的准确显示；

步骤3：按照用户自身需求设置Word模板，由用户将占位字符分布在Word模板中的相应位置，至此，个性化word模板构建完毕；

步骤4：获取用户已构建完毕的个性化Word模板，利用POI对word文件的读写性能，解析word模板内容并识别模板中的段落区域和表格区域；根据区域不同，对区域中的各占位字符区别处理；如果是针对段落区域的处理，转步骤5；如果是针对表格区域的处理，转步骤6；

步骤5：根据占位字符标识，识别出段落区域的占位字符，通过查询系统占位字符的字典表，按照占位字符与相匹配数据的关联性，从数据库中调取一个相匹配数据直接替换该占位字符；

步骤6：根据占位字符标识，识别出表格区域占位字符；以行为单位，按照每个单元格中分布的占位字符类型形成不同的数据显示。

所述步骤1中，所述占位字符的前后以“#”做为识别标志包裹，所述占位字符包括系统占位字符和自定义占位字符，所述系统占位字符来源于管理人员预先设置的具备通用性质的占位字符，所述自定义占位字符是用户根据需求后续自行添加的占位字符，且自定义占位字符仅包含普通占位字符。

所述系统占位字符分为“普通占位字符”和“列表占位字符”；其中每个普通占位字符唯一地指向相匹配数据；当在word模板中使用普通占位字符时，将会在最终的生成文件中，该占位字符由相对应的相匹配数据替代；每个“列表占位字符”以“list”开头作为标志，唯一地指向一组相匹配数据；当在word模板中使用列表占位字符时，将会在最终的生成文件中循环地被一组相匹配数据替代。

针对段落区域内自定义占位字符处理，按照所述步骤5中段落区域内系统占位字符相同方式处理。

在所述步骤5中，列表占位字符设置的格式包括字体类型、字体大小、字体颜色、字体粗细、字体是否倾斜。

在步骤6中，所述按照每个单元格中分布的占位字符类型形成不同的数据显示，具体包括：

(1)如果每个单元格中都是普通占位字符，则通过查询系统占位字符的字典表，按照占位字符与对应相匹配数据的关联性，从数据库中调取一个相匹配数据直接替换该普通占位字符；

(2)如果每个单元格中都是列表占位字符，按照每个单元格内占位字符的设置格式，包括字体类型、字体大小、字体颜色、字体粗细、字体是否倾斜、单元格边框、单元格背景，通过查询系统占位字符的字典表，按照字符与对应一组相匹配数据的关联性，依次按行循环输出一组相匹配数据；

(3)如果既包含普通占位字符又包含列表占位字符，其中列表占位字符依旧按照占位字符与对应相匹配数据的关联性，依次按行循环输出一组相匹配数据；普通占位字符按照列表占位字符循环输出数据的次数，依次按行循环重复相匹配数据。

本发明所达到的有益效果:

(1)本发明通过使用word作为模板，以poi作为模板处理器，用户可以自由编辑模板内容，增强了用户使用体验，满足了用户个性化的需求同时降低了系统研发成本。

(2)本发明通过使用占位字符作为数据在Word文件中的位置标识，一方面简化了模板编辑操作，另一方面使用户可以即时且直接看到模板呈现的最终效果，提高用户对模板编辑的参与度，有效提升用户体验效果。

附图说明

图1为本发明实施例中一种基于poi的word模板打印方法实现流程图；

图2为本发明实施例中占位字符示意图；

图3为本发明实施例中用户自定义的word模板示意图；

图4为本发明实施例中字典调用流程示意图；

图5为本发明实施例中段落区域普通占位字符在最终word文件呈现的效果示意图；

图6为本发明实施例中表格区域内普通占位字符的效果呈现；

图7本发明实施例中表格区域2种占位字符共存的数据显示图。

具体实施方式

为了让本技术领域的人能够更好的理解本申请实例中的技术方案，下面结合附图对本申请实施中的技术方案做进一步的说明。

本发明通过设置占位字符并建立占位字符与数据的关联性，使用户在Word模板编辑时直接利用填充占位字符的方式，完成Word模板内容的设置和排版，提供用户在Word编辑过程自主性和参与度，极大满足用户的个性化需求，提升用户体验效果。

本发明的技术方案如下：一种基于poi的word模板生成方法，通过设置占位字符并建立占位字符与数据的关联性，使用户在Word模板编辑时直接填充占位字符，完成Word模板内容的设置和排版，具体步骤包括：

步骤1：设置占位字符，用于标识相匹配数据在word模板中的位置占用，在word模板中占位字符的前后以“#”做为识别标志包裹；所述占位字符包括系统占位字符和自定义占位字符；

特别地，所述系统占位字符来源于管理人员预先设置的具备通用性质的占位字符，所述自定义占位字符是用户根据需求后续自行添加的占位字符，且自定义占位字符仅包含普通占位字符

特别地，所述系统占位字符分为“普通占位字符”和“列表占位字符”；其中每个普通占位字符唯一地指向相匹配数据；当在word模板中使用普通占位字符时，将会在最终的生成文件中，该占位字符由相对应的相匹配数据替代；每个“列表占位字符”以“list”开头作为标志，唯一地指向一组相匹配数据；当在word模板中使用列表占位字符时，将会在最终的生成文件中循环地被一组相匹配数据替代；

步骤2：建立与占位字符相对应的字典表，所述字典表用于保存占位字符与相匹配数据的关联性，以用于在最终文件生成过程中，数据在相对应位置的准确显示；

步骤3：按照用户自身需求设置Word模板，由用户将系统占位字符和自定义占位字符分布在Word模板中的相应位置，至此，满足个性化需求的word模板构建完毕；

步骤4：获取用户已构建完毕的个性化Word模板，利用POI对word文件的读写性能，解析word模板内容并识别模板中的段落区域和表格区域；根据区域不同，对区域中的各占位字符区别处理；如果是针对段落区域的处理，转步骤5；如果是针对表格区域的处理，转步骤6；

步骤5：根据占位字符标识，分别识别出段落区域的普通占位字符和列表占位字符；针对普通占位字符，通过查询系统占位字符的字典表，按照占位字符与对应相匹配数据的关联性，从数据库中调取一个唯一的数据直接替换该普通占位字符；针对列表占位字符，按照当前字符设置的格式，包括字体类型、字体大小、字体颜色、字体粗细、字体是否倾斜、单元格边框、单元格背景，通过查询系统占位字符的字典表，按照字符与对应一组相匹配数据的关联性，从当前字符位置开始向下循环输出所对应的数据；

特别地，针对段落区域的自定义占位字符处理，按照段落区域的系统占位字符相同方式处理；

步骤6：根据占位字符标识，分别识别出表格区域的普通占位字符和列表占位字符；以行为单位，按照每个单元格中分布的占位字符类型形成不同的数据显示；具体如下：

(1)如果每个单元格中都是普通占位字符，则通过查询系统占位字符的字典表，按照占位字符与对应相匹配数据的关联性，从数据库中调取一个唯一的数据直接替换该普通占位字符；

(2)如果每个单元格中都是列表占位字符，按照每个单元格内占位字符的设置格式，包括字体类型、字体大小、字体颜色、字体粗细、字体是否倾斜，通过查询系统占位字符的字典表，按照字符与对应一组相匹配数据的关联性，依次按行循环输出相对应的一组数据；

(3)如果既包含普通占位字符又包含列表占位字符，其中列表占位字符依旧按照占位字符与对应相匹配数据的关联性，依次按行循环输出相对应的一组数据；普通占位字符按照列表占位字符循环输出数据的次数，依次按行循环重复相对于的唯一数据；

图1为本发明实施例中一种基于poi的word模板打印方法实现流程图，具体包括：

步骤101：设置占位字符，用于标识相匹配数据在word模板中的位置占用，word模板中的占位字符以前后“#”包裹作为识别标志，参阅图2本发明实施例中占位字符示意图，比如#reciver#、#email#、“list_code”均是占位字符；

特别地，所述占位字符包括系统占位字符和自定义占位字符；其中，所述系统占位字符来源于管理人员预先设置的具备通用性质的占位字符，所述自定义占位字符是用户根据需求后续自行添加的占位字符，且自定义占位字符仅包含普通占位字符；

特别地，所述系统占位字符分为“普通占位字符”和“列表占位字符”；图2为本发明实施例中占位字符示意图，“#orderNum#、#street#、#city#、#state#、#country#、#tel#、#fax#、#email#”均是普通占位字符，每一个普通占位唯一地指向相匹配数据，比如占位字符“#reciver#”在最后的word文件中仅会指代一个数据；当在word模板中使用普通占位字符时，将会在最终的生成文件中，该占位字符由相对应的相匹配具体数据替代；

每个“列表占位字符”以“list”开头作为标志，图2中#list_code#、#list_prodName#、#list_brand#、#list_model#、#list_prodDetail#、#list_prodCount#、#list_prodPrice#、#list_prodTotal#为列表占位字符，唯一地指向一组相匹配数据；当在word模板中使用列表占位字符时，将会在最终的生成文件中循环地被一组相匹配数据替代，比如#list_code#在最后的word文件中将会指代多个数据，或者重复循环同一个数据，或循环输出不同数据；

步骤102：建立与占位字符相对应的字典表，用于保存各占位字符与相匹配数据的关联性，以用于在最终文件生成过程中，数据在相对应位置的准确显示；

步骤103：按照用户自身需求设置Word模板，由用户将系统占位字符和自定义占位字符分布在Word模板中的相应位置，图3为本发明实施例中用户自定义的word模板示意图，至此，满足个性化需求的word模板构建完毕；

步骤104：获取用户已构建完毕的个性化Word模板，利用POI对word文件的读写性能，解析word模板内容并识别模板中的段落区域和表格区域；根据区域不同，对区域中的各占位字符区别处理；如果是针对段落区域的处理，如图3中没有被框出的区域，转步骤5；如果是针对表格区域的处理，如图3中被框出的区域，转步骤6；

步骤105：根据占位字符标识，分别识别出段落区域的普通占位字符和列表占位字符；在图3没有被框出的区域中，不存在“list_”开头的占位字符，因而段落区域中的字符均为普通占位字符；针对每一个普通占位字符，利用步骤102中建立的字符查询占位字符与数据间的关联性，图4为本发明实施例中字典调用流程示意图，具体包括：首先会从系统字典表查找与该普通占位字符相匹配的数据，如若没有查到匹配数据，则再从自定义字典表中查找与该普通占位字符相匹配的数据，待查找到后将匹配数据返回，并在占位字符处显示，如图5为本发明实施例中段落区域普通占位字符在最终word文件呈现的效果示意图

步骤106：根据占位字符标识，分别识别出表格区域的普通占位字符和列表占位字符；在图3中被框出的区域1中既有普通占位字符，又有列表占位字符，被框出的区域2中全部均由普通占位字符；

针对表格区域2中的每一个普通占位字符，通过系统字典表和自定义字典表中查找与这些普通占位字符匹配的数据，具体步骤参照图4本发明实施例中字典调用流程示意图，寻找到的匹配数据在最终word文件中的效果呈现如图6所示。

经过对区域1中占位字符的分析，既有普通占位字符“#currency#”又有列表占位字符“#list_code#、#list_prodName#、#list_brand#、#list_model#、#list_prodDetail#、#list_prodCount#、#list_prodPrice#、#list_prodTotal#”；

针对区域1中的列表占位字符，首先获取并复制每一个列表占位字符的预设格式，比如字体类型、字体大小、字体颜色、字体粗细、字体是否倾斜，然后根据图4的查询流程，在系统字典表和自定义字典表中查找到匹配的一组数据，比如与#list_prodCount#匹配的一组数据是“3”、“1”、“5”，以行为单位循环地在各占位字符输出匹配数据，参阅图7本发明实施例中表格区域2种占位字符共存的数据显示图；

针对区域1中的普通占位字符，经过在系统字典表和自定义字典表中查询，与普通占位字符匹配的数据仅是一个，但为一致于列表占位字符的数据显示，因此普通占位字符的数据显示会根据列表占位字符的循环次数，不断重复输出唯一匹配的数据，如图7中的数据“￥”。

以上实施例不以任何方式限定本发明，凡是对以上实施例以等效变换方式做出的其它改进与应用，都属于本发明的保护范围。

Claims (6)

1.一种基于poi的word模板生成方法，其特征在于，通过设置占位字符并建立占位字符与数据的关联性，使用户在Word模板编辑时直接填充占位字符，完成Word模板内容的设置和排版，具体步骤包括：

步骤1：设置占位字符，用于标识相匹配数据在word模板中的位置占用，在word模板中占位字符的前后设置识别标志；

步骤2：建立与占位字符相对应的字典表，所述字典表用于保存占位字符与相匹配数据的关联性，以用于在最终文件生成过程中，数据在相对应位置的准确显示；

步骤3：按照用户自身需求设置Word模板，由用户将占位字符分布在Word模板中的相应位置，至此，个性化word模板构建完毕；

步骤4：获取用户已构建完毕的个性化Word模板，利用POI对word文件的读写性能，解析word模板内容并识别模板中的段落区域和表格区域；根据区域不同，对区域中的各占位字符区别处理；如果是针对段落区域的处理，转步骤5；如果是针对表格区域的处理，转步骤6；

步骤5：根据占位字符标识，识别出段落区域的占位字符，通过查询系统占位字符的字典表，按照占位字符与相匹配数据的关联性，从数据库中调取一个相匹配数据直接替换该占位字符；

步骤6：根据占位字符标识，识别出表格区域占位字符；以行为单位，按照每个单元格中分布的占位字符类型形成不同的数据显示。

2.如权利要求1所述的一种基于poi的word模板生成方法，其特征在于：所述步骤1中，所述占位字符的前后以“#”做为识别标志包裹，所述占位字符包括系统占位字符和自定义占位字符，所述系统占位字符来源于管理人员预先设置的具备通用性质的占位字符，所述自定义占位字符是用户根据需求后续自行添加的占位字符，且自定义占位字符仅包含普通占位字符。

3.如权利要求2所述的一种基于poi的word模板生成方法，其特征在于：所述系统占位字符分为“普通占位字符”和“列表占位字符”； 其中每个普通占位字符唯一地指向相匹配数据；当在word模板中使用普通占位字符时，将会在最终的生成文件中，该占位字符由相对应的相匹配数据替代；每个“列表占位字符”以“list”开头作为标志，唯一地指向一组相匹配数据；当在word模板中使用列表占位字符时，将会在最终的生成文件中循环地被一组相匹配数据替代。

4.如权利要求3所述的一种基于poi的word模板生成方法，其特征在于：针对段落区域内自定义占位字符处理，按照所述步骤5中段落区域内系统占位字符相同方式处理。

5.如权利要求4所述的一种基于poi的word模板生成方法，其特征在于：在所述步骤5中，列表占位字符设置的格式包括字体类型、字体大小、字体颜色、字体粗细、字体是否倾斜。

6.如权利要求5所述的一种基于poi的word模板生成方法，其特征在于，在步骤6中，所述按照每个单元格中分布的占位字符类型形成不同的数据显示，具体包括：

（1）如果每个单元格中都是普通占位字符，则通过查询系统占位字符的字典表，按照占位字符与对应相匹配数据的关联性，从数据库中调取一个相匹配数据直接替换该普通占位字符；

（2）如果每个单元格中都是列表占位字符，按照每个单元格内占位字符的设置格式，包括字体类型、字体大小、字体颜色、字体粗细、字体是否倾斜、单元格边框、单元格背景，通过查询系统占位字符的字典表，按照字符与对应一组相匹配数据的关联性，依次按行循环输出一组相匹配数据；

（3）如果既包含普通占位字符又包含列表占位字符，其中列表占位字符依旧按照占位字符与对应相匹配数据的关联性，依次按行循环输出一组相匹配数据；普通占位字符按照列表占位字符循环输出数据的次数，依次按行循环重复相匹配数据。