API

• API
  • IHostBuilder.UsePluginFactory 扩展方法
    • UsePluginFactory()
    • UsePluginFactory(IConfiguration configuration)
    • UsePluginFactory(IConfiguration configuration, Assembly assembly)
    • UsePluginFactory(IConfiguration configuration, IEnumerable<Assembly> assemblies)
    • UsePluginFactory(Assembly assembly)
    • UsePluginFactory(IEnumerable<Assembly> assemblies)
    • UsePluginFactory(Action<PluginFactoryOptions> options)
    • UsePluginFactory(IConfiguration configuration, Action<PluginFactoryOptions> options)
  • IServiceCollection.AddPluginFactory 扩展方法
    • AddPluginFactory()
    • AddPluginFactory(IConfiguration configuration)
    • AddPluginFactory(IConfiguration configuration, Assembly assembly)
    • AddPluginFactory(IConfiguration configuration, IEnumerable<Assembly> assemblies)
    • AddPluginFactory(Action<PluginFactoryOptions> configureOptions)
    • AddPluginFactory(IConfiguration configuration, Action<PluginFactoryOptions> configureOptions)
    • AddPluginFactory(PluginFactoryOptions options, IConfiguration configuration)
  • IPluginLoader
    • PluginList属性
    • Load()
    • Init()
  • IPluginFactory
    • StartAsync(CancellationToken cancellationToken)
    • StopAsync(CancellationToken cancellationToken)
  • IPluginContext
    • PluginFactory属性
    • ServiceProvider属性
    • CancellationToken属性
  • IPluginInitContext
    • PluginPath属性
    • PluginLoader属性
    • ServiceCollection属性
    • InitServiceProvider属性
  • IPlugin
    • StartAsync(IPluginContext context)
    • Task StopAsync(IPluginContext context)
  • ISupportInitPlugin
    • Init(IPluginInitContext context)
  • ISupportConfigPlugin
  • PluginFactoryOptions
    • PluginPath属性
    • FileProvider属性
    • DisabledPluginList属性
    • AddAssembly(Assembly assembly)
  • PluginInfo
    • Id属性
    • Name属性
    • Description属性
    • Alias属性
    • IsEnable属性
    • PluginType属性
    • CanConfig顺序
    • CanInit属性
  • PluginBase
  • SupportConfigPluginBase
  • PluginAttribute
    • Id属性
    • Alias属性
    • Name属性
    • Description属性

IHostBuilder.UsePluginFactory 扩展方法

UsePluginFactory()

• 说明：无参数，使用默认配置来启用插件工厂，此时会使用IHostBuilder的配置作为插件配置容器，使用应用目录的Plugins目录作为插件目录

UsePluginFactory(IConfiguration configuration)

• 说明：使用指定的配置来初始化插件工厂
• 参数列表：
  • configuration： IConfiguration，插件所使用的配置对象，插件将从此配置的Plugins节点获取插件自身的配置

UsePluginFactory(IConfiguration configuration, Assembly assembly)

• 说明：使用指定的配置来初始化插件工厂, 并自动加载assembly参数指定的程序集
• 参数列表：
  • configuration： IConfiguration，插件所使用的配置对象，插件将从此配置的Plugins节点获取插件自身的配置
  • assembly：Assembly，要载入的插件程序集

UsePluginFactory(IConfiguration configuration, IEnumerable<Assembly> assemblies)

• 说明：使用指定的配置来初始化插件工厂, 并自动加载assemblies参数指定的程序集列表
• 参数列表：
  • configuration： IConfiguration，插件所使用的配置对象，插件将从此配置的Plugins节点获取插件自身的配置
  • assemblies：List<Assembly>，要载入的插件程序集列表

UsePluginFactory(Assembly assembly)

• 说明：使用默认配置初始化插件工厂, 并自动加载assembly参数指定的程序集
• 参数列表：
  • assembly：Assembly，要载入的插件程序集

UsePluginFactory(IEnumerable<Assembly> assemblies)

• 说明：使用默认配置初始化插件工厂, 并自动加载assemblies参数指定的程序集列表
• 参数列表：
  • assemblies：List<Assembly>，要载入的插件程序集列表

UsePluginFactory(Action<PluginFactoryOptions> options)

• 说明：使用指定的设置来初始化插件工厂
• 参数列表：
  • options：Action<PluginFactoryOptions>，设置委托，可设置项参考PluginFactoryOptions

UsePluginFactory(IConfiguration configuration, Action<PluginFactoryOptions> options)

• 说明：指定插件配置容器，并使用指定的设置来初始化插件工厂
• 参数列表：
  • configuration： IConfiguration，插件所使用的配置对象，插件将从此配置的Plugins节点获取插件自身的配置
  • options：Action<PluginFactoryOptions>，设置委托，可设置项参考PluginFactoryOptions

IServiceCollection.AddPluginFactory 扩展方法

AddPluginFactory()

• 说明：使用默认设置初始化插件工厂，此时内部会使用内存配置容器作为插件配置，故不会从配置文件或其他配置源载入配置；插件目录将使用Plugins目录

AddPluginFactory(IConfiguration configuration)

• 说明：使用指定的配置来初始化插件工厂
• 参数列表：
  • configuration： IConfiguration，插件所使用的配置对象，插件将从此配置的Plugins节点获取插件自身的配置

AddPluginFactory(IConfiguration configuration, Assembly assembly)

• 说明：使用指定的配置来初始化插件工厂, 并自动加载assembly参数指定的程序集
• 参数列表：
  • configuration： IConfiguration，插件所使用的配置对象，插件将从此配置的Plugins节点获取插件自身的配置
  • assembly：Assembly，要载入的插件程序集

AddPluginFactory(IConfiguration configuration, IEnumerable<Assembly> assemblies)

