ASP.NET Core应用针对静态文件请求的处理[3]: StaticFileMiddleware中间件如何处理针对文件请求
我们通过《以Web的形式发布静态文件》和《条件请求与区间请求》中的实例演示,以及上面针对条件请求和区间请求的介绍,从提供的功能和特性的角度对这个名为StaticFileMiddleware的中间进行了全面的介绍,接下来我们将更近一步,将从实现原理的角度来进一步认识这个中间件。 [本文已经同步到《ASP.NET Core框架揭秘》之中]
目录
一、StaticFileMiddleware
二、ContentTypeProvider
三、利用配置指定StaticFileOptions
四、实现原理
一、StaticFileMiddleware
不过在此之前,我们先来看看StaticFileMiddleware这个类型的定义。
1: public class StaticFileMiddleware
2: {
3: public StaticFileMiddleware(RequestDelegate next, IHostingEnvironment hostingEnv, IOptions<StaticFileOptions> options, ILoggerFactory loggerFactory);
4: public Task Invoke(HttpContext context);
5: }
如上面的代码片段所示,除了作为“下一个中间件”的next参数之前,StaticFileMiddleware的构造函数还包含三个参数。其中hostingEnv和loggerFactory这两个参数分别表示当前执行环境和用来创建Logger的工厂,最重要的options参数表示为这个中间件指定的配置选项,至于具体可以提供怎样的配置选项,我们只需要看看 StaticFileOptions这个类型提供了怎样的属性成员。
1: public class StaticFileOptions : SharedOptionsBase
2: {
3: public IContentTypeProvider ContentTypeProvider { get; set; }
4: public string DefaultContentType { get; set; }
5: public bool ServeUnknownFileTypes { get; set; }
6: public Action<StaticFileResponseContext> OnPrepareResponse { get; set; }
7:
8: public StaticFileOptions();
9: public StaticFileOptions(SharedOptions sharedOptions);
10: }
11:
12: public abstract class SharedOptionsBase
13: {
14: protected SharedOptionsBase(SharedOptions sharedOptions);
15: public IFileProvider FileProvider { get; set; }
16: public PathString RequestPath { get; set; }
17: }
18:
19: public class SharedOptions
20: {
21: public IFileProvider FileProvider { get; set; }
22: public PathString RequestPath { get; set; }
23: }
24:
25: public class StaticFileResponseContext
26: {
27: public HttpContext Context { get; }
28: public IFileInfo File { get; }
29: }
如上面的代码片段所示,StaticFileOptions继承自抽象类型SharedOptionsBase,后者实际上体现的是两个路径之间的映射关系,一个是HTTP请求采用的路径,另一个则是文件的物理地址,后者体现为一个FileProvider对象。不过也正是因为文件的读取是通过这个FileProvider来完成的,而FileProvider未必就一定对应着具体的物理文件,所以StaticFileMiddleware并不限于针对专门处理“物理文件”。
直接定义在StaticFileOptions中的前三个类型都与媒体类型的解析有关,其中ContentTypeProvider属性返回一个根据请求相对地址进行媒体类型的ContentTypeProvider对象。如果这个ContentTypeProvider不能正确解析出目标文件的媒体类型,我们可以利用DefaultContentType设置一个默认媒体类型。但是只有将另一个名为ServeUnknownFileTypes的属性设置为True的情况下,媒体类型不能正常识别的请求采用使用这个默认设置的媒体类型。
StaticFileOptions还具有一个OnPrepareResponse属性,它返回一个Action<StaticFileResponseContext>类型的委托对象,我们可以为这属性指定的委托对象来对最终的响应进行定制。至于作为委托输入参数的是一个类型为StaticFileResponseContext的对象,我们利用它可以获得当前的HTTP上下文和目标文件。
针对StaticFileMiddleware这个中间件的注册一般都是调用针对ApplicationBuilder的UseStaticFiles扩展方法来完成的。具体来说,一共具有三个UseStaticFiles方法重载供我们选择,如下所示的代码片段展示了这三个扩展方法的实现。
1: public static class StaticFileExtensions
2: {
3: public static IApplicationBuilder UseStaticFiles(this IApplicationBuilder app)
4: {
5: return app.UseMiddleware<StaticFileMiddleware>();
6: }
7:
8: public static IApplicationBuilder UseStaticFiles(this IApplicationBuilder app,StaticFileOptions options)
9: {
10: return app.UseMiddleware<StaticFileMiddleware>(Options.Create<StaticFileOptions>(options));
11: }
12:
13: public static IApplicationBuilder UseStaticFiles(this IApplicationBuilder app, string requestPath)
14: {
15: StaticFileOptions options = new StaticFileOptions
16: {
17: RequestPath = new PathString(requestPath)
18: };
19: return app.UseStaticFiles(options);
20: }
21: }
二、ContentTypeProvider
StaticFileMiddleware针对物理文件请求的处理并不仅仅限于完成文件内容的响应,还需要针对文件的格式解析出正确的媒体类型。对于客户端来说,如果无法确定媒体类型,获取的文件就像是一步无法解码的天书,毫无意义。StaticFileMiddleware利用指定的ContentTypeProvider来解析媒体类型,ContentTypeProvider是我们对实现了IContentTypeProvider接口的所有类型以及对应对象的统称。如下面的代码片段所示,IContentTypeProvider接口定义了唯一的方法TryGetContentType根据当前请求的相对路径来解析这个作为输出参数的媒体类型。
1: public interface IContentTypeProvider
2: {
3: bool TryGetContentType(string subpath, out string contentType);
4: }
StaticFileMiddleware默认使用的ContentProvider是一个具有如下定义的FileExtensionContentTypeProvider对象。顾名思义,FileExtensionContentTypeProvider利用物理文件的扩展名来解析对应的媒体类型,它利用其Mappings属性表示的字典维护了一个扩展名与媒体类型之间的映射关系。我们常用的数百种标准的文件扩展名和对应的媒体类型之间的映射关系都会保存在爱这个字典中。如果我们发布的文件具有一些特殊的扩展名,或者我们需要现有的某些扩展名映射为不同的媒体类型,这些通过添加或者修改映射关系来实现。
1: public class FileExtensionContentTypeProvider : IContentTypeProvider
2: {
3: public IDictionary<string, string> Mappings { get; }
4:
5: public FileExtensionContentTypeProvider();
6: public FileExtensionContentTypeProvider(IDictionary<string, string> mapping);
7:
8: public bool TryGetContentType(string subpath, out string contentType);
9: }
三、利用配置指定StaticFileOptions
由于StaticFileMiddleware的构造函数用来设置相关选项的options参数类型为IOptions<StaticFileOptions>,所以我们可以根据Options模式将StaticFileOptions对象承载的部分选项定义在配置文件中。比如我们利用如下所示的一个JSON文件开启了针对未知文件类型的支持,并设置了默认使用媒体类型(“application/octet-stream”),这两个配置项对应着StaticFileOptions的同名属性。
1: {
2: "serveUnknownFileTypes" : true,
3: "defaultContentType" : "application/octet-stream"
4: }
有了这个配置文件(假设文件名为“StaticFileOptions.json”),我们就可以按照如下的方式加载它并生成对应的Configuration对象,然后采用Options模式特有的编程模式实现与StaticFileOptions类型的映射。这样的配置将会自动应用到注册的StaticFileMiddleware中间件上。
1: public class Program
2: {
3: public static void Main()
4: {
5: IConfiguration config = new ConfigurationBuilder()
6: .AddJsonFile("StaticFileOptions.json")
7: .Build();
8:
9: new WebHostBuilder()
10: .UseContentRoot(Directory.GetCurrentDirectory())
11: .UseKestrel()
12: .ConfigureServices(svsc=>svsc.Configure<StaticFileOptions>(config))
13: .Configure(app=>app.UseStaticFiles())
14: .Build()
15: .Run();
16: }
17: }
对于上面这样的应用,所有未知文件类型都将自动映射为“application/octet-stream”媒体类型。如果使用浏览器请求一个未知类型的文件(比如前面演示的“~/wwwroot/img/ dophin1.img”),目标文件将以如下图所示的形式以一个附件的形式被下载。
四、实现原理
为了上读者朋友们对针对静态文件的请求在StaticFileMiddleware中间件的处理具有更加深刻的认识,接下来我们会采用相对简单的代码来重新定义这个中间件。这部分作为选修内容供有兴趣的读者朋友阅读,忽略这些内容不会影响对后续内容的理解。这个模拟中间件具有与StaticFileMiddleware相同的能力,它能够将目标文件的内容采用正确的媒体类型响应给客户端,同时能够处理条件请求和区间请求。
StaticFileMiddleware中间处理针对静态文件请求的整个处理流程大体上可以划分为如上图所示的三个步骤:
- 获取目标文件:中间件根据请求的路径获取目标文件,并解析出正确的媒体类型。在此之前,中间件还会验证请求采用的方法,它支持GET和HEAD请求。除此之外,中间件还会获取文件最后被修改的时间,然后根据这个时间戳和文件内容的长度生成一个签名,响应消息的Last-odified和ETag报头的内容来源于此。
- 条件请求解析:获取与条件请求相关的四个报头(If-Match、If-None-Match、If-Modified-Since和If-Unmodified-Since)的值,根据HTTP规范计算出最终的条件状态。
- 响应请求:如果是区间请求,中间件会获取相关的报头(Range和If-Range)解析出正确的内容区间。中间件最终根据上面计算的条件状态和区间相关信息设置响应的响应报头,并根据需要响应整个文件的内容或者指定区间的内容。
接下来我们按照上述的这个流程来重新定义这个StaticFileMiddleware,不过在此之前先来了解一下我们预先定义的几个辅助性的扩展方法。如下面代码片段所示,扩展方法UseMethods用于判指定的请求是否采用指定的HTTP方法,而TryGetSubpath用于解析请求的目标文件的相对路径。TryGetContentType方法会根据指定的StaticFileOptions携带的ContentTypeProvider解析出正确的媒体类型,而TryGetFileInfo则根据指定的路径获取描述目标文件的FileInfo对象。至于最后的IsRangeRequest方法,它会根据是否携带Rang报头判断指定的请求是否是一个区间请求。
1: public static class Extensions
2: {
3: public static bool UseMethods(this HttpContext context, params string[] methods)
4: {
5: return methods.Contains(context.Request.Method, StringComparer.OrdinalIgnoreCase);
6: }
7:
8: public static bool TryGetSubpath(this HttpContext context, string requestPath, out PathString subpath)
9: {
10: return new PathString(context.Request.Path).StartsWithSegments(requestPath, out subpath);
11: }
12:
13: public static bool TryGetContentType(this StaticFileOptions options, PathString subpath, out string contentType)
14: {
15: return options.ContentTypeProvider.TryGetContentType(subpath.Value, out contentType) ||(!string.IsNullOrEmpty(contentType = options.DefaultContentType) && options.ServeUnknownFileTypes);
16: }
17:
18: public static bool TryGetFileInfo(this StaticFileOptions options, PathString subpath, out IFileInfo fileInfo)
19: {
20: return (fileInfo = options.FileProvider.GetFileInfo(subpath.Value)).Exists;
21: }
22:
23: public static bool IsRangeRequest(this HttpContext context)
24: {
25: return context.Request.GetTypedHeaders().Range != null;
26: }
27: }
如下所示的模拟类型 StaticFileMiddleware的定义。如果指定的StaticFileOptions没有提供FileProvider,我们会默认使用指向WebRoot目录的那个PhysicalFileProvider。如果一个具体的ContentTypeProvider没有显式指定,我们使用的则是一个FileExtensionContentTypeProvider对象。这两个默认值分别解释了两个问题,为什么请求的静态文件将WebRoot作为默认的根目录,以及为什么目标文件的扩展名决定响应的媒体类型。
1: public class StaticFileMiddleware
2: {
3: private RequestDelegate _next;
4: private StaticFileOptions _options;
5:
6: public StaticFileMiddleware(RequestDelegate next, IHostingEnvironment env, IOptions<StaticFileOptions> options)
7: {
8: _next = next;
9: _options = options.Value;
10: _options.FileProvider = _options.FileProvider??env.WebRootFileProvider;
11: _options.ContentTypeProvider = _options.ContentTypeProvider ?? new FileExtensionContentTypeProvider();
12: }
13: ...
14: }
我们上述的三个步骤分别实现在三个对应的方法(TryGetFileInfo、ResolvePreconditionState和SendResponseAsync)中,所以StaticFileMiddleware的Invoke方法按照如下的方式先后调用这三个方法完整对整个请求的处理。
1: public class StaticFileMiddleware
2: {
3: public async Task Invoke(HttpContext context)
4: {
5: IFileInfo fileInfo;
6: string contentType;
7: DateTimeOffset? lastModified;
8: EntityTagHeaderValue etag;
9:
10: if (this.TryGetFileInfo(context, out contentType, out fileInfo, out lastModified, out etag))
11: {
12: PreconditionState preconditionState = this.GetPreconditionState(context, lastModified.Value, etag);
13: await this.SendResponseAsync(preconditionState, context, etag, lastModified.Value, contentType, fileInfo);
14: return;
15: }
16: await _next(context);
17: }
18: ...
19: }
接下来我们的重点就集中到上述这三个方法的实现上。我们首先看看TryGetFileInfo方法是如何根据请求的路径获得描述目标文件的FileInfo对象的。如下面的代码片段所示,如果目标文件存在,这个方法除了将目标文件的FileInfo对象作为输出参数返回之外,与这个文件相关的数据(媒体类型、最后修改时间戳和封装签名的ETag)。
1: public class StaticFileMiddleware
2: {
3: public bool TryGetFileInfo(HttpContext context, out string contentType, out IFileInfo fileInfo, out DateTimeOffset? lastModified, out EntityTagHeaderValue etag)
4: {
5: contentType = null;
6: fileInfo = null;
7: PathString subpath;
8:
9: if (context.UseMethods("GET", "HEAD") &&context.TryGetSubpath(_options.RequestPath, out subpath) &&_options.TryGetContentType(subpath, out contentType) &&_options.TryGetFileInfo(subpath, out fileInfo))
10: {
11: DateTimeOffset last = fileInfo.LastModified;
12: long etagHash = last.ToFileTime() ^ fileInfo.Length;
13: etag = new EntityTagHeaderValue('\"' + Convert.ToString(etagHash, 16) + '\"');
14: lastModified = new DateTimeOffset(last.Year, last.Month, last.Day, last.Hour, last.Minute, last.Second, last.Offset).ToUniversalTime();
15: return true;
16: }
17:
18: etag = null;
19: lastModified = null;
20: return false;
21: }
22: }
方法 GetPreconditionState旨在获取与条件请求相关的四个报头(If-Match、If-None-Match、If-Modified-Since和If-Unmodified-Since)的值,并通过与目标文件当前的状态进行比较,进而得到一个最终的检验结果。针对这四个请求报头的检验最终会产生四种可能的结果,所以我们定义了如下一个PreconditionState枚举来表示它们。
1: private enum PreconditionState
2: {
3: Unspecified = 0,
4: NotModified = 1,
5: ShouldProcess = 2,
6: PreconditionFailed = 3,
7: }
对于定义在这个枚举类型中的四个选项,Unspecified表示请求中不包含这四个报头。如果将请求报头If-None-Match的值与当前文件签名进行比较,或者将请求If-Modified-Since报头的值与文件最后修改时间进行比较确定目标文件不曾改变,检验结果对应的枚举值为NotModified,反之对应的枚举值为ShouldProcess。如果目标文件当前的状态不满足If-Match或者If-Unmodified-Since报头表示的条件,检验结果对应的枚举值为PreconditionFailed,反之对应的枚举值为ShouldProcess。如果请求携带多个报头,针对它们会得出不同的检验结果,那么值最大的那个将最为最终的结果。如下面的代码片段所示,GetPreconditionState方法正是通过这样的逻辑得到这个标识最终条件检验结果的PreconditionState枚举。
1: public class StaticFileMiddleware
2: {
3: private PreconditionState GetPreconditionState(HttpContext context, DateTimeOffset lastModified, EntityTagHeaderValue etag)
4: {
5: PreconditionState ifMatch,ifNonematch, ifModifiedSince, ifUnmodifiedSince;
6: ifMatch = ifNonematch = ifModifiedSince = ifUnmodifiedSince = PreconditionState.Unspecified;
7:
8: RequestHeaders requestHeaders = context.Request.GetTypedHeaders();
9: //If-Match:ShouldProcess or PreconditionFailed
10: if (requestHeaders.IfMatch != null)
11: {
12: ifMatch = requestHeaders.IfMatch.Any(it => it.Equals(EntityTagHeaderValue.Any) || it.Compare(etag, true))
13: ? PreconditionState.ShouldProcess
14: : PreconditionState.PreconditionFailed;
15: }
16:
17: //If-None-Match:NotModified or ShouldProcess
18: if (requestHeaders.IfNoneMatch != null)
19: {
20: ifNonematch = requestHeaders.IfNoneMatch.Any(it => it.Equals(EntityTagHeaderValue.Any) || it.Compare(etag, true))
21: ? PreconditionState.NotModified
22: : PreconditionState.ShouldProcess;
23: }
24:
25: //If-Modified-Since: ShouldProcess or NotModified
26: if (requestHeaders.IfModifiedSince.HasValue)
27: {
28: ifModifiedSince = requestHeaders.IfModifiedSince < lastModified
29: ? PreconditionState.ShouldProcess
30: : PreconditionState.NotModified;
31: }
32:
33: //If-Unmodified-Since: ShouldProcess or PreconditionFailed
34: if (requestHeaders.IfUnmodifiedSince.HasValue)
35: {
36: ifUnmodifiedSince = requestHeaders.IfUnmodifiedSince > lastModified
37: ? PreconditionState.ShouldProcess
38: : PreconditionState.PreconditionFailed;
39: }
40:
41: //Return maximum.
42: return new PreconditionState[] { ifMatch, ifNonematch, ifModifiedSince, ifUnmodifiedSince }.Max();
43: }
44: ...
45: }
针对静态文件的处理最终实现在SendResponseAsync方法中,这个方法最终会设置相应的响应报头和状态码,如果需要还会将目标文件的内容写入到响应报文的主体。为响应选择怎样的状态码,设置哪些报头,以及响应内容的选择除了决定于GetPreconditionState方法返回的条件检验结果外,与区间请求相关的两个报头(Range和If-Range)也是决定因素之一。为了我们定义了如下这个TryGetRanges方法来解析这两个报头并计算出正确的区间。
1: public class StaticFileMiddleware
2: {
3: private bool TryGetRanges(HttpContext context, DateTimeOffset lastModified, EntityTagHeaderValue etag, long length, out IEnumerable<RangeItemHeaderValue> ranges)
4: {
5: ranges = null;
6: RequestHeaders requestHeaders = context.Request.GetTypedHeaders();
7:
8: //Check If-Range
9: RangeConditionHeaderValue ifRange = requestHeaders.IfRange;
10: if (ifRange != null)
11: {
12: bool ignore = (ifRange.EntityTag != null && !ifRange.EntityTag.Compare(etag, true)) ||(ifRange.LastModified.HasValue && ifRange.LastModified < lastModified);
13: if (ignore)
14: {
15: return false;
16: }
17: }
18:
19: List<RangeItemHeaderValue> list = new List<RangeItemHeaderValue>();
20: foreach (var it in requestHeaders.Range.Ranges)
21: {
22: //Range:{from}-{to} Or {from}-
23: if (it.From.HasValue)
24: {
25: if (it.From.Value < length - 1)
26: {
27: long to = it.To.HasValue ? Math.Min(it.To.Value, length - 1) : length - 1;
28: list.Add(new RangeItemHeaderValue(it.From.Value, to));
29: }
30: }
31: //Range:-{size}
32: else if (it.To.Value != 0)
33: {
34: long size = Math.Min(length, it.To.Value);
35: list.Add(new RangeItemHeaderValue(length - size, length - 1));
36: }
37: }
38: return ( ranges = list) != null;
39: }
40: …
41: }
如上面的代码片段所示,TryGetRanges方法会先获取If-Range报头的值,并与目标位文件当前的状态进行比较。如果当前状态不满足If-Range报头表示的条件,这种情况意味着目标文件内容发生变化,那么请求Range报头携带的区间信息将自动被忽略。至于Range报头携带的值,考虑到它具有不同的表现形式(比如“bytes={from}-{to}”、“bytes={from}-”或者“bytes=-{size}”)以及指定的端点是否超出目标文件长度,这个方法定义了相应的逻辑来检验区间定义的合法性以及计算出正确的区间范围。
对于区间请求,TryGetRanges的返回值表示目标文件的当前状态是否满足If-Range携带的条件相匹配。由于HTTP规范并未限制Range报头中设置的区间数量,所以这个方法通过输出参数返回的区间信息是一个元素类型为RangeItemHeaderValue的集合。如果集合为空,表示设置的区间不符合要求。
实现在SendResponseAsync方法中针对请求的处理不外乎指定响应状态码、设置响应报头和写入响应主体内。我们将前两个工作实现在HttpContext如下这个扩展方法SetResponseHeaders中。该方法会我们指定的响应状态码应用到指定的HttpContext,并设置相应的响应报头。
1: public static class Extensions
2: {
3: public static void SetResponseHeaders(this HttpContext context, int statusCode, EntityTagHeaderValue etag, DateTimeOffset lastModified, string contentType,long contentLength, RangeItemHeaderValue range = null)
4: {
5: context.Response.StatusCode = statusCode;
6: var responseHeaders = context.Response.GetTypedHeaders();
7: if (statusCode < 400)
8: {
9: responseHeaders.ETag = etag;
10: responseHeaders.LastModified = lastModified;
11: context.Response.ContentType = contentType;
12: context.Response.Headers[HeaderNames.AcceptRanges] = "bytes";
13: }
14: if (statusCode == 200)
15: {
16: context.Response.ContentLength = contentLength;
17: }
18:
19: if (statusCode == 416)
20: {
21: responseHeaders.ContentRange = new ContentRangeHeaderValue(contentLength);
22: }
23:
24: if (statusCode == 206 && range != null)
25: {
26: responseHeaders.ContentRange = new ContentRangeHeaderValue(range.From.Value, range.To.Value, contentLength);
27: }
28: }
29: }
如上面的代码片段所示,对于所有非错误类型的响应(主要指“200 OK”、“206 partial Content”和“304 Not Modified”),除了表示媒体类型的Content-Type报头之外,它们还具有三个额外的报头(Last-Modified、ETag和Accept-Range)。针对区间请求的两种响应(“206 partial Content”和“416 Range Not Satisfiable”),它们都具有一个Content-Range报头。
如下所示的是 SendResponseAsync方法的完整定义。它会根据条件请求和区间请求的解析结果来决定最终采用的响应状态码。响应状态和相关响应报头的设置通过调用上面这个SetResponseHeaders方法来完成。对于状态码为“200 OK”或者“206 Partial Content”的响应,这个方法会分别将整个文件内容或者指定区间的内容写入到响应报文的主体部分。至于文件的内容的读取,我们直接可以利用表示目标文件的FileInfo的CreateReadStream方法创建的读取文件输出流来实现。
1: public class StaticFileMiddleware
2: {
3: private async Task SendResponseAsync(PreconditionState state, HttpContext context, EntityTagHeaderValue etag, DateTimeOffset lastModified, string contentType, IFileInfo fileInfo)
4: {
5: switch (state)
6: {
7: //304 Not Modified
8: case PreconditionState.NotModified:
9: {
10: context.SetResponseHeaders(304, etag, lastModified, contentType, fileInfo.Length);
11: break;
12: }
13: //416 Precondition Failded
14: case PreconditionState.PreconditionFailed:
15: {
16: context.SetResponseHeaders(412, etag, lastModified, contentType,fileInfo.Length);
17: break;
18: }
19: case PreconditionState.Unspecified:
20: case PreconditionState.ShouldProcess:
21: {
22: //200 OK
23: if (context.UseMethods("HEAD"))
24: {
25: context.SetResponseHeaders(200, etag, lastModified, contentType, fileInfo.Length);
26: return;
27: }
28:
29: IEnumerable<RangeItemHeaderValue> ranges;
30: if (context.IsRangeRequest() && this.TryGetRanges(context, lastModified, etag, fileInfo.Length, out ranges))
31: {
32: RangeItemHeaderValue range = ranges.FirstOrDefault();
33: //416
34: if (null == range)
35: {
36: context.SetResponseHeaders(416, etag, lastModified,
37: contentType, fileInfo.Length);
38: return;
39: }
40: else
41: {
42: //206 Partial Content
43: context.SetResponseHeaders(206, etag, lastModified, contentType, fileInfo.Length, range);
44: context.Response.GetTypedHeaders().ContentRange = new ContentRangeHeaderValue(range.From.Value, range.To.Value, fileInfo.Length);
45: using (Stream stream = fileInfo.CreateReadStream())
46: {
47: stream.Seek(range.From.Value, SeekOrigin.Begin);
48: await StreamCopyOperation.CopyToAsync(stream, context.Response.Body, range.To - range.From + 1, context.RequestAborted);
49: }
50: return;
51: }
52: }
53: //200 OK
54: context.SetResponseHeaders(200, etag, lastModified, contentType, fileInfo.Length);
55: using (Stream stream = fileInfo.CreateReadStream())
56: {
57: await StreamCopyOperation.CopyToAsync(stream, context.Response.Body, fileInfo.Length, context.RequestAborted);
58: }
59: break;
60: }
61: }
62: }
63: }
ASP.NET Core应用针对静态文件请求的处理[1]: 以Web的形式发布静态文件
ASP.NET Core应用针对静态文件请求的处理[2]: 条件请求与区间请求
ASP.NET Core应用针对静态文件请求的处理[3]: StaticFileMiddleware中间件如何处理针对文件请求
ASP.NET Core应用针对静态文件请求的处理[4]: DirectoryBrowserMiddleware中间件如何呈现目录结构
ASP.NET Core应用针对静态文件请求的处理[5]: DefaultFilesMiddleware中间件如何显示默认页面
ASP.NET Core应用针对静态文件请求的处理[3]: StaticFileMiddleware中间件如何处理针对文件请求的更多相关文章
- StaticFileMiddleware中间件如何处理针对文件请求
StaticFileMiddleware中间件如何处理针对文件请求 我们通过<以Web的形式发布静态文件>和<条件请求与区间请求>中的实例演示,以及上面针对条件请求和区间请求的 ...
- ASP.NET Core 1.1 静态文件、路由、自定义中间件、身份验证简介
概述 之前写过一篇关于<ASP.NET Core 1.0 静态文件.路由.自定义中间件.身份验证简介>的文章,主要介绍了ASP.NET Core中StaticFile.Middleware ...
- (5)ASP.NET Core 中的静态文件
1.前言 当我们创建Core项目的时候,Web根目录下会有个wwwroot文件目录,wwwroot文件目录里面默认有HTML.CSS.IMG.JavaScript等文件,而这些文件都是Core提供给客 ...
- asp.net core 系列之静态文件
这篇讲解asp.net core中的静态文件(大致翻译于官网). 静态文件,例如HTML,CSS, images和JavaScript. 要想直接被客户端访问,需要做一些配置. 一.Serve sta ...
- Asp.Net Core 中的静态文件
Asp.Net Core 中的静态文件 在这节中我们将讨论如何使 ASP.NET Core 应用程序,支持静态文件,如 HTML,图像,CSS 和 JavaScript 文件. 静态文件 默认情况下, ...
- ASP.NET Core 1.0 静态文件、路由、自定义中间件、身份验证简介
概述 ASP.NET Core 1.0是ASP.NET的一个重要的重新设计. 例如,在ASP.NET Core中,使用Middleware编写请求管道. ASP.NET Core中间件对HttpCon ...
- Asp.Net Core入门之静态文件
静态文件(css,js,html等类型文件)通常位于 web根目录下,而ASP.Net Core框架默认内容根目录下的wwwroot文件夹为web根目录.这里简单解释下内容根目录:实际就是指包含可执行 ...
- asp.net core MVC 添加静态文件
ASP.net Core 中添加插件需要 1.将文件放在wwwroot文件夹下(根目录文件夹,没有的话需要创建) 2.需要在project.json中的dependencies添加如下依赖 " ...
- 解决ASP.NET Core部署到IIS,更新项目"另一个程序正在使用此文件,进程无法访问"
问题:部署到IIS上的ASP.NET Core项目,在更新的时候会进程占用的错误 初步解决方案: 1,关闭应用程序池 2,关闭网站 3,更新项目 缺点:网站没法访问,部署项目停的时间过长 查询官方文档 ...
随机推荐
- js学习笔记:操作iframe
iframe可以说是比较老得话题了,而且网上也基本上在说少用iframe,其原因大致为:堵塞页面加载.安全问题.兼容性问题.搜索引擎抓取不到等等,不过相对于这些缺点,iframe的优点更牛,跨域请求. ...
- 4.Windows Server2012 R2里面部署 MVC 的网站
网站部署之~Windows Server | 本地部署:http://www.cnblogs.com/dunitian/p/4822808.html#iis 后期会在博客首发更新:http://dnt ...
- 前端学HTTP之重定向和负载均衡
前面的话 HTTP并不是独自运行在网上的.很多协议都会在HTTP报文的传输过程中对其数据进行管理.HTTP只关心旅程的端点(发送者和接收者),但在包含有镜像服务器.Web代理和缓存的网络世界中,HTT ...
- 基于Oracle安装Zabbix
软件版本 Oracle Enterprise Linux 7.1 64bit Oracle Enterprise Edition 12.1.0.2 64bit Zabbix 3.2.1 准备工作 上传 ...
- Visual Studio 2012远程调试中遇到的问题
有的时候开发环境没问题的代码在生产环境中会某些开发环境无法重现的问题,或者需要对生产环境代码进行远程调试该怎么办? Vs已经提供给开发者远程调试的工具 下面简单讲讲该怎么用,前期准备:1.本地登录账户 ...
- Kooboo CMS技术文档之一:Kooboo CMS技术背景
语言平台 依赖注入方案 存储模型 1. 语言平台 Kooboo CMS基于.NET Framework 4.x,.NET Framework 4.x的一些技术特性成为站点开发人员使用Kooboo CM ...
- Oracle手边常用70则脚本知识汇总
Oracle手边常用70则脚本知识汇总 作者:白宁超 时间:2016年3月4日13:58:36 摘要: 日常使用oracle数据库过程中,常用脚本命令莫不是用户和密码.表空间.多表联合.执行语句等常规 ...
- Servlet监听器笔记总结
监听器Listener的概念 监听器的概念很好理解,顾名思义,就是监视目标动作或状态的变化,目标一旦状态发生变化或者有动作,则立马做出反应. Servlet中的也有实现监听器的机制,就是Listene ...
- bzoj1723--前缀和(水题)
题目大意: 你难以想象贝茜看到一只妖精在牧场出现时是多么的惊讶.她不是傻瓜,立即猛扑过去,用她那灵活的牛蹄抓住了那只妖精. "你可以许一个愿望,傻大个儿!"妖精说. ...
- NSStringCompareOptions
typedefNS_OPTIONS(NSUInteger, NSStringCompareOptions) { NSCaseInsensitiveSearch = 1, //不区分大小写比较 N ...