How to Use OWIN to Self-Host ASP.NET Web API?

-

 In a Service Oriented architecture where there are multiple services serving the request from different clients it becomes imperative to add additional capabilities to these services and allow the Services to describe itself.

What is meant by Self-Hosting?

Self Hosting is a term used commonly to host a web Application or a Backend Service in a custom exe like console application instead of hosting it in IIS or some other exe. It is normally done to reduce the bulkiness and additional overhead which comes with external hosting platforms.

What is OWIN?

OWIN stands for Open Web Interface for .NET which basically acts as a abstraction between the Web Application and the Web Server so this means that Web Application is no more tightly bound to the Web Server which is hosting the application. OWIN  provides some standard API through which the Web Server can communicate with the Web Application. It also provides some middleware functionality through which it is possible to add pipelines through which the request flows and reaches the Web application end point.

These pipelines can hold different logic like authenticating the request which is coming in and validating the request etc.

Why we need to go with OWIN?

Still if we have any doubts about why we need to go ahead and use OWIN, then we can look at the below example which demonstrates using OWIN to host a Web API.

I have used a Console Application to host the Web API. Once the Console Application is created its time to add few Nuget packages which is needed to use the functionality of OWIN.

Below Two Packages are mainly needed 

  • Microsoft.AspNet.WebApi.OwinSelfHost
  • Swashbucke
Along with these there are multiple dependent bundles which also gets downloaded. Once these packages are installed then we can add a OWIN Startup file which specifies the configuration to be used by the Web Application.

Sample Startup File is given below:

Using OWIN To Selfhost ASP.NET Web API | Startup File

As shown in the Startup file we are specifying some HttpConfigurations which must be used.

Once the Startup file is created its time to Host the Application using the OWIN WebApp as shown below:

OWIN to Self Host the Web Application | Hosting

Project Structure is as shown below:

Web API Project structure


Now Run the Console Application and navigate to the URL : http://localhost:4500/swagger. We can see Swagger Web Page which gets loaded and it describes the API's exposed by the Web Application which its hosting as shown below:

API Description in OWIN Web Page

We have Defined a HomeController class which exposes few API as shown below:

ApiController exposing few API


These API's are described in the Swagger page which is quite helpful if we want to Test out few API's or simply if we want to know all the API's exposed by the Web Application.

Note: Please make the Controller class public otherwise Swagger/Clients will not be able to discover the API's exposed by the Controller.

Comments

Post a Comment

Popular posts from this blog

Creating RESTful Minimal WebAPI in .Net 6 in an Easy Manner! | FastEndpoints

-
Image
  We might have developed Web APIs using MVC Controllers where we used to give Route Path Attributes to the Controller and  to identify individual methods we used to provide Actions in the Route. With the Controller approach we need to write boiler plate code in separate files which deals with the Configuration of the Web Service. Those who have worked in Node js would be aware of how easy it is to create a Web API and expose different Endpoints without the need of so much boiler plate code. Here we are going to discuss of similar approach for creating a Web API in .Net6 using FastEndpoints. Under the hood it uses Minimal API concept which tries to reduce the dependencies required to achieve a particular task. This approach is more suitable in the case of Microservice Architecture where we want to keep the dependencies to minimum. Must Read : Fluent API and Data Annotations What are FastEndpoints? FastEndpoints is a Framework compatible with .Net 6 which allows to build a RESTful Web A
Read more

Mastering Concurrency with Latches and Barriers in C++20: A Practical Guide for Students

-
Image
Introduction Picture yourself as a student tasked with organizing a surprise party for a friend. You have a team of friends helping you, each with a specific role: one decorating, another cooking, and yet another taking care of entertainment. As you plan and coordinate, you quickly realize the importance of timing and synchronization. Just as in party planning, in the world of programming and computing, we often have multiple tasks running concurrently, similar to your friends handling different aspects of the party all at once. However, ensuring that these concurrent tasks harmonize can be a significant challenge. If decorations go up before the food is ready or the entertainment starts before guests arrive, it could lead to chaos. This is where the world of programming comes in, and in this blog, we'll explore powerful tools called "latches" and "barriers" to manage these concurrent scenarios efficiently. Learning about latches and barriers isn't just abou
Read more

Graph Visualization using MSAGL with Examples

-
Image
 Graph visualization is a great way to get a better understanding of complex relationships and structures in data. Whether you work as a software developer, a data scientist, or just want to explore networks, seeing graphs at runtime can be really helpful. In this blog, we'll look at how to make graphs at runtime with MSAGL. We'll cover the basics of creating, customizing, and visualizing graphs with MSAGL, as well as practical examples of how it can be used to create a social network and workflow. What is MSAGL? MSAGL, developed by Microsoft Research, is an open-source library designed for graph and diagram visualization. It offers a wide range of features and layout algorithms to create clear and aesthetically pleasing representations of complex graph structures. Installing MSAGL: To begin, you'll need to install the MSAGL library. You can download the latest version from the official MSAGL GitHub repository or conveniently install it using the NuGet package manager in Vi
Read more