基于 fireasy 构建的 asp.net core 示例

最近花时间弄了一个关于fireasy使用的demo，已放到 github 上供大家研究，https://github.com/faib920/zero

该 demo 演示了如何使用 fireasy 创建一个后台的管理系统。解决方案包含 asp.net mvc5 和 asp.net core 两个示例，使用 SQLite 数据库，基于 easyui 1.4.3 构建。

用户名: 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 一样面临的问题，那就是 <b>延迟加载</b> 属性会被一概序列化。因此 json 序列化也被优化过，采用 fireasy json serializer 能够主动识别延迟加载对象。
• 没有 ViewModel，但是可以扩展更多的属性给前端使用，在实体类_Ex 中，可以定义非 virtual 的属性，然后用 ExtendAs 扩展方法，这样避免了 new { } 这样繁琐的赋值操作。
• 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 数据库

containers 为IOC容器配置

mvc/bundles 配置bundle资源文件

注意 global 里对 fireasy 的配置，这些都是必要的

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 类文件里的配置

public void ConfigureServices(IServiceCollection services)
{
services.AddFireasy(Configuration)
    .AddIoc(ContainerUnity.GetContainer()); //添加IOC容器

services.AddMvc()
    .ConfigureFireasyMvc(options =>
    {
        options.Converters.Add(new LightEntityJsonConverter()); //action接收的实体对象，是经过 fireasy 底层处理过的
    })
    .ConfigureEasyUI();
}