webOpen

在线打开Office文档。

此方法是 PageOfficeCtrl 控件的重要方法，用来在线打开Office文档。

webOpen 方法一般放在PageOfficeCtrl调用代码末尾处调用。

语法：

public void webOpen(java.lang.String documentURL,
                    OpenModeType openMode,
                    java.lang.String userName)
             throws java.lang.Exception,
                    java.io.IOException

参数：

documentURL - 待打开文档的URL地址。这里的URL可以是相对于当前页面的地址，也可以是以"/"开头的相对于整个Web应用程序根的地址。对于前后端分离的项目，此URL地址是相当于后端项目的相对路径。

此文档既可以是来自Web服务器文件夹的文件，也可以是用服务器页面动态输出的文件二进制流，但是必须保证此URL地址可以下载一个正常的Office文档。

此地址也可以直接使用文件在服务器上的磁盘路径，例如：Windows服务器的"D:\documents\test.doc"，或者linux服务器的"file://"+"/home/documents/test.doc"(使用linux的文件路径必须添加file://前缀)。

PageOffice 支持很多Office文档格式，例如 .doc,.docx,.xls,.xlsx,.ppt,.pptx,.xml and .rtf 等。

注意：如果URL采用http开头的绝对地址，您必须确保这个地址和当前页面同属于一个网站。

openMode - 文档打开模式。请确保 openMode 与要打开的Office文档的文件格式保持一致。

userName - 操作当前文档的用户名。一般来说，userName 应该采用登录到您的Web项目的当前用户的名称。

[!note] 如果是前后端分离的项目，documentURL使用相对地址时，是相对于后端项目的相对路径。

抛出：

java.io.IOException

java.lang.Exception

示例：

打开 test.doc 文档并把文档设置成可编辑状态。

//URL方式打开文档
poCtrl1.webOpen("doc/test.doc", OpenModeType.docNormalEdit, "张三");
//服务器磁盘路径方式打开文档
poCtrl1.webOpen("D:\\documents\\test.doc", OpenModeType.docNormalEdit, "张三");