• 说明：使用指定的配置来初始化插件工厂, 并自动加载assemblies参数指定的程序集列表
• 参数列表：
  • configuration： IConfiguration，插件所使用的配置对象，插件将从此配置的Plugins节点获取插件自身的配置
  • assemblies：List<Assembly>，要载入的插件程序集列表

AddPluginFactory(Action<PluginFactoryOptions> configureOptions)

• 说明：使用指定的设置来初始化插件工厂
• 参数列表：
  • options：Action<PluginFactoryOptions>，设置委托，可设置项参考PluginFactoryOptions

AddPluginFactory(IConfiguration configuration, Action<PluginFactoryOptions> configureOptions)

• 说明：指定插件配置容器，并使用指定的设置来初始化插件工厂
• 参数列表：
  • configuration： IConfiguration，插件所使用的配置对象，插件将从此配置的Plugins节点获取插件自身的配置
  • options：Action<PluginFactoryOptions>，设置委托，可设置项参考PluginFactoryOptions

AddPluginFactory(PluginFactoryOptions options, IConfiguration configuration)

• 说明：指定设置对象，并使用指定配置对象来初始化插件工厂
• 参数列表：
  • options：PluginFactoryOptions，设置对象，可设置项参考PluginFactoryOptions
  • configuration： IConfiguration，插件所使用的配置对象，插件将从此配置的Plugins节点获取插件自身的配置

IPluginLoader

IPluginLoader主要用于从指定位置载入插件

PluginList属性

• 说明：只读属性，返回已加载的插件列表，类型为IReadOnlyList≶PluginInfo>，参见PluginInfo

Load()

• 说明：加载插件程序集，注意：通常情况下你无需调用此方法，框架内部会自动调用，如果你要实现自己的加载机制，则可实现此接口
• 返回：void

Init()

• 说明：初始化插件，注意：通常情况下你无需调用此方法，框架内部会自动调用，如果你要实现自己的加载机制，则可实现此接口
• 返回：void

IPluginFactory

IPluginFactory插件工厂接口，用于控制插件的生命周期，该接口从IHostedService继承，故支持宿主的托管服务机制

StartAsync(CancellationToken cancellationToken)

• 说明：启动所有插件
• 参数：
  • cancellationToken： CancellationToken，取消监听令牌
• 返回：Task

StopAsync(CancellationToken cancellationToken)

• 说明：停止所有插件
• 参数：
  • cancellationToken： CancellationToken，取消监听令牌
• 返回：Task

IPluginContext

IPluginContext插件上下文，是插件运行时的上下文数据，将传递给插件的相关方法

PluginFactory属性

• 说明：只读，当前的IPluginFactory实例

ServiceProvider属性

• 说明：只读，当前的IServiceProvider实例

CancellationToken属性

• 说明：只读，关联的取消监听令牌，你可以通过此令牌判断上层操作是否已被取消

IPluginInitContext

IPluginInitContext插件初始化上下文，由支持初始化的插件接口ISupportInitPlugin的Init方法使用

PluginPath属性

• 说明：只读，插件路径

PluginLoader属性

• 说明：只读，当前关联的插件载入器, 请参考IPluginLoader

ServiceCollection属性

• 说明：只读，应用的依赖注入服务容器，通过此属性可注入新的服务

InitServiceProvider属性

• 说明：只读，初始化所使用的服务提供器，通过此属性可获取依赖的其他服务，注意通过此提供器可获取初始化插件工厂方法之前所注入的服务。

IPlugin

IPlugin是插件的基础接口，所有插件需实现此接口

StartAsync(IPluginContext context)

• 说明：启动插件
• 参数：
  • context, IPluginContext, 插件上下文
• 返回：Task

Task StopAsync(IPluginContext context)

• 说明：停止插件
• 参数：
  • context, IPluginContext, 插件上下文
• 返回：Task

ISupportInitPlugin

ISupportInitPlugin接口用于实现插件的初始化机制

Init(IPluginInitContext context)

• 说明：插件初始化
• 参数：
  • context：IPluginInitContext, 插件初始化上下文

ISupportConfigPlugin

ISupportConfigPlugin接口用于实现插件的配置机制，它是泛型接口，泛型参数为TOptions，表示插件的配置类型

PluginFactoryOptions

PluginFactoryOptions是插件工厂的配置类型

PluginPath属性

• 说明：获取或设置插件工厂所使用的插件路径

FileProvider属性

• 说明：获取或设置插件载入时所使用的文件提供器，默认将使用PhysicalFileProvider提供器

DisabledPluginList属性

• 说明，只读，获取当前被禁用的插件列表

AddAssembly(Assembly assembly)

• 说明：添加插件程序集
• 参数：
  • assembly：Assembly，插件程序集

PluginInfo

PluginInfo类用于保存插件的相关信息

Id属性

• 说明：插件ID

Name属性

• 说明：插件名称

Description属性

• 说明：插件说明

Alias属性

• 说明：插件别名

IsEnable属性

• 说明：是否启用

PluginType属性

• 说明：插件的类型信息

CanConfig顺序

• 说明：插件是否可配置

CanInit属性

• 说明：插件是否可初始化

PluginBase

PluginBase插件基类，实现了IPlugin接口，你可以从此类继承，然后重写相应的方法

SupportConfigPluginBase

SupportConfigPluginBase支持配置的插件基类，从PluginBase继承，并实现了ISupportConfigPlugin<TOptions>方法，继承此类，必须提供支持IOptionsMonitor<TOptions> options参数的构造函数，以传入插件配置。

PluginAttribute

PluginAttribute特性，用于设置插件的相关信息。

Id属性

• 说明：插件ID

Alias属性

• 说明：插件别名

Name属性

• 说明：插件名称

Description属性

• 说明：插件描述