Java/JSF实现跨浏览器预览Word、Excel文档技术求助

方案1：微软在线预览服务（零后端改造，快速实现） #

利用微软官方的文档预览接口，支持直接预览公网可访问的Word/Excel文件，无需后端转换，兼容Chrome、Edge等主流浏览器。

实现步骤： #

1. 构造预览链接：
   对目标文件URL进行URL编码后，拼接至微软预览接口：

   https://view.officeapps.live.com/op/view.aspx?src=编码后的文件URL
   

2. JSF中添加触发按钮：
   • 新标签页打开预览：

     <h:button value="预览Word文档" onclick="
         const fileUrl = 'http://erp.lixco.com:6065/LixcoResource/resources/quanlytailieu/test/b4646089-ce50-4bd7-8013-9fb02ad0fae5.docx';
         window.open('https://view.officeapps.live.com/op/view.aspx?src=' + encodeURIComponent(fileUrl), '_blank');
     " />
     

   • 嵌入页面预览（iframe）：

     <h:button value="嵌入预览Excel" onclick="
         const fileUrl = 'http://erp.lixco.com:6065/LixcoResource/resources/quanlytailieu/test/351f8f49-49f9-4b76-8280-670386934285.xlsx';
         document.getElementById('excelPreviewFrame').src = 'https://view.officeapps.live.com/op/view.aspx?src=' + encodeURIComponent(fileUrl);
     " />
     <iframe id="excelPreviewFrame" width="100%" height="600px" frameborder="0"></iframe>
     

方案2：后端转换为HTML/PDF（无外部依赖） #

如果不想依赖第三方服务，可通过Apache POI解析Office文档，转换为HTML或PDF后返回前端预览。

1. 添加Maven依赖 #

<!-- Apache POI 处理Office文档 -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.5</version>
</dependency>
<!-- 可选：Flying Saucer 将HTML转为PDF -->
<dependency>
    <groupId>org.xhtmlrenderer</groupId>
    <artifactId>flying-saucer-pdf</artifactId>
    <version>9.1.22</version>
</dependency>

2. 后端Bean实现转换逻辑（以Word转HTML为例） #

@ManagedBean
@RequestScoped
public class DocumentPreviewBean {

    public void previewWordAsHtml(String serverFilePath) throws IOException {
        // 从服务器路径读取Word文档
        try (XWPFDocument doc = new XWPFDocument(new FileInputStream(serverFilePath))) {
            XHTMLOptions options = XHTMLOptions.create();
            // 处理文档内图片，指定临时存储目录
            options.setExtractor(new FileImageExtractor(new File(new File(serverFilePath).getParent(), "preview_images")));
            
            StringWriter htmlWriter = new StringWriter();
            XHTMLConverter.getInstance().convert(doc, htmlWriter, options);
            
            // 返回HTML内容给前端
            FacesContext ctx = FacesContext.getCurrentInstance();
            ctx.getExternalContext().setResponseContentType("text/html");
            ctx.getExternalContext().getResponseOutputWriter().write(htmlWriter.toString());
            ctx.responseComplete();
        }
    }
}

3. JSF按钮调用后端方法 #

<h:commandButton 
    value="Word转HTML预览" 
    action="#{documentPreviewBean.previewWordAsHtml('/your/server/path/b4646089-ce50-4bd7-8013-9fb02ad0fae5.docx')}" 
/>

方案3：直接触发浏览器原生预览（依赖插件） #

若用户浏览器安装了Office相关插件，可直接打开文件原始URL，由浏览器自行处理预览：

<h:button value="直接打开Excel" onclick="window.open('http://erp.lixco.com:6065/LixcoResource/resources/quanlytailieu/test/351f8f49-49f9-4b76-8280-670386934285.xlsx', '_blank');" />

注意：此方式兼容性取决于用户浏览器配置，稳定性不如前两种方案。

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