Spring Boot(Java)基于Google Docs API单独旋转表格为横向的实现

一、能否通过API仅将Google Docs中的表格设置为横向？ #

可以实现，但并非直接给表格设置方向——Google Docs的页面方向是节（Section）的属性，而非表格本身。解决方案是：将目标表格放置在独立的节中，为该节设置横向布局，同时保持前后节为纵向，以此实现仅表格区域横向、其他内容不变的效果。

二、Spring Boot + Java 实现步骤与代码示例 #

1. 前置准备 #

• 启用Google Docs API并创建服务账号密钥，将密钥文件放入项目资源目录（如src/main/resources/service-account-key.json）
• 引入Google Docs API依赖：

<dependency>
    <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-docs</artifactId>
    <version>v1-rev20240523-2.0.0</version>
</dependency>
<dependency>
    <groupId>com.google.auth</groupId>
    <artifactId>google-auth-library-oauth2-http</artifactId>
    <version>1.20.0</version>
</dependency>

2. 核心实现逻辑 #

步骤1：初始化Docs客户端

import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.docs.v1.Docs;
import com.google.api.services.docs.v1.DocsScopes;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;

import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.Collections;

public class DocsTableService {
    private static final String APPLICATION_NAME = "Spring Boot Docs API Demo";
    private static final GsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();

    public static Docs getDocsService() throws GeneralSecurityException, IOException {
        GoogleCredentials credentials = GoogleCredentials.fromStream(
                DocsTableService.class.getResourceAsStream("/service-account-key.json"))
                .createScoped(Collections.singleton(DocsScopes.DOCUMENTS));

        return new Docs.Builder(GoogleNetHttpTransport.newTrustedTransport(), JSON_FACTORY,
                new HttpCredentialsAdapter(credentials))
                .setApplicationName(APPLICATION_NAME)
                .build();
    }
}

步骤2：插入分节符并创建横向节

假设要在文档的指定位置（比如段落ID为paragraphId）插入表格，需先在该位置前后插入下一页分节符，将表格区域隔离为独立节，然后设置该节的页面方向为横向：

import com.google.api.services.docs.v1.model.*;
import java.util.ArrayList;
import java.util.List;

public class TableGenerator {
    public void addLandscapeTableToDoc(String documentId, String insertParagraphId, List<List<String>> tableData) throws IOException, GeneralSecurityException {
        Docs docsService = DocsTableService.getDocsService();
        List<Request> requests = new ArrayList<>();

        // 1. 在插入位置前插入下一页分节符（开始新节）
        requests.add(new Request()
                .setInsertSectionBreak(new InsertSectionBreakRequest()
                        .setLocation(new Location().setSegmentId(insertParagraphId).setIndex(0))
                        .setSectionBreakType("NEXT_PAGE")));

        // 2. 插入表格（根据tableData生成行列数）
        int rowCount = tableData.size();
        int colCount = tableData.get(0).size();
        requests.add(new Request()
                .setInsertTable(new InsertTableRequest()
                        .setLocation(new Location().setSegmentId(insertParagraphId).setIndex(1))
                        .setRows(rowCount)
                        .setColumns(colCount)));

        // 3. 在表格后插入下一页分节符（结束当前节）
        requests.add(new Request()
                .setInsertSectionBreak(new InsertSectionBreakRequest()
                        .setLocation(new Location().setSegmentId(insertParagraphId).setIndex(1 + rowCount * colCount))
                        .setSectionBreakType("NEXT_PAGE")));

        // 4. 设置中间节的页面方向为横向（A4规格）
        requests.add(new Request()
                .setUpdateSectionStyle(new UpdateSectionStyleRequest()
                        .setSectionStyle(new SectionStyle()
                                .setPageSize(new PageSize()
                                        .setWidth(new Dimension().setMagnitude(841.89).setUnit("PT"))
                                        .setHeight(new Dimension().setMagnitude(595.28).setUnit("PT"))))
                        .setFields("pageSize")
                        .setRange(new Range()
                                .setStartIndex(1)
                                .setEndIndex(1 + rowCount * colCount))));

        // 5. 批量填充表格内容
        int cellIndex = 1;
        for (List<String> row : tableData) {
            for (String cellContent : row) {
                requests.add(new Request()
                        .setInsertText(new InsertTextRequest()
                                .setLocation(new Location().setSegmentId(insertParagraphId).setIndex(cellIndex))
                                .setText(cellContent)));
                cellIndex++;
            }
        }

        // 执行所有请求
        docsService.documents().batchUpdate(documentId, new BatchUpdateDocumentRequest().setRequests(requests)).execute();
    }
}

步骤3：从JSON解析表格数据

假设外部JSON格式如下：

{
  "tableData": [
    ["列标题1", "列标题2", "列标题3", "列标题4", "列标题5"],
    ["数据1-1", "数据1-2", "数据1-3", "数据1-4", "数据1-5"],
    ["数据2-1", "数据2-2", "数据2-3", "数据2-4", "数据2-5"]
  ]
}

用Jackson解析为表格数据结构：

import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.File;
import java.io.IOException;
import java.util.List;

public class JsonParser {
    public static List<List<String>> parseTableDataFromJson(String jsonPath) throws IOException {
        ObjectMapper objectMapper = new ObjectMapper();
        TableDataWrapper wrapper = objectMapper.readValue(new File(jsonPath), TableDataWrapper.class);
        return wrapper.getTableData();
    }

    static class TableDataWrapper {
        private List<List<String>> tableData;
        
        public List<List<String>> getTableData() { return tableData; }
        public void setTableData(List<List<String>> tableData) { this.tableData = tableData; }
    }
}

3. 关键注意事项 #

• 节范围准确性：设置节样式时必须精准指定节的起始/结束索引，避免影响其他节布局
• 分节符类型：使用CONTINUOUS分节符可实现无分页的横向区域，但需适配页面边距
• 页面尺寸：示例采用A4横向规格，可根据需求调整为其他纸张尺寸

效果对比 #

当前效果 #

期望效果 #

内容的提问来源于stack exchange，提问作者Aditi Tare