正文

从零开始：Asp.Net Core + MySQL + EF数据库设计实战指南

/0 浏览量
0322

引言

随着互联网技术的飞速发展，Web应用程序的开发变得越来越重要。在众多Web开发框架中，Asp.Net Core凭借其高性能、跨平台等特点，成为了开发者们喜爱的选择。MySQL作为一款开源的关系型数据库，以其稳定性和易用性广受欢迎。Entity Framework（EF）则是一个强大的ORM（对象关系映射）框架，能够帮助开发者更高效地处理数据库操作。本文将带你从零开始，使用Asp.Net Core、MySQL和EF进行数据库设计实战。

环境准备

在开始之前，请确保以下环境已经安装：

  1. 操作系统：Windows、macOS或Linux
  2. .NET Core SDK：从.NET Core官网下载并安装
  3. MySQL数据库：从MySQL官网下载并安装
  4. Visual Studio：推荐使用Visual Studio 2019或更高版本

创建项目

  1. 打开Visual Studio，选择“创建新项目”。
  2. 在“创建新项目”窗口中，选择“.NET Core Web应用”模板。
  3. 在“配置项目”窗口中，输入项目名称和存储位置，选择“ASP.NET Core Web API”作为项目类型。
  4. 点击“创建”按钮。

配置MySQL数据库

  1. 打开MySQL命令行工具，连接到数据库服务器。
  2. 创建一个新的数据库，例如aspnetcore_mysql_example。
CREATE DATABASE aspnetcore_mysql_example;
  1. 创建一个新的用户，并授权其访问数据库。
CREATE USER 'exampleuser'@'localhost' IDENTIFIED BY 'examplepassword';
GRANT ALL PRIVILEGES ON aspnetcore_mysql_example.* TO 'exampleuser'@'localhost';
FLUSH PRIVILEGES;

添加EF Core依赖

  1. 在Visual Studio中，打开项目文件（例如aspnetcore_mysql_example.csproj）。
  2. 在<ItemGroup>标签中添加以下内容：
<PackageReference Include="Microsoft.EntityFrameworkCore" Version="5.0.0" />
<PackageReference Include="Microsoft.EntityFrameworkCore.MySql" Version="5.0.0" />
  1. 保存并关闭文件。

设计数据库模型

  1. 在项目中创建一个新的文件夹，命名为Models。
  2. 在Models文件夹中创建一个新的类，命名为ExampleModel.cs。
using System;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata.Builders;

namespace aspnetcore_mysql_example.Models
{
    public class ExampleModel
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public DateTime CreatedAt { get; set; }
    }
}
  1. 在ExampleModel.cs文件中，添加以下内容：
public class ExampleModelConfiguration : IEntityTypeConfiguration<ExampleModel>
{
    public void Configure(EntityTypeBuilder<ExampleModel> builder)
    {
        builder.ToTable("Examples");
        builder.HasKey(e => e.Id);
        builder.Property(e => e.Name).IsRequired().HasMaxLength(100);
        builder.Property(e => e.CreatedAt).IsRequired();
    }
}

配置数据库连接

  1. 在项目中创建一个新的文件夹，命名为Data。
  2. 在Data文件夹中创建一个新的类，命名为ApplicationDbContext.cs。
using Microsoft.EntityFrameworkCore;

namespace aspnetcore_mysql_example.Data
{
    public class ApplicationDbContext : DbContext
    {
        public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
            : base(options)
        {
        }

        public DbSet<ExampleModel> Examples { get; set; }
    }
}
  1. 在aspnetcore_mysql_example.csproj文件中，添加以下内容：
<ItemGroup>
  <EntityFrameworkDesignerSettings Include="EntityFrameworkDesigner.cs">
    <Generator>EntityFrameworkCore</Generator>
    <LastGenOutput>EntityFrameworkCoreDesignTimeServices.cs</LastGenOutput>
  </EntityFrameworkDesignerSettings>
</ItemGroup>
  1. 在Program.cs文件中，配置数据库连接字符串：
var builder = WebApplication.CreateBuilder(args);

// 添加服务
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseMySql("server=localhost;port=3306;database=aspnetcore_mysql_example;user=root;password=root;"));

// ...

创建API控制器

  1. 在项目中创建一个新的文件夹，命名为Controllers。
  2. 在Controllers文件夹中创建一个新的类，命名为ExampleController.cs。
using Microsoft.AspNetCore.Mvc;
using aspnetcore_mysql_example.Data;
using aspnetcore_mysql_example.Models;
using System.Linq;

namespace aspnetcore_mysql_example.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class ExampleController : ControllerBase
    {
        private readonly ApplicationDbContext _context;

        public ExampleController(ApplicationDbContext context)
        {
            _context = context;
        }

        // 获取所有示例
        [HttpGet]
        public async Task<ActionResult<IEnumerable<ExampleModel>>> GetExamples()
        {
            return await _context.Examples.ToListAsync();
        }

        // 创建示例
        [HttpPost]
        public async Task<ActionResult<ExampleModel>> PostExample(ExampleModel example)
        {
            _context.Examples.Add(example);
            await _context.SaveChangesAsync();

            return CreatedAtAction(nameof(GetExample), new { id = example.Id }, example);
        }

        // 获取指定示例
        [HttpGet("{id}")]
        public async Task<ActionResult<ExampleModel>> GetExample(int id)
        {
            var example = await _context.Examples.FindAsync(id);

            if (example == null)
            {
                return NotFound();
            }

            return example;
        }

        // 更新示例
        [HttpPut("{id}")]
        public async Task<IActionResult> PutExample(int id, ExampleModel example)
        {
            if (id != example.Id)
            {
                return BadRequest();
            }

            _context.Entry(example).State = EntityState.Modified;

            try
            {
                await _context.SaveChangesAsync();
            }
            catch (DbUpdateConcurrencyException)
            {
                if (!_context.Examples.Any(e => e.Id == id))
                {
                    return NotFound();
                }
                else
                {
                    throw;
                }
            }

            return NoContent();
        }

        // 删除示例
        [HttpDelete("{id}")]
        public async Task<IActionResult> DeleteExample(int id)
        {
            var example = await _context.Examples.FindAsync(id);
            if (example == null)
            {
                return NotFound();
            }

            _context.Examples.Remove(example);
            await _context.SaveChangesAsync();

            return NoContent();
        }
    }
}

运行项目

  1. 在Visual Studio中，按F5键或点击“启动”按钮运行项目。
  2. 打开浏览器，访问http://localhost:5000/example，即可看到API控制器返回的示例数据。

总结

本文从零开始，介绍了如何使用Asp.Net Core、MySQL和EF进行数据库设计实战。通过本文的学习，你将能够：

  1. 创建Asp.Net Core Web API项目
  2. 配置MySQL数据库
  3. 设计数据库模型
  4. 使用EF Core进行数据库操作
  5. 创建API控制器

希望本文能够帮助你快速掌握Asp.Net Core + MySQL + EF数据库设计实战。

-- 展开阅读全文 --