如何用Java Spring将在线编辑器集成到您自己的网站中

概述

此示例将帮助您将 ONLYOFFICE 文档集成到用 Java with Spring Boot 编写的 Web 应用程序中。

Spring Boot 有很多功能,但它最重要的特性是:依赖管理、自动配置和内置的 servlet 容器。

它用于测试和演示编辑器的功能。 如果没有适当的代码修改,请不要在自己的服务器上使用此集成示例。 如果您启用了测试示例,请在投入产品之前将其禁用。

在使用测试示例时,请记住以下几方面的安全事项:

  • 由于不需要授权,因此无法保护存储免受未经授权的访问。
  • 没有检查链接中的参数替换,因为参数是由代码根据预先安排的脚本生成的。
  • 在编辑后保存文件的请求中没有数据检查,因为每个测试示例仅适用于来自 ONLYOFFICE 文档服务器的请求。
  • 没有禁止使用来自其他网站的测试示例,因为它们用于与来自另一个域的 ONLYOFFICE 文档服务器进行交互。

下载并安装 ONLYOFFICE 文档 (打包为文档服务器 )。

请参阅详细指南以了解如何安装 Windows版文档服务器

从我们的网站下载 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 文件中的 参数

要运行 Java-Spring 示例代码,请安装适用于您的操作系统和框架 Apache Maven的 Java 版本 11:

  1. 在 Windows 上安装 Java 后,将 JAVA_HOME 环境变量设置为指向 Java 安装目录。

    找出 Java 的安装位置。 如果您在安装过程中没有更改路径,它将是这样的:

    C:\Program Files\Java\jdk11

    Windows 7中,右键单击 我的电脑 并选择 属性,然后单击 高级

    Windows 8中,进入 控制面板 并选择 系统,然后单击 高级系统设置

    单击 环境变量 按钮。

    系统变量下,单击 新建

    变量名称 字段中,如果您安装了 JDK (Java 开发工具包),请输入 JAVA_HOME;如果您安装了 JRE (Java 运行时环境),请输入 JRE_HOME

    变量值 字段中,输入您的 JDKJRE 安装路径,例如 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

    变量值 字段中,输入您的 JDKJRE 安装路径,例如 C:\apache-maven-3.8.1

    在系统变量中,找到 PATH,单击 编辑... 按钮。在 编辑环境变量 对话框中,单击 新建 按钮并将 C:\apache-maven-3.8.1\bin 添加到 PATH 系统变量。

    检查 命令提示符 中的 echo命令是否成功创建变量:

    echo %MAVEN_HOME%
  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.addressserver.port打开浏览器:

    http://server.address:server.port/
    
  4. 如果示例和文档服务器安装在不同的计算机上,请确保安装了示例的服务器可以访问您指定地址的文档服务器,而不是配置文件中的 documentserver。 确保文档服务器能够访问安装了示例的服务器,该示例使用您指定的地址而不是配置文件中的 example.com

    如果您成功集成了编辑器,结果应该类似于我们网站上的 演示预览

    下载并安装 ONLYOFFICE 文档 (打包为文档服务器 )。

    请参阅详细指南以了解如何安装 Linux版文档服务器

    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.git
    3. 将当前目录更改为项目目录:

      • 在归档中:

        cd Java\ Spring\ Example
      • 在 git 存储库中:

        cd document-server-integration/web/documentserver-example/java-spring
    4. 编辑 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 是创建和存储文件的路径(默认在项目文件夹中)。您可以设置绝对路径。

    5. 安装 Maven
      sudo apt-get install maven
    6. 构建:
      mvn package
    7. 启动 Java-Spring 示例:

      ./mvnw spring-boot:run
    8. 使用 server.addressserver.port打开浏览器:

      http://server.address:server.port/

    如果示例和文档服务器安装在不同的计算机上,请确保安装了示例的服务器可以访问您指定地址的文档服务器,而不是配置文件中的 documentserver。 确保文档服务器能够访问安装了示例的服务器,该示例使用您在配置文件中 指定的地址而不是 example.com 安装。

    如果您成功集成了编辑器,结果应该类似于我们网站上的 演示预览

    下载并安装 ONLYOFFICE Docs(打包为文档服务器)。

    请参阅详细指南,了解如何 为Docker 安装文档服务器

    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.git
    3. 将当前目录更改为项目目录:

      • 在存档中:

        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 是创建和存储文件的路径(默认在项目文件夹中)。 您可以设置绝对路径。

    5. 在 Java-Spring 示例目录中运行下一个命令:
      docker-compose up
    6. 使用 server.addressserver.port打开浏览器:

      http://server.address:server.port/

    如果示例和文档服务器安装在不同的计算机上,请确保安装了示例的服务器可以使用您在配置文件中指定的地址(而不是 documentserver)访问文档服务器。 确保文档服务器可以访问安装了示例的服务器,该示例的地址是您在配置文件中指定的地址,而不是 example.com

    如果您成功集成了编辑器,结果应类似于我们网站上的 演示预览