Loading and registering API Controllers From Class Library in ASP.NET core
Solution 1
Maybe you're doing something wrong. So, here are the steps to make this work.
- Create a new project: ASP.NET Core Web Application (.NET Core);
- Choose the Web API template;
- Run the project and access the "api/values" to make sure it's working;
- Add a new project to the solution named ClassLibrary: Class Library (.NET Core);
- Delete the Class1.cs and create a TestController.cs class;
Add the MVC dependency in the project.json from the ClassLibrary project:
"dependencies": { "NETStandard.Library": "1.6.0", "Microsoft.AspNetCore.Mvc": "1.0.0" },
Update your TestController.cs to be like this:
[Route("api/[controller]")] public class TestController : Controller{ [HttpGet] public IEnumerable<string> Get() { return new string[] { "test1", "test2" }; } }
Add the reference to ClassLibrary in your WebAPI Project: right-click on "References"->"Add Reference..." or update your project.json like this:
"dependencies": { "Microsoft.NETCore.App": { "version": "1.0.0", "type": "platform" }, "Microsoft.AspNetCore.Mvc": "1.0.0", "Microsoft.AspNetCore.Server.IISIntegration": "1.0.0", "Microsoft.AspNetCore.Server.Kestrel": "1.0.0", "Microsoft.Extensions.Configuration.EnvironmentVariables": "1.0.0", "Microsoft.Extensions.Configuration.FileExtensions": "1.0.0", "Microsoft.Extensions.Configuration.Json": "1.0.0", "Microsoft.Extensions.Logging": "1.0.0", "Microsoft.Extensions.Logging.Console": "1.0.0", "Microsoft.Extensions.Logging.Debug": "1.0.0", "Microsoft.Extensions.Options.ConfigurationExtensions": "1.0.0", "ClassLibrary": "1.0.0-*" },
Update your Startup.cs
ConfigureServices
method:public void ConfigureServices(IServiceCollection services) { services.AddMvc().AddApplicationPart(Assembly.Load(new AssemblyName("ClassLibrary"))); }
- Run the project again and access "api/test";
Solution 2
you don't need to do anything special in Startup.cs of the main web app, it just needs to reference the class library.
The one trick is that for your controllers to be discovered your class library must directly reference MVC in its project.json file dependencies section:
"Microsoft.AspNetCore.Mvc": "1.0.*"
UPDATE: for MVC app I did not need anything special in my Startup but in one of my api apps I did need it maybe because using attribute routing.
services.AddMvc()
.AddApplicationPart(Assembly.Load(new AssemblyName("CSharp.WebLib")))
;
where CSharp.WebLib is the name of my class library
Related videos on Youtube
Hussein Salman
Engineering Manager & Cloud-Native Architect, focusing on Kubernetes, Containers & Microservices. Check out my youtube channel: https://www.youtube.com/channel/UCoAh8g6dmwXQUwKhkggUFIA
Updated on February 09, 2021Comments
-
Hussein Salman about 3 years
I am using ASP.NET Core 1.0.1. I have the following
- A class library that uses
"Microsoft.AspNetCore.Mvc": "1.0.1"
in order to develop my controllers:
using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using Microsoft.AspNetCore.Mvc; namespace CoreAPIsLibrary.Controllers { [Route("api/[controller]")] public class ValuesContoller : Controller { public string Get() { return "value"; } // GET api/values/5 [HttpGet("{id}")] public string Get(int id) { return "value"; } // POST api/values [HttpPost] public void Post([FromBody]string value) { } // PUT api/values/5 [HttpPut("{id}")] public void Put(int id, [FromBody]string value) { } } }
This is my class libray's project.json:
{ "version": "1.0.0-*", "dependencies": { "Microsoft.AspNetCore.Mvc": "1.0.1", "NETStandard.Library": "1.6.0" }, "frameworks": { "netstandard1.6": { "imports": "dnxcore50" } } }
- Asp.net core application (Web API Template) that will host my controllers and reference that class library. However, It never hits the break point in the controller. Here is my startup class in the web application:
using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Logging; using System.Reflection; using CoreAPIsLibrary.Controllers; namespace APIsHost { public class Startup { public Startup(IHostingEnvironment env) { var builder = new ConfigurationBuilder() .SetBasePath(env.ContentRootPath) .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true) .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true) .AddEnvironmentVariables(); Configuration = builder.Build(); } public IConfigurationRoot Configuration { get; } // This method gets called by the runtime. Use this method to add services to the container. public void ConfigureServices(IServiceCollection services) { services.AddMvc() .AddApplicationPart(typeof(ValuesContoller).GetTypeInfo().Assembly).AddControllersAsServices(); } // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory) { loggerFactory.AddConsole(Configuration.GetSection("Logging")); loggerFactory.AddDebug(); app.UseMvc(routes => { routes.MapRoute("default", "{controller}/{action}/{id}"); }); //app.UseMvc(); } } }
I also checked if the controller was injected:
So, what is missing?
-
Fabricio Koch over 7 yearstry replacing
typeof(ValuesContoller).GetTypeInfo().Assembly
fortypeof(ValuesContoller).Assembly
-
Hussein Salman over 7 yearsThis is not valid a method or extension.
-
Fabricio Koch over 7 yearsThis method is available for me. Can you update your question with your complete Startup.cs ?
-
Fabricio Koch over 7 yearsTry to insert
[Route("api/[controller]")]
in your controller. Also, try to create a controller in the same assembly of the app to make sure the MVC is working fine. -
Hussein Salman over 7 yearsI created a controller in the assembly itself, but not was working also. I didn't imagine that. What is the problem?
-
Hussein Salman over 7 yearsI added a new asp.net core (web API) project tested a controller in the same assembly, it is working. Then, I deleted the Controllers Folder in the Web App. and then referenced the class library and modified the startup class of the new web. But, it didn't hit the controller yet. So, this is not a routing issue.
-
Fabricio Koch over 7 yearsI guess you're doing something wrong. I'm gonna post an answer with the steps to make this work.
- A class library that uses
-
Hussein Salman over 7 yearsThanks, Fabrico. This is exactly what I did and there is something really wierd on my machine, because I have made a change on my startup, then return it back to the code in my question and now its working, but don't know the reason.
-
IAbstract over 3 yearsI wish I had found this answer a few hours ago. It would have saved me a lot of time. Sometimes it comes down to the specific search terms. Great job.
-
Gusman about 3 yearsThat does exactly the same as the other responses, you are returning the full assembly from the type...
-
MikeT about 2 yearsIn Asp.Net Core 6, you no longer need to include
AddApplicationPart(Assembly.Load(new AssemblyName("CSharp.WebLib")))
. It automatically picks up controllers with attribute routing