(一)学习了解OrchardCore笔记——开篇：基于asp.net core的OrchardCore

　　想深刻了解OrchadCore源码许久了，可是读源码的时候遇到不少问题而网上的参考资料太少了(几乎都是OrchadCms不带OrchardCore的)，如今解决得差很少了，作下笔记方便本身查看，有错误之处也请你们帮忙指出，谢谢。

　　OrchardCore是一个基于asp.net core的cms(废话)，其结构相似于asp.net core(为啥说相似我也不知道，asp.net core的源码我只看了一部分，似是而非吧)。所以，我将直接从asp.net core的角度来解析OrchardCore，从asp.net core的角度就是说关于asp.net core的靠本身理解，能够省略1万字。

　　废话结束，开始正题，源码直接github搜索OrchardCore就能够下载了，我直接用visual studio(我不用rider，首先我没钱买，其次我以前是弄.net framework不是java，我用的vs都是社区版)自带的git去clone半天(这小水管受不了后面直接码云找镜像仓库clone了)。

　　clone完了，第一个坑出现了，选择记得选择版本和分支，说多都是泪，OrchardCore支持的版本(从.net core 1.0到.net core 3.1都有)和自身的分支太多了，第一次接触没注意跳坑了致使各类出错(缘由是我没有装对应的.net core版本，默认好像2.x)，后面发现了就直接用.net core 3.1的dev分支。新手常见错误，你们尽管嘲笑，让我涨涨记性，特么有次我本身的代码都改错分支！

　　正文开始，vs加载完OrchardCore解决方案出现不少项目，很是清晰，加粗的OrcharCore.Cms.Web项目就是启动项目。

　　启动项目的内容很是熟悉很是简洁，就是一个asp.net core的项目。

　　固然你会发现多了个Localization文件夹和NLog.config配置文件，除了这两个以外跟咱们正常新建asp.net core项目如出一辙，全部咱们直接从asp.net core解读开始剖析。

　　程序入口Program.cs文件的main函数(为啥是这样我也不知道，反正学c、学java仍是c#的时候老师和书都是这样教的，应该是定义或者约定俗成吧)打开以下：

namespace OrchardCore.Cms.Web
{
    public class Program
    {
        public static Task Main(string[] args)
            => BuildHost(args).RunAsync();

        public static IHost BuildHost(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureLogging(logging => logging.ClearProviders())
                .ConfigureWebHostDefaults(webBuilder => webBuilder
                    .UseStartup<Startup>()
                    .UseNLogWeb())
                .Build()
            ;
    }
}

　　很是明显的asp.net core代码，建立Host(主机)，而后Build(生成)，而后Run(运行)，跟新建asp.net core项目惟一区别就多了ConfigureLogging和ConfigureWebHostDefaults两个配置了，意思也很清楚(不清楚得去看asp.net core的源码了，此处省略1万个字)，就是清除默认日志提供者而后用NLog代替(感受就是我的爱好，你用log4net又咋样)，这也是项目里有NLog.config这个配置文件的缘由。要了解logging.ClearProviders()直接看asp.net core的api去。UseNLogWeb()是OrchardCord自定义的扩展方法，代码很是清楚就是加载NLog.config这个配置文件，NLog我也是只会简单用，就不分析了，之后有空再去看源码

        public static IWebHostBuilder UseNLogWeb(this IWebHostBuilder builder)
        {
            LayoutRenderer.Register<TenantLayoutRenderer>(TenantLayoutRenderer.LayoutRendererName);
            builder.UseNLog();
            builder.ConfigureAppConfiguration((context, configuration) =>
            {
                var environment = context.HostingEnvironment;
                environment.ConfigureNLog($"{environment.ContentRootPath}{Path.DirectorySeparatorChar}NLog.config");
                LogManager.Configuration.Variables["configDir"] = environment.ContentRootPath;
            });

            return builder;
        }

　　我重点关注仍是入口文件的UseStartup<Startup>()，总所周知这个是asp.net core的核心中的核心，没错，就是服务和中间件，终于来到重点了，这个会调用项目里Startup.cs的代码经过中间件生成管道，至于原理又是关于asp.net core的运行原理又能够省略1万字。

　　接触过asp.net core都知道经过Startup的ConfigureServices方法注册服务，Configure方法配置管道中间件。

    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddOrchardCms();
        }

        public void Configure(IApplicationBuilder app, IHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseStaticFiles();

            app.UseOrchardCore();
        }
    }

　　asp.net core表示服务配置能够没有。服务部分我是直接跳过了，这里是直接调用扩展方法services.AddOrchardCms()配置服务，其实服务按我理解就是依赖注入的注册，依赖注入是asp.net core的基础没啥好说的，反正就是后面能够自动实例化构造函数的类，因此这个地方致使我后面又掉了一个坑(找错实例的类)。

　　asp.net core的中间件配置必定要有，因此这部分是重中之重，前面的app.UseDeveloperExceptionPage()和app.UseStaticFiles()就不用说了，通常的asp.net core项目都有，就是异常和静态文件中间件。这个OrchardCore最重要的内容在于app.UseOrchardCore()这个扩展方法，这个扩展方法主要是后面两个中间件，固然前面那个PoweredByMiddleware也很重要(做者说我辛辛苦苦弄一个cms你竟然说个人版权不重要那我就惨了)，我这里只是说程序的运行很重要并非不尊重版权(我自己很尊重各个版权的，因此vs我只能用社区版、sqlserver只能用epress版)

    public static class ApplicationBuilderExtensions
    {
        /// <summary>
        /// Enables multi-tenant requests support for the current path.
        /// </summary>
        public static IApplicationBuilder UseOrchardCore(this IApplicationBuilder app, Action<IApplicationBuilder> configure = null)
        {
            var env = app.ApplicationServices.GetRequiredService<IHostEnvironment>();
            var appContext = app.ApplicationServices.GetRequiredService<IApplicationContext>();

            env.ContentRootFileProvider = new CompositeFileProvider(
                new ModuleEmbeddedFileProvider(appContext),
                env.ContentRootFileProvider);

            // Init also the web host 'ContentRootFileProvider'.
            app.ApplicationServices.GetRequiredService<IWebHostEnvironment>()
                .ContentRootFileProvider = env.ContentRootFileProvider;

            app.UseMiddleware<PoweredByMiddleware>();

            // Ensure the shell tenants are loaded when a request comes in
            // and replaces the current service provider for the tenant's one.
            app.UseMiddleware<ModularTenantContainerMiddleware>();

            configure?.Invoke(app);

            app.UseMiddleware<ModularTenantRouterMiddleware>(app.ServerFeatures);

            return app;
        }
    }

　　ModularTenantContainerMiddleware和ModularTenantRouterMiddleware这两个中间件撑起OrchardCore一片天，下次就从UseOrchardCore继续！从asp.net core角度去看真心简化好多，可是后面估计要恶补下asp.net core了(源码的项目太多，这个感受要看好久，并且目前github上面的asp.net core源码都是基于.net 5的，build都要很久)