ASP.NET Core基础1：应用启动流程

/// <summary>
        /// initializes a new instance of the <see cref="webhostbuilder"/> class with pre-configured defaults.
        /// </summary>
        /// <remarks>
        ///   the following defaults are applied to the returned <see cref="webhostbuilder"/>:
        ///     use kestrel as the web server and configure it using the application's configuration providers,
        ///     set the <see cref="ihostingenvironment.contentrootpath"/> to the result of <see cref="directory.getcurrentdirectory()"/>,
        ///     load <see cref="iconfiguration"/> from 'appsettings.json' and 'appsettings.[<see cref="ihostingenvironment.environmentname"/>].json',
        ///     load <see cref="iconfiguration"/> from user secrets when <see cref="ihostingenvironment.environmentname"/> is 'development' using the entry assembly,
        ///     load <see cref="iconfiguration"/> from environment variables,
        ///     load <see cref="iconfiguration"/> from supplied command line args,
        ///     configure the <see cref="iloggerfactory"/> to log to the console and debug output,
        ///     and enable iis integration.
        /// </remarks>
        /// <param name="args">the command line args.</param>
        /// <returns>the initialized <see cref="iwebhostbuilder"/>.</returns>
        public static iwebhostbuilder createdefaultbuilder(string[] args)
        {
            var builder = new webhostbuilder();

            if (string.isnullorempty(builder.getsetting(webhostdefaults.contentrootkey)))
            {
                builder.usecontentroot(directory.getcurrentdirectory());
            }
            if (args != null)
            {
                builder.useconfiguration(new configurationbuilder().addcommandline(args).build());
            }

            builder.usekestrel((buildercontext, options) =>
                {
                    options.configure(buildercontext.configuration.getsection("kestrel"));
                })
                .configureappconfiguration((hostingcontext, config) =>
                {
                    var env = hostingcontext.hostingenvironment;

                    config.addjsonfile("appsettings.json", optional: true, reloadonchange: true)
                          .addjsonfile($"appsettings.{env.environmentname}.json", optional: true, reloadonchange: true);

                    if (env.isdevelopment())
                    {
                        var appassembly = assembly.load(new assemblyname(env.applicationname));
                        if (appassembly != null)
                        {
                            config.addusersecrets(appassembly, optional: true);
                        }
                    }

                    config.addenvironmentvariables();

                    if (args != null)
                    {
                        config.addcommandline(args);
                    }
                })
                .configurelogging((hostingcontext, logging) =>
                {
                    logging.addconfiguration(hostingcontext.configuration.getsection("logging"));
                    logging.addconsole();
                    logging.adddebug();
                    logging.addeventsourcelogger();
                })
                .configureservices((hostingcontext, services) =>
                {
                    // fallback
                    services.postconfigure<hostfilteringoptions>(options =>
                    {
                        if (options.allowedhosts == null || options.allowedhosts.count == 0)
                        {
                            // "allowedhosts": "localhost;127.0.0.1;[::1]"
                            var hosts = hostingcontext.configuration["allowedhosts"]?.split(new[] { ';' }, stringsplitoptions.removeemptyentries);
                            // fall back to "*" to disable.
                            options.allowedhosts = (hosts?.length > 0 ? hosts : new[] { "*" });
                        }
                    });
                    // change notification
                    services.addsingleton<ioptionschangetokensource<hostfilteringoptions>>(
                        new configurationchangetokensource<hostfilteringoptions>(hostingcontext.configuration));

                    services.addtransient<istartupfilter, hostfilteringstartupfilter>();
                })
                .useiis()
                .useiisintegration()
                .usedefaultserviceprovider((context, options) =>
                {
                    options.validatescopes = context.hostingenvironment.isdevelopment();
                });

            return builder;
        }

/// <summary>
        /// builds the required services and an <see cref="iwebhost"/> which hosts a web application.
        /// </summary>
        public iwebhost build()
        {
            if (_webhostbuilt)
            {
                throw new invalidoperationexception(resources.webhostbuilder_singleinstance);
            }
            _webhostbuilt = true;

            var hostingservices = buildcommonservices(out var hostingstartuperrors);
            var applicationservices = hostingservices.clone();
            var hostingserviceprovider = getproviderfromfactory(hostingservices);

            if (!_options.suppressstatusmessages)
            {
                // warn about deprecated environment variables
                if (environment.getenvironmentvariable("hosting:environment") != null)
                {
                    console.writeline("the environment variable 'hosting:environment' is obsolete and has been replaced with 'aspnetcore_environment'");
                }

                if (environment.getenvironmentvariable("aspnet_env") != null)
                {
                    console.writeline("the environment variable 'aspnet_env' is obsolete and has been replaced with 'aspnetcore_environment'");
                }

                if (environment.getenvironmentvariable("aspnetcore_server.urls") != null)
                {
                    console.writeline("the environment variable 'aspnetcore_server.urls' is obsolete and has been replaced with 'aspnetcore_urls'");
                }
            }

            addapplicationservices(applicationservices, hostingserviceprovider);

            var host = new webhost(
                applicationservices,
                hostingserviceprovider,
                _options,
                _config,
                hostingstartuperrors);
            try
            {
                host.initialize();

                var logger = host.services.getrequiredservice<ilogger<webhost>>();

                // warn about duplicate hostingstartupassemblies
                foreach (var assemblyname in _options.getfinalhostingstartupassemblies().groupby(a => a, stringcomparer.ordinalignorecase).where(g => g.count() > 1))
                {
                    logger.logwarning($"the assembly {assemblyname} was specified multiple times. hosting startup assemblies should only be specified once.");
                }

                return host;
            }
            catch
            {
                // dispose the host if there's a failure to initialize, this should clean up
                // will dispose services that were constructed until the exception was thrown
                host.dispose();
                throw;
            }

            iserviceprovider getproviderfromfactory(iservicecollection collection)
            {
                var provider = collection.buildserviceprovider();
                var factory = provider.getservice<iserviceproviderfactory<iservicecollection>>();

                if (factory != null && !(factory is defaultserviceproviderfactory))
                {
                    using (provider)
                    {
                        return factory.createserviceprovider(factory.createbuilder(collection));
                    }
                }

                return provider;
            }
        }

namespace hellonetcorewebapi
{
    public class startup
    {
        public startup(iconfiguration configuration)
        {
            configuration = configuration;
        }

        public iconfiguration 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().setcompatibilityversion(compatibilityversion.version_2_2);
        }

        // this method gets called by the runtime. use this method to configure the http request pipeline.
        public void configure(iapplicationbuilder app, ihostingenvironment env)
        {
            if (env.isdevelopment())
            {
                app.usedeveloperexceptionpage();
            }
            else
            {
                // the default hsts value is 30 days. you may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
                app.usehsts();
            }

            app.usehttpsredirection();
            app.usemvc();
        }
    }
}