.NetCore之下载文档

本篇将和大家分享的丝.NetCore下载文档,常见的下载有两种:A标签直接指向下载文档地址和post或get请求后台输出文档流的方式,本篇也将围绕这两种来分享;如果对您有好的帮助,请多多支持。

  • 允许站点不识别content-type下载文档(即:不受mime类型限制下载)
  • 如何允许下载.nupkg和.apk后缀的文档
  • Razor模板的post下载文档例子
  • 半年来使用NetCore的一些感想和焦虑

允许站点不识别content-type下载文档(即:不受mime类型限制下载)

对于netcore的web项目而言,内置了一些content-type允许下载的文档类型;我们将通过一个普通的razorweb项目来看看直接通过连接下载excel例子;首先,在项目的wwwroot目录创建一个bak文档夹,然后在该目录下存放如下几种文档:

然后不用修改任何代码或设置,直接启动站点,再直接在浏览器地址栏分别录入下载文档地址,如:

http://localhost:1120/bak/excel.xls

http://localhost:1120/bak/love.apk

http://localhost:1120/bak/stackexchange.redis.1.2.6.nupkg

http://localhost:1120/bak/Startup.cs

通过测试这个时候只有excel.xls文档是能直接被下载的,其他的都是404:

要想.apk,.nupkg.cs等后缀的文档不被限制,我们可以通过 public static IApplicationBuilder UseStaticFiles(this IApplicationBuilder app, StaticFileOptions options); 扩展来设置,我们仅仅只需要修改为如下代码:

            app.UseStaticFiles(new StaticFileOptions
            {
                //设置不限制content-type
                ServeUnknownFileTypes = true 
            });

然后在重启运行,这个时候我们再来访问下载这几个文档就没问题了(注意这个时候下载任何后缀的文档都行),如下截图:

至于cs后缀的文档在google浏览器中是直接显示的内容,这里就不贴图了,有兴趣的可以试试;

如何允许下载.nupkg和.apk后缀的文档

通过上面例子我们能够使用 ServeUnknownFileTypes = true; 直接设置无限制下载文档类型,这种通常不是太好或者说不允许,亦或者不常说的不安全吧;如果我们只需要增加.nupkg和.apk后缀的文档的下载,那么可以通过如下代码来添加mime类型,如:

app.UseStaticFiles(new StaticFileOptions
            {
                //ServeUnknownFileTypes = true 
                ContentTypeProvider = new FileExtensionContentTypeProvider(new Dictionary<string, string>
                {
                    { ".apk","application/vnd.android.package-archive"},
                    { ".nupkg","application/zip"}
                })
            });

同样的也能对excel,apk,nupkg后缀的文档进行下载:

但是这个时候我们访问 http://localhost:1120/bak/Startup.cs 就得不到下载的内容了:

因为我们没有添加对.cs文档的扩展类型,故而系统直接给咋们返回404;这里我们通过FileExtensionContentTypeProvider对象的构造函数传递了一个mapping的dic类型来让项目知道允许下载的content-type类型的文档;

Razor模板的post下载文档例子

老实说最近一端时间有空我就会研究下Razor模板,下面我们将通过她的post表单的方式来请求后端下载文档的方法;下面直接给出login.cshtml文档的代码:

@page
@model LoginModel
@{}
<form method="post">
    <button type="submit" asp-page-handler="down" class="btn">下载</button>
    <button type="submit" asp-page-handler="down01" class="btn">下载01</button>
    <button type="submit" asp-page-handler="down02" class="btn">下载02</button>
</form>

这里值得注意的是,razor通过asp-page-handler=来执行请求后端的方法,我们来看看最终她生成的html代码后是什么样子的:

能够看出这里主要通过handler作为参数名称来传递请求的后端方法,下面再来看看后端代码这样写的(为了方便下载文档的路劲我以love.apk为例):

/// <summary>
        /// 虚拟文档地址输出下载
        /// </summary>
        /// <returns></returns>
        public IActionResult OnPostDown()
        {
            var addrUrl = "/bak/love.apk";
            return File(addrUrl, "application/vnd.android.package-archive", Path.GetFileName(addrUrl));
        }
        
        /// <summary>
        /// 文档流的方式输出
        /// </summary>
        /// <returns></returns>
        public IActionResult OnPostDown01()
        {
            var addrUrl = @"D:\F\学习\vs2017\netcore\Study.AspNetCore\WebApp02-1\wwwroot\bak\love.apk";
            var stream = System.IO.File.OpenRead(addrUrl);
            return File(stream, "application/vnd.android.package-archive", Path.GetFileName(addrUrl));
        }

        /// <summary>
        /// 通过HttpClient获取另外站点的文档流,再输出
        /// </summary>
        /// <returns></returns>
        public async Task<IActionResult> OnPostDown02()
        {
            var path = "https://files.cnblogs.com/files/wangrudong003/%E7%89%B9%E4%BB%B701.gif";
            HttpClient client = new HttpClient();
            client.BaseAddress = new Uri(path);
            var stream = await client.GetStreamAsync(path);
            return File(stream, "application/vnd.android.package-archive", Path.GetFileName(path));
        }

后端3个post接受方法都同样使用了FileStreamResult来输出下载文档,不同点在于文档来源不同;

对于简单一些的站点来说,下载文档一般存在于站点目录下,有点类似于我这里的wwwroot/bak目录,因此能够通过站点虚拟目录下载,也就是咋们第一种的下载方式;

有一些站点为了文档安全性,一般会存在于web站点的相同服务器磁盘中,因此需要通过这里的第二种方式获取文档流,再传递给File();

最后一种就是把自己其他站点或者别人站点上的文档转一下,当做自己的文档来输出,这种方式也就是咋们常说的盗链方式之一

对于razor的handler参数,这里需要注意的是她对应是咋们后端代码OnGetxxx或者OnPostxxx方法中的xxx名称,这是一种razor请求规范,必须要遵守哦。

半年来使用NetCore的一些感想和焦虑

感想:

到目前netcore最新版本2.0,其api很强大了,就目前我做的几个项目使用来看,她api支持度很好;之前遇到过也有人问过我有处理图片的api吗,答案是肯定的,现在nuget包社区已经有很多种包支持图片处理了,有兴趣的朋友可以去看看https://www.nuget.org/packages;在穿插了几个项目后,深刻感觉netcore的学习成本其实并不高,就netcore的mvc项目而言,只要之前会mvc框架,或是webform(个人感觉对应razor)那用起来是无压力;这里建议有些不敢尝试netcore2.0的朋友或者觉的有学习成本的朋友不妨试试;netcore官网文档:https://docs.microsoft.com/en-us/aspnet/core/

焦虑:

netcore2.0出来还是有段时间了,这段时间尽管有很多朋友在博客园分享很多相关的文章和git上的项目;但是在3个netqq群中反应或者提出netcore开发遇到的问题情况来看还是很少,不由让人担心;当然了我所知道的几个大牛们或公司的部分技术决策层的人也在关注并也陆续用这再做新项目;其他城市我不了解,就北京这边很有一些创业公司的创业项目起始点就用的是netcore,所以希望还在观望的朋友或领导们是时候开始行动了,一起努力推动社区的发展。

关键词:文档 下载 netcore 通过 站点 我们 apk 项目 bak 直接

相关推荐:

使用Swashbuckle构建RESTful风格文档

springboot读取自定义配置文档节点

dubbo+zookeeper+springboot构建服务

每天记录一点:NetCore获得配置文档 appsettings.json

ImageSharp一个专注于NetCore平台图像处理的开源项目

.NetCore获取Json和Xml格式的配置信息

粗略使用.NetCore2.0自带授权登陆Authorize

ASP.NET Core 2.0 : 三. 项目结构

Linux+.NetCore+Nginx搭建集群

开源个.NetCore写的 - 并发请求工具PressureTool