現在新需求來了，匯出的Word文件中、需要包含圖片。

大致的處理流程為:

1. 解析匯出資訊、將 <img ... src="xxx" ...> 抽取出來。 替換為 [img[xxxIdInt]];
2. 替換 HTML 標籤
3. 將 [img[xxxIdInt]] 格式的字串、使用XML標籤替換回去。 參考下面的程式碼段。
4. 下載 src 為 byte[];
5. 處理為物件;
6. 處理對應的 XML 文件,生成 String 和 byte[]
7. 替換 docx/zip 檔案的某些 entry, 加上圖片的 entry.

相關原始碼

圖片部分的XML大致如下:

public static String template_t_start = "</w:t
 
></w:r><w:r>";
public static String template_t_end = "</w:r><w:r><w:t>";
public static String template_drawing 
  = "<w:drawing>" +
    "<wp:inline>" +
    "<wp:extent cx=\"{{imgWEMU}}\" cy=\"{{imgHEMU}}\"/>" +
    "<wp:docPr id=\"{{imgId}}\" name=\"圖片
 
 {{imgId}}\"/>" +
    "<a:graphic xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\">" +
    "<a:graphicData uri=\"http://schemas.openxmlformats.org/drawingml/2006/picture\">" +
    "<pic:pic xmlns:pic=\"http://schemas.openxmlformats.org/drawingml/2006/picture\">" +
    "<pic:nvPicPr
 
>" +
    "<pic:cNvPr id=\"{{imgId}}\" name=\"Picture {{imgId}}\"/>" +
    "<pic:cNvPicPr/>" +
    "</pic:nvPicPr>" +
    "<pic:blipFill>" +
    "<a:blip r:embed=\"rId{{imgId}}\"></a:blip>" +
    "<a:stretch><a:fillRect/></a:stretch>" +
    "</pic:blipFill>" +
    "<pic:spPr bwMode=\"auto\">" +
    "<a:xfrm><a:ext cx=\"{{imgWEMU}}\" cy=\"{{imgHEMU}}\"/></a:xfrm>" +
    "<a:prstGeom prst=\"rect\"><a:avLst/></a:prstGeom>" +
    "<a:noFill/><a:ln><a:noFill/></a:ln>" +
    "</pic:spPr>" +
    "</pic:pic>" +
    "</a:graphicData>" +
    "</a:graphic>" +
    "</wp:inline>" +
    "</w:drawing>";

public static String imgTemplate = template_t_start + template_drawing + template_t_end;

如果檔案版本不一致、請自己抽取 docx 檔案中的相關文件來對比。

圖片資訊模型如下:

public class WordImagePropertyVO {
    public static int emuWeight = 9525; // emu全職; EMU = 畫素*weight;

    private String imgId; // ID,如20,21,22
    private String relationshipId;
    private Integer width=0; // 圖片的寬度
    private Integer height=0;// 圖片的高度
    private Integer imgHEMU; // EMU = 畫素*weight;
    private Integer imgWEMU;
    private String imgSrc;
    private byte[] imgByte;
    ...
}

ZipUtils 類增加了一些方法:

/**
 * 自定義的ZIP工具
 */
