[英]ASP.NET Core, .NET6 Adding a Controller to Swagger
我發現很難將 API 集成到 Swagger - 只有默認值 controller(WeatherForecast):
using Business.Repository.IRepository;
using Microsoft.AspNetCore.Mvc;
namespace HiddenVilla_API.Controllers
{
[Route("api/[controller]")]
[ApiController]
public class HotelRoomController : Controller
{
private readonly IHotelRoomRepository _hotelRoomRepository;
public HotelRoomController(IHotelRoomRepository hotelRoomRepository)
{
_hotelRoomRepository = hotelRoomRepository;
}
/// <summary>
/// Gets All hotel rooms
/// </summary>
/// <returns></returns>
[HttpGet]
private async Task<IActionResult> GetHotelRooms()
{
var allRooms = await _hotelRoomRepository.GetAllHotelRoom();
return Ok(allRooms);
}
}
}
using Business.Repository;
using Business.Repository.IRepository;
using DataAcess.Data;
using Microsoft.AspNetCore.Identity;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.PlatformAbstractions;
using Microsoft.OpenApi.Models;
var builder = WebApplication.CreateBuilder(args);
// Add services to the container.
builder.Services.AddDbContext<ApplicationDbContext>(options =>
options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
builder.Services.AddIdentity<IdentityUser, IdentityRole>().AddEntityFrameworkStores<ApplicationDbContext>().AddDefaultTokenProviders();
builder.Services.AddAutoMapper(AppDomain.CurrentDomain.GetAssemblies());
builder.Services.AddScoped<IHotelRoomRepository, HotelRoomRepository>();
builder.Services.AddScoped<IHotelAmenityRepository, HotelAmenityRepository>();
builder.Services.AddScoped<IHotelImagesRepository, HotelImagesRepository>();
builder.Services.AddRouting(option => option.LowercaseUrls = true);
builder.Services.AddControllers();
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new OpenApiInfo { Title = "HiddenVilla_Api", Version = "v1" });
});
builder.Services.AddMvc();
//builder.Services.AddMvcCore().AddApiExplorer();
var app = builder.Build();
// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
app.UseSwagger(options => options.SerializeAsV2 = true);
app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "HiddenVilla_Api v1"));
}
app.UseHttpsRedirection();
app.UseRouting();
app.UseAuthorization();
app.MapControllers();
app.Run();
我想也許我錯過了什么。 這個想法是讓 controller 從 HotelRoolRepository 中獲取方法。 我已經安裝了 Swashbuckle.AspNetCore.Swagger、Swashbuckle.AspNetCore.SwaggerGen、Swashbuckle.AspNetCore.SwaggerUI
這可能是您的操作方法是private
的事實。 你應該把它public
。
改變這個
private async Task<IActionResult> GetHotelRooms();
至
public async Task<IActionResult> GetHotelRooms();
使方法公開而不是私有。 以這種方式添加屬性 [HttpGet("GetHotelRooms")]。
[HttpGet("GetHotelRooms")]
public async Task<IActionResult> GetHotelRooms()
{
var allRooms = await _hotelRoomRepository.GetAllHotelRoom();
return Ok(allRooms);
}
這是因為路由問題。
1- 定義 HttpGet 或 HttpPost,...
如果有一些動作具有相同的方法(GET、POST、...),則需要定義方法路由。
2-定義路由路徑
3- 將訪問修飾符定義為 public。
私有修飾符不會為 swagger 拋出任何異常,但私有操作不會顯示在 swagger api 列表中。
[HttpGet]
[Route("GetPersonInfo")]
public async Task<IActionResult> GetPersonInfo([FromBody] PersonInfoSearchItem searchItem)
{
return Ok(new
{
errorNumber = 2,
message = "data is fetched successfully",
Object= new Person()
});
}
[HttpGet]
[Route("SavePerson")]
private async Task<IActionResult> SavePerson([FromBody] PersonInfoSearchItem searchItem)
{
return Ok(new
{
errorNumber = 0,
message = "everything is Ok"
});
}
聲明:本站的技術帖子網頁,遵循CC BY-SA 4.0協議,如果您需要轉載,請注明本站網址或者原文地址。任何問題請咨詢:yoyou2525@163.com.