梦想家装平台开发记录,Asp.Net Core上手实践

DreamingHome

Dreaming Home 梦想家,家装平台

EF Core概念

  • Model: 数据模型,一个普通的C#类
  • DbContext: 与数据库沟通的桥梁,一个数据库对应一个DbContext

注册EF Core服务

services.AddEntityFrameworkSqlite()
    .AddDbContext(options => options.UseSqlite(Configuration["database:connection"]));

数据库上下文 DbContext

public class MainContext : DbContext
{
    public MainContext() { }
    public MainContext(DbContextOptions options) : base(options) { }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        var builder = new ConfigurationBuilder().SetBasePath(Directory.GetCurrentDirectory()).AddJsonFile("appsettings.json");
        var configuration = builder.Build();
        optionsBuilder.UseSqlite(configuration["database:connection"]);
    }
}

这里我遇到一个很奇怪的问题,单纯在Startup.cs里面注册EFCore根本不行,运行的时候老是提示我No database provider,只能在DbContext里面再重写这个OnConfiguring,重新配置一遍数据库= =...

数据库迁移

创建数据库迁移:

dotnet ef migrations add InitialCreate -v

查看状态:

dotnet ef migrations list

应用迁移来更新数据库:

dotnet ef database update -v

引入Swagger支持

安装依赖

Install-Package Swashbuckle.AspNetCore

配置中间件

using Swashbuckle.AspNetCore.Swagger;

// 在Startup.ConfigureServices中配置服务
services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new OpenApiInfo {Title = "My Api", Version = "v1"}); });

// 在Startup.Configure中配置中间件
app.UseSwagger();
app.UseSwaggerUI(c => { c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1"); });

把应用的根路径设置为Swagger UI,如下:

app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
    c.RoutePrefix = string.Empty;
});

启动测试

启动应用,并导航到http://localhost:/swagger/v1/swagger.json,生成的描述终结点的文档显示如下json格式。

可在 http://localhost:/swagger 找到 Swagger UI。 通过 Swagger UI 浏览 API文档。

注意

  • 每一个Controller的方法都需要标注出具体的Http方法,不然会报错
  • Swagger会自动读取每个接口函数的C#文档,但是前提是要生成xml文档才可以

自定义以及扩展

修改之前配置的Swagger服务:

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1",
        info: new OpenApiInfo
        {
            Version = "v1",
            Title = "Dreaming Home 智能家装平台",
            Description = "智能家装平台 Api 文档",
            TermsOfService = new Uri("http://blog.deali.cn"),
            Contact = new OpenApiContact
            {
                Name = "DealiAxy",
                Email = "[email protected]",
                Url = new Uri("https://zhuanlan.zhihu.com/deali"),
            },
            License = new OpenApiLicense
            {
                Name = "GNU GENERAL PUBLIC LICENSE Version 2",
                Url = new Uri("https://www.gnu.org/licenses/old-licenses/gpl-2.0.html"),
            }
         });
});

显示接口的xml文档要先生成,然后在services.AddSwaggerGen里面设置才行。

// 为 Swagger JSON and UI设置xml文档注释路径
//获取应用程序所在目录(绝对,不受工作目录影响,建议采用此方法获取路径)
var basePath = Path.GetDirectoryName(typeof(Program).Assembly.Location);
var xmlPath = Path.Combine(basePath, "Doc", "DreamingHome.xml");
c.IncludeXmlComments(xmlPath);

小结

通过上面的操作可以总结出,Swagger UI 显示上述注释代码的

元素的内部文本作为api大的注释!

当然你还可以将 remarks 元素添加到 Get 操作方法文档。 它可以补充

元素中指定的信息,并提供更可靠的 Swagger UI。 元素内容可包含文本、JSON 或 XML。 代码如下:

 /// 
 /// 这是一个带参数的get请求
 /// 
 /// 
 /// 例子:
 /// Get api/Values/1
 /// 
 /// 主键
 /// 测试字符串          
 [HttpGet("{id}")]
 public ActionResult Get(int id)
 {
       return $"你请求的 id 是 {id}";
 }

描述响应类型

摘录自:https://www.cnblogs.com/yanbigfeg/p/9232844.html

接口使用者最关心的就是接口的返回内容和响应类型啦。下面展示一下201和400状态码的一个简单例子:

我们需要在我们的方法上添加:

[ProducesResponseType(201)]
[ProducesResponseType(400)]

然后添加相应的状态说明:返回value字符串如果id为空

最终代码应该是这个样子:

 /// 
 /// 这是一个带参数的get请求
 /// 
 /// 
 /// 例子:
 /// Get api/Values/1
 /// 
 /// 主键
 /// 测试字符串 
 /// 返回value字符串
/// 如果id为空  
 // GET api/values/2
[HttpGet("{id}")]
[ProducesResponseType(201)]
[ProducesResponseType(400)]
public ActionResult Get(int id)
{
     return $"你请求的 id 是 {id}";
}

运行效果

梦想家装平台开发记录,Asp.Net Core上手实践_第1张图片

欢迎交流

交流问题请在微信公众号后台留言,每一条信息我都会回复哈~

  • 微信公众号:画星星高手
  • 打代码直播间:https://live.bilibili.com/11883038
  • 知乎:https://www.zhihu.com/people/dealiaxy
  • :https://www.jianshu.com/u/965b95853b9f

你可能感兴趣的:(梦想家装平台开发记录,Asp.Net Core上手实践)