Java 添加、删除、替换、格式化Word中的文本（基于Spire.Cloud.SDK for Java）

墨蓝 2023-03-04 15:29 6阅读 0赞

Spire.Cloud.SDK for Java提供了TextRangesApi接口可通过addTextRange()添加文本、deleteTextRange()删除文本、updateTextRangeText()替换文本、updateTextRangeFormat()格式化文本等。本文将从以上方法介绍如何来实现对文本的操作。可参考以下步骤进行准备：

**一、导入jar****文件**

**创建Maven项目程序，通过**[**maven**][maven]**仓库下载导入。**以IDEA为例，新建Maven项目，在pom.xml文件中配置maven仓库路径，并指定spire.cloud.sdk的依赖，如下：

<repositories>
        <repository>
            <id>com.e-iceblue</id>
               <name>cloud</name>
            <url>http://repo.e-iceblue.cn/repository/maven-public/</url>
        </repository>
    </repositories>
    
    <dependencies>
            <dependency>
                <groupId> cloud </groupId>
                <artifactId>spire.cloud.sdk</artifactId>
                <version>3.5.0</version>
            </dependency>
    
            <dependency>
            <groupId> com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
            <version>2.8.1</version>
            </dependency>
    
            <dependency>
                <groupId> com.squareup.okhttp</groupId>
                <artifactId>logging-interceptor</artifactId>
                <version>2.7.5</version>
            </dependency>
    
            <dependency>
                <groupId> com.squareup.okhttp </groupId>
                <artifactId>okhttp</artifactId>
                <version>2.7.5</version>
            </dependency>
    
            <dependency>
                <groupId> com.squareup.okio </groupId>
                <artifactId>okio</artifactId>
                <version>1.6.0</version>
            </dependency>
    
            <dependency>
                <groupId> io.gsonfire</groupId>
                <artifactId>gson-fire</artifactId>
                <version>1.8.0</version>
            </dependency>
    
            <dependency>
                <groupId>io.swagger</groupId>
                <artifactId>swagger-annotations</artifactId>
                <version>1.5.18</version>
            </dependency>
    
            <dependency>
                <groupId> org.threeten </groupId>
                <artifactId>threetenbp</artifactId>
                <version>1.3.5</version>
            </dependency>
    </dependencies>

完成配置后，点击“Import Changes” 即可导入所有需要的jar文件。**如果使用的是****Eclipse****，可参考**[**这里**][Link 1]**的导入方法。**

导入结果：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70][]

**二、登录冰蓝云账号，创建文件夹，上传文档**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 1][]

**三、创建应用程序，获取App ID****及App Key**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 2][]

完成以上步骤后，可参考以下代码，进行文档操作。

用于测试的Word源文档如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 3][]

**1.** **添加文本到Word**

import spire.cloud.word.sdk.client.ApiException;
    import spire.cloud.word.sdk.client.Configuration;
    import spire.cloud.word.sdk.client.api.TextRangesApi;
    
    public class AddTextRange {
        //配置App账号信息
        static String appId = "App ID";
        static String appKey = "App Key";
        static String baseUrl = "https://api.e-iceblue.cn";
        static Configuration wordConfiguration = new Configuration(appId, appKey, baseUrl);
        static TextRangesApi textRangesApi = new TextRangesApi(wordConfiguration);
    
        public static void main(String[] args) throws ApiException {
            String name = "testfile.docx";//用于测试的Word源文档
            String paragraphPath = "Section/0/Body/0/Paragraph/0";//获取文档中的段落
            Integer  indexInParagraph = 0;
            String text = "新添加的文本内容！";//指定需要添加的文本内容
            String folder = "input";//源文档所在的云端文件夹
            String storage = null;//冰蓝云存储空间
            String password = null;//源文档密码
            String destFilePath = "output/AddTextRange.docx";//结果文档路径
    
            //调用方法添加文本内容到Word段落
            textRangesApi.addTextRange(name, paragraphPath, text, destFilePath, folder, storage, indexInParagraph, password);
        }
    }

文本添加效果：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 4][]

**2.** **删除Word****中的文本**

