1.17.0

purewind · Nov 14, 2021 · eea14d4 · eea14d4
1 parent 8f2479b
commit eea14d4
Show file tree

Hide file tree

Showing 19 changed files with 81 additions and 51 deletions.
diff --git a/README.md b/README.md
@@ -24,9 +24,10 @@
 - [**ofdrw-reader**](./ofdrw-reader) OFD文档解析器，用于OFD的反序列化以及签名签章。
 - [**ofdrw-sign**](./ofdrw-sign) OFD文档数字签章。
 - [**ofdrw-gm**](./ofdrw-gm) 用于支持签章模块需要的国密电子签章数据结构。
-- [**ofrw-crypto**](./ofdrw-crypto) 用于实现《GM/T 0099-2020 开放版式文档密码应用技术规范》对OFD的密码相关功能。 ***New***
+- [**ofrw-crypto**](./ofdrw-crypto) 用于实现《GM/T 0099-2020 开放版式文档密码应用技术规范》对OFD的密码相关功能。
 - [**ofdrw-gv**](./ofdrw-gv) OFDRW 所有模块所共用的全局变量。
 - [**ofdrw-converter**](./ofdrw-converter) OFD文档转换PDF、图片、SVG、HTML。
+- [**ofdrw-tool**](./ofdrw-tool) OFD文档操作工具，如文档合并。 ***New***
 - [**ofdrw-full**](./ofdrw-full) 上述所有模块整合包，用于简化依赖引入。
 
 ## QuickStart
@@ -36,7 +37,7 @@
 <dependency>
   <groupId>org.ofdrw</groupId>
   <artifactId>ofdrw-full</artifactId>
-  <version>1.16.0</version>
+  <version>1.17.0</version>
 </dependency>
 ```
 
@@ -81,6 +82,8 @@ public class HelloWorld {
 - [OFD R&W OFD转换SVG](./ofdrw-converter/README.md)
 - [OFD R&W OFD转换HTML](./ofdrw-converter/README.md)
 - [OFD R&W 字形数据解析](./ofdrw-converter/src/main/java/org/ofdrw/converter/font/README.md)
+- [OFD R&W 文档合并](./ofdrw-tool/README.md)
+
 
 OFD阅读器客户端: [数科阅读器 . http://www.suwell.cn/](http://www.suwell.cn/)
 

diff --git a/ofdrw-converter/README.md b/ofdrw-converter/README.md
@@ -34,7 +34,7 @@ pom引入相关模块
 <dependency>
     <groupId>org.ofdrw</groupId>
     <artifactId>ofdrw-converter</artifactId>
-    <version>1.16.0</version>
+    <version>1.17.0</version>
 </dependency>
 ```
 

diff --git a/ofdrw-converter/pom.xml b/ofdrw-converter/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

diff --git a/ofdrw-core/pom.xml b/ofdrw-core/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

diff --git a/ofdrw-crypto/pom.xml b/ofdrw-crypto/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

diff --git a/ofdrw-font/pom.xml b/ofdrw-font/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

diff --git a/ofdrw-full/pom.xml b/ofdrw-full/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

diff --git a/ofdrw-gm/pom.xml b/ofdrw-gm/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

diff --git a/ofdrw-gv/pom.xml b/ofdrw-gv/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
     <artifactId>ofdrw-gv</artifactId>

diff --git a/ofdrw-gv/src/main/java/org/ofdrw/gv/GlobalVar.java b/ofdrw-gv/src/main/java/org/ofdrw/gv/GlobalVar.java
@@ -11,5 +11,5 @@ final public class GlobalVar {
     /**
      * OFD Reader and Writer 版本号
      */
-    public static final String Version = "1.16.0";
+    public static final String Version = "1.17.0";
 }
diff --git a/ofdrw-layout/pom.xml b/ofdrw-layout/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <artifactId>ofdrw-layout</artifactId>
 

diff --git a/ofdrw-pkg/pom.xml b/ofdrw-pkg/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
     <description>OFD文件的容器以及用于文档的打包</description>

diff --git a/ofdrw-reader/pom.xml b/ofdrw-reader/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

diff --git a/ofdrw-sign/doc/quickstart/README.md b/ofdrw-sign/doc/quickstart/README.md
@@ -11,7 +11,7 @@
 <dependency>
     <groupId>org.ofdrw</groupId>
     <artifactId>ofdrw-sign</artifactId>
