前言

項目中都會遇到關于文件的導出，這里主要使用freemarker來根據ftl來生成word文檔，這里使用的例子中我只考慮到一些常見的情況，如果你遇到問題或是其他特殊情況，希望留下你問題和見解。

word文件導出

引入依賴

1. 首先是導入freemarker的jar包

           <dependency>
               <groupId>org.freemarker</groupId>
               <artifactId>freemarker</artifactId>
               <version>2.3.30</version>
           </dependency>
   

模板填充

1. 然后我們在word的模板上填充上對應的參數：
   
   上面模板中個人榮譽和工作經歷是存在多個，對應了一個list對象，在此我們先不在頁面上進行參數填充，而頭像和個人風采需要插入圖片，所以我們先默認插入一些圖片進行占位和設置其大小屬性；值得注意的是如果你需要像上圖個人風采部分動態的展示圖片的話，其圖片一定要設置為四周型環繞。

2. 將word另存為xml格式：
   
   在另存為時，提供了兩種xml格式的轉儲，請用Word XML 文檔格式進行轉儲。

3. 將導出的xml文件的后綴更改為ftl，并放入項目的resources資源包的templates文件夾中
   

list數據的遍歷填充

1. 打開該ftl文件，上面我們提到了關于個人榮譽和工作經歷都是存在多條的，所以需要用list對象來存儲，在ftl文件中就需要對list數據進行遍歷，以下是對工作經歷數據的遍歷

   <#--這里的使用if標簽來對list進行判空操作-->
   <#if workExperienceList?? && (workExperienceList?size > 0) >
   <#--這里是對list進行遍歷循環，workExperience為每次被遍歷到的對象-->
      <#list workExperienceList as workExperience>
      <#--在ftl模板中，一個w:p標簽代表一個段落,這里不要直接將這份代碼粘貼過去，因為你本身的格式與我不同，導出后可能會出現的格式不一的問題-->
           <w:p>
               <w:pPr>
                   <w:bidi w:val="0"/>
                   <w:jc w:val="center"/>
                   <w:rPr>
                       <w:rFonts w:hint="default" w:ascii="仿宋_GB2312" w:hAnsi="仿宋_GB2312"
                                 w:eastAsia="仿宋_GB2312" w:cs="仿宋_GB2312"/>
                       <w:sz w:val="24"/>
                       <w:szCs w:val="24"/>
                       <w:vertAlign w:val="baseline"/>
                       <w:lang w:val="en-US" w:eastAsia="zh-CN"/>
                   </w:rPr>
               </w:pPr>
               <w:r>
                   <w:rPr>
                       <w:rFonts w:hint="eastAsia" w:ascii="仿宋_GB2312" w:hAnsi="仿宋_GB2312"
                                 w:eastAsia="仿宋_GB2312" w:cs="仿宋_GB2312"/>
                       <w:sz w:val="24"/>
                       <w:szCs w:val="24"/>
                       <w:vertAlign w:val="baseline"/>
                       <w:lang w:val="en-US" w:eastAsia="zh-CN"/>
                   </w:rPr>
                   <#--在w:t標簽中填充值，通過time?string("yyyy-MM-dd")!，首先判斷time是否為空，如果不為空則對時間進行格式轉換，這里的?!其實類似于java的三目運算符 -->
                   <w:t>${(workExperience.workStartTime?string("yyyy-MM-dd"))!}~${(workExperience.workEndTime?string("yyyy-MM-dd"))!'至今'}在${workExperience.unitName!}擔任${workExperience.title!},${workExperience.jobDescription!}</w:t>
               </w:r>
           </w:p>
       </#list>
   </#if>
   

插入圖片

