如何在基于Tomcat 9的Web应用中配置Daeja Virtual Viewer

1. 环境准备 #

• 确认服务器环境：支持Java EE的应用服务器（如Tomcat、WebSphere）或静态Web服务器（纯前端部署场景）
• 安装对应版本JDK：推荐JDK 8或11（具体版本参考官方文档要求）
• 确认浏览器兼容性：使用Chrome、Firefox、Edge等现代浏览器

2. 源码文件梳理 #

基于你提供的源码文件结构，先整理核心文件：

• 静态资源：viewer.js、viewone.css及各类图标资源
• 核心配置：config.js（部署核心配置文件）
• 后端依赖（若存在）：war包或Java服务类文件

3. 核心配置调整 #

编辑config.js文件，重点配置以下参数：

• serverUrl：设置后端文档转换服务地址（有后端依赖时必填）
• documentUrl：默认加载的文档路径
• viewerMode：设置查看模式（如view只读、edit可编辑）
• 示例配置片段：

var config = {
  serverUrl: "/daeja/services",
  documentUrl: "/docs/sample.pdf",
  viewerMode: "view",
  ui: {
    toolbar: {
      visible: true,
      items: ["open", "zoom", "rotate"]
    }
  }
};

4. 静态资源部署 #

• 将所有静态文件（js、css、图标、html页面）上传至Web服务器的目标目录（如Tomcat的webapps/daeja-viewer）
• 确保文件路径可通过浏览器正常访问

5. 后端服务部署（可选） #

• 若包含文档格式转换等后端服务，将对应的war包部署到应用服务器
• 启动服务器后，验证服务可用性：访问服务器对应健康检查路径（如http://你的服务器地址/daeja/services/health）

6. 集成到现有Web应用 #

在你的Web页面中引入Daeja资源并初始化：

<link rel="stylesheet" href="/daeja-viewer/viewone.css">
<script src="/daeja-viewer/viewer.js"></script>

<div id="viewerContainer" style="width: 100%; height: 800px;"></div>
<script>
  var viewer = new ViewOne.Viewer(config);
  viewer.initialize("viewerContainer");
</script>

7. 测试验证 #

• 启动Web服务器，访问集成页面
• 加载测试文档，验证显示、缩放、旋转、翻页等功能是否正常
• 若出现异常，查看浏览器控制台日志，结合官方文档排查配置问题

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