Orchard Core Framework:ASP.NET Core 模块化,多租户框架
上一篇编写Orchard Core一分钟搭建ASP.NET Core CMS ,介绍ASP.NET Core CMS ,Orchard的ASP.NET Core版,同时对应有一个ASP.NET Core框架。
支持模块化和多租户。整个Orchard Core就是通过一个个模块Module组成的
首先创建一个空的 ASP.NET Core Web应用程序为基础。下面学习模块的建立及使用。
模块化
首先在之前创建好的ASP.NET Core Web应用程序中,新建一个 类库(.NET Core)项目 为ModuleWeb。
然后添加 Microsoft.AspNetCore.Mvc 及 OrchardCore.Module.Targets 引用。
命令如下:
Install-Package Microsoft.AspNetCore.Mvc
Install-Package OrchardCore.Module.Targets -Pre
接着我们就可以添加一个Views 文件夹和 Controllers 文件夹,以及添加一个HomeController和对应的视图页。
由于类库上没有很好的新建快捷方式,建议从ASP.NET Core Web 项目中复制。
public class HomeController : Controller
{
public IActionResult Index()
{
return View();
}
}
Home/Index.cshtml
Hello from ModuleWeb /Home/Index
LineZero
Module 创建好了,接下来在ASP.NET Core Web 项目中引用。
首先需要在Web 项目添加一个OrchardCore.Application.Mvc.Targets 包
Install-Package OrchardCore.Application.Mvc.Targets -Pre
接着将ModuleWeb 项目引用进来。
更改Startup.cs 如下:
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
services.AddModules();
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseModules();
}
}
注意项目中引用为 Microsoft.AspNetCore 以及Microsoft.ApplicationInsights.AspNetCore,配置如下
接着运行程序,输入 ModuleWeb/Home/index 如下
ModuleWeb 也就是正常可用。
多租户
多租户,可以直接根据配置读取用户设置,实现多域名或者多目录。
先来添加一个ModuleInfo ,添加引用:
Install-Package OrchardCore.Module.Targets -Pre
Install-Package OrchardCore.Environment.Shell.Abstractions -Pre
接着添加一个Startup.cs,实现如下:
public class Startup : StartupBase { // This method gets called by the runtime. Use this method to add services to the container. // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940 public override void ConfigureServices(IServiceCollection services) { } // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. public override void Configure(IApplicationBuilder app, IRouteBuilder routes, IServiceProvider serviceProvider) { app.Map("/hello", branch => branch.Run(context => context.Response.WriteAsync("Hello World From ModuleInfo LineZero")) ); app.Map("/info", branch => { branch.Run(context => { var shellSettings = context.RequestServices.GetRequiredService(); return context.Response.WriteAsync($"Request from tenant: {shellSettings.Name}"); }); }); } }
访问/info 会读取shellsetting 获取用户的配置。
在ASP.NET Core Web应用程序 中添加一个tenants.json 如下:
{ "Web": { "State": "Running", // "RequestUrlHost": "web.com", "RequestUrlPrefix": "web", "Features": [ "ModuleWeb", "ModuleInfo", "OrchardCore.Mvc" ], "MyConnectionString": "connectionstring1" }, "Info": { "State": "Running", // "RequestUrlHost": "info.com, info.org", "RequestUrlPrefix": "info", "Features": [ "ModuleInfo", "OrchardCore.Mvc" ], "MyConnectionString": "connectionstring2" } }
并更改Startup.cs
public void ConfigureServices(IServiceCollection services) { services.AddModules(c=>c.WithTenants()); }
接着将ModuleInfo 添加到Web应用程序,运行应用程序。
访问/web/info ,如下会输出Web
访问/info/info ,如下会输出Info
然后Web 配置下才会有两个模块,Info 配置下只有一个模块。可以根据这些信息来做用户隔离和区分。
对于Orchard Core Framework 更深入的了解,可以查看GitHub 上的源码:https://github.com/OrchardCMS/OrchardCore