时间：2023-05-23 16:57:02 | 来源：网站运营
时间：2023-05-23 16:57:02 来源：网站运营
梦想家装平台开发记录，Asp.Net Core上手实践：
在线咨询
Model: 数据模型，一个普通的C#类DbContext: 与数据库沟通的桥梁，一个数据库对应一个DbContextEF Core服务services.AddEntityFrameworkSqlite() .AddDbContext<MainContext>(options => options.UseSqlite(Configuration["database:connection"]));DbContextpublic class MainContext : DbContext{ public MainContext() { } public MainContext(DbContextOptions<MainContext> 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 -vInstall-Package Swashbuckle.AspNetCoreusing 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:<port>/swagger/v1/swagger.json，生成的描述终结点的文档显示如下json格式。http://localhost:<port>/swagger 找到 Swagger UI。 通过 Swagger UI 浏览 API文档。Controller的方法都需要标注出具体的Http方法，不然会报错Swagger会自动读取每个接口函数的C#文档，但是前提是要生成xml文档才可以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 = "dealiaxy@gmail.com", 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);<summary> 元素的内部文本作为api大的注释！Get 操作方法文档。 它可以补充 <summary> 元素中指定的信息，并提供更可靠的 Swagger UI。 <remarks> 元素内容可包含文本、JSON 或 XML。 代码如下：/// <summary> /// 这是一个带参数的get请求 /// </summary> /// <remarks> /// 例子: /// Get api/Values/1 /// </remarks> /// <param name="id">主键</param> /// <returns>测试字符串</returns> [HttpGet("{id}")] public ActionResult<string> Get(int id) { return $"你请求的 id 是 {id}"; }摘录自：https://www.cnblogs.com/yanbigfeg/p/9232844.html接口使用者最关心的就是接口的返回内容和响应类型啦。下面展示一下201和400状态码的一个简单例子：
[ProducesResponseType(201)][ProducesResponseType(400)]然后添加相应的状态说明：返回value字符串如果id为空/// <summary> /// 这是一个带参数的get请求 /// </summary> /// <remarks> /// 例子: /// Get api/Values/1 /// </remarks> /// <param name="id">主键</param> /// <returns>测试字符串</returns> /// <response code="201">返回value字符串</response>/// <response code="400">如果id为空</response> // GET api/values/2[HttpGet("{id}")][ProducesResponseType(201)][ProducesResponseType(400)]public ActionResult<string> Get(int id){ return $"你请求的 id 是 {id}";}关键词：实践,记录,平台,梦想
