网站建设制作优帮云,模板网站如何快速交付给客户,佛山 详情公布,android下载介绍
DocumentGenerator是一个Excel快速生成工具#xff0c;目标以后还能实现Word、pdf等的文件的生成。该程序独立运行#xff0c;可通过HTTP接口调用其生成接口。 典型使用场景为如下#xff1a;
使用者编写模板文件使用者准备模板文件的填充JSON数据内容使用者通过网络…介绍
DocumentGenerator是一个Excel快速生成工具目标以后还能实现Word、pdf等的文件的生成。该程序独立运行可通过HTTP接口调用其生成接口。 典型使用场景为如下
使用者编写模板文件使用者准备模板文件的填充JSON数据内容使用者通过网络接口调用该程序服务完成模板数据自动加载JSON内容并生成最终文件。
工具目录如下图所示红色框选的便是文件生成的服务程序其中_d结尾的是调试版没有_d结尾的是发布版两个版本功能一样。 下方的DocumentGeneratorTestGui工具是一个测试工具为了方便功能测试使用。
DocumentGeneratorService工具介绍
DocumentGeneratorService是独立运行的文件生成工具对外提供了HTTP接口服务用于生成文档。工具启动成功提示如下图所示 DocumentGeneratorTestGui工具介绍
DocumentGeneratorTestGui工具为测试小工具主界面如下所示 通过选择模板excel文件填写json数据点击生成即可根据选择的模板文件以及当前设置的json内容即可直接生成excel文件。
JSON内容
json数据是调用服务时需要传递的内容部分HTTP的POST方法调用实例如下
POST http://127.0.0.1:8080/generate/xlsx HTTP/1.0
content-type: application/json{template: templates/example_01_property.xlsx,outputPath: outputFiles/outFile_example_01_property.xlsx,data: {proName:这是属性名字}
}
template:指定生成文档时使用的模板文件路径。outputPath:指定生成文档时保存的模板文件路径。“data”属性内容Json-Object即为调用服务生成文档时的数据部分。data结点的内容是模板文件的数据源。DocumentGeneratorTestGui工具的JSON数据就是这里的“data”结点的内容。
模板Excel文件制作
DocumentGenerator/templates目录已经存放了部分典型模板文件。当前程序支持属性、循环指令用户通过灵活配合指令的使用即可完成复杂模板内容的填充。
指令语法{cmd:params}
属性指令(p)
${p:proName}proName代表属性名称用于提取请求json数据内容的proName字段值。
可以简写为${proName}。
简单示例1
比如请求的数据内容如下
{proName:这是属性名字
}
那么${p:proName}就代表了取JSON数据的“proName”结点的值替换该表格生成过程将自动把指令换成了“这是属性名字”。 生成的文件如下 简单示例2
如下方模板文件属性可以通过.操作符获取子属性。 使用JSON数据为
{proName:这是属性名字,cell1:A,cell2:B,cell3:C,cell4:D,cell5:E,cell6:F,cell7:G,cell8:H,user:{name:张三,sex:男,title:是个帅气的小伙儿}
}
生成的内容如下 循环指令(for_*)
循环指令分为水平循环(for_h)和垂直循环(for_v)两种。水平循环用于遍历数据集合并挨个取集合中的元素值横向排布填充excel的表格垂直循环用于遍历数据集合并挨个取集合中的元素值纵向排布填充excel的表格。
综合示例
比如模板内容如下 JSON内容如下
{testName:for测试示例,cells:[A,B,C,D,E,F,G,H],products:[{id:1,name:矿泉水,price:1.5},{id:2,name:中华香烟,price:45.5},{id:3,name:打火机,price:0.5}]
}
生成的结果如下 接口调用
HTTP接口
HTTP接口提供以HTTP POST方式调用文档生成功能。上节的示例中已经介绍过这里不再赘述。
POST http://127.0.0.1:8080/generate/xlsx HTTP/1.0
content-type: application/json{template: templates/example_01_property.xlsx,outputPath: outputFiles/outFile_example_01_property.xlsx,data: {proName:这是属性名字}
}### 测试POST jSON数据
POST http://127.0.0.1:8080/generate/xlsx HTTP/1.0
content-type: application/json{template: templates/example_02_property.xlsx,outputPath: outputFiles/outFile_example_02_property.xlsx,data: {proName:这是属性名字,cell1:A,cell2:B,cell3:C,cell4:D,cell5:E,cell6:F,cell7:G,cell8:H,user:{name:张三,sex:男,title:是个帅气的小伙儿}}
}### 测试POST jSON数据
POST http://127.0.0.1:8080/generate/xlsx HTTP/1.0
content-type: application/json{template: templates/example_03_for.xlsx,outputPath: outputFiles/outFile_example_03_for.xlsx,data: {testName:for测试示例,cells:[A,B,C,D,E,F,G,H],products:[{id:1,name:矿泉水,price:1.5},{id:2,name:中华香烟,price:45.5},{id:3,name:打火机,price:0.5}]}
}
其他待扩展接口
目前还没实现其他接口待扩展。
特别声明
该软件为个人开发软件只用于同行们测试相互学习使用。不可直接用于商业用途谢谢。
如需商业应用请主动邮箱联系作者洽谈谢谢。
