In the previous post I looked into the F# Giraffe library which makes writing all sorts of web request\/response code pretty simple. This in turn is built on top of the existing functionality within ASP.NET Core.<\/p>\n
Let’s again look at the bare bones code from running up Kestrel adding code to the pipeline<\/p>\n
\r\nusing Microsoft.AspNetCore;\r\nusing Microsoft.AspNetCore.Builder;\r\nusing Microsoft.AspNetCore.Hosting;\r\nusing Microsoft.AspNetCore.Http;\r\n\r\nnamespace KestrelTest\r\n{\r\n public class Startup\r\n {\r\n public void Configure(\r\n IApplicationBuilder applicationBuilder,\r\n IHostingEnvironment hostingEnvironment)\r\n {\r\n }\r\n }\r\n\r\n class Program\r\n {\r\n static void Main(string[] args)\r\n {\r\n WebHost.CreateDefaultBuilder()\r\n .UseStartup<Startup>()\r\n .UseKestrel()\r\n .Build()\r\n .Run();\r\n }\r\n }\r\n}\r\n<\/pre>\nWithin the Configure method we can start adding code to respond to different routes using the Map<\/em> method, for example add the following to the Configure method<\/p>\n\r\napplicationBuilder.Map("\/hello", app =>\r\n{\r\n app.Run(async ctx =>\r\n {\r\n var request = \r\n ctx.Request.Path.HasValue ? \r\n ctx.Request.Path.Value.Substring(1) : \r\n String.Empty;\r\n await ctx.Response.WriteAsync("Hello " + request);\r\n });\r\n});\r\napplicationBuilder.Map("\/error", app =>\r\n{\r\n app.Run(ctx => \r\n Task.FromResult(\r\n ctx.Response.StatusCode = 404) \r\n );\r\n});\r\n<\/pre>\nNote: The code is somewhat basic, obviously you would probably want to write some better code for extracting partial paths etc. from the routes\/maps. However we’ll be covering a better alternative to this sort of code later in the post.<\/em><\/p>\nIn the above we’ve created the equivalent of two “routes”. The first handles URL’s along the line of localhost:5000\/hello\/World where the return would become “Hello World”. The second route simply responds with a 404 for the URL localhost:5000\/error.<\/p>\n
We can also (as you’d expect) handle queries within our URL, so let’s say we expect this format URL, http:\/\/localhost:5000\/hello?name=World, then we can amend our \/hello code to the following<\/p>\n
\r\napplicationBuilder.Map("\/hello", app =>\r\n{\r\n app.Run(async ctx =>\r\n {\r\n await ctx.Response.WriteAsync(\r\n "Hello " + ctx.Request.Query["name"]);\r\n });\r\n});\r\n<\/pre>\nThese pieces of code write responses, but we can also insert code into the pipeline which doesn’t write to the response but instead might add debug\/logging code. Other examples of usage might include (as per Writing Middleware<\/a>) changes to the culture for the user response.<\/p>\nHere’s a simple example of such code, this is a little contrived as we’re going to (in essence) redirect calls to \/hello path. Just place the following code before the applicationBuilder.Map method in the above<\/p>\n
\r\napplicationBuilder.Use(async (ctx, next) =>\r\n{\r\n if (ctx.Request.Path.Value == "\/hello")\r\n {\r\n ctx.Request.Path = new PathString("\/error");\r\n }\r\n await next.Invoke();\r\n});\r\n<\/pre>\nNote: there are redirect\/URL rewriting capabilities already in ASP.NET Core, see URL Rewriting Middleware in ASP.NET Core<\/a>.<\/em><\/p>\nRouting<\/strong><\/p>\nIn the previous example we demonstrated using the Map method to route our calls but ASP.NET Core libraries already supply a routing middleware which handles a lot of the standard routing type of functionality we’d expect. We can add the routing services by adding a method to the Startup class like this<\/p>\n
\r\npublic void ConfigureServices(\r\n IServiceCollection services)\r\n{\r\n services.AddRouting();\r\n}\r\n<\/pre>\nNow the Configure method should look like this<\/p>\n
\r\npublic void Configure(\r\n IApplicationBuilder applicationBuilder,\r\n IHostingEnvironment hostingEnvironment)\r\n{\r\n var routes = new RouteBuilder(applicationBuilder);\r\n routes.MapGet("hello\/{name}", ctx =>\r\n {\r\n var name = ctx.GetRouteValue("name");\r\n return ctx.Response.WriteAsync($"Hello {name}");\r\n });\r\n\r\n applicationBuilder.UseRouter(routes.Build());\r\n}\r\n<\/pre>\nThe RouteBuilder handles the routing in a more helpful\/useful manner. Don’t forget to use the line applicationBuilder.UseRouter(routes.Build());<\/em> or you’ll find that the routes are not registered and hence your code will never get called.<\/p>\nReferences<\/strong><\/p>\nASP.NET Core Middleware<\/a>Routing in ASP.NET Core<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"In the previous post I looked into the F# Giraffe library which makes writing all sorts of web request\/response code pretty simple. This in turn is built on top of the existing functionality within ASP.NET Core. Let’s again look at the bare bones code from running up Kestrel adding code to the pipeline using Microsoft.AspNetCore; […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[200,3,202],"tags":[],"class_list":["post-5898","post","type-post","status-publish","format-standard","hentry","category-asp-net-core","category-c","category-kestrel"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/5898","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/comments?post=5898"}],"version-history":[{"count":9,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/5898\/revisions"}],"predecessor-version":[{"id":5917,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/5898\/revisions\/5917"}],"wp:attachment":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/media?parent=5898"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/categories?post=5898"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/tags?post=5898"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}