Domino服务器代理读写Excel文件的最优方案咨询（服务器未安装Excel）

当然可以用这种方式实现需求！而且这是Domino服务器未安装Excel时，借助Apache POI处理Excel文件的合理方案之一，下面给你拆解具体逻辑、步骤和注意事项：

核心逻辑为什么可行？ #

首先，Apache POI是纯Java编写的开源库，完全不需要依赖本地安装的Excel软件，Domino服务器的Java代理（包括xAgent）天生就能集成它。而调度代理调用xAgent的本质，就是通过HTTP请求触发xAgent执行，这种跨代理的调用方式在Domino生态里是很成熟的用法。

具体实现步骤 #

• 1. 部署Apache POI依赖包
  把POI的核心jar包（比如poi.jar、poi-ooxml.jar、poi-ooxml-schemas.jar）以及它的依赖包（比如commons-codec.jar、commons-collections4.jar）放到Domino服务器的jvm/lib/ext目录下，然后重启Domino服务器让它加载这些库。如果你的应用是基于OSGi插件开发的，也可以把这些包打包到插件里，不过直接放ext目录是最简单的方式。

• 2. 编写处理Excel的xAgent
  创建一个Java xAgent，在service方法里实现POI的读写逻辑：

  • 读取Excel：用XSSFWorkbook（处理.xlsx格式）或HSSFWorkbook（处理.xls格式）加载文件输入流，然后遍历工作表、行、单元格获取数据。
  • 写入Excel：创建新的XSSFWorkbook，构建工作表、行、单元格，最后通过输出流保存到服务器本地路径，或者作为附件存到Domino文档里。
    注意：文件路径要用Domino服务器运行账号能访问的绝对路径，或者从Domino文档的附件中获取输入流，避免权限问题。

• 3. 编写调度代理触发xAgent
  调度代理可以用Java或LotusScript编写：

  • Java代理：用HttpURLConnection发送GET/POST请求到xAgent的URL（示例：http://your-domino-server/your-database.nsf/YourExcelXAgent?openAgent），记得处理请求的响应码，判断xAgent是否执行成功。
  • LotusScript代理：用NotesHTTPRequest类发送HTTP请求，同样要处理响应结果。
    最后给调度代理设置好运行时间计划，让它定期触发xAgent执行Excel处理逻辑。

关键注意事项 #

• 权限问题要重视：Domino服务器的运行账号需要有Excel文件所在目录的读写权限，同时xAgent所在数据库要给调度代理的执行账号开放访问权限；如果xAgent不需要认证，记得在数据库的ACL里设置xAgent允许匿名访问，或者在请求里带上认证信息。
• 内存泄漏要避免：处理大Excel文件时，POI容易占用较多内存，一定要用try-with-resources语法（Java 7+支持，Domino JVM已兼容）自动关闭Workbook、InputStream、OutputStream等资源，防止内存泄漏拖垮服务器。
• 版本兼容性要匹配：确保POI版本和Domino服务器的JVM版本兼容，比如Domino 10及以上用的是Java 8，选POI 4.x或5.x版本（POI 5.x要求Java 8+），避免出现ClassNotFoundException这类版本冲突问题。
• 调试要留痕：在xAgent里添加日志输出（比如写到Domino控制台或服务器本地日志文件），方便排查执行过程中的错误；调度代理里也要捕获请求异常和响应结果，便于监控任务执行状态。

额外小建议 #

其实你也可以直接在调度代理里集成POI的处理逻辑，省去一次HTTP请求的开销。但如果你的Excel处理逻辑需要被多个场景调用，或者想把调度逻辑和业务逻辑拆分得更清晰，那调度代理调用xAgent的方式就非常合适。

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