🐬 .NET Web 应用框架
注意:
本项目插件部分现已封装为类库,如果你仅仅需要快速实现插件系统,请见 PluginCore
一个轻量的 Web 应用框架, 具有优雅、高效、简洁、富于表达力等优点。采用 前后端分离 设计,是崇尚开发效率的全栈框架
- 简单 - 享受5分钟安装, 轻松上手。
- 易扩展 - 插件化架构, 轻松扩展。
- 暂无
一个示例插件项目结构 如下图
或则你可以直接实现
IPlugin
可通过预先定义框架行为钩子,插件再实现接口,将插件行为加入框架,如实现
ITestPlugin
支持插件
构造器注入
框架预先注入的服务等
public class GetUserInfoPlugin : BasePlugin, ITestPlugin
{
private readonly IUserInfoService _userInfoService;
public GetUserInfoPlugin(IUserInfoService userInfoService)
{
this._userInfoService = userInfoService;
}
public string Say()
{
UserInfo userInfo = _userInfoService.FirstOrDefaultAsync(m => !m.IsDeleted).Result;
string rtn = $"用户名: {userInfo.UserName}, 创建时间: {userInfo.CreateTime.ToString()}";
return rtn;
}
public override (bool IsSuccess, string Message) AfterEnable()
{
Console.WriteLine($"{nameof(GetUserInfoPlugin)}: {nameof(AfterEnable)}");
return base.AfterEnable();
}
public override (bool IsSuccess, string Message) BeforeDisable()
{
Console.WriteLine($"{nameof(GetUserInfoPlugin)}: {nameof(BeforeDisable)}");
return base.BeforeDisable();
}
}
支持 动态扩展 WebAPI,和普通WebAPI 项目相同,直接创建 Controller 即可
[Route("api/plugins/[controller]")]
[ApiController]
public class UserHelloController : ControllerBase
{
private readonly IUserInfoService _userInfoService;
public UserHelloController(IUserInfoService userInfoService)
{
this._userInfoService = userInfoService;
}
public ActionResult Get()
{
UserInfo userInfo = _userInfoService.FirstOrDefaultAsync(m => !m.IsDeleted).Result;
SettingsModel settingsModel = PluginSettingsModelFactory.Create<SettingsModel>("GetUserInfo");
string rtn = $"用户名: {userInfo.UserName}, 创建时间: {userInfo.CreateTime.ToString()}, Hello: {settingsModel.Hello}";
return Ok(rtn);
}
}
插件设置(可选), Json Model 类 继承
PluginSettingsModel
public class SettingsModel : PluginSettingsModel
{
public string Hello { get; set; }
}
文件名必须 settings.json
{
"Hello": "哈哈哈哈哈或或或或或或"
}
插件描述
info.json
(必需)
{
"PluginId": "GetUserInfo",
"DisplayName": "获取一个用户",
"Description": "这是一个示例插件2号。",
"Author": "yiyun",
"Version": "0.1.0",
"SupportedVersions": [ "0.0.1" ]
}
插件文档
README.md
(可选), 文件名必须 README.md
## 说明文档(可选)
- [] 这是一个示例插件
- [x] 感谢使用
右键选择插件项目,点击发布(Publish),再将发布后的插件文件夹打包为
GetUserInfo.zip
即可
压缩包名可随意,框架将以info.json
中PluginId
作为插件标识
打包后的插件,即可通过 上传本地插件 载入框架
GetUserInfo.csproj 参考
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netcoreapp3.1</TargetFramework>
</PropertyGroup>
<ItemGroup>
<ProjectReference Include="..\..\src\Framework\Libraries\Domain\Domain.csproj" />
<ProjectReference Include="..\..\src\Framework\Libraries\Framework\Framework.csproj" />
<ProjectReference Include="..\..\src\Framework\Libraries\PluginCore\PluginCore.csproj" />
<ProjectReference Include="..\..\src\Framework\Libraries\Services\Services.csproj" />
</ItemGroup>
<ItemGroup>
<None Update="info.json">
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
</None>
<None Update="README.md">
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
</None>
<None Update="settings.json">
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
</None>
</ItemGroup>
</Project>
本框架主要提供了插件框架的简单实现样板,如果你想要实现一个Web插件框架,你可以参考本框架的代码。 目前运行本框架 还需要 同时运行 以下两个
- remember-default-admin-theme 本框架的 Vue.js 前端
- UHub 统一身份认证
- 运行环境: .NET Core 3.1
- 开发环境: Visual Studio Community 2019
- 插件系统设计参考自 Mystique,感谢作者 lamondlu 的贡献
- 设计参考自 TsBlog,感谢作者 lampo1024 的贡献
- 设计参考自 nopCommerce,感谢作者 nopSolutions 的贡献
- 设计参考自 Blog.Core,感谢作者 anjoy8 的贡献
Remember.Core is an Apache-2.0 licensed open source project and completely free to use. However, the amount of effort needed to maintain and develop new features for the project is not sustainable without proper financial backing.
We accept donations through these channels:
Remember.Core © yiyun, Released under the Apache-2.0 License.
Authored and maintained by yiyun with help from contributors (list).
GitHub @yiyungent