EasyData快速入门指南

EasyData快速入门指南

EasyData Adaptive CRUD for ASP.NET Core. With EasyData you can get both API endpoints and client-side UI for all CRUD operations in a matter of minutes using just your DbContext and a few lines of code. 项目地址: https://gitcode.com/gh_mirrors/ea/EasyData

EasyData 是一个专为 ASP.NET Core 设计的轻量级 CRUD（创建、读取、更新、删除）框架，通过简单的步骤即可在应用程序中实现数据库操作界面。以下是基于其GitHub仓库https://github.com/KorzhCom/EasyData.git的简要安装与配置教程。

1. 目录结构及介绍

EasyData 的项目目录结构通常包括以下核心部分：

• EasyData/: 根目录，包含了整个项目的主框架。
  • config/: 可能存放配置相关文件。
  • js/: 包含用于前端的JavaScript代码，如easydata.min.js用于客户端渲染UI。
  • net/: .NET相关的源码。
  • samples/: 示例项目，帮助理解如何使用EasyData快速搭建应用。
  • sln, .sln*: 解决方案文件，如EasyData.sln, EasyData.Samples.sln，用于加载整个解决方案或样本工程到Visual Studio。
  • LICENSE, README.md: 许可证信息与项目说明文档。

2. 项目的启动文件介绍

在ASP.NET Core项目中，启动过程主要涉及以下两个关键文件：

对于 .NET 6 或更高版本的项目（基于Program.cs）

• Program.cs

  using EasyData.Services;
  
  var app = builder.Build();
  app.UseEasyData(options => 
      options.UseDbContext<AppDbContext>()
  );
  app.MapRazorPages();
  

  这里定义了中间件使用，通过UseEasyData配置EasyData，并指定使用的DbContext类型。

对于传统 .NET Core项目的 Startup.cs（旧方式）

• Startup.cs

  using EasyData.Services;
  
  public class Startup
  {
      public void ConfigureServices(IServiceCollection services)
      {
          // 配置EasyData的服务
          services.AddEasyData();
      }
  
      public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
      {
          app.UseRouting();
          app.UseEndpoints(endpoints =>
          {
              endpoints.MapEasyData(options => 
                  options.UseDbContext<AppDbContext>()
              );
              endpoints.MapRazorPages();
          });
      }
  }
  

  注意在较早版本的项目中，服务配置与端点映射是在ConfigureServices和Configure中分别完成的。

3. 项目的配置文件介绍

EasyData本身没有特定的配置文件，但它的配置主要通过代码来实现。然而，如果你希望调整EasyData的行为或集成自定义设置，可以通过几种方式进行：

• 代码内配置：正如在启动文件中通过中间件选项(options.UseDbContext<>)直接配置所示。
• Fluent API配置：在注册EasyData服务时，可以使用Fluent API进行更详细的配置，比如过滤实体或属性、定制元数据等。
• 环境变量或依赖注入：虽然不是直接的配置文件，但可以通过环境变量或依赖注入的方式为EasyData服务提供配置值，尤其是当处理数据库连接字符串或其他运行时需要动态改变的设置时。

为了完全利用EasyData的功能，确保你的项目已经安装了必要的NuGet包（如EasyData.AspNetCore, EasyData.EntityFrameworkCore.Relational），并遵循上述步骤设置好启动流程和所需的上下文配置。此外，别忘了创建或配置一个页面来捕捉所有CRUD操作，这通常涉及到Razor页面或MVC视图，以及引入EasyData的前端资源。

EasyData Adaptive CRUD for ASP.NET Core. With EasyData you can get both API endpoints and client-side UI for all CRUD operations in a matter of minutes using just your DbContext and a few lines of code. 项目地址: https://gitcode.com/gh_mirrors/ea/EasyData