[ASP.NET Core] Static File Middleware

最新推荐文章于 2024-11-14 14:43:49 发布
最新推荐文章于 2024-11-14 14:43:49 发布
阅读量180 收藏
点赞数
文章标签： json
原文链接：http://www.cnblogs.com/clark159/p/5984152.html
版权

前言

本篇文章介绍ASP.NET Core里，用来处理静态档案的Middleware，为自己留个纪录也希望能帮助到有需要的开发人员。

结构

  • 一个Web站台最基本的功能，就是在接收到从「浏览器传入」的HTTP Request封包后，将站台内所提供的静态档案(Static File)，封装成为「服务器回传」的HTTP Response封包内容，来提供给浏览器使用。

    结构01

  • 在ASP.NET Core里，内建了一个Middleware：StaticFileMiddleware，用来建立Web站台提供静态档案的功能。这个Middleware会先剖析HTTP Request封包中的URL路径、然后依照URL路径计算并取得对应的File路径下的档案内容、接着再将该档案内容封装为HTTP Response封包内容，用来提供给浏览器使用。

    结构02

  • 而在StaticFileMiddleware里，定义URL根路径、File根路径这两个系统参数，来映像URL路径所对应的File路径。用以提供开发人员，灵活的去设定URL路径与File路径之间的关系。

    开发01

    开发02

开发

Microsoft.AspNetCore.StaticFiles

在ASP.NET Core里，要加入StaticFileMiddleware来提供静态档案功能。开发人员可以先依照[ASP.NET Core] Getting Started这篇文章里的步骤，来建立相关环境与基本程序代码。接着在project.json里挂载「Microsoft.AspNetCore.StaticFiles」的参考，后续就能使用这个参考里，所提供的StaticFileMiddleware相关对象。

{
  "version": "1.0.0-*",
  "buildOptions": {
    "debugType": "portable",
    "emitEntryPoint": true
  },
  "dependencies": {},
  "frameworks": {
    "netcoreapp1.0": {
      "dependencies": {
        "Microsoft.NETCore.App": {
          "type": "platform",
          "version": "1.0.0"
        },
        "Microsoft.AspNetCore.StaticFiles": "1.0.0",
        "Microsoft.AspNetCore.Server.Kestrel": "1.0.0"
      },
      "imports": "dnxcore50"
    }
  }
}

UseStaticFiles()

