What is the use of "Map" extension while adding middleware to C# ASP.NET Core pipeline?

Middleware are software components that are assembled into an application pipeline to handle requests and responses.

Each component chooses whether to pass the request on to the next component in the pipeline, and can perform certain actions before and after the next component is invoked in the pipeline.

Map extensions are used as convention for branching the pipeline.

The Map extension method is used to match request delegates based on a request’s path. Map simply accepts a path and a function that configures a separate middleware pipeline.

In the following example, any request with the base path of /maptest will be handled by the pipeline configured in the HandleMapTest method.

Example

private static void HandleMapTest(IApplicationBuilder app){
   app.Run(async context =>{
      await context.Response.WriteAsync("Map Test Successful");
   });
}
public void ConfigureMapping(IApplicationBuilder app){
   app.Map("/maptest", HandleMapTest);
}

In addition to path-based mapping, the MapWhen method supports predicate-based middleware branching, allowing separate pipelines to be constructed in a very flexible fashion.

Any predicate of type Func<HttpContext, bool> can be used to map requests to a new branch of the pipeline.

private static void HandleBranch(IApplicationBuilder app){
   app.Run(async context =>{
      await context.Response.WriteAsync("Branch used.");
   });
}
public void ConfigureMapWhen(IApplicationBuilder app){
   app.MapWhen(context => {
      return context.Request.Query.ContainsKey("branch");
   }, HandleBranch);
      app.Run(async context =>{
         await context.Response.WriteAsync("Hello from " + _environment);
   });
}

Maps can also be nested

app.Map("/level1", level1App => {
   level1App.Map("/level2a", level2AApp => {
      // "/level1/level2a"
      //...
   });
   level1App.Map("/level2b", level2BApp => {
      // "/level1/level2b"
      //...
   });
});

Nizamuddin Siddiqui

Updated on 24-Sep-2020 13:09:03

• Related Questions & Answers
• What is the use of ChildActionOnly attribute in ASP .Net MVC C#?
• What is the significance of NonActionAttribute in ASP .Net MVC C#?
• What is ViewData in ASP .Net MVC C#?
• How to use ViewBag in ASP .Net MVC C#?
• How C# ASP.NET Core Middleware is different from HttpModule?
• Adding middleware in Express in Node.js
• What is the use of Map in JavaScript?
• How to handle errors in middleware C# Asp.net Core?
• What is the use of UseIISIntegration in C# Asp.net Core?
• What are the three segments of the default route, that is present in ASP .Net MVC\nC#?
• How to determine if C# .NET Core is installed?
• What is the use of map object in javascript?
• What is the use of the Configure() method of startup class in C# Asp.net Core?
• What are the levels at which filters can be applied in ASP .Net MVC C#?
• What is the use of MySQL BINARY keyword while performing string comparison?