# zero
**Repository Path**: faib920/zero
## Basic Information
- **Project Name**: zero
- **Description**: 该 demo 演示了如何使用 fireasy 创建一个后台的管理系统。解决方案包含 asp.net mvc5 和 asp.net core 两个示例，使用 SQLite 数据库，基于 easyui 1.4.3 构建。
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 2
- **Forks**: 5
- **Created**: 2018-06-04
- **Last Updated**: 2022-10-29
## Categories & Tags
**Categories**: backend
**Tags**: None
## README
# fireasy zero sample
该 demo 演示了如何使用 fireasy 创建一个后台的管理系统。解决方案包含 asp.net mvc5 和 asp.net core 两个示例，使用 SQLite 数据库，基于 easyui 1.4.3 构建。
该 demo 是基于 Fireasy 框架搭建的，Fireasy 在线文档请点这里进入：[http://www.fireasy.cn/docs](http://www.fireasy.cn/docs)
注意
* 最新的版本基于.net core 2.2 / .net core 3.1 (默认为 2.2，若需切换请直接修改项目文件里的 TargetFramework)，请确定你已安装sdk，否则将无法运行。
* 示例中使用 redis 作为数据缓存，你可以安装 redis 2.8 或在配置中将缓存关闭（删除配置节）。
* 示例中使用 mongodb 作为日志数据库。如果你未安装 mongodb 及未正确配置，登录后记录日志时将连接超时，错误日志将在控制台输出，属于正常情况。
* 用户名: admin 密码: admin
特点
* 数据库操作与 entity framework 的用法较相似，也是使用 linq ，降低了学习成本，然而与后者所不同的是，提供了 Insert、Update、Delete、Batch 等方法更快捷地进行操作，更贴近于 sql 原生语言。
* 基于 easyui 构建的后台管理系统，view 层采用 ajax 进行数据交互，因此在 action 接收参数时，直接通过 json 反序列化的方式进行 model bind，这样的好处是，对于复杂的提交的数据结构，比如多个 list，嵌套的对象等，都很容易在 action 里接收。
* action 接收的实体对象能够主动区分哪些属性被修改，这得益于 LightEntityJsonConverter 转换器，这样，新增或修改时，不必考虑原有数据被覆盖的可能。
* 没有创建 ViewModel，而直接使用 DataModel，这样节省了很多开发时间，然而这样带来的一个问题，可能也是使用 entity framework 一样面临的问题，那就是 延迟加载 属性会被一概序列化。因此 json 序列化也被优化过，采用 fireasy json serializer 能够主动识别延迟加载对象。
* 没有 ViewModel，但是可以扩展更多的属性给前端使用，在实体类_Ex 中，可以定义非 virtual 的属性，然后用 ExtendAs 扩展方法，这样避免了 new { } 这样繁琐的赋值操作。
* 新版也引入了 DTO 模式，具体可查看用户相关的功能。
* services 是基于 AOP 的实例，提供了事务处理、缓存处理等拦截器，只需要标识特性就可以实现这些功能。这也必须使用 fireasy 的 IOC 容器。
项目结构
Fireasy.Zero.Models 实体模型
Fireasy.Zero.Infrastructure 基础设施
Fireasy.Zero.Helpers 相关辅助
Fireasy.Zero.Services 数据服务
Fireasy.Zero.AspNet Mvc5示例
Fireasy.Zero.AspNetCore Core示例
Mvc5 配置
有关 fireasy 的配置请参考 web.config 里的 fireasy 小节，其中:
dataInstances 为数据库实例配置，当前使用 sqlite 数据库
cachings 缓存配置，当前采用 redis ，如果删除此配置，则使用内存作为缓存
containers 为IOC容器配置
mvc/bundles 配置bundle资源文件
注意 global 里对 fireasy 的配置，这些都是必要的
```C#
BundleManager.Config();
//MVC控制器工厂添加IOC容器
var container = ContainerUnity.GetContainer();
ControllerBuilder.Current.SetControllerFactory(new ControllerFactory(container));
//easyui验证绑定
SettingsBindManager.RegisterBinder("validatebox", new ValidateBoxSettingBinder());
SettingsBindManager.RegisterBinder("numberbox", new NumberBoxSettingBinder());
//使用 LightEntity 反序列化转换器
GlobalSetting.Converters.Add(new LightEntityJsonConverter());
//从 Container 里反转类型反序列化
GlobalSetting.Converters.Add(new ContainerJsonConverter(container));
```
core 配置
以上面示例相似，core 的配置在 appsettings.json 里，也是对数据库实例，IOC容器进行配置。
Startup 类文件里的配置（有更新，具体请查看代码）
```C#
public void ConfigureServices(IServiceCollection services)
{
services.AddFireasy(Configuration, options =>
{
//注册实体持久化的订阅通知
options.AddSubscriber(string.Empty, subject => new EntitySubscriber().Accept(subject));
})
.AddIoc(ContainerUnity.GetContainer()) //添加 appsettings.json 里的 ioc 配置
.AddEntityContext(options =>
{
options.AutoCreateTables = true; //此项为 true 时, 采用 codefirst 模式维护数据库表
options.NotifyEvents = true; //此项设为 true 时, 上面的实体持久化订阅通知才会触发
});
services.AddMvc()
.AddSessionStateTempDataProvider()
.ConfigureFireasyMvc(options =>
{
options.JsonSerializeOption.Converters.Add(new LightEntityJsonConverter()); //action接收的实体对象，是经过 fireasy 底层处理过的
})
.ConfigureEasyUI();
services.AddSession()
.AddSessionRevive(); //session 复活
}
```
------------------------------------------------------------------------
QQ号： 55570729
QQ群： 225698098
------------------------------------------------------------------------
