Serve.Run功能启动和使用方法

一、速通一图流

（缺图，下班了）

二、六种启动方式

1. 配置默认启动地址/端口

在使用 Furion 框架时，默认的 Web 主机端口为 5000 和 5001。可以通过多种方式自定义启动地址和端口：

1.1 直接在代码中指定端口

可以通过以下代码直接指定端口：

Serve.Run("https://localhost:8080");  // 将 Web 主机配置为在端口 8080 上运行

1.2 通过 RunOptions 配置

使用 RunOptions 配置启动地址和端口：

Serve.Run(RunOptions.Default, "https://localhost:8080");  // 使用默认的 RunOptions 配置，并指定端口 8080

1.3 通过 dotnet run 命令行指定

使用命令行在运行时指定启动地址和端口：

dotnet run --urls https://localhost:8080  // 使用命令行参数指定端口 8080

1.4 通过 ConfigureBuilder 自定义配置

可以通过 ConfigureBuilder 方法来自定义更多的配置选项：

Serve.Run(RunOptions.Default.ConfigureBuilder(builder =>
{
    builder.WebHost.UseUrls("https://localhost:8080");  // 配置 Web 主机使用端口 8080
}));

1.5 通过 JSON 文件配置端口

可以在 JSON 配置文件中指定启动端口：

• 在 launchSettings.json 中配置：

{
  "profiles": {
    "YourProjectName": {
      "applicationUrl": "https://localhost:8080;http://localhost:8081",  // 指定多个端口，分别为 8080 和 8081
    }
  }
}

• 在 appsettings.json 中配置：

{
  "Urls": "http://localhost:8081"  // 通过配置文件指定端口 8081
}

1.6 使用随机空闲端口启动

可以让应用在随机的空闲端口上启动：

Serve.Run(urls: Serve.IdleHost.Urls);  // 使用随机的空闲端口启动应用

2. 便捷服务注册

在 Furion 4.8.0+ 版本中，可以通过以下方式注册服务：

2.1 直接注册服务

可以直接在 Serve.Run 方法中注册服务：

Serve.Run(additional: services =>
{
    services.AddRemoteRequest();  // 直接注册远程请求服务
});

2.2 使用泛型主机方式注册服务

可以使用泛型主机的方式来注册服务：

Serve.RunGeneric(services =>
{
    services.AddRemoteRequest();  // 使用泛型主机注册远程请求服务
});

3. 自定义配置

通过 RunOptions 对象，可以自定义和控制服务的配置：

3.1 仅集成 Furion 默认配置

只使用 Furion 的默认配置：

Serve.Run(RunOptions.Default);  // 使用 Furion 的默认配置启动

3.2 配置更多服务和中间件

可以通过 RunOptions 自定义服务和中间件的配置：

Serve.Run(RunOptions.Default
    .ConfigureBuilder(builder =>
    {
        builder.Services.AddControllers().AddInject();  // 添加控制器和依赖注入
    })
    .Configure(app =>
    {
        app.UseRouting();  // 使用路由中间件
        app.UseInject(string.Empty);  // 使用依赖注入中间件
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();  // 映射控制器路由
        });
    }));

3.3 使用 WebComponent 方式扩展配置

可以通过添加 Web 组件的方式来扩展应用的配置：

Serve.Run(RunOptions.Default.AddWebComponent<XXXWebComponent>());

public class XXXWebComponent : IWebComponent  // 自定义 Web 组件实现
{
    public void Load(WebApplicationBuilder builder, ComponentContext componentContext)
    {
        // 自定义组件加载逻辑
    }
}

4. Serve.Run 和 Startup 最佳组合

为了简化 Program.cs 文件中的配置，Furion 推荐使用组件化启动方式：

4.1 Program.cs 中只需一句话

在 Program.cs 中使用一句话启动应用：

Serve.Run(RunOptions.Default);  // 使用默认配置启动应用

4.2 在 Startup.cs 中进行服务和中间件配置

通过 Startup.cs 文件进行更详细的服务和中间件配置：

public class Startup : AppStartup  // 定义 Startup 类，继承自 AppStartup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // 配置服务
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // 配置中间件
    }
}

5. 支持 Furion 的所有功能

5.1 添加 appsettings.json 并读取配置

可以通过 appsettings.json 文件来配置和读取应用的设置：

Serve.Run();  // 启动应用

[DynamicApiController]
public class HelloService
{
    public string Say()
    {
        return "Hello, Furion " + App.Configuration["Logging:LogLevel:Default"];  // 读取配置文件中的日志级别
    }
}

5.2 将控制台项目变为 Web 项目

可以通过修改 .csproj 文件，将控制台项目转换为 Web 项目：

<Project Sdk="Microsoft.NET.Sdk">  // 修改为 Web 项目类型
<Project Sdk="Microsoft.NET.Sdk.Web">  // 通过修改 Sdk 属性，将控制台项目转为 Web 项目

6. RunOptions、LegacyRunOptions 和 GenericRunOptions

Furion 提供了三种方式来配置和启动应用：

6.1 RunOptions

用于创建 Web 主机的推荐方式：

Serve.Run(RunOptions.Default);  // 使用 RunOptions 默认配置启动应用

6.2 LegacyRunOptions

使用传统 Host 方式但默认配置了 Web 主机：

Serve.Run(LegacyRunOptions.Default);  // 使用 LegacyRunOptions 配置启动应用

6.3 GenericRunOptions

用于通用类型主机，适用于 Worker Service：

Serve.Run(GenericRunOptions.Default);  // 使用 GenericRunOptions 启动应用，适用于通用主机

7. 在 WinForm/WPF/Console 中使用 Furion

7.1 WinForm 中初始化

可以在 WinForm 中初始化 Furion 应用：

Serve.RunNative();  // 默认使用端口 5000 启动，可以通过 includeWeb 参数关闭或更改端口

7.2 WPF 中初始化

可以在 WPF 应用中初始化 Furion：

Serve.RunNative();  // 使用默认配置在 WPF 应用中启动 Furion

7.3 Console 中初始化

可以在控制台应用中初始化 Furion：

Serve.RunNative();  // 使用默认配置在控制台应用中启动 Furion

8. 静默启动

8.1 阻塞线程启动

可以以静默模式阻塞线程启动应用：

Serve.Run(silence: true);  // 使用静默模式启动应用，阻塞线程

8.2 使用 RunOptions 配置静默启动

也可以通过 RunOptions 配置静默启动：

Serve.Run(RunOptions.DefaultSilence);  // 使用默认的静默配置启动应用

---