1. 首先插入圖片前我們需要知道在ftl中圖片分為三部分

   • 第一部分：
     在創建模板之前因為插入了幾張圖片，所以你能看到占位
     

     <#--pkg:name中填充的是圖片在ftl模板中的位置，pkg:contentTyped代表了當前的標簽內容的類型-->
     <pkg:part pkg:name="/word/media/image1.jpeg" pkg:contentType="image/jpeg">
            <pkg:binaryData>存放圖片的base64位編碼</pkg:binaryData>
       	</pkg:part>
     

   • 第二部分：
     

     <pkg:part pkg:name="/word/_rels/document.xml.rels" pkg:contentType="application/vnd.openxmlformats-package.relationships+xml">
       <pkg:xmlData>
          <Relatiaonships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
              <Relationship Id="指定ID" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"
                             Target="對應第一部分中pkg:name，只是去掉了/word/"/>
              
               </Relationships>
            </Relationships>   
        </pkg:xmlData>
      </pkg:part>
     

     這一部分可以說是對圖片的一個申明，我們看到使用Relationship標簽對圖片進行了申明，這里只有三張圖片（其他的非圖片為了方便截圖我將其隱藏了）是因為我的模板中雖然展示了四張圖片，但是因為有兩張圖片相同，所以這里就只有三個聲明，通過Target屬性指向圖片所在的路徑，而Id則必須唯一它是連接連接第三部分的重要參數。
   • 第三部分：
     該部分的xml比較長，我就只截重要的部分說明
     
     以上就是對圖片插入的說明，如果說你只有一張圖片插入，那直接在第一部分中填充入你圖片的Base64位編碼就能實現圖片的插入，而當你需要動態的插入圖片就必須要通過循環來指定圖片

2. 動態插入圖片

   • 首先我將圖片都封裝為一個實體類，然后多張圖片對應一個list集合

     import lombok.Data;
     /**
      * @Author HomeWellGo
      * @Date 2020/10/18 20:10
      * @Description 圖片信息類
      */
     @Data
     public class ImgInfo {
         //圖片的base64位編碼
         private String imgBaseCode;
         //圖片的路徑
         private String imgUrl;
         //序號
         private Integer imgIndex;
     }
     

   • 填充圖片的base64位編碼

     <#if personalStyle?? && (personalStyle?size > 0) >
         <#list personalStyle as style>
              <pkg:part pkg:name="/word/media/image${style.imgIndex}.jpeg" pkg:contentType="image/jpeg">
                 <pkg:binaryData>
                     ${(style.imgBaseCode)!''}
                 </pkg:binaryData>
             </pkg:part>
         </#list>
     </#if>
     

   • 聲明圖片

     <#if personalStyle?? && (personalStyle?size > 0) >
      <#list personalStyle as style>
          <Relationship Id="rId${style.imgIndex}jpg" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"
                        Target="media/image${style.imgIndex}.jpeg"/>
          <Relationship Id="rId${style.imgIndex}jpg" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"
                        Target="media/image${style.imgIndex}.jpeg"/>
          <Relationship Id="rId${style.imgIndex}jpg" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"
                        Target="media/image${style.imgIndex}.jpeg"/>
       </#list>
     </#if>
     

   • 指定圖片
     

java代碼

1. 代碼部分

   /**
    * 導出word文件
    * @param user 實體類
    * @param path 導出的word文件路徑
    * */
   public static  void exportWord(User user,String path){
       //Configuration 用于讀取ftl文件
       Configuration configuration = new Configuration(new Version("2.3.0"));
   
       configuration.setDefaultEncoding("utf-8");
   
       configuration.setClassForTemplateLoading(ExportPdfForDocx4j.class, "/templates");
   
       Writer out=null;
   
       try {
           //輸出文檔路徑及名稱
           File outFile = new File(path);
           //以utf-8的編碼讀取ftl文件
           Template template = configuration.getTemplate("/exportPDFForWord.ftl", "utf-8");
   
           out= new BufferedWriter(new OutputStreamWriter(new FileOutputStream(outFile), "utf-8"), 10240);
   
           template.process(user, out);
   
       } catch (IOException e) { e.printStackTrace();
   
       }catch (TemplateException e1){  e1.printStackTrace();
   
       }finally {
   
           try {
   
               if(out!=null) out.close();
   
           } catch (IOException e) {   e.printStackTrace();  }
   
       }
   
   }
   

   /**
   * 獲取圖片的Base64位編碼
    * */
   public  static String getImgBase64(String path){
   
       InputStream in = null;
   
       byte[] data = null;
   
       try{
   
           in = new FileInputStream(path);
   
           data = new byte[in.available()];
   
           in.read(data);
   
           in.close();
   
       }catch (IOException e){   e.printStackTrace();
   
       }finally {
   
           try {
   
               if (in!=null) in.close();
   
           } catch (IOException e) {  e.printStackTrace();  }
   
       }
       //對字節數組Base64編碼
       BASE64Encoder encoder = new BASE64Encoder();
   
       return encoder.encode(data);
   
   }