import spire.cloud.word.sdk.client.ApiException;
    import spire.cloud.word.sdk.client.Configuration;
    import spire.cloud.word.sdk.client.api.TextRangesApi;
    
    public class DeleteTextRange {
        //配置App账号信息
        static String appId = "App ID";
        static String appKey = "App Key";
        static String baseUrl = "https://api.e-iceblue.cn";
        static Configuration wordConfiguration = new Configuration(appId, appKey, baseUrl);
        static TextRangesApi textRangesApi = new TextRangesApi(wordConfiguration);
    
        public static void main(String[] args) throws ApiException {
            String name = "testfile.docx";//源文档
            String paragraphPath = "Section/0/Body/0/Paragraph/0";//获取段落
            Integer  index = 0;
            String folder = "input";//源文档所在文件夹
            String storage = null;//冰蓝云存储空间
            String password = null;//源文档密码
            String destFilePath = "output/DeleteTextRange.docx";//结果文档路径
    
            //调用方法删除Word第一段文本
            textRangesApi.deleteTextRange(name, paragraphPath, index, destFilePath,folder, storage, password);
        }
    }

文本删除效果：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 5][]

**3.** **替换Word****中的文本**

import spire.cloud.word.sdk.client.ApiException;
    import spire.cloud.word.sdk.client.Configuration;
    import spire.cloud.word.sdk.client.api.TextRangesApi;
    
    public class UpdateTextRange {
        //配置App账号信息
        static String appId = "App ID";
        static String appKey = "App Key";
        static String baseUrl = "https://api.e-iceblue.cn";
        static Configuration wordConfiguration = new Configuration(appId, appKey, baseUrl);
        static TextRangesApi textRangesApi = new TextRangesApi(wordConfiguration);
    
        public static void main(String[] args) throws ApiException {
            String name = "testfile.docx";//源文档
            String paragraphPath = "Section/0/Body/0/Paragraph/0";//获取段落
            Integer  index = 0;
            String text = "新替换文本";//指定新文本
            String folder = "input";//源文档所在文件夹
            String storage = null;
            String password = null;
            String destFilePath = "output/UpdateTextRangeText.docx";//结果文档路径
    
            //调用方法更新（替换）原有的文本
            textRangesApi.updateTextRangeText(name, paragraphPath, index, text, destFilePath, folder, storage, password);
        }
    }

文本替换效果：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 6][]

**4.** **格式化Word****中的文本**

import spire.cloud.word.sdk.client.ApiException;
    import spire.cloud.word.sdk.client.Configuration;
    import spire.cloud.word.sdk.client.api.TextRangesApi;
    import spire.cloud.word.sdk.client.model.Color;
    import spire.cloud.word.sdk.client.model.Font;
    import spire.cloud.word.sdk.client.model.TextRangeFormat;
    
    public class UpdateTextRangeFormat {
        //配置App账号信息
        static String appId = "App ID";
        static String appKey = "App Key";
        static String baseUrl = "https://api.e-iceblue.cn";
        static Configuration wordConfiguration = new Configuration(appId, appKey, baseUrl);
        static TextRangesApi textRangesApi = new TextRangesApi(wordConfiguration);
    
        public static void main(String[] args) throws ApiException {
            String name = "testfile.docx";//源文档
            String paragraphPath = "Section/0/Body/0/Paragraph/0";//获取段落
            Integer  index = 0;
    
            //创建文本样式，指定字体、颜色、字号，并应用到文本
            TextRangeFormat format = new TextRangeFormat();
            Color color = new Color(34,139,34);
            Font font = new Font("宋体", 20f, color);
            format.setFont(font);
            TextRangeFormat textRange = format;
    
            String folder = "input";//源文档所在文件夹
            String storage = null;
            String password = null;
            String destFilePath = "output/UpdateTextRangeFormat.docx";//结果文档路径
    
            //调用方法更新（应用）文本样式
            textRangesApi.updateTextRangeFormat(name, paragraphPath, index, textRange, destFilePath, folder, storage, password);
        }
    }

文本格式设置效果：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 7][]

（完）

[maven]: http://repo.e-iceblue.cn/#browse/browse:maven-public
[Link 1]: https://cloud.e-iceblue.cn/index.php/tutorials/cloud/webapi/java/maven-spire-cloud-web-api
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70]: /images/20230208/f94757ec941e476a9efd5a7fe983d886.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 1]: /images/20230208/4216bdf3c46343d5a43d80b8c5f41a54.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 2]: /images/20230208/206bb7707885453f965c5fc225561724.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 3]: /images/20230208/f929116d6b3e4a18a3b1a39222f11efd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 4]: /images/20230208/b10f627b08c7458eafaaf006fb09f575.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 5]: /images/20230208/24ec6fb900ca4f229e263256b276e38b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 6]: /images/20230208/123375e207504a92acc768bf9509fe4a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0VpY2VibHVl_size_16_color_FFFFFF_t_70 7]: /images/20230208/38cba4ddc4fd44c399a78b02813e8d66.png