你的位置:首页 > ASP.net教程

[ASP.net教程].Net Core集成Office Web Apps(二)


想要使用OWA需要一台单独的服务器来部署,这对很多人造成困难。而写该文的目的是为了分享有个OWA的集成步骤,它不仅适用于.Net开发环境,其它语言也是一样的,只要实现了需要的服务接口。并且该文不局限与OWA的研究,还包括Config、、Cache、Redis等技术。更重要的是熟悉.Net Core开发。

在OwaFileInfo的SupportsUpdate、UserCanWrite、SupportsLocks属性为true时将允许用户在线编辑文件。

在原有的基础上编辑一个test.xlsx文件,其访问链接为(测试链接没有实际意义):http://owa.test.com/x/_layouts/xlviewerinternal.aspx?edit=1&WOPISrc=http%3a%2f%2f192.168.1.1%2fapi%2fwopi%2ffiles%2ftest.xlsx&access_token=H7lFBYT4pVMK

将弹出如下对话框

点击编辑副本

 

查看请求日志发现,另存副本请求将调用PutRelativeFile服务,所有我们应该再原来的基础上添加PutRelativeFile服务。

PutRelativeFile服务

PutRelativeFile操作将在主机上创建一个基于当前文件的副本文件,创建成功后必须将副本文件名及URL以Json的格式返回给OWA服务器。

如果OWA客户端设置了CheckFileInfo的SupportsUpdate为true的话,就必须要实现PutRelativeFile服务,否则需要设置UserCanNotWriteRelative为true并且返回501状态码。

Method:POST

URI:HTTP://server/<...>/wopi*/files/<id>

 

Request Headers:

X-WOPI-Override 固定值 PUT_RELATIVE

X-WOPI-SuggestedTarget 文件扩展名或全名(可修改)

X-WOPI-RelativeTarget 文件全名(不可更改)

X-WOPI-OverwriteRelativeTarget 是否覆盖文件名

X-WOPI-Size 文件的大小bytes

X-WOPI-FileConversion 指示请求是否转换文件

Response Headers:

X-WOPI-ValidRelativeTarget

X-WOPI-Lock

X-WOPI-LockFailureReason

 

该接口需要返回的Json格式如下:

{Name:”test.xlsx”,Url:” http://server/<...>/wopi/files/ test.xlsx”, HostViewUrl :””, HostEditUrl :””}

 

说明:Name为新的文件名(如果修改的话),Url为新的文件的CheckFileInfo服务路径。

在线Excel用到这个服务的情况有两种:

1.另存为,如果没有实现PutRelativeFile服务,则另存为将不能使用;

2.当编辑服务器不支持的Excel某些格式的文件时,会先保存一个系统支持格式的副本,如果没有实现PutRelativeFile服务,则不能编辑该Excel(因为保存新文件会失败);

 

PutRelativeFile服务与CheckFileInfo服务的URL是相同的,只是Method不同,所以我们只需在CheckFileInfo的基础上修改。

    [RouteAttribute("files/{name}")]    public JsonResult GetFileInfo(string name, string access_token)    {      string wopiType = Request.Headers["X-WOPI-Override"];      Console.WriteLine("1.X-WOPI-Override:" + wopiType);      if (wopiType == "PUT_RELATIVE")      {        using (FileStream fs = System.IO.File.Create("Files/new_" + name))        {          Request.Body.CopyTo(fs);        }        Response.Headers.Add("X-WOPI-ValidRelativeTarget", "new_" + name);        Response.Headers.Add("X-WOPI-Lock", Request.Headers["X-WOPI-Lock"]);        Response.StatusCode = 200;        PutRelativeFile file = new PutRelativeFile();        file.Name = "new_" + name;        file.Url = "http://b1wcfoqm7r.proxy.qqbrowser.cc/api/wopi/files/new_" + name;        return Json(file);      }      else if (wopiType == "UNLOCK" || wopiType == "LOCK")      {        Response.Headers.Add("X-WOPI-Lock", Request.Headers["X-WOPI-Lock"]);        Response.StatusCode = 200;        return Json("");      }      else      {        FileHelper helper = new FileHelper();        var info = helper.GetFileInfo(name);        info.SupportsUpdate = true;        info.SupportsLocks = true;        info.UserCanWrite = true;        return Json(info);      }

GetFileInfo
  [DataContract(Name = "PutRelativeFile")]  public class PutRelativeFile  {    [DataMember(Name = "Name")]    public string Name { get; set; }    [DataMember(Name = "Url")]    public string Url { get; set; }    [DataMember(Name = "HostViewUrl")]    public string HostViewUrl { get; set; }    [DataMember(Name = "HostEditUrl")]    public string HostEditUrl { get; set; }  }

PutRelativeFile

Discovery.

访问OWA服务器的如下地址:http://owa.host.com/hosting/discovery(该链接无实际意义)就能得到OWA服务器能够处理的所有文件格式、操作及相关的URL。

<action name="view" ext="xls" default="true" urlsrc="http://owa.hand-china.com/x/_layouts/xlviewerinternal.aspx?<ui=UI_LLCC&><rs=DC_LLCC&>"/>

name=”view”表示动作为查看,ext=”xls”表示文件扩展名为xls,urlsrc则表示相应动作的地址。

以预览test.xls为例,其ChecFileInfo路径为:http://localhost:5000/api/wopi/files/test.xls

则最终预览的链接为:http://owa.host.com/x/_layouts/xlviewerinternal.aspx?WOPISrc=http://localhost:5000/api/wopi/files/test.xls

我将OWA服务提交的discovery内容放到了本地的

    public static List<DiscoveryAction> GetDiscoveryAction()    {      List<DiscoveryAction> list = new List<DiscoveryAction>();      = "Files/Discovery.");      //循环Read方法直到文档结束       while (reader.Read())      {        //Console.WriteLine("rdr.NodeType = " + reader.NodeType);        //如果是开始节点         if (reader.NodeType == //通过rdr.Name得到节点名           string elementName = reader.Name;          //读取到cat元素 这时rdr.Read()读取到的内容为<cat color="white">           if (elementName == "action")          {            DiscoveryAction act = new DiscoveryAction();            //可以通过中括号获得属性值             act.Name = reader["name"];            act.UrlSrc = reader["urlsrc"];            act.Default = TransBool(reader["default"]);            act.Ext = reader["ext"];            act.ProGid = reader["progid"];            act.Requires = reader["requires"];            list.Add(act);          }        }      }      return list;    }

GetDiscovery

Discovery.

Controller Action代码如下:

    [Route("files/{name}/links")]    [HttpGetAttribute]    public JsonResult GetOwaLinks(string name, string type, string access_token, string lang)    {      if (string.IsNullOrEmpty(type))      {        type = "view";      }      if (string.IsNullOrEmpty(lang))      {        lang = "zh-CN";      }      if (string.IsNullOrEmpty(access_token))      {        access_token = "H7lFBYT4pVMK";      }      List<string> lst = new List<string>();      var res = var ext = Path.GetExtension(name).TrimStart('.');      var discovery = res.Where(t => t.Ext == ext && t.Name == type);      foreach (var item in discovery)      {        Console.WriteLine(item.UrlSrc);        var index = item.UrlSrc.IndexOf('<');        var api = System.Net.WebUtility.UrlEncode("http://localhost:5000/api/wopi/files/" + name);        lst.Add(string.Format(item.UrlSrc.Substring(0, index) + "WOPISrc={0}&access_token={1}&ui={2}", api, access_token, lang));      }      return Json(lst);    }

GetOwaLinks

测试访问:http://localhost:5000/api/wopi/files/test.docx/links