完成project.json的相关设定之后，就可以回过来修改「Program.cs」。在Microsoft.AspNetCore.StaticFiles里，提供了UseStaticFiles Extension，让开发人员可以方便的挂载StaticFileMiddleware。在下列的范例程序代码里，示范如何透过UseStaticFiles来挂载StaticFileMiddleware。(在StaticFileMiddleware里面，URL根路径默认为：「http://<Url>」、File根路径默认为：「file:\\<ContentRoot>\wwwroot」)。

开发01

开发02

using System;
using System.IO;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.FileProviders;

namespace aspnetcoreapp
{
    public class Program
    {
        public static void Main(string[] args)
        {
            // Build
            var host = new WebHostBuilder()

                // 设定Host内容的File根路径
                .UseContentRoot(Directory.GetCurrentDirectory())

                // 设定启动参数
                .UseStartup<Startup>()

                // 开启Kestrel聆听HTTP            
                .UseKestrel()

                // 设定聆听的URL
                .UseUrls("http://localhost:5000")

                // 建立Host       
                .Build();

            // Run 
            try
            {
                // 启动Host
                host.Start();

                // 等待关闭
                Console.WriteLine("Application started. Press any key to shut down.");
                Console.ReadKey();
            }
            finally
            {
                // 关闭Host
                host.Dispose();
            }
        }
    }

    public class Startup
    {
        // Methods
        public void Configure(IApplicationBuilder app)
        {            
            // 挂载StaticFilesMiddleware
            app.UseStaticFiles();
        }
    }
}

UseWebRoot(webRoot)

在StaticFileMiddleware里面，File根路径默认为：「file:\\<ContentRoot>\wwwroot」。如果要变更默认的File根路径，开发人员可以使用ASP.NET Core所提供的UseWebRoot Extension来变更默认的File根路径。在下列的范例程序代码里，示范如何透过UseWebRoot来变更默认的File根路径。(范例执行时挂载的StaticFileMiddleware，URL根路径同样为：「http://<Url>」、File根路径变更为：「file:\\<CurrentDirectory>\aaa」)。

开发03

开发04

using System;
using System.IO;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.FileProviders;

namespace aspnetcoreapp
{
    public class Program
    {
        public static void Main(string[] args)
        {
            // Build
            var host = new WebHostBuilder()

                // 设定Web站台的File根路径
                .UseWebRoot(Directory.GetCurrentDirectory() + @"\aaa")

                // 设定Host内容的File根路径
                .UseContentRoot(Directory.GetCurrentDirectory())

                // 设定启动参数
                .UseStartup<Startup>()

                // 开启Kestrel聆听HTTP            
                .UseKestrel()

                // 设定聆听的URL
                .UseUrls("http://localhost:5000")

                // 建立Host       
                .Build();

            // Run 
            try
            {
                // 启动Host
                host.Start();

                // 等待关闭
                Console.WriteLine("Application started. Press any key to shut down.");
                Console.ReadKey();
            }
            finally
            {
                // 关闭Host
                host.Dispose();
            }
        }
    }

    public class Startup
    {
        // Methods
        public void Configure(IApplicationBuilder app)
        {
            // 挂载StaticFilesMiddleware
            app.UseStaticFiles();
        }
    }
}

UseStaticFiles(options)

除了使用预设参数挂载StaticFilesMiddleware之外，开发人员也可以使用自定义参数来挂载StaticFilesMiddleware。如果要使用自定义参数来挂载StaticFilesMiddleware，开发人员可以同样使用UseStaticFiles Extension来使用自定义参数挂载StaticFilesMiddleware。在下列的范例程序代码里，示范如何透过UseStaticFiles来挂载StaticFilesMiddleware，并且定义其URL根路径与File根路径。(范例执行时挂载的StaticFileMiddleware，URL根路径变更为：「http://<Url>/bbb」、File根路径变更为：「file:\\<CurrentDirectory>\ccc」)。

开发05

开发06

using System;
using System.IO;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.FileProviders;

namespace aspnetcoreapp
{
    public class Program
    {
        public static void Main(string[] args)
        {
            // Build
            var host = new WebHostBuilder()

                // 设定Host内容的File根路径
                .UseContentRoot(Directory.GetCurrentDirectory())

                // 设定启动参数
                .UseStartup<Startup>()

                // 开启Kestrel聆听HTTP            
                .UseKestrel()

                // 设定聆听的URL
                .UseUrls("http://localhost:5000")

                // 建立Host       
                .Build();

            // Run 
            try
            {
                // 启动Host
                host.Start();

                // 等待关闭
                Console.WriteLine("Application started. Press any key to shut down.");
                Console.ReadKey();
            }
            finally
            {
                // 关闭Host
                host.Dispose();
            }
        }
    }

    public class Startup
    {
        // Methods
        public void Configure(IApplicationBuilder app)
        {
            // 挂载StaticFilesMiddleware
            app.UseStaticFiles(new StaticFileOptions()
            {
                // 设定URL根路径
                RequestPath = @"/bbb",

                // 设定File根目录
                FileProvider = new PhysicalFileProvider(Directory.GetCurrentDirectory() + @"\ccc")
            });
        }
    }
}

参考

转载于:https://www.cnblogs.com/clark159/p/5984152.html

weixin_30851867
关注
Chapter 5: Middleware in .NET 8.0 ASP.NET Core Book Management System
代数的博客
07-26 108
【代码】Chapter 5: Middleware in .NET 8.0 ASP.NET Core Book Management System。
从ASP.NET MVC迁移到ASP.NET Core的分步指南
编程故事的地方
09-20 1537
分步指南 这是有关将项目从ASP.NET MVC框架迁移到ASP.NET Core的实用指南。 由nopCommerce开源项目团队编写的分步说明可以轻松地应用于任何ASP.NET MVC项目。 它还描述了为什么您可能需要升级，以及为什么尚未跟上进度的项目应该考虑它。 为什么要移植到ASP.NET Core？ 在继续进行从ASP.NET MVC移植到ASP.NET Core的步骤（以no...
ASP.NET Core应用针对静态文件请求的处理[3]: StaticFileMiddleware中间件如何处理针对文件请求...
weixin_34174132的博客
12-09 210
我们通过《以Web的形式发布静态文件》和《条件请求与区间请求》中的实例演示，以及上面针对条件请求和区间请求的介绍，从提供的功能和特性的角度对这个名为StaticFileMiddleware的中间进行了全面的介绍，接下来我们将更近一步，将从实现原理的角度来进一步认识这个中间件。 [本文已经同步到《ASP.NET Core框架揭秘》之中] 目录 一、StaticFileMiddleware二、Con...
ASP.NET Core 开发-中间件(StaticFiles)使用
weixin_34010566的博客
05-30 299
ASP.NET Core 开发，中间件(StaticFiles)的使用，我们开发一款简易的静态文件服务器。 告别需要使用文件，又需要安装一个web服务器。现在随时随地打开程序即可使用，跨平台，方便快捷。 前一篇讲解了中间件的开发，了解了中间件的知识。 下面我们就来使用StaticFiles 开发一款简易静态文件服务器。还可以直接运行纯静态的网站。 新建的ASP.NET Core 项目，不是...
跟我一起学.NetCore之中间件(Middleware)简介和解析请求管道构建
dotNET跨平台
09-24 1062
前言中间件(Middleware)对于Asp.NetCore项目来说，不能说重要，而是不能缺少，因为Asp.NetCore的请求管道就是通过一系列的中间件组成的；在服务器接收到请求之后，...
netcore-wwwroot文件夹（StaticFiles中间件配置）
u011385246的博客
06-02 3461
默认情况下，ASP.NET Core项目中的wwwroot文件夹被视为Web根文件夹。静态文件可以存储在Web根目录下的任何文件夹中，并可以使用该根目录的相对路径进行访问。在ASP.NET应用程序中，可以从应用程序的根文件夹或其下的任何其他文件夹提供静态文件。这已在ASP.NET Core中更改。现在，只有Web根目录-wwwroot文件夹中的那些文件才能通过http请求提供。其他所有文件均被阻止，默认情况下无法提供。通常，在wwwroot文件夹中应有用于不同类型的静态文件（例如JavaScript，CSS
ASP.NET Core：静态文件
子昊
10-28 1089
在Web开发中，如js脚本、css样式、图片等的静态文件通常占据了很大一部分。ASP.NET Core提供了三个中间件来处理这种针对静态文件的请求。利用它们我们不经可以将物理文件发布为通过http请求可以去获取的外部资源。还可以将所在的物理结构也给呈现出来。通过http请求获取的外部资源大部分都来源于存储在服务器磁盘上的静态文件。 对于ASP.NET Core来说，如果静态文件存储在约定的目录下，那么绝大部分文件类型都是可以通过web的形式对外发布的。 像这种在web根目录下的所有文件都会自动的发.
asp.net core英文版教程
02-21
- **Middleware**：中间件的概念及其在 ASP.NET Core 中的应用。 - **Working with Static Files**：处理静态文件的方法。 - **Routing**：路由机制及其配置。 - **Error Handling**：错误处理策略。 - **...
【ASP.NET编程知识】.Net Core中间件之静态文件(StaticFiles)示例详解.docx
05-15
在ASP.NET Core中，静态文件中间件（StaticFiles Middleware）是一个关键组件，它负责处理和提供HTML、CSS、JavaScript以及图像等静态资源给客户端。理解并有效地使用静态文件中间件对于构建高效的Web应用至关重要。...
ASP.NET Core 使用app.UseStaticFiles配置静态文件中间件，达到类似IIS中虚拟目录的效果，可访问位于 Web 根目录之外的文件
最数据的专栏
06-08 6589
<article class="baidu_pl"> <div id="article_content" class="article_content clearfix"> <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-b5506197d8.css"> ...
用2.0使用swagger完全没问题，但是使用3.0就会报错，很奇葩的错。
在夜里奔跑的人
11-19 971
“MissingMethodException: Method not found: 'Void Microsoft.AspNetCore.StaticFiles.StaticFileMiddleware..ctor(Microsoft.AspNetCore.Http.RequestDelegate, Microsoft.AspNetCore.Hosting.IHostingEnvironment, Microsoft.Extensions.Options.IOptions`1<Microsoft.A
细说ASP.NET Core静态文件的缓存方式
weixin_30561177的博客
11-11 192
一、前言 　　我们在优化Web服务的时候，对于静态的资源文件，通常都是通过客户端缓存、服务器缓存、CDN缓存，这三种方式来缓解客户端对于Web服务器的连接请求压力的。 　　本文指在这三个方面，在ASP.NET Core中静态文件的实现过程和使用方法进行阐述。当然也可以考虑使用反向代理的方式(例如IIS或Nginx)，这些不是本文讨论的内容。 　　本文重点展示如何通过StaticFileMid...
ASP.NET Core基础（十一）——静态文件Static files
catshitone的专栏
04-20 2292
此文是在官方文档的基础上做的个人笔记，一些简单的内容就没用再列出来了，参考官方文档：https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/http-requests?view=aspnetcore-5.0 默认情况下，诸如HTML、css、图像、js之类的静态资源，应用不需要特殊处理直接提供出去。静态资源一般都存放在wwwroot文件夹中。 1.提供静态文件 1.1 提供wwwroot目录下的静态文件 直接调用app.UseStaticFil.
新功能介绍​
weixin_43715205的博客
11-13 304
近期基于客户实际需求，基于现有的数合建模平台，开发了基于API接口的数据接入功能，旨在帮助您轻松地将各种API接口的数据结构化并存储到数据库中。支持主子表结构，能够自动生成数据库结构，并提供直观的界面编辑功能，让您能够轻松管理表名称和外键关系。能够处理各种JSON格式的数据，无论您的API返回的是简单的键值对还是复杂的嵌套结构，我们都能够将其有效地存储到数据库中。支持主子表结构，允许您定义复杂的数据关系，并通过外键约束来维护这些关系，确保数据的一致性和完整性。2. 数据结构化存储​。5. 界面编辑功能​。
02-SpringBoot3Web开发
最新发布
小钟不想敲代码
11-14 827
02-SpringBoot3 Web开发
微信小程序开发，仿小红书瀑布流实现
商城app+新闻app+备忘录记事本app视频教程在某站【浩宇软件开发】
11-14 954
lib: 3.6.4)解决方案：这个报错在控制台提示的很明显了，需要在.json文件中设置。温馨提示： 仅支持作为。即可 ，如下图所示。
ASP.NET Core MVC 2开发指南
4. **中间件（Middleware）**：ASP.NET Core引入了中间件概念，这是一种处理请求和响应的管道模式，开发者可以通过串联多个中间件组件来构建应用程序的处理流程。 5. **模型绑定（Model Binding）**：模型绑定自动...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值