在现代协作办公环境中，将功能强大的文档编辑器无缝集成到自有业务系统中，已成为提升工作效率和用户体验的关键需求。ONLYOFFICE 文档服务器提供了一套成熟的在线文档编辑解决方案，而 Java Spring Boot 则是构建高效、模块化 Web 应用的热门框架。
本文将详细介绍如何将 ONLYOFFICE 文档编辑器集成到基于 Spring Boot 的 Java Web 应用程序中，涵盖从环境配置到安全部署的完整流程，助力开发者快速实现文档协作能力的嵌入。
关于 ONLYOFFICE 文档
ONLYOFFICE 文档是多合一的文档编辑套件，支持文字、表格、幻灯片、 PDF 和表单的编辑与协作，高度兼容微软Office格式。易于使用和集成，可以在您的网站、平台或系统中高效处理多种类型的文档，实现文件格式间的便捷转换和无缝协作。
如果您想要将为自己的系统和平台集成编辑功能，您可以了解我们的开发者版本：
ONLYOFFICE文档开发者版：集成至Web应用程序，实现文档编辑功能
为什么要在 Web 程序中集成文档编辑器
通过集成 ONLYOFFICE 文档，你的用户可以在您的应用中直接编辑和协作处理文档，而无需切换到其他工具，为您带来以下显著优势：
1. 易于集成，提升用户体验
ONLYOFFICE 文档可以无缝地适应您的网络应用，支持多种流行的编程语言和开发框架，包括JavaScript、Python、Java、C#等。我们为前端框架提供现成的组件样本 (Angular, React, Vue 等)。
2. 多种部署方式
您可以将 ONLYOFFICE 文档开发者版集成到您的 SaaS 或本地解决方案中，支持私有化部署和内网环境使用，更好得保护数据安全。此外，您可以在多种安装选项中选择部署编辑器，例如Docker、Snap、阿里云镜像等。
3. 品牌自定义和扩展性
我们提供白标产品，您可以更改 logo，自定义编辑界面，选择显示或隐藏额外的按钮，为您的用户提供更好的品牌体验。ONLYOFFICE 文档可以为任何数量的用户进行扩展，即使您有成千上万的用户，也能满足需求。而且无论是开发文件和内容管理系统、CRM 和电子学习平台、邮箱和项目管理软件等，ONLYOFFICE 都可以很好的适应不各种业务场景和工作流程。
了解更多ONLYOFFICE开发者版优势
实操指南：集成 ONLYOFFICE 到您的网页
重要安全信息
Spring Boot 有很多功能，但它最重要的特性是：依赖管理、自动配置和内置的 servlet 容器。
它用于测试和演示编辑器的功能。如果没有适当的代码修改，请不要在自己的服务器上使用此集成示例。如果您启用了测试示例，请在投入产品之前将其禁用。
在使用测试示例时，请记住以下几方面的安全事项：
- 由于不需要授权，因此无法保护存储免受未经授权的访问。
- 没有检查链接中的参数替换，因为参数是由代码根据预先安排的脚本生成的。
- 在编辑后保存文件的请求中没有数据检查，因为每个测试示例仅适用于来自 ONLYOFFICE 文档的请求。
- 没有禁止使用来自其他网站的测试示例，因为它们用于与来自另一个域的 ONLYOFFICE 文档进行交互。
安装与配置流程：适用于 Windows
步骤 1. 安装 ONLYOFFICE 文档
在开始集成前，需要先为自己的系统安装合适的 ONLYOFFICE 文档 ONLYOFFICE 编辑器（打包为文档服务器）：
请参阅详细指南以了解如何安装适用于 Windows的 ONLYOFFICE 文档。
步骤 2. 下载用于编辑器集成的 Java 代码
从我们的网站下载Java-Spring 示例。
要将编辑器连接到您的网站，请在 src/main/resources/application.properties 文件中指定编辑器安装的路径和存储文件夹的路径：
files.storage=
server.port=port
files.docservice.url.site=https://documentserver/
其中 documentserver 是安装了 ONLYOFFICE 文档的服务器的名称，port 是任何可用的端口，而 files.storage 是创建和存储文件的路径（默认在项目文件夹中）。 您可以设置绝对路径。例如，D:\\folder。请注意，在 Windows 操作系统上，双反斜杠必须用作分隔符。
如果要试验编辑器配置，请修改 src/main/webapp/editor.jsp 文件中的参数。
步骤 3. 安装先决条件
要运行 Java-Spring 示例代码，请安装适用于您的操作系统和框架 Apache Maven 的 Java 版本 11：
- Java（从 Oracle官网下载）；
- Apache Maven（从官网下载）。
步骤 4. 设置环境变量
1. 在 Windows 上安装 Java 后，将 JAVA_HOME 环境变量设置为指向 Java 安装目录。
找出 Java 的安装位置。如果您在安装过程中没有更改路径，它将是这样的：
C:\Program Files\Java\jdk11
在 Windows 7 中，右键单击我的电脑并选择属性，然后单击高级。
在 Windows 8中，进入控制面板并选择系统，然后单击高级系统设置。
单击环境变量按钮。
在系统变量，单击新建。
在变量名称字段中，如果您安装了JDK（Java 开发工具包），请输入 JAVA_HOME；如果您安装了 JRE（Java 运行时环境），请输入JRE_HOME。
在变量值字段中，输入您的 JDK 或 JRE 安装路径，例如 C:\Program Files\Java\jdk11。
检查命令提示符中的 echo 命令是否成功创建变量：
echo %JAVA_HOME%
2. 设置 MAVEN_HOME 环境变量：
使用 Maven 将下载的压缩文件解压缩到任意目录。它会是这样的：
C:\apache-maven-3.8.1
在 Windows 7 中，右键单击我的电脑并选择属性，然后单击高级。
在 Windows 8中，进入控制面板并选择系统，然后单击高级系统设置。
单击环境变量按钮。
在系统变量，单击新建。
在变量名称字段中，输入 MAVEN_HOME。
在变量值字段中，输入您的 JDK 或 JRE 安装路径，例如 C:\apache-maven-3.8.1。
在系统变量中，找到 PATH，单击编辑...按钮。在编辑环境变量对话框中，单击新建按钮并将 C:\apache-maven-3.8.1\bin 添加到 PATH 系统变量。
检查命令提示符中的 echo 命令是否成功创建变量：
echo %MAVEN_HOME%
步骤 5. 配置 JWT
打开 src/main/resouces/application.properties 文件，并与 ONLYOFFICE 文档指定相同密钥 以启用 JWT：
docservice.security.key=secret
步骤 6. 使用 Maven 启动应用程序
1. 打开控制台并使用 cd 命令转到 java-spring 文件夹：
cd C:\Program Files\document-server-integration\web\documentserver-example\java-spring
2. 在打开的控制台中，输入以下命令：
mvn clean
mvn package
mvn spring-boot:run
3. 使用 server.address 和 server.port 打开浏览器：
http://server.address:server.port/
步骤 7. 检查可访问性
如果示例和 ONLYOFFICE 文档安装在不同的计算机上，请确保安装了示例的服务器可以访问您指定地址的 ONLYOFFICE 文档，而不是配置文件中的 documentserver。确保 ONLYOFFICE 文档能够访问安装了示例的服务器，该示例使用您指定的地址而不是配置文件中的 example.com。
安装与配置流程：适用于 Linux
步骤 1. 安装 ONLYOFFICE 文档
下载并安装 ONLYOFFICE 文档 （打包为文档服务器）：
请参阅详细指南以了解如何安装适用于Linux 的 ONLYOFFICE 文档。
步骤 2. 安装先决条件并使用编辑器运行网站
1. 按照此处说明安装 Java。
2. 获取 Java-Spring 示例的方法有两种：
- 下载包含 Java-Spring 示例的压缩文件并解压缩：
wget https://github.com/ONLYOFFICE/document-server-integration/releases/latest/download/Java.Spring.Example.zipunzip Java.Spring.Example.zip- 克隆 git 存储库：
git clone https://github.com/ONLYOFFICE/document-server-integration.git3. 将当前目录更改为项目目录：
- 在归档中：
cd Java\ Spring\ Example/- 在 git 存储库中：
cd document-server-integration/web/documentserver-example/java-spring4. 编辑 src/main/resources/application.properties 配置文件。指定安装了 ONLYOFFICE 文档的本地服务器的名称。
nano src/main/resources/application.properties
编辑以下行：
files.storage=
server.port=port
files.docservice.url.site=https://documentserver/
其中 documentserver 是安装了 ONLYOFFICE 文档的服务器的名称，port 是任何可用的端口，而 files.storage 是创建和存储文件的路径（默认在项目文件夹中）。您可以设置绝对路径。
与 ONLYOFFICE 文档指定相同密钥 以启用 JWT：
docservice.security.key=secret
5. 安装 Maven:
sudo apt-get install maven
6. 构建：
mvn package
7. 启动 Java-Spring 示例：
./mvnw spring-boot:run
8. 使用 server.address 和 server.port 打开浏览器：
http://server.address:server.port/
步骤 3. 检查可访问性
如果示例和的 ONLYOFFICE 文档安装在不同的计算机上，请确保安装了示例的服务器可以访问您指定地址的的 ONLYOFFICE 文档，而不是配置文件中的 documentserver。确保的 ONLYOFFICE 文档能够访问安装了示例的服务器，该示例使用您在配置文件中 指定的地址而不是 example.com 安装。
安装与配置流程：适用于 Docker
步骤1. 安装ONLYOFFICE文档
下载并安装 ONLYOFFICE 文档 （打包为文档服务器）：
获取 ONLYOFFICE 编辑器
请参阅详细指南以了解如何安装适用于 Docker的 ONLYOFFICE 文档。
步骤2. 安装先决条件并使用编辑器运行网站
1. 按照此处说明安装 Java。
2. 有两种方式获取 Java-Spring 示例：
- 下载包含 Java-Spring 示例的存档并解压它：
wget https://github.com/ONLYOFFICE/document-server-integration/releases/latest/download/Java.Spring.Example.zip
unzip Java.Spring.Example.zip
- 克隆 git 存储库：
git clone https://github.com/ONLYOFFICE/document-server-integration.git3. 将当前目录更改为项目目录：
- 在存档中：
cd Java\ Spring\ Example/
- 在 git 存储库中：
cd document-server-integration/web/documentserver-example/java-spring
4. 编辑 src/main/resources/application.properties 配置文件。指定安装了 ONLYOFFICE Docs 的本地服务器的名称：
nano src/main/resources/application.properties
编辑以下行：
files.storage=
server.port=port
files.docservice.url.site=https://documentserver/
其中 documentserver 是安装了 ONLYOFFICE 文档的服务器的名称，port 是任何可用的端口，而 files.storage 是创建和存储文件的路径（默认在项目文件夹中）。您可以设置绝对路径。
与 ONLYOFFICE 文档指定相同密钥 以启用 JWT：
docservice.security.key=secret
5. 在 Java-Spring 示例目录中运行下一个命令：
docker-compose up
6. 使用 server.address 和 server.port 打开浏览器：
http://server.address:server.port/
步骤3. 检查可访问性
如果示例和的 ONLYOFFICE 文档安装在不同的计算机上，请确保安装了示例的服务器可以使用您在配置文件中指定的地址（而不是 documentserver）访问的 ONLYOFFICE 文档。确保的 ONLYOFFICE 文档可以访问安装了示例的服务器，该示例的地址是您在配置文件中指定的地址，而不是 example.com。
通过遵循上述步骤，您已成功地在 Java Spring Boot 应用中集成了 ONLYOFFICE 文档编辑器，为您的用户提供了强大的在线文档创建、编辑和协作功能。
ONLYOFFICE 丰富的 API 与 Java Spring 框架的灵活性相结合，为构建功能强大且安全的文档协作解决方案奠定了坚实的基础。您可以基于此示例深入探索 ONLYOFFICE API 文档，定制更符合业务需求的文档处理流程和交互体验。如果在集成过程中遇到问题，欢迎在评论区留言讨论。
相关链接
更多文档 API 语言示例
)
)
