Visual Studio 2019创建基于Furion的WebAPI项目
1、打开 Visual Studio 2019 并创建 Web 项目,如下图所示:
2、配置项目名称,如下图所示:
3、选择 WebAPI 项目,由于Furion 已经内置了 Swagger 规范化库,所以创建时无需勾选 Enable OpenAPI support 选项,否则提示版本不一致产生冲突,如下图所示:
4、添加 Furion 依赖包,如下图所示:
5、Furion 基本配置,在Program.cs 添加 Inject(),如下图所示:
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;
namespace FurionStart
{
public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder
.Inject() // 添加这一行
.UseStartup<Startup>();
});
}
}
6、 在 Startup.cs 中添加两个 Inject(),如果 app.UseInject() 不输入参数,则默认地址为 /api,如果输入 string.Empty 则为 / 目录。如果输入任意字符串,则为 /任意字符串 目录,如下图所示:
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
namespace FurionStart
{
public class Startup
{
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
public IConfiguration Configuration { get; }
public void ConfigureServices(IServiceCollection services)
{
services.AddControllers().AddInject(); // 添加 AddInject();
}
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseHttpsRedirection();
app.UseRouting();
app.UseAuthorization();
// 添加这一行,如果是 MVC和API共存项目,无需添加 string.Empty
app.UseInject(string.Empty);
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
});
}
}
}
7、启动浏览器查看效果,如下图所示:
8、默认情况下,通过 Visual Studio 2019 创建的项目会自动配置了启动页,如果使用 F5 运行,可能不会自动打开首页,这时候我们只需要配置 launchSettings.json 的 launchUrl 即可,如下图所示: