.Net Core Web Api_笔记01

.net core web api
可以和任何前端Client端技术或框架(javascript , jQuery , Vue , React , Angular)做结合
藉由URL请求来实现资料添加、更新、删除以及查询等操作
甚至跟其他程序语言(PHP , Node.Js)交换沟通因为都是透过HTTP在做交流

启用OPEN API可以暂时勾消

新创建出来的专案
可以观察到只会有Controllers文件夹
不像MVC会再多出Models , Views

启动预设范例执行结果

因为web api 不需要View视图(也无法回传view)
仅作资料回传

预设范本的WeatherForecastController.cs
code部分

using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Logging;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace MyApiTest1.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WeatherForecastController : ControllerBase
    {
        private static readonly string[] Summaries = new[]
        {
            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
        };

        private readonly ILogger<WeatherForecastController> _logger;

        public WeatherForecastController(ILogger<WeatherForecastController> logger)
        {
            _logger = logger;
        }

        [HttpGet]
        public IEnumerable<WeatherForecast> Get()
        {
            var rng = new Random();
            return Enumerable.Range(1, 5).Select(index => new WeatherForecast
            {
                Date = DateTime.Now.AddDays(index),
                TemperatureC = rng.Next(-20, 55),
                Summary = Summaries[rng.Next(Summaries.Length)]
            })
            .ToArray();
        }
    }
}

有使用[ApiController] attribute修饰
代表该Controller为api 控制器

而在Program.cs中的Main()跟.net core mvc一样程序进入点

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace MyApiTest1
{
    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.UseStartup<Startup>();
                });
    }
}

主要用於web api应用初始化时候要做的配置

在Startup.cs 启动class程序文件中

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace MyApiTest1
{
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        // This method gets called by the runtime. Use this method to add services to the container.
        public void ConfigureServices(IServiceCollection services)
        {

            services.AddControllers();
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseRouting();

            app.UseAuthorization();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
            });
        }
    }
}

基本上跟MVC没有太大差异同样也是在ConfigureServices方法中将服务注入
这里别於MVC仅注入Controllers服务而已

在.NET Core MVC中的ConfigureServices

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllersWithViews();
}

在.NET Core WebAPI中的ConfigureServices

public void ConfigureServices(IServiceCollection services)
{

    services.AddControllers();
}

本篇同步发表至个人blog
https://coolmandiary.blogspot.com/2021/07/net-core-web-api01.html