public class ZipUtils {
    /**
     * 替換ZIP中的部分條目
     * @param zipInputStream 輸入zip流
     * @param zipOutputStream 寫出zip流
     * @param replaceItems 替換列表
     */
    public static void replaceItems(ZipInputStream zipInputStream,
                                   ZipOutputStream zipOutputStream,
                                 Map<String, InputStream> replaceItems
    ) {
        if (null == zipInputStream || null == zipOutputStream) {
            return;
        }
        if (null == replaceItems) {
            replaceItems = new HashMap<>();
        }
        ZipEntry entryIn;
        try {
            // 1. 替換
            while ((entryIn = zipInputStream.getNextEntry()) != null) {
                String entryName = entryIn.getName();
                //
                boolean shouldReplaceItem = replaceItems.containsKey(entryName);
                InputStream targetItemInputStream = replaceItems.get(entryName);
                //
                if(shouldReplaceItem && null == targetItemInputStream){
                    continue;// 需要刪除的item;
                }
                // 只使用 name
                ZipEntry entryOut = new ZipEntry(entryName);
                zipOutputStream.putNextEntry(entryOut);
                // 緩衝區
                byte[] buf = new byte[8 * 1024];
                int len;
                if (shouldReplaceItem) {
                    // 使用替換流
                    while ((len = (targetItemInputStream.read(buf))) > 0) {
                        zipOutputStream.write(buf, 0, len);
                    }
                } else {
                    // 輸出普通Zip流
                    while ((len = (zipInputStream.read(buf))) > 0) {
                        zipOutputStream.write(buf, 0, len);
                    }
                }
                // 關閉此 entry
                zipOutputStream.closeEntry();
            }
            // 2. 新增 items
        } catch (IOException e) {
            e.printStackTrace();
            throw new RuntimeException(e);
        }
    }
    // 新增 items
    public static void addItems(ZipInputStream zipInputStream,
                                    ZipOutputStream zipOutputStream,
                                    Map<String, InputStream> addItems
    ) {
        if (null == zipInputStream || null == zipOutputStream || null == addItems || addItems.isEmpty()) {
            return;
        }
        Set<String> itemKeys = addItems.keySet();
        // 2. 新增 items
        try {
            for(String entryName :itemKeys){
                //
                InputStream targetItemInputStream = addItems.get(entryName);
                //
                if(null == entryName || null == targetItemInputStream){
                    continue;
                }
                //
                ZipEntry entryOut = new ZipEntry(entryName);
                zipOutputStream.putNextEntry(entryOut);
                // 緩衝區
                byte[] buf = new byte[8 * 1024];
                int len;
                // 使用替換流
                while ((len = (targetItemInputStream.read(buf))) > 0) {
                    zipOutputStream.write(buf, 0, len);
                }
                // 關閉此 entry
                zipOutputStream.closeEntry();
            }
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }
}

1. 引入檔案格式:

根據需要增加, 如 png 或 jpeg

[Content_Types].xml 檔案中需要增加以下內容:

<Default Extension="png" ContentType="image/png"/>
<Default Extension="jpeg" ContentType="image/jpeg"/>

2. word/document.xml引入名稱空間:

此部分、可以將一個無圖的docx、一個有圖的docx、抽取相關xml檔案格式化後對比得出。

<w:document 
            ......
            xmlns:wp14="http://schemas.microsoft.com/office/word/2010/wordprocessingDrawing"
            xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
            xmlns:wpc="http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas"
            xmlns:w14="http://schemas.microsoft.com/office/word/2010/wordml"
            xmlns:wpg="http://schemas.microsoft.com/office/word/2010/wordprocessingGroup"
            xmlns:wpi="http://schemas.microsoft.com/office/word/2010/wordprocessingInk"
            xmlns:wps="http://schemas.microsoft.com/office/word/2010/wordprocessingShape" mc:Ignorable="w14 wp14"
            >

圖片繪製元素w:drawing

<w:r>
    <w:drawing>
      ...
    </w:drawing>
</w:r>

w:drawing子元素: 行內元素(inline)

<w:drawing>
    <wp:inline distT="0" distB="0" distL="0" distR="0">
      ...
    </wp:inline>
</w:drawing>

其中 distT 之類的屬性是距離上方Text的間距。(Distance From Text on Top Edge)

wp:inline子元素:

<wp:inline distT="0" distB="0" distL="0" distR="0">

<wp:extent cx="5274310" cy="3620117"/>
<wp:effectExtent l="0" t="0" r="2540" b="0"/>
<wp:docPr id="20" name="圖片 20"/>
<wp:cNvGraphicFramePr>
    <a:graphicFrameLocks xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
 noChangeAspect="1"/>
</wp:cNvGraphicFramePr>
  ......
</wp:inline>

其中:

• 必需元素: <wp:extent cx="5274310" cy="3620117"/> 是圖片的寬高= 畫素值*9525; 後面還有一個 <a:ext cx="5274310" cy="3620117"/> 與之對應。為什麼是9525我也不知道, 參考https://msdn.microsoft.com/en-us/library/ee342530(v=office.12).aspx。
• 非必需元素: <wp:effectExtent l="0" t="0" r="2540" b="0"/>,估計是用於控制特效之類的擴充套件屬性。
• 必需元素: <wp:docPr id="20" name="圖片 20"/> ; 應該是圖片的文件屬性, 其中ID互相之間不重複即可。
• 非必需元素: <wp:cNvGraphicFramePr>; 不可見元素的屬性。(Common DrawingML Non-Visual Properties)

wp:inline子元素<a:graphic>:

<wp:inline distT="0" distB="0" distL="0" distR="0">
  ......
   <a:graphic xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main">
     ...
   </a:graphic>
</wp:inline>

a:graphic單一子元素<a:graphicData>

<a:graphic xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main">
    <a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/picture">
      ...
    </a:graphicData>
</a:graphic>

<a:graphicData> 子元素:

<a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/picture">
    <pic:pic xmlns:pic="http://schemas.openxmlformats.org/drawingml/2006/picture">
      ...
    </pic:pic>
</a:graphicData>

pic:pic子元素列表:

<pic:pic xmlns:pic="http://schemas.openxmlformats.org/drawingml/2006/picture">
    <pic:nvPicPr>
        <pic:cNvPr id="20" name="Picture 20"/>
        <pic:cNvPicPr/>
    </pic:nvPicPr>
    <pic:blipFill>
      ...
    </pic:blipFill>
    <pic:spPr bwMode="auto">
      ...
    </pic:spPr>
</pic:pic>

必需元素: <pic:nvPicPr>:

表示 Non-Visual Picture Properties:

• <pic:nvPicPr>。
  
