Goal of that lib is to make subdomain routing easy to use in asp net core mvc applications. Normally you would use some custom route for some special case scenario in your app. This should solve most of issues while using subdomain routing. Inspired by couple of already existing libraries around the web which handle routing in some degree this should meet requirements:
- Register subdomain routes as you would do with normal routes.
- Make links, forms urls etc. in views as you would do with helpers in your cshtml pages.
- Catch all route values in controller.
Important note, this library does not work currently with the endpoint routing.
Build server | Build status | Unit tests | Integration tests | Functional tests |
---|---|---|---|---|
AppVeyor |
https://github.com/mariuszkerl/AspNetCoreSubdomain/wiki
Your application have to be aware of using subdomains. Important thing is to use method AddSubdomains()
before AddMvc()
public void ConfigureServices(IServiceCollection services)
{
services.AddSubdomains();
// Add framework services.
//...
services.AddMvc(x => x.EnableEndpointRouting = false);
}
You configure your routes just like standard routes, but you cannot use standard MapRoute
methods. That will be explained later in wiki. Use MapRoute method from this lib extensions method which accepts hostnames
as a parameter.
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
var hostnames = new[] { "localhost:54575" };
app.UseMvc(routes =>
{
routes.MapRoute(
hostnames,
"NormalRoute",
"{action}",
new { controller = "SomeController" });
routes.MapSubdomainRoute(
hostnames,
"SubdomainRoute",
"{controller}", //that's subdomain parameter, it can be anything
"{action}",
new { controller = "Home", action = "Action1" });
)};
}
Goal of that library is not only catching routes for subdomain but also generating links to actions while persisting standard razor syntax. Helper below will generate url <a href="http://home.localhost:54575">Hyperlink example</a>
. Route named SubdomainRoute should catch that link.
@Html.ActionLink("Hyperlink example", "Action1", "Home")
Big advantage of library is you can catch all route values with controller.
//HomeController.cs
public IActionResult Action1()
{
//code
}
Having url http://home.localhost:54575/
will invoke Action1
method in Home
controller.
https://github.com/mariuszkerl/AspNetCoreSubdomain/wiki/Running-samples-project