Java实现为Word文档添加文档属性_Java

word文档的文档属性（document properties）是一组用于描述文件本身及其内容的元数据，包括内置属性（如标题、作者、主题、关键词、公司等）和自定义属性。这些属性不会直接显示在文档正文中，但对文档的搜索、分类、版本管理和协作非常有用。在java开发中，通过spire.doc for java库可以直接操作这些属性，无需依赖microsoft office环境。本文以客观方式介绍如何在java项目中为word文档添加文档属性，包含环境准备、代码示例和注意事项，适合开发者快速上手。

一、环境准备

首先确保开发环境已安装jdk（推荐jdk 8及以上）。spire.doc for java通过jar包或maven依赖引入项目。

maven引入方式（推荐）：在pom.xml中添加以下配置：

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.com/nexus/content/groups/public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupid>e-iceblue</groupid>
        <artifactid>spire.doc</artifactid>
        <version>14.3.5</version>
    </dependency>
</dependencies>

若不使用maven，可从官网下载spire.doc.jar并添加到项目classpath。引入后，即可在代码中使用com.spire.doc包下的类。

二、添加内置文档属性（built-in document properties）

内置文档属性是microsoft word预定义的固定属性集，名称不可更改，但值可以设置或修改。常见属性包括title（标题）、subject（主题）、author（作者）、company（公司）、keywords（关键词）等。

操作步骤：

创建document实例并加载现有word文档（或新建空文档）。
通过document.getbuiltindocumentproperties()获取builtindocumentproperties对象。
调用相应setter方法设置属性值。
调用savetofile()保存文档。

完整代码示例：

import com.spire.doc.builtindocumentproperties;
import com.spire.doc.document;
import com.spire.doc.fileformat;

public class addbuiltindocumentproperties {
    public static void main(string[] args) throws exception {
        // 创建document实例并加载word文档
        document document = new document();
        document.loadfromfile("sample.docx");  // 可替换为实际文件路径

        // 获取内置文档属性对象
        builtindocumentproperties standardproperties = document.getbuiltindocumentproperties();

        // 设置具体属性值
        standardproperties.settitle("添加文档属性示例");
        standardproperties.setsubject("java开发教程");
        standardproperties.setauthor("开发者姓名");
        standardproperties.setcompany("示例公司");
        standardproperties.setmanager("项目经理");
        standardproperties.setcategory("文档处理");
        standardproperties.setkeywords("java, word, 文档属性, spire.doc");
        standardproperties.setcomments("本文演示如何使用spire.doc for java添加内置属性");

        // 保存文档，支持docx_2013格式
        document.savetofile("addstandardproperties.docx", fileformat.docx_2013);
        system.out.println("内置文档属性添加完成！");
    }
}

运行后，打开生成的addstandardproperties.docx，在文件属性（右键→属性→详细信息）中即可看到设置的值。

三、添加自定义文档属性（custom document properties）

自定义文档属性由开发者或用户自行定义，支持名称自由设置，值类型包括文本（string）、日期（date）、数字（int/long/double等）和布尔（boolean）。这在需要存储特定业务数据（如文档id、审批状态、自定义标签）时特别实用。

操作步骤：

创建document实例并加载文档。
通过document.getcustomdocumentproperties()获取customdocumentproperties对象。
使用add(string name, object value)方法添加属性（value会自动识别类型）。
保存文档。

完整代码示例：

import com.spire.doc.customdocumentproperties;
import com.spire.doc.document;
import com.spire.doc.fileformat;

import java.util.date;

public class addcustomdocumentproperties {
    public static void main(string[] args) throws exception {
        document document = new document();
        document.loadfromfile("sample.docx");

        // 获取自定义文档属性对象
        customdocumentproperties customproperties = document.getcustomdocumentproperties();

        // 添加不同类型的自定义属性
        customproperties.add("文档id", 2026001);                    // 数字类型
        customproperties.add("已审核", true);                       // 布尔类型
        customproperties.add("审核人", "张工程师");                 // 文本类型
        customproperties.add("审核日期", new date());               // 日期类型

        // 保存文档
        document.savetofile("addcustomproperties.docx", fileformat.docx_2013);
        system.out.println("自定义文档属性添加完成！");
    }
}

自定义属性同样可在word的“文件→信息→属性→高级属性→自定义”标签页中查看和编辑。

四、注意事项与扩展

新建文档 vs 加载现有文档：以上示例均加载现有文件。若需从零创建文档，可使用new document()后直接添加section和内容，再设置属性。
文件格式：推荐使用fileformat.docx_2013以确保兼容性；旧版.doc也可支持，但属性操作更推荐现代docx格式。
异常处理：实际项目中建议添加try-catch处理loadfromfile或savetofile可能出现的io异常。
属性读取与删除：spire.doc for java还提供getbuiltindocumentproperties()/getcustomdocumentproperties()读取值，以及remove()方法删除属性，开发者可根据需求扩展。
性能与兼容：操作仅针对内存中的文档对象，适合批量处理场景；生成的文档可在word 2007及以上版本正常打开。
多文档场景：可循环处理多个文件，或结合模板生成文档时同步设置属性。