基于 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();
}

  

上一篇:ASP.NET 5 RC1 升级 ASP.NET Core 1.0 RC2 记录


下一篇:JavaScript巧学巧用