Java 示例
概述
此示例将帮助您将 ONLYOFFICE 文档集成到用 Java 编写的 Web 应用程序中。
它用于测试和演示编辑器的功能。如果没有适当的代码修改，请不要在自己的服务器上使用此集成示例。I如果您启用了测试示例，请在投入产品之前将其禁用。
重要安全信息
在使用测试示例时，请记住以下几方面的安全事项：
- 由于不需要授权，因此无法保护存储免受未经授权的访问。
- 没有检查链接中的参数替换，因为参数是由代码根据预先安排的脚本生成的。
- 在编辑后保存文件的请求中没有数据检查，因为每个测试示例仅适用于来自 ONLYOFFICE 文档的请求。
- 没有禁止使用来自其他网站的测试示例，因为它们用于与来自另一个域的 ONLYOFFICE 文档进行交互。
对于 Windows
步骤 1. 安装 ONLYOFFICE 文档
下载并安装 ONLYOFFICE 文档（打包为文档服务器）：
请参阅详细指南以了解如何安装适用于 Windows 的 ONLYOFFICE 文档。
步骤 2. 下载用于编辑器集成的 Java 代码
从我们的网站下载 Java 示例。
要将编辑器连接到您的网站，请在 src/main/resources/settings.properties 文件中指定编辑器安装的路径和存储文件夹的路径：
storage-folder = app_data
files.docservice.url.site=https://documentserver/
其中 documentserver 是安装了 ONLYOFFICE 文档的服务器的名称，storage-folder 是创建和存储文件的路径。您可以设置绝对路径。例如，D:\\folder。请注意，在 Windows 操作系统上，双反斜杠必须用作分隔符。
如果要试验编辑器配置，请修改 src/main/webapp/editor.jsp 文件中的参数。
步骤 3. 安装的先决条件
要运行 Java 示例代码，请安装适用于您的操作系统和 Web 服务器 Apache Tomcat 的 Java 版本：
步骤 4. 运行 Apache Tomcat
-
在 Windows 上安装 Java 后，将 JAVA_HOME 环境变量设置为指向 Java 安装目录。
找出 Java 的安装位置。如果您在安装过程中没有更改路径，它将是这样的：
C:\Program Files\Java\jdk1.8.0_65在 Windows 7 中，右键单击我的电脑并选择属性，然后单击高级。
在 Windows 8中，进入控制面板并选择系统，然后单击高级系统设置。
单击环境变量按钮。
在系统变量，单击新建。
在变量名称字段中，如果您安装了JDK（Java 开发工具包），请输入 JAVA_HOME；如果您安装了 JRE（Java 运行时环境），请输入JRE_HOME。
在变量值字段中，输入您的 JDK 或 JRE 安装路径，例如 C:\Program Files\Java\jdk1.8.0_65。
检查命令提示符中的 echo 命令是否成功创建变量：
echo %JAVA_HOME% -
运行命令提示符更改 Apache Tomcat 安装目录的当前目录：
cd /d C:\Apache Tomcat\apache-tomcat-7.0.67\bin -
使用 startup.bat 脚本启动 Apache Tomcat：
startup.bat您将看到显示的新 Tomcat 控制台窗口，其中提供有关 Tomcat 启动的信息和消息：
使用 Web 浏览器中的地址测试 Tomcat 安装：
http://localhost:8080如果一切正确，您将在浏览器中看到 Tomcat 网页，如下所示。
步骤 5. 运行 Java 代码
-
通过单击 Manager App: 打开 Tomcat Web Application Manager：
-
Tomcat Web Application Manager 将请求 username 和 password:
在 Apache Tomcat 安装文件夹中的 tomcat-users.xml 文件中指定用户数据。定义 manager-gui 用户角色，指定 user name 和 password 的值：
<tomcat-users>
<role rolename="manager-gui"/>
<user username="tomcat" password="tomcat" roles="manager-gui"/>
</tomcat-users> -
在 Tomcat Web Application Manager中上传 Java 项目。为此，单击 WAR file to deploy 部分中的 Choose File 并在 Java 项目文件夹中找到*.war* 文件，然后单击 Deploy。
-
您将在 Application 列表中看到该项目：
-
单击应用程序名来运行它。
步骤 6. 检查可访问性
如果示例和 ONLYOFFICE 文档安装在不同的计算机上，请确保安装了示例的服务器可以访问您指定地址的 ONLYOFFICE 文档，而不是配置文件中的 documentserver。确保 ONLYOFFICE 文档能够访问安装了示例的服务器，该示例使用您在配置文件中 指定的地址而不是 example.com 安装。
对于 Linux
步骤 1. 安装 ONLYOFFICE 文档
下载并安装 ONLYOFFICE 文档（打包为文档服务器）：
请参阅详细指南以了解如何安装适用于Linux的 ONLYOFFICE 文档。
步骤 2. 安装的先决条件及使用编辑器运行网站
-
按照此处说明安装 Java。
-
下载包含 Java 示例的存档并解压缩存档：
wget https://github.com/ONLYOFFICE/document-server-integration/releases/latest/download/Java.Example.zipunzip Java.Example.zip -
将当前目录更改为项目目录：
cd Java\ Example/ -
编辑 src/main/resources/settings.properties 配置文件。指定安装了 ONLYOFFICE 文档的本地服务器的名称。
nano src/main/resources/settings.properties编辑以下行：
storage-folder = app_data
files.docservice.url.site=https://documentserver/其中 documentserver 是安装了 ONLYOFFICE 文档的服务器的名称，storage-folder 是创建和存储文件的路径。请注意，您必须具有对该文件夹的读取和写入权限。如果您没有它们，请使用下一个命令：
sudo chmod -R ugo+rw /{path} -
安装 Maven:
sudo apt-get install maven -
构建：
mvn package -
使用管理页面安装 Tomcat：
sudo apt-get install tomcat8 tomcat8-admin -
在 Tomcat 上配置管理员用户：
sudo nano /var/lib/tomcat8/conf/tomcat-users.xml插入以下行：
<role rolename="manager-gui"/>
<user username="USERNAME" password="PASSWORD" roles="manager-gui"/>其中 USERNAME 和 PASSWORD 是您自己的凭据数据。
重启 Tomcat:
systemctl restart tomcat8 -
使用管理员用户凭据在浏览器中打开 Tomcat 管理页面：
http://localhost:8080/manager/html -
从 target/OnlineEditorsExampleJava-1.0.war 选择要上传的 WAR 文件。
-
使用地址在浏览器中查看结果：
http://localhost:8080/OnlineEditorsExampleJava-1.0/
步骤 3. 检查可访问性
如果示例和ONLYOFFICE 文档安装在不同的计算机上，请确保安装了示例的服务器可以访问您指定地址的 ONLYOFFICE 文档，而不是配置文件中的 documentserver。确保 ONLYOFFICE 文档能够访问安装了示例的服务器，该示例使用您在配置文件中 指定的地址而不是 example.com 安装。
对于 Docker
步骤 1. 安装 ONLYOFFICE 文档
下载并安装 ONLYOFFICE 文档（打包为文档服务器）：
请参阅详细指南以了解如何安装适用于Docker的 ONLYOFFICE 文档。
步骤 2. 安装先决条件并使用编辑器运行网站
-
按照此处说明安装 Java。
-
下载包含 Java 示例的存档并解压存档：
wget https://github.com/ONLYOFFICE/document-server-integration/releases/latest/download/Java.Example.zipunzip Java.Example.zip -
将当前目录更改为项目目录：
cd Java\ Example/ -
编辑 src/main/resources/settings.properties 配置文件。指定安装了 ONLYOFFICE 文档的本地服务器的名称：
nano src/main/resources/settings.properties编辑以下行：
storage-folder = app_data
files.docservice.url.site=https://documentserver/其中 documentserver 是安装了 ONLYOFFICE 文档的服务器的名称，storage-folder 是创建和存储文件的路径。
-
在 Java 示例目录中运行下一个命令：
docker-compose up -
之后，所有的 bin 文件将被传递到 ./target 文件夹。
步骤 3. 检查可访问性
如果示例和 ONLYOFFICE 文档安装在不同的计算机上，请确保安装了示例的服务器可以使用您在配置文件中指定的地址（而不是 documentserver ）访问ONLYOFFICE 文档。确保 ONLYOFFICE 文档可以访问安装了示例的服务器，该示例的地址是您在配置文件中指定的地址，而不是 example.com。