APS.Net core webapi 写一个完整的webserver 接口示例

ASP.NET Core是一个现代化的Web框架，它允许快速、高效地构建跨平台的Web API。下面是一个简单的ASP.NET Core Web API服务器接口的创建步骤，并附带一个基本的示例：

首先，你需要安装`Microsoft.AspNetCore.Mvc` NuGet包，这个包包含了创建API所需的基础控制器和路由功能。

1. **创建一个新的ASP.NET Core Web API项目**:
使用Visual Studio或命令行工具 `dotnet new webapi` 创建一个新的Web API项目。

2. **打开`Startup.cs`文件**:
这里配置应用程序的基础设置，如依赖注入和中间件。添加对`Controllers`命名空间的支持:

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;

// ...

public void ConfigureServices(IServiceCollection services)
{
    // 添加控制器服务
    services.AddControllers();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 应用程序配置
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    
    app.UseRouting();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers(); // 映射所有控制器到HTTP请求
    });
}

3. **创建一个控制器**:
在`Controllers`目录下，创建一个名为`ValuesController.cs`的文件，内容如下：

using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;

namespace YourProjectName.Controllers
{
    [ApiController] // 标记为API控制器
    [Route("api/[controller]")]
    public class ValuesController : ControllerBase
    {
        [HttpGet] // GET请求，返回值序列化为JSON
        public async Task<ActionResult<string[]>> Get()
        {
            return new string[] { "value1", "value2" };
        }

        [HttpGet("{id}")]
        // 使用"{id}"作为路径参数，支持查询单个记录
        public async Task<ActionResult<string>> Get(int id)
        {
            if (id == 42) // 示例：如果id等于42，返回特定信息
            {
                return Ok("The Answer to Life, the Universe, and Everything");
            }
            else
            {
                return NotFound();
            }
        }
    }
}

在这个例子中，我们定义了两个GET请求：一个用于获取一组默认值，另一个用于按ID获取特定值。