-    <version>1.16.0</version>
+    <version>1.17.0</version>
 </dependency>
 ```
 

diff --git a/ofdrw-sign/pom.xml b/ofdrw-sign/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

diff --git a/ofdrw-tool/README.md b/ofdrw-tool/README.md
@@ -1,45 +1,59 @@
 # OFD Reader & Writer 文档操作工具
 
-## 文档合并
+## 引入依赖
 
-1. 创建空文档
-2. 输入待合并文档
-3. 选择页面
-   - 资源分析
-   - 资源复制
-   - 页面复制
-   - 页面资源替换
-4. 合并成文件
+```xml
 
+<dependency>
+    <groupId>org.ofdrw</groupId>
+    <artifactId>ofdrw-tool</artifactId>
+    <version>1.17.0</version>
+</dependency>
+```
 
-页面涉及资源：
-
-- 页面模板
-- 绘制参数 （DrawParam）
-- 颜色空间
-- 字体
-- 多媒体
-- 矢量图像
-
-
-- 注释
-
-相同资源
-
-模板页
+## 多文档合并
+
+1. 提供合并文件输出位置。
+2. 提供待合并文件。
+3. 创建合并对象`OFDMerger`。
+4. 添加合并文档和页面（支持添加多个文档）。
+5. 关闭合并对象，生成文档。
+
+```java
+import java.io.IOException;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+
+public class HelloMerge {
+    public static void main(String[] args) throws IOException {
+        // 1. 提供合并文件输出位置。
+        Path dst = Paths.get("dst.ofd");
+        // 2. 提供待合并文件。
+        Path d1Path = Paths.get("file1.ofd");
+        Path d2Path = Paths.get("file2.ofd");
+        // 3. 创建合并对象
+        try (OFDMerger ofdMerger = new OFDMerger(dst)) {
+            // 4. 添加合并文档和页面。
+            ofdMerger.add(d1Path);
+            ofdMerger.add(d2Path);
+        }
+        // 5. 关闭合并对象，生成文档 (try() 语法自动关闭)
+    }
+}
+```
 
-- 资源对象
-- 资源文件
+为了更加灵活的合并文档，`OFDMerger#add`方法支持可选参数，指定需要合并的页面页码（从1开始）
 
-相同文件 关联到不同页码
 
+例如：
 
-每个文档 资源映射表
+- 选取`file1.ofd`的第3、1页作为新文档的第1、2页。
+- 选择`file2.ofd`的第1页作为新文档的第3、4页内容。
 
-ID -> 资源对象 | 关联文件 (Hash) -> 新文档ID 
+```java
+// Path d1Path = Paths.get("file1.ofd");
+// Path d2Path = Paths.get("file2.ofd");
 
-查表流程
-```
-原文档ID -> 查表 -> 新ID
-            -> 对象关联文件 -> 计算文件Hash -> 查文件表 -> 存储
+ofdMerger.add(d1Path, 3, 1);
+ofdMerger.add(d2Path, 1, 1);
 ```
diff --git a/ofdrw-tool/pom.xml b/ofdrw-tool/pom.xml
@@ -5,7 +5,7 @@
     <parent>
         <artifactId>ofdrw</artifactId>
         <groupId>org.ofdrw</groupId>
-        <version>1.16.0</version>
+        <version>1.17.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

diff --git a/pom.xml b/pom.xml
@@ -9,7 +9,7 @@
     <groupId>org.ofdrw</groupId>
     <artifactId>ofdrw</artifactId>
     <packaging>pom</packaging>
-    <version>1.16.0</version>
+    <version>1.17.0</version>
 
     <url>https://github.com/ofdrw/ofdrw</url>
     <description>Open Fixed layout Document Reader And Writer Libary(OFD-RW) provider developers to generate ofd

diff --git a/releasenotes.md b/releasenotes.md
@@ -1,5 +1,18 @@
 # 发布记录和特性
 
+## Version 1.17.0 2021-11-14 22:53:35
+
+> Alias: Daxue
+
+新增：
+
+- 增加文档操作工具模块[ofdrw-tool](./ofdrw-tool)
+  - 文档合并功能，见 [测试用用例](./ofdrw-tool/src/test/java/org/ofdrw/tool/merge/OFDMergerTest.java)
+
+修复：
+
+- 外部字体复制BUG。
+
 ## Version 1.16.0 2021-10-15 20:42:17
 
 > Alias: Xiaoxue