  • cNvPicPr 表示 (Non-Visual Picture Drawing Properties)
  • • 非必需元素 a:picLocks, 指定生成程式的行為等。
  • cNvPr 表示(Non-Visual Drawing Properties),是必需元素, 其中ID互相之間不重複即可

必需元素: <pic:blipFill> :

Picture Fill, 如下所示:

<pic:blipFill>
  <a:blip r:embed="rId20">
  </a:blip>
  <a:srcRect/>
  <a:stretch>
    <a:fillRect/>
  </a:stretch>
</pic:blipFill>

其中, 重要元素是<a:blip r:embed="rId20">:

• 重要屬性: embed (Embedded Picture Reference),表示嵌入的圖片引用。
  
  • 引用關係處於檔案: word/_rels/document.xml.rels 檔案中.

• 重要子元素:<a:stretch> 控制縮放, <a:fillRect/> 表示填滿?

• <a:extLst>擴充套件屬性列表, BlipExtensionList, 可以忽略

必需元素: <pic:spPr>：

Shape Properties.

<pic:spPr bwMode="auto">
    <a:xfrm>
        <a:off x="0" y="0"/>
        <a:ext cx="5274310" cy="3620117"/>
    </a:xfrm>
    <a:prstGeom prst="rect">
        <a:avLst/>
    </a:prstGeom>
    <a:noFill/>
    <a:ln>
        <a:noFill/>
    </a:ln>
</pic:spPr>

其中:

• bwMode 屬性(Black and White Mode)
• <a:xfrm> - Transform2D, 屬性。
  
  • <a:off x="0" y="0"/> 表示 Offset; 有預設值可忽略。
  • 重要屬性: <a:ext cx="5274310" cy="3620117"/> 表示大小, 參考上文。

3. word/_rels/document.xml.rels檔案中存在對應的 Rid

形如:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Relationships
    xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
    ....
    <Relationship Id="rId20" 
        Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"
        Target="media/image20.png"/>
    ...
</Relationships>

可以看到, rId20 的關係。

4. 相關的media檔案:

如 word/media/image20.png

5. 注意事項:

• 不能有  ?