浅谈ASP.NET Core静态文件处理源码探究
前言
静态文件(如 html、css、图像和 javascript)等是web程序的重要组成部分。传统的asp.net项目一般都是部署在iis上,iis是一个功能非常强大的服务器平台,可以直接处理接收到的静态文件处理而不需要经过应用程序池处理,所以很多情况下对于静态文件的处理程序本身是无感知的。asp.net core则不同,作为server的kestrel服务是宿主到程序上的,由宿主运行程序启动server然后可以监听请求,所以通过程序我们直接可以处理静态文件相关。静态文件默认存储到项目的wwwroot目录中,当然我们也可以自定义任意目录去处理静态文件。总之,在asp.net core我们可以处理静态文件相关的请求。
staticfile三剑客
通常我们在说道静态文件相关的时候会涉及到三个话题分别是启用静态文件、默认静态页面、静态文件目录浏览,在asp.net core分别是通过usestaticfiles、usedefaultfiles、usedirectorybrowser三个中间件去处理。只有配置了相关中间件才能去操作对应的处理,相信大家对这种操作已经很熟了。静态文件操作相关的源码都位于github aspnetcore仓库中的https://github.com/dotnet/aspnetcore/tree/v3.1.6/src/middleware/staticfiles/src目录。接下来我们分别探究这三个中间件的相关代码,来揭开静态文件处理的神秘面纱。
usestaticfiles
usestaticfiles中间件使我们处理静态文件时最常使用的中间件,因为只有开启了这个中间件我们才能使用静态文件,比如在使用mvc开发的时候需要私用js css html等文件都需要用到它,使用的方式也比较简单
//使用默认路径,即wwwroot app.usestaticfiles(); //或自定义读取路径 var fileprovider = new physicalfileprovider($"{env.contentrootpath}/staticfiles"); app.usestaticfiles(new staticfileoptions { requestpath="/staticfiles", fileprovider = fileprovider });
我们直接找到中间件的注册类staticfileextensions[点击查看staticfileextensions源码]
public static class staticfileextensions { public static iapplicationbuilder usestaticfiles(this iapplicationbuilder app) { return app.usemiddleware<staticfilemiddleware>(); } public static iapplicationbuilder usestaticfiles(this iapplicationbuilder app, string requestpath) { return app.usestaticfiles(new staticfileoptions { requestpath = new pathstring(requestpath) }); } public static iapplicationbuilder usestaticfiles(this iapplicationbuilder app, staticfileoptions options) { return app.usemiddleware<staticfilemiddleware>(options.create(options)); } }
一般我们最常用到的是无参的方式和传递自定义staticfileoptions的方式比较多,staticfileoptions是自定义使用静态文件时的配置信息类,接下来我们大致看一下具体包含哪些配置项[点击查看staticfileoptions源码]
public class staticfileoptions : sharedoptionsbase { public staticfileoptions() : this(new sharedoptions()) { } public staticfileoptions(sharedoptions sharedoptions) : base(sharedoptions) { onprepareresponse = _ => { }; } /// <summary> /// 文件类型提供程序,也就是我们常用的文件名对应mimetype的对应关系 /// </summary> public icontenttypeprovider contenttypeprovider { get; set; } /// <summary> /// 设置该路径下默认文件输出类型 /// </summary> public string defaultcontenttype { get; set; } public bool serveunknownfiletypes { get; set; } /// <summary> /// 文件压缩方式 /// </summary> public httpscompressionmode httpscompression { get; set; } = httpscompressionmode.compress; /// <summary> /// 准备输出之前可以做一些自定义操作 /// </summary> public action<staticfileresponsecontext> onprepareresponse { get; set; } } public abstract class sharedoptionsbase { protected sharedoptionsbase(sharedoptions sharedoptions) { sharedoptions = sharedoptions; } protected sharedoptions sharedoptions { get; private set; } /// <summary> /// 请求路径 /// </summary> public pathstring requestpath { get { return sharedoptions.requestpath; } set { sharedoptions.requestpath = value; } } /// <summary> /// 文件提供程序,在.net core中如果需要访问文件相关操作可使用fileprovider文件提供程序获取文件相关信息 /// </summary> public ifileprovider fileprovider { get { return sharedoptions.fileprovider; } set { sharedoptions.fileprovider = value; } } }
我们自定义静态文件访问时,最常用到的就是requestpath和fileprovider,一个设置请求路径信息,一个设置读取文件信息。如果需要自定义mimetype映射关系可通过contenttypeprovider自定义设置映射关系
var provider = new fileextensioncontenttypeprovider(); provider.mappings[".myapp"] = "application/x-msdownload"; provider.mappings[".htm3"] = "text/html"; app.usestaticfiles(new staticfileoptions { contenttypeprovider = provider, //可以在输出之前设置输出相关 onprepareresponse = ctx => { ctx.context.response.headers.append("cache-control", $"public, max-age=3600"); } });
接下来我们步入正题直接查看staticfilemiddleware中间件的代码[点击查看staticfilemiddleware源码]
public class staticfilemiddleware { private readonly staticfileoptions _options; private readonly pathstring _matchurl; private readonly requestdelegate _next; private readonly ilogger _logger; private readonly ifileprovider _fileprovider; private readonly icontenttypeprovider _contenttypeprovider; public staticfilemiddleware(requestdelegate next, iwebhostenvironment hostingenv, ioptions<staticfileoptions> options, iloggerfactory loggerfactory) { _next = next; _options = options.value; //设置文件类型提供程序 _contenttypeprovider = options.value.contenttypeprovider ?? new fileextensioncontenttypeprovider(); //文件提供程序 _fileprovider = _options.fileprovider ?? helpers.resolvefileprovider(hostingenv); //匹配路径 _matchurl = _options.requestpath; _logger = loggerfactory.createlogger<staticfilemiddleware>(); } public task invoke(httpcontext context) { //判断是够获取到终结点信息,这也就是为什么我们使用usestaticfiles要在userouting之前 if (!validatenoendpoint(context)) { } //判断httpmethod,只能是get和head操作 else if (!validatemethod(context)) { } //判断请求路径是否存在 else if (!validatepath(context, _matchurl, out var subpath)) { } //根据请求文件名称判断是否可以匹配到对应的mimetype,如果匹配到则返回contenttype else if (!lookupcontenttype(_contenttypeprovider, _options, subpath, out var contenttype)) { } else { //执行静态文件操作 return tryservestaticfile(context, contenttype, subpath); } return _next(context); } private task tryservestaticfile(httpcontext context, string contenttype, pathstring subpath) { var filecontext = new staticfilecontext(context, _options, _logger, _fileprovider, contenttype, subpath); //判断文件是否存在 if (!filecontext.lookupfileinfo()) { _logger.filenotfound(filecontext.subpath); } else { //静态文件处理 return filecontext.servestaticfile(context, _next); } return _next(context); } }
关于fileextensioncontenttypeprovider这里就不作讲解了,主要是承载文件扩展名和mimetype的映射关系代码不复杂,但是映射关系比较多,有兴趣的可以自行查看fileextensioncontenttypeprovider源码,通过上面我们可以看到,最终执行文件相关操作的是staticfilecontext类[点击查看staticfilecontext源码]
internal struct staticfilecontext { private const int streamcopybuffersize = 64 * 1024; private readonly httpcontext _context; private readonly staticfileoptions _options; private readonly httprequest _request; private readonly httpresponse _response; private readonly ilogger _logger; private readonly ifileprovider _fileprovider; private readonly string _method; private readonly string _contenttype; private ifileinfo _fileinfo; private entitytagheadervalue _etag; private requestheaders _requestheaders; private responseheaders _responseheaders; private rangeitemheadervalue _range; private long _length; private readonly pathstring _subpath; private datetimeoffset _lastmodified; private preconditionstate _ifmatchstate; private preconditionstate _ifnonematchstate; private preconditionstate _ifmodifiedsincestate; private preconditionstate _ifunmodifiedsincestate; private requesttype _requesttype; public staticfilecontext(httpcontext context, staticfileoptions options, ilogger logger, ifileprovider fileprovider, string contenttype, pathstring subpath) { _context = context; _options = options; _request = context.request; _response = context.response; _logger = logger; _fileprovider = fileprovider; _method = _request.method; _contenttype = contenttype; _fileinfo = null; _etag = null; _requestheaders = null; _responseheaders = null; _range = null; _length = 0; _subpath = subpath; _lastmodified = new datetimeoffset(); _ifmatchstate = preconditionstate.unspecified; _ifnonematchstate = preconditionstate.unspecified; _ifmodifiedsincestate = preconditionstate.unspecified; _ifunmodifiedsincestate = preconditionstate.unspecified; //再次判断请求httpmethod if (httpmethods.isget(_method)) { _requesttype = requesttype.isget; } else if (httpmethods.ishead(_method)) { _requesttype = requesttype.ishead; } else { _requesttype = requesttype.unspecified; } } /// <summary> /// 判断文件是否存在 /// </summary> public bool lookupfileinfo() { //判断根据请求路径是否可以获取到文件信息 _fileinfo = _fileprovider.getfileinfo(_subpath.value); if (_fileinfo.exists) { //获取文件长度 _length = _fileinfo.length; //最后修改日期 datetimeoffset last = _fileinfo.lastmodified; _lastmodified = new datetimeoffset(last.year, last.month, last.day, last.hour, last.minute, last.second, last.offset).touniversaltime(); //etag标识 long etaghash = _lastmodified.tofiletime() ^ _length; _etag = new entitytagheadervalue('\"' + convert.tostring(etaghash, 16) + '\"'); } return _fileinfo.exists; } /// <summary> /// 处理文件输出 /// </summary> public async task servestaticfile(httpcontext context, requestdelegate next) { //1.准备输出相关header,主要是获取和输出静态文件输出缓存相关的内容 //2.我们之前提到的onprepareresponse也是在这里执行的 comprehendrequestheaders(); //根据comprehendrequestheaders方法获取到的文件状态进行判断 switch (getpreconditionstate()) { case preconditionstate.unspecified: //处理文件输出 case preconditionstate.shouldprocess: //判断是否是head请求 if (isheadmethod) { await sendstatusasync(constants.status200ok); return; } try { //判断是否包含range请求,即文件分段下载的情况 if (israngerequest) { await sendrangeasync(); return; } //正常文件输出处理 await sendasync(); _logger.fileserved(subpath, physicalpath); return; } catch (filenotfoundexception) { context.response.clear(); } await next(context); return; case preconditionstate.notmodified: await sendstatusasync(constants.status304notmodified); return; case preconditionstate.preconditionfailed: await sendstatusasync(constants.status412preconditionfailed); return; default: var exception = new notimplementedexception(getpreconditionstate().tostring()); throw exception; } } /// <summary> /// 通用文件文件返回处理 /// </summary> public async task sendasync() { setcompressionmode(); applyresponseheaders(constants.status200ok); string physicalpath = _fileinfo.physicalpath; var sendfile = _context.features.get<ihttpresponsebodyfeature>(); //判断是否设置过输出特征操作相关,比如是否启动输出压缩,或者自定义的输出处理比如输出加密等等 if (sendfile != null && !string.isnullorempty(physicalpath)) { await sendfile.sendfileasync(physicalpath, 0, _length, cancellationtoken.none); return; } try { //不存在任何特殊处理的操作作,直接读取文件返回 using (var readstream = _fileinfo.createreadstream()) { await streamcopyoperation.copytoasync(readstream, _response.body, _length, streamcopybuffersize, _context.requestaborted); } } catch (operationcanceledexception ex) { _context.abort(); } } /// <summary> /// 分段请求下载操作处理 /// </summary> internal async task sendrangeasync() { if (_range == null) { responseheaders.contentrange = new contentrangeheadervalue(_length); applyresponseheaders(constants.status416rangenotsatisfiable); _logger.rangenotsatisfiable(subpath); return; } //计算range相关header数据 responseheaders.contentrange = computecontentrange(_range, out var start, out var length); _response.contentlength = length; //设置输出压缩相关header setcompressionmode(); applyresponseheaders(constants.status206partialcontent); string physicalpath = _fileinfo.physicalpath; var sendfile = _context.features.get<ihttpresponsebodyfeature>(); //判断是否设置过输出特征操作相关,比如是否启动输出压缩,或者自定义的输出处理比如输出加密等等 if (sendfile != null && !string.isnullorempty(physicalpath)) { _logger.sendingfilerange(_response.headers[headernames.contentrange], physicalpath); await sendfile.sendfileasync(physicalpath, start, length, cancellationtoken.none); return; } try { using (var readstream = _fileinfo.createreadstream()) { readstream.seek(start, seekorigin.begin); _logger.copyingfilerange(_response.headers[headernames.contentrange], subpath); //设置文件输出起始位置和读取长度 await streamcopyoperation.copytoasync(readstream, _response.body, length, _context.requestaborted); } } catch (operationcanceledexception ex) { _context.abort(); } } }
关的读取设置和处理,其此次是针对正常返回和分段返回的情况,在返回之前判断是否有对输出做特殊处理的情况,比如输出压缩或者自定义的其他输出操作的ihttpresponsebodyfeature,分段返回和正常返回相比主要是多了一部分关于http头content-range相关的设置,对于读取本身其实只是读取的起始位置和读取长度的差别。
usedirectorybrowser
目录浏览允许在指定目录中列出目录里的文件及子目录。出于安全方面考虑默认情况下是关闭的可以通过usedirectorybrowser中间件开启指定目录浏览功能。通常情况下我们会这样使用
//启用默认目录浏览,即wwwroot app.usedirectorybrowser(); //或自定义指定目录浏览 var fileprovider = new physicalfileprovider($"{env.contentrootpath}/myimages"); app.usedirectorybrowser(new directorybrowseroptions { requestpath = "/myimages", fileprovider = fileprovider });
开启之后当我们访问https://
/myimages地址的时候将会展示如下效果,通过一个表格展示目录里的文件信息等
找
到中间件注册类[点击查看directorybrowserextensions源码]
public static class directorybrowserextensions { public static iapplicationbuilder usedirectorybrowser(this iapplicationbuilder app) { return app.usemiddleware<directorybrowsermiddleware>(); } public static iapplicationbuilder usedirectorybrowser(this iapplicationbuilder app, string requestpath) { return app.usedirectorybrowser(new directorybrowseroptions { requestpath = new pathstring(requestpath) }); } public static iapplicationbuilder usedirectorybrowser(this iapplicationbuilder app, directorybrowseroptions options) { return app.usemiddleware<directorybrowsermiddleware>(options.create(options)); } }
这个中间件启用的重载方法和usestaticfiles类似最终都是在传递directorybrowseroptions,接下来我们就看directorybrowseroptions传递了哪些信息[点击查看directorybrowseroptions源码]
public class directorybrowseroptions : sharedoptionsbase { public directorybrowseroptions() : this(new sharedoptions()) { } public directorybrowseroptions(sharedoptions sharedoptions) : base(sharedoptions) { } /// <summary> /// 目录格式化提供,默认是提供表格的形式展示,课自定义 /// </summary> public idirectoryformatter formatter { get; set; } }
无独有偶这个类和staticfileoptions一样也是集成自sharedoptionsbase类,唯一多了idirectoryformatter操作,通过它我们可以自定义展示到页面的输出形式,接下来我们就重点看下directorybrowsermiddleware中间件的实现
public class directorybrowsermiddleware { private readonly directorybrowseroptions _options; private readonly pathstring _matchurl; private readonly requestdelegate _next; private readonly idirectoryformatter _formatter; private readonly ifileprovider _fileprovider; public directorybrowsermiddleware(requestdelegate next, iwebhostenvironment hostingenv, ioptions<directorybrowseroptions> options) : this(next, hostingenv, htmlencoder.default, options) { } public directorybrowsermiddleware(requestdelegate next, iwebhostenvironment hostingenv, htmlencoder encoder, ioptions<directorybrowseroptions> options) { _next = next; _options = options.value; //默认是提供默认目录的访问程序 _fileprovider = _options.fileprovider ?? helpers.resolvefileprovider(hostingenv); //默认传递的是htmldirectoryformatter类型,也就是我们看到的输出表格的页面 _formatter = options.value.formatter ?? new htmldirectoryformatter(encoder); _matchurl = _options.requestpath; } public task invoke(httpcontext context) { //1.isgetorheadmethod判断是否为get或head请求 //2.trymatchpath判断请求的路径和设置的路径是否可以匹配的上 //3.trygetdirectoryinfo判断根据匹配出来的路径能否查找到真实的物理路径 if (context.getendpoint() == null && helpers.isgetorheadmethod(context.request.method) && helpers.trymatchpath(context, _matchurl, fordirectory: true, subpath: out var subpath) && trygetdirectoryinfo(subpath, out var contents)) { //判断请求路径是否是/为结尾 if (!helpers.pathendsinslash(context.request.path)) { //如果不是以斜线结尾则重定向(个人感觉直接在服务端重定向就可以了,为啥还要返回浏览器在请求一次) context.response.statuscode = statuscodes.status301movedpermanently; var request = context.request; var redirect = urihelper.buildabsolute(request.scheme, request.host, request.pathbase, request.path + "/", request.querystring); context.response.headers[headernames.location] = redirect; return task.completedtask; } //返回展示目录的内容 return _formatter.generatecontentasync(context, contents); } return _next(context); } /// <summary> /// 根据请求路径匹配到物理路径信息是否存在,存在则返回路径信息 /// </summary> private bool trygetdirectoryinfo(pathstring subpath, out idirectorycontents contents) { contents = _fileprovider.getdirectorycontents(subpath.value); return contents.exists; } }
这个操作相对简单了许多,主要就是判断请求路径能否和预设置的路径匹配的到,如果匹配到则获取可以操作当前目录内容idirectorycontents然后通过idirectoryformatter输出如何展示目录内容,关于idirectoryformatter的默认实现类htmldirectoryformatter这里就不展示里面的代码了,逻辑非常的加单就是拼接成table的html代码然后输出,有兴趣的同学可自行查看源码[点击查看htmldirectoryformatter源码],如果自定义的话规则也非常简单,主要看你想输出啥
public class treedirectoryformatter: idirectoryformatter { public task generatecontentasync(httpcontext context, ienumerable<ifileinfo> contents) { //遍历contents实现你想展示的方式 } }
然后在usedirectorybrowser的时候给formatter赋值即可
app.usedirectorybrowser(new directorybrowseroptions { formatter = new treedirectoryformatter() });
usedefaultfiles
很多时候出于安全考虑或者其他原因我们想在访问某个目录的时候返回一个默认的页面或展示,这个事实我们就需要使用usedefaultfiles中间件,当我们配置了这个中间件,如果命中了配置路径,那么会直接返回默认的页面信息,简单使用方式如下
//wwwroot目录访问展示默认文件 app.usedefaultfiles(); //或自定义目录默认展示文件 var fileprovider = new physicalfileprovider($"{env.contentrootpath}/staticfiles"); app.usedefaultfiles(new defaultfilesoptions { requestpath = "/staticfiles", fileprovider = fileprovider });
老规矩,我们查看下注册usedefaultfiles的源码[点击查看defaultfilesextensions源码]
public static class defaultfilesextensions { public static iapplicationbuilder usedefaultfiles(this iapplicationbuilder app) { return app.usemiddleware<defaultfilesmiddleware>(); } public static iapplicationbuilder usedefaultfiles(this iapplicationbuilder app, string requestpath) { return app.usedefaultfiles(new defaultfilesoptions { requestpath = new pathstring(requestpath) }); } public static iapplicationbuilder usedefaultfiles(this iapplicationbuilder app, defaultfilesoptions options) { return app.usemiddleware<defaultfilesmiddleware>(options.create(options)); } }
使用方式和usestaticfiles、usedirectorybrowser是一样,最终都是调用传递defaultfilesoptions的方法,我们查看一下defaultfilesoptions的大致实现[点击查看源码]
public class defaultfilesoptions : sharedoptionsbase { public defaultfilesoptions() : this(new sharedoptions()) { } public defaultfilesoptions(sharedoptions sharedoptions) : base(sharedoptions) { //系统提供的默认页面的名称 defaultfilenames = new list<string> { "default.htm", "default.html", "index.htm", "index.html", }; } /// <summary> /// 通过这个属性可以配置默认文件名称 /// </summary> public ilist<string> defaultfilenames { get; set; } }
和之前的方法如出一辙,都是继承自sharedoptionsbase,通过defaultfilenames我们可以配置默认文件的名称,默认是default.html/htm和index.html/htm。我们直接查看中间件defaultfilesmiddleware的源码[点击查看源码]
public class defaultfilesmiddleware { private readonly defaultfilesoptions _options; private readonly pathstring _matchurl; private readonly requestdelegate _next; private readonly ifileprovider _fileprovider; public defaultfilesmiddleware(requestdelegate next, iwebhostenvironment hostingenv, ioptions<defaultfilesoptions> options) { _next = next; _options = options.value; _fileprovider = _options.fileprovider ?? helpers.resolvefileprovider(hostingenv); _matchurl = _options.requestpath; } public task invoke(httpcontext context) { //1.我们使用usedefaultfiles中间件的时候要置于userouting之上,否则就会不生效 //2.isgetorheadmethod判断请求为get或head的情况下才生效 //3.trymatchpath判断请求的路径和设置的路径是否可以匹配的上 if (context.getendpoint() == null && helpers.isgetorheadmethod(context.request.method) && helpers.trymatchpath(context, _matchurl, fordirectory: true, subpath: out var subpath)) { //根据匹配路径获取物理路径对应的信息 var dircontents = _fileprovider.getdirectorycontents(subpath.value); if (dircontents.exists) { //循环配置的默认文件名称 for (int matchindex = 0; matchindex < _options.defaultfilenames.count; matchindex++) { string defaultfile = _options.defaultfilenames[matchindex]; //匹配配置的启用默认文件的路径+遍历到的默认文件名称的路径是否存在 var file = _fileprovider.getfileinfo(subpath.value + defaultfile); if (file.exists) { //判断请求路径是否已"/"结尾,如果不是则从定向(这个点个人感觉可以改进) if (!helpers.pathendsinslash(context.request.path)) { context.response.statuscode = statuscodes.status301movedpermanently; var request = context.request; var redirect = urihelper.buildabsolute(request.scheme, request.host, request.pathbase, request.path + "/", request.querystring); context.response.headers[headernames.location] = redirect; return task.completedtask; } //如果匹配的上,则将配置的启用默认文件的路径+遍历到的默认文件名称的路径组合成新的path交给_next(context) //比如将组成类似这种路径/staticfiles/index.html向下传递 context.request.path = new pathstring(context.request.path.value + defaultfile); break; } } } } return _next(context); } }
这个中间件的实现思路也非常简单主要的工作就是,匹配配置的启用默认文件的路径+遍历到的默认文件名称的路径是否存在,如果匹配的上,则将配置的启用默认文件的路径+遍历到的默认文件名称的路径组合成新的path(比如/staticfiles/index.html)交给后续的中间件去处理。这里值得注意的是usedefaultfiles 必须要配合usestaticfiles一起使用,而且注册位置要出现在usestaticfiles之上。这也是为什么usedefaultfiles只需要匹配到默认文件所在的路径并重新赋值给context.request.path既可的原因。
当然我们也可以自定义默认文件的名称,因为只要能匹配的到具体的文件既可
var defaultfilesoptions = new defaultfilesoptions { requestpath = "/staticfiles", fileprovider = fileprovider }; //我们可以清除掉系统默认的默认文件名称 defaultfilesoptions.defaultfilenames.clear(); defaultfilesoptions.defaultfilenames.add("mydefault.html"); app.usedefaultfiles(defaultfilesoptions);
总结
通过上面的介绍我们已经大致了解了静态文件处理的大致实现思路,相对于传统的asp.net程序我们可以更方便的处理静态文件信息,但是思路是一致的,iis会优先处理静态文件,如果静态文件处理不了的情况才会交给程序去处理。asp.net core也不例外,通过我们查看中间件源码里的context.getendpoint()==null判断可以知道,asp.net core更希望我们优先去处理静态文件,而不是任意出现在其他位置去处理。关于asp.net core处理静态文件的讲解就到这里,欢迎评论区探讨交流。
到此这篇关于浅谈asp.net core静态文件处理源码探究的文章就介绍到这了,更多相关asp.net core静态文件处理内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!