.Net Core集成Office Web Apps（二）

想要使用OWA需要一台单独的服务器来部署，这对很多人造成困难。而写该文的目的是为了分享有个OWA的集成步骤，它不仅适用于.Net开发环境，其它语言也是一样的，只要实现了需要的服务接口。并且该文不局限与OWA的研究，还包括Config、XML、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 = ;

                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 = ;

                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.xml

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

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内容放到了本地的xml文件中，读取方法如下：

        public static List<DiscoveryAction> GetDiscoveryAction()

        {

            List<DiscoveryAction> list = new List<DiscoveryAction>();

            XmlReader reader = XmlReader.Create("Files/Discovery.xml");

            //循环Read方法直到文档结束

            while (reader.Read())

            {

                //Console.WriteLine("rdr.NodeType = " + reader.NodeType);

                //如果是开始节点

                if (reader.NodeType == XmlNodeType.Element)

                {

                    //通过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.xml文件下载：Disconvery

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 = XmlHelper.GetDiscoveryAction();

            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(, 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