Java 在Word中創建郵件合並模板並合並文本和圖片

Word里面的郵件合並功能是一種可以快速批量操作同類型數據的方式，常見的如數據填充、打印等。其中必不可少的步驟包括用於填充的模板文檔、填充的數據源以及實現郵件合並的功能。下面，通過Java程序展示如何來實現創建模板，並通過郵件合並功能來合並文本數據和圖片數據的方法，分別以2個示例來展示，即：

1. 創建Word填充模板

2. 郵件合並文本和圖片

 

本次程序運行環境如下：

• 代碼編譯工具：IDEA
• Jdk版本：1.8.0
• Word測試文檔：.docx 2013
• Word jar包工具：Free Spire.Doc for Java 

關於jar導入：

下載Free Spire.Doc for Java 到本地后，解壓。然后執行如下步驟手動導入jar到Java程序：Project Structure（Shift+Ctrl+Alt+S）打開的界面中選擇【Modules】—【Dependencies】，點擊“+”，【JARs or directories…】,選擇本地路徑中的jar文件，添加后，勾選，點擊“OK”。完成導入。

 

 

Java代碼示例

1. 創建Word郵件合並模板

import com.spire.doc.*;
import com.spire.doc.documents.Paragraph;

public class CreateTemplate {
    public static void main(String[] args) {
        //創建Document實例
        Document document = new Document();
        document.loadFromFile("test.docx");

        //獲取第一節
        Section section = document.getSections().get(0);

        //添加4個段落
        Paragraph para1 = section.addParagraph();
        Paragraph para2 = section.addParagraph();
        Paragraph para3 = section.addParagraph();
        Paragraph para4 = section.addParagraph();

        //添加合並域,包括文字域、圖片域
        para1.setText("姓名 : ");
        para1.appendField("Name", FieldType.Field_Merge_Field);
        para2.setText("郵件地址: ");
        para2.appendField("Email Address", FieldType.Field_Merge_Field);
        para3.setText("日期 : ");
        para3.appendField("Date", FieldType.Field_Merge_Field);
        para4.setText("圖片：");
        para4.appendField("Image:image",FieldType.Field_Merge_Field);

        //保存模板文檔
        document.saveToFile("template.docx", FileFormat.Docx);
        document.dispose();
    }
}

模板效果：

 

2. 郵件合並文本和圖片數據

以上面創建模板為例，填充文本數據及圖片數據

import com.spire.doc.*;
import com.spire.doc.reporting.MergeImageFieldEventArgs;
import com.spire.doc.reporting.MergeImageFieldEventHandler;

import java.text.SimpleDateFormat;
import java.util.Date;

public class MailMerge {
    public static void main(String[] args) throws Exception{
        //創建Document實例，並加載郵件合並模板文檔
        Document document = new Document();
        document.loadFromFile("template.docx");

        //按文本合並域名稱，設置合並域的文本值
        Date currentTime = new Date();
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String dateString = formatter.format(currentTime);
        String[] textFieldNames  = new String[]{"Name", "Email Address", "Date"};
        String[] textFieldValues  = new String[]{"亞當斯密", "[e-mail]", dateString};

        //合並文本到模板
        document.getMailMerge().execute(textFieldNames,textFieldValues  );

        //按圖片合並域名稱，設置圖片路徑值
        String[] imageFieldNames  = new String[]{"image"};
        String[] imageFieldValues  = new String[]{"logo.jpg"};

        //調用郵件合並事件加載圖片
        document.getMailMerge().MergeImageField = new MergeImageFieldEventHandler()
        {
            public void invoke(Object sender, MergeImageFieldEventArgs args)
            {
                mailMerge_MergeImageField(sender, args);
            }
        };
        //執行郵件合並
        document.getMailMerge().execute(imageFieldNames, imageFieldValues);

        //保存文檔
        document.saveToFile("result.docx", FileFormat.Docx);

    }
    //創建郵件合並事件用於加載圖片
    private static void mailMerge_MergeImageField(Object sender, MergeImageFieldEventArgs field) {
        String filePath = (String) field.getFieldValue();
        if (!filePath.isEmpty())
        {
            field.setImage(filePath);
        }
    }
}

合並效果：

 

—End—