(一)學習瞭解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都要好久)