Hướng dẫn dotnet api with mysql - dotnet api với mysql

Bỏ qua nội dung chính

Trình duyệt này không còn được hỗ trợ.

Nâng cấp lên Microsoft Edge để tận dụng các tính năng mới nhất, cập nhật bảo mật và hỗ trợ kỹ thuật.

Hướng dẫn: Tạo API web với ASP.NET Core

• Bài báo
• 11/08/2022
• 63 phút để đọc

Trong bài viết này

Bởi Rick Anderson và Kirk Larkin

Hướng dẫn này dạy những điều cơ bản của việc xây dựng API Web bằng cơ sở dữ liệu.

Tổng quan

Hướng dẫn này tạo ra API sau:

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

Mảng các mặt hàng cần làm

[HttpPost] public async Task> PostTodoItem(TodoItem todoItem) { _context.TodoItems.Add(todoItem); await _context.SaveChangesAsync(); // return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem); return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem); } 4

Nhận một mục theo ID

• Mục cần làm

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  5
• Thêm một mục mới

Xác nhận khung là .NET 7.0 (hoặc muộn hơn).

Xác nhận hộp kiểm cho bộ điều khiển sử dụng (bỏ chọn để sử dụng API tối thiểu) được kiểm tra.

• Mục cần làm

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  5
• Thêm một mục mới

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

6

Cập nhật một mục hiện tại & nbsp;

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

7 & nbsp; & nbsp;Yes if you trust the IIS Express SSL certificate.

Xóa một mục & nbsp; & nbsp;

Biểu đồ sau đây cho thấy thiết kế của ứng dụng.Yes if you agree to trust the development certificate.

Điều kiện tiên quyết

Tạo một dự án web

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

Từ menu Tệp, chọn New> Project.GET > Try it out > Execute. The page displays:

• Nhập API Web vào hộp tìm kiếm.
• Chọn mẫu API API ASP.NET Core và chọn Tiếp theo.
• Trong hộp thoại Cấu hình dự án mới của bạn, đặt tên cho dự án TODOAPI và chọn Tiếp theo.
• Trong hộp thoại Thông tin bổ sung:

Nếu trang Swagger không xuất hiện, hãy xem vấn đề GitHub này.

Swagger được sử dụng để tạo tài liệu hữu ích và các trang trợ giúp cho API Web. Hướng dẫn này tập trung vào việc tạo API Web. Để biết thêm thông tin về Swagger, hãy xem Tài liệu API API ASP.NET Core với Swagger / Openapi.

Sao chép và dán URL yêu cầu vào trình duyệt:

dotnet dev-certs https --trust

dotnet dev-certs https --trust

JSON Tương tự như ví dụ sau được trả về:

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Thêm một lớp mô hình

Một mô hình là một tập hợp các lớp đại diện cho dữ liệu mà ứng dụng quản lý. Mô hình cho ứng dụng này là lớp

dotnet dev-certs https --trust

• Visual Studio
• Visual Studio Code
• Visual Studio cho Mac

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

Thêm một thư mục có tên

dotnet dev-certs https --trust

Thêm tệp

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Nhấp vào Bấm vào dự án TODOAPI và chọn Thêm> Thư mục mới. Đặt tên cho thư mục dotnet dev-certs https --trust 06.

Bấm vào thư mục

dotnet dev-certs https --trust

• Visual Studio
• Visual Studio Code

• Đặt tên cho lớp TODOITEM, sau đó chọn Tạo.

  using Microsoft.EntityFrameworkCore;
  
  namespace TodoApi.Models;
  
  public class TodoContext : DbContext
  {
      public TodoContext(DbContextOptions options)
          : base(options)
      {
      }
  
      public DbSet TodoItems { get; set; } = null!;
  }
  

Thuộc tính dotnet dev-certs https --trust 13 có chức năng là khóa duy nhất trong cơ sở dữ liệu quan hệ.

Các lớp mô hình có thể đi bất cứ nơi nào trong dự án, nhưng thư mục ____106 được sử dụng bởi quy ước.

Thêm bối cảnh cơ sở dữ liệu

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Bối cảnh cơ sở dữ liệu là lớp chính phối hợp chức năng khung thực thể cho mô hình dữ liệu. Lớp này được tạo bằng cách xuất phát từ lớp microsoft.entityframeworkcore.dbcontext.

• Visual Studio Code / Visual Studio cho Mac
• Thêm gói Nuget
• Từ menu Công cụ, chọn Trình quản lý gói NUGET> Quản lý các gói Nuget cho giải pháp.

Chọn tab Duyệt, sau đó nhập [HttpPost] public async Task> PostTodoItem(TodoItem todoItem) { _context.TodoItems.Add(todoItem); await _context.SaveChangesAsync(); // return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem); return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem); } 9 vào hộp tìm kiếm.

• Visual Studio
• Visual Studio Code

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.SqlServer -v 7.0.0-*
dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

dotnet-aspnet-codegenerator controller -name TodoItemsController -async -api -m TodoItem -dc TodoContext -outDir Controllers

Chọn tab Duyệt, sau đó nhập

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

• Chọn

  [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  9 ở khung bên trái.
• Chọn hộp kiểm Dự án ở khung bên phải và sau đó chọn Cài đặt.

Thêm bối cảnh cơ sở dữ liệu Todocontext

• Nhấp chuột phải vào thư mục

  dotnet dev-certs https --trust
  

  06 và chọn Thêm> Lớp. Kể tên lớp Todocontext và nhấp vào Thêm.
• Thêm tệp

  dotnet dev-certs https --trust
  

  18 vào thư mục

  dotnet dev-certs https --trust
  

  06.

Nhập mã sau:

Đăng ký bối cảnh cơ sở dữ liệu

Trong ASP.NET Core, các dịch vụ như bối cảnh DB phải được đăng ký với thùng chứa tiêm phụ thuộc (DI). Container cung cấp dịch vụ cho bộ điều khiển.

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

Cập nhật

dotnet dev-certs https --trust

Để biết thêm thông tin, hãy xem định tuyến thuộc tính với các thuộc tính HTTP [động từ].

Phương thức tạo ra:

• Trả về mã trạng thái HTTP 201 nếu thành công.

  dotnet dev-certs https --trust
  

  34 là phản hồi tiêu chuẩn cho phương thức

  dotnet dev-certs https --trust
  

  31 tạo ra một tài nguyên mới trên máy chủ.
• Thêm một tiêu đề vị trí vào phản hồi. Tiêu đề

  dotnet dev-certs https --trust
  

  36 chỉ định URI của mục việc cần làm mới được tạo. Để biết thêm thông tin, xem 10.2.2 201 được tạo.
• Tài liệu tham khảo hành động

  dotnet dev-certs https --trust
  

  37 để tạo URI tiêu đề

  dotnet dev-certs https --trust
  

  36. Từ khóa C#

  dotnet dev-certs https --trust
  

  39 được sử dụng để tránh mã hóa cứng tên hành động trong cuộc gọi

  dotnet dev-certs https --trust
  

  40.

Kiểm tra posttodoitem

• Nhấn Ctrl+F5 để chạy ứng dụng.

• Trong cửa sổ Trình duyệt Swagger, chọn POST /API /TODOITEMS, sau đó chọn dùng thử.POST /api/TodoItems, and then select Try it out.

• Trong cửa sổ đầu vào yêu cầu, cập nhật JSON. Ví dụ,Request body input window, update the JSON. For example,

  {
    "name": "walk dog",
    "isComplete": true
  }
  

• Chọn Thực thiExecute

Kiểm tra URI tiêu đề vị trí

Trong bài trước, UI Swagger hiển thị tiêu đề vị trí trong các tiêu đề phản hồi. Ví dụ,

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Để kiểm tra tiêu đề vị trí:

• Trong cửa sổ Trình duyệt Swagger, chọn GET/API/TODOITEMS/{id}, sau đó chọn dùng thử.GET /api/TodoItems/{id}, and then select Try it out.

• Nhập

  dotnet dev-certs https --trust
  

  42 vào hộp nhập

  dotnet dev-certs https --trust
  

  43, sau đó chọn Execute.Execute.

Kiểm tra các phương pháp GET

Hai điểm cuối được thực hiện:

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  3

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  4

Phần trước cho thấy một ví dụ về tuyến đường

dotnet dev-certs https --trust

Thực hiện theo các hướng dẫn bài đăng để thêm một mục TODO khác, sau đó kiểm tra tuyến

dotnet dev-certs https --trust

Ứng dụng này sử dụng cơ sở dữ liệu trong bộ nhớ. Nếu ứng dụng được dừng và bắt đầu, yêu cầu GET trước sẽ không trả về bất kỳ dữ liệu nào. Nếu không có dữ liệu được trả về, hãy đăng dữ liệu lên ứng dụng.

Định tuyến và đường dẫn URL

Thuộc tính

dotnet dev-certs https --trust

dotnet dev-certs https --trust

• Bắt đầu với chuỗi mẫu trong thuộc tính

  dotnet dev-certs https --trust
  

  50 của bộ điều khiển:

  dotnet dev-certs https --trust
  

  0

• Thay thế

  dotnet dev-certs https --trust
  

  51 bằng tên của bộ điều khiển, theo quy ước là tên lớp bộ điều khiển trừ đi hậu tố "bộ điều khiển". Đối với mẫu này, tên lớp bộ điều khiển là TODOITEMSControll, vì vậy tên bộ điều khiển là "TODOITEMS". Định tuyến cốt lõi ASP.NET là trường hợp không nhạy cảm.TodoItemsController, so the controller name is "TodoItems". ASP.NET Core routing is case insensitive.

• Nếu thuộc tính

  dotnet dev-certs https --trust
  

  48 có mẫu tuyến đường (ví dụ:

  dotnet dev-certs https --trust
  

  53), hãy nối nó vào đường dẫn. Mẫu này không sử dụng một mẫu. Để biết thêm thông tin, hãy xem định tuyến thuộc tính với các thuộc tính HTTP [động từ].

Trong phương thức

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Trả về giá trị

Loại trả về của các phương thức

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

• Nếu không có mục nào khớp với ID được yêu cầu, phương thức sẽ trả về mã lỗi trạng thái 404.
• Mặt khác, phương pháp trả về 200 với cơ thể phản hồi JSON. Trả lại

  dotnet dev-certs https --trust
  

  63 dẫn đến phản hồi

  dotnet dev-certs https --trust
  

  64.

Phương pháp puttodoitem

Kiểm tra phương pháp

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Kiểm tra phương pháp puttodoitem

Mẫu này sử dụng cơ sở dữ liệu trong bộ nhớ phải được khởi tạo mỗi khi ứng dụng được bắt đầu. Phải có một mục trong cơ sở dữ liệu trước khi bạn thực hiện cuộc gọi. Gọi nhận để đảm bảo có một mục trong cơ sở dữ liệu trước khi thực hiện cuộc gọi.

Sử dụng giao diện người dùng Swagger, sử dụng nút đặt để cập nhật

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Phương thức Deletetodoitem

Kiểm tra phương pháp

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Kiểm tra phương thức DeletetOdoItem

Sử dụng UI Swagger để xóa

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Kiểm tra với http-repl, postman hoặc curl

HTTP-Repl, Postman và Curl thường được sử dụng để kiểm tra API. Swagger sử dụng

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Để biết hướng dẫn về các công cụ này, hãy xem các liên kết sau:

• Kiểm tra API với người đưa thư
• Cài đặt và kiểm tra API với

  dotnet dev-certs https --trust
  

  78

Để biết thêm thông tin về

dotnet dev-certs https --trust

Ngăn chặn quá mức

Hiện tại ứng dụng mẫu hiển thị toàn bộ đối tượng

dotnet dev-certs https --trust

Một DTO có thể được sử dụng để:

• Ngăn chặn quá mức.
• Ẩn các thuộc tính mà khách hàng không được phép xem.
• Bỏ qua một số thuộc tính để giảm kích thước tải trọng.
• Biểu đồ đối tượng phẳng có chứa các đối tượng lồng nhau. Biểu đồ đối tượng phẳng có thể thuận tiện hơn cho khách hàng.

Để chứng minh phương pháp DTO, hãy cập nhật lớp

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Trường bí mật cần được ẩn khỏi ứng dụng này, nhưng một ứng dụng hành chính có thể chọn để lộ nó.

Xác minh bạn có thể đăng và nhận trường bí mật.

Tạo mô hình DTO:

dotnet dev-certs https --trust

Cập nhật

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Xác minh bạn không thể đăng hoặc nhận trường bí mật.

Gọi API Web với JavaScript

Xem Hướng dẫn: Gọi API Web ASP.NET Core với JavaScript.

Loạt video API Web

Xem video: Sê -ri của người mới bắt đầu: API Web.

Trong hướng dẫn này, bạn học cách:

• Tạo một dự án API Web.
• Thêm một lớp mô hình và bối cảnh cơ sở dữ liệu.
• Giàn giáo Một bộ điều khiển với các phương pháp CRUD.
• Định cấu hình định tuyến, đường dẫn URL và trả về giá trị.
• Gọi API Web với HTTP-Repl.

Cuối cùng, bạn có một API web có thể quản lý các mục "Việc cần làm" được lưu trữ trong cơ sở dữ liệu.

Tổng quan

Hướng dẫn này tạo ra API sau:

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

Mảng các mặt hàng cần làm

[HttpPost] public async Task> PostTodoItem(TodoItem todoItem) { _context.TodoItems.Add(todoItem); await _context.SaveChangesAsync(); // return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem); return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem); } 4

Nhận một mục theo ID

• Mục cần làm

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  5
• Thêm một mục mới

dotnet dev-certs https --trust

Điều hướng đến Tùy chọn hệ thống> Bàn phím> Phím tắt> Dịch vụ.

Trong các tệp và thư mục, xác minh thiết bị đầu cuối mới tại thư mục được chọn.

• Mục cần làm

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  5
• Thêm một mục mới

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

6

Cập nhật một mục hiện tại & nbsp;

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

7 & nbsp; & nbsp;Yes if you trust the IIS Express SSL certificate.

Xóa một mục & nbsp; & nbsp;

Biểu đồ sau đây cho thấy thiết kế của ứng dụng.Yes if you agree to trust the development certificate.

Điều kiện tiên quyết

Tạo một dự án web

Trong cấu hình JSON:GET > Try it out > Execute. The page displays:

• Thay thế

  dotnet dev-certs https --trust
  

  93 bằng

  dotnet dev-certs https --trust
  

  94.
• Thay thế

  dotnet dev-certs https --trust
  

  95 bằng

  dotnet dev-certs https --trust
  

  96.
• Trong không thể tìm thấy hộp thoại 'xây dựng' tác vụ, chọn Định cấu hình tác vụ.
• Chọn Tạo tệp

  dotnet dev-certs https --trust
  

  97 từ mẫu.

Chọn mẫu .NET Core tác vụ.

Trong trình duyệt, điều hướng đến

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

Đối với Visual Studio cho Mac, xem phiên bản .NET 5 của hướng dẫn này.Request URL in the browser:

dotnet dev-certs https --trust

Trang Swagger

dotnet dev-certs https --trust

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Lệnh Curl để kiểm tra API WeatherForecast.

URL để kiểm tra API thời tiết.

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Mã phản hồi, cơ thể và tiêu đề.

Một hộp danh sách thả xuống với các loại phương tiện và giá trị ví dụ và lược đồ.

Nếu trang Swagger không xuất hiện, hãy xem vấn đề GitHub này.

• Swagger được sử dụng để tạo tài liệu hữu ích và các trang trợ giúp cho API Web. Hướng dẫn này tập trung vào việc tạo API Web. Để biết thêm thông tin về Swagger, hãy xem Tài liệu API API ASP.NET Core với Swagger / Openapi.
• Sao chép và dán URL yêu cầu vào trình duyệt:

  dotnet dev-certs https --trust
  

  04
• JSON Tương tự như ví dụ sau được trả về:

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Trong cấu hình JSON:

Thay thế

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Thay thế dotnet dev-certs https --trust 95 bằng dotnet dev-certs https --trust 96.

Trong không thể tìm thấy hộp thoại 'xây dựng' tác vụ, chọn Định cấu hình tác vụ.

• Swagger được sử dụng để tạo tài liệu hữu ích và các trang trợ giúp cho API Web. Hướng dẫn này tập trung vào việc tạo API Web. Để biết thêm thông tin về Swagger, hãy xem Tài liệu API API ASP.NET Core với Swagger / Openapi.
• Sao chép và dán URL yêu cầu vào trình duyệt:

  dotnet dev-certs https --trust
  

  04
• JSON Tương tự như ví dụ sau được trả về:

• Trong cấu hình JSON:

  [
      {
          "date": "2019-07-16T19:04:05.7257911-06:00",
          "temperatureC": 52,
          "temperatureF": 125,
          "summary": "Mild"
      },
      {
          "date": "2019-07-17T19:04:05.7258461-06:00",
          "temperatureC": 36,
          "temperatureF": 96,
          "summary": "Warm"
      },
      {
          "date": "2019-07-18T19:04:05.7258467-06:00",
          "temperatureC": 39,
          "temperatureF": 102,
          "summary": "Cool"
      },
      {
          "date": "2019-07-19T19:04:05.7258471-06:00",
          "temperatureC": 10,
          "temperatureF": 49,
          "summary": "Bracing"
      },
      {
          "date": "2019-07-20T19:04:05.7258474-06:00",
          "temperatureC": -1,
          "temperatureF": 31,
          "summary": "Chilly"
      }
  ]
  

  3

Thay thế dotnet dev-certs https --trust 93 bằng dotnet dev-certs https --trust 94.

Thay thế

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Trong không thể tìm thấy hộp thoại 'xây dựng' tác vụ, chọn Định cấu hình tác vụ.

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Chọn Tạo tệp

dotnet dev-certs https --trust

• Chọn mẫu .NET Core tác vụ.
• Trong trình duyệt, điều hướng đến

  {
    "name": "walk dog",
    "isComplete": true
  }
  

  7, trong đó

  {
    "name": "walk dog",
    "isComplete": true
  }
  

  2 là số cổng được chọn ngẫu nhiên được hiển thị trong đầu ra.
• Đối với Visual Studio cho Mac, xem phiên bản .NET 5 của hướng dẫn này.
• Trang Swagger

  dotnet dev-certs https --trust
  

  03 được hiển thị. Chọn Nhận> Thử nó ra> Thực thi. Trang hiển thị:

Lệnh Curl để kiểm tra API WeatherForecast.

• Swagger được sử dụng để tạo tài liệu hữu ích và các trang trợ giúp cho API Web. Hướng dẫn này tập trung vào việc tạo API Web. Để biết thêm thông tin về Swagger, hãy xem Tài liệu API API ASP.NET Core với Swagger / Openapi.
• Sao chép và dán URL yêu cầu vào trình duyệt:

  dotnet dev-certs https --trust
  

  04
• JSON Tương tự như ví dụ sau được trả về:

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Mã được tạo:

• Đánh dấu lớp với thuộc tính

  dotnet dev-certs https --trust
  

  25. Thuộc tính này chỉ ra rằng bộ điều khiển đáp ứng các yêu cầu API Web. Để biết thông tin về các hành vi cụ thể mà thuộc tính cho phép, hãy xem Tạo API Web với ASP.NET Core.
• Sử dụng DI để tiêm bối cảnh cơ sở dữ liệu (

  dotnet dev-certs https --trust
  

  26) vào bộ điều khiển. Bối cảnh cơ sở dữ liệu được sử dụng trong mỗi phương thức CRUD trong bộ điều khiển.

Các mẫu lõi ASP.NET cho:

• Bộ điều khiển có chế độ xem bao gồm

  dotnet dev-certs https --trust
  

  27 trong mẫu tuyến đường.
• Bộ điều khiển API không bao gồm

  dotnet dev-certs https --trust
  

  27 trong mẫu tuyến đường.

Khi mã thông báo

dotnet dev-certs https --trust

Cập nhật phương thức tạo posttodoitem

Cập nhật câu lệnh trả về trong

dotnet dev-certs https --trust

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Mã trước là một phương thức bài HTTP, như được biểu thị bằng thuộc tính

dotnet dev-certs https --trust

Để biết thêm thông tin, hãy xem định tuyến thuộc tính với các thuộc tính HTTP [động từ].

Phương thức tạo ra:

• Trả về mã trạng thái HTTP 201 nếu thành công. HTTP 201 là phản hồi tiêu chuẩn cho phương thức bài HTTP tạo ra tài nguyên mới trên máy chủ.
• Thêm một tiêu đề vị trí vào phản hồi. Tiêu đề

  dotnet dev-certs https --trust
  

  36 chỉ định URI của mục việc cần làm mới được tạo. Để biết thêm thông tin, xem 10.2.2 201 được tạo.
• Tài liệu tham khảo hành động

  dotnet dev-certs https --trust
  

  37 để tạo URI tiêu đề

  dotnet dev-certs https --trust
  

  36. Từ khóa C#

  dotnet dev-certs https --trust
  

  39 được sử dụng để tránh mã hóa cứng tên hành động trong cuộc gọi

  dotnet dev-certs https --trust
  

  40.

Cài đặt http-repl

Hướng dẫn này sử dụng http-repl để kiểm tra API web.

• Chạy lệnh sau tại dấu nhắc lệnh:

  [
      {
          "date": "2019-07-16T19:04:05.7257911-06:00",
          "temperatureC": 52,
          "temperatureF": 125,
          "summary": "Mild"
      },
      {
          "date": "2019-07-17T19:04:05.7258461-06:00",
          "temperatureC": 36,
          "temperatureF": 96,
          "summary": "Warm"
      },
      {
          "date": "2019-07-18T19:04:05.7258467-06:00",
          "temperatureC": 39,
          "temperatureF": 102,
          "summary": "Cool"
      },
      {
          "date": "2019-07-19T19:04:05.7258471-06:00",
          "temperatureC": 10,
          "temperatureF": 49,
          "summary": "Bracing"
      },
      {
          "date": "2019-07-20T19:04:05.7258474-06:00",
          "temperatureC": -1,
          "temperatureF": 31,
          "summary": "Chilly"
      }
  ]
  

  7

• Nếu bạn không cài đặt .NET 6.0 SDK hoặc thời gian chạy, hãy cài đặt thời gian chạy .NET 6.0.

Kiểm tra posttodoitem

• Nhấn Ctrl+F5 để chạy ứng dụng.

• Mở một cửa sổ thiết bị đầu cuối mới và chạy các lệnh sau. Nếu ứng dụng của bạn sử dụng một số cổng khác, hãy thay thế 5001 trong lệnh httprepl bằng số cổng của bạn.

  [
      {
          "date": "2019-07-16T19:04:05.7257911-06:00",
          "temperatureC": 52,
          "temperatureF": 125,
          "summary": "Mild"
      },
      {
          "date": "2019-07-17T19:04:05.7258461-06:00",
          "temperatureC": 36,
          "temperatureF": 96,
          "summary": "Warm"
      },
      {
          "date": "2019-07-18T19:04:05.7258467-06:00",
          "temperatureC": 39,
          "temperatureF": 102,
          "summary": "Cool"
      },
      {
          "date": "2019-07-19T19:04:05.7258471-06:00",
          "temperatureC": 10,
          "temperatureF": 49,
          "summary": "Bracing"
      },
      {
          "date": "2019-07-20T19:04:05.7258474-06:00",
          "temperatureC": -1,
          "temperatureF": 31,
          "summary": "Chilly"
      }
  ]
  

  8

  Dưới đây là một ví dụ về đầu ra từ lệnh:

  [
      {
          "date": "2019-07-16T19:04:05.7257911-06:00",
          "temperatureC": 52,
          "temperatureF": 125,
          "summary": "Mild"
      },
      {
          "date": "2019-07-17T19:04:05.7258461-06:00",
          "temperatureC": 36,
          "temperatureF": 96,
          "summary": "Warm"
      },
      {
          "date": "2019-07-18T19:04:05.7258467-06:00",
          "temperatureC": 39,
          "temperatureF": 102,
          "summary": "Cool"
      },
      {
          "date": "2019-07-19T19:04:05.7258471-06:00",
          "temperatureC": 10,
          "temperatureF": 49,
          "summary": "Bracing"
      },
      {
          "date": "2019-07-20T19:04:05.7258474-06:00",
          "temperatureC": -1,
          "temperatureF": 31,
          "summary": "Chilly"
      }
  ]
  

  9

Kiểm tra URI tiêu đề vị trí

Để kiểm tra tiêu đề vị trí, sao chép và dán nó vào lệnh httprepl

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Ví dụ sau đây giả định rằng bạn vẫn còn trong phiên HTTPrepl. Nếu bạn kết thúc phiên httprepl trước đó, hãy thay thế

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

Dưới đây là một ví dụ về đầu ra từ lệnh:

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

Kiểm tra URI tiêu đề vị trí

Để kiểm tra tiêu đề vị trí, sao chép và dán nó vào lệnh httprepl

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  3

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  4

Ví dụ sau đây giả định rằng bạn vẫn còn trong phiên HTTPrepl. Nếu bạn kết thúc phiên httprepl trước đó, hãy thay thế

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

Dưới đây là một ví dụ về đầu ra từ lệnh:

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

Kiểm tra URI tiêu đề vị trí

Để kiểm tra tiêu đề vị trí, sao chép và dán nó vào lệnh httprepl

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Ví dụ sau đây giả định rằng bạn vẫn còn trong phiên HTTPrepl. Nếu bạn kết thúc phiên httprepl trước đó, hãy thay thế [ { "date": "2019-07-16T19:04:05.7257911-06:00", "temperatureC": 52, "temperatureF": 125, "summary": "Mild" }, { "date": "2019-07-17T19:04:05.7258461-06:00", "temperatureC": 36, "temperatureF": 96, "summary": "Warm" }, { "date": "2019-07-18T19:04:05.7258467-06:00", "temperatureC": 39, "temperatureF": 102, "summary": "Cool" }, { "date": "2019-07-19T19:04:05.7258471-06:00", "temperatureC": 10, "temperatureF": 49, "summary": "Bracing" }, { "date": "2019-07-20T19:04:05.7258474-06:00", "temperatureC": -1, "temperatureF": 31, "summary": "Chilly" } ] 36 bằng [ { "date": "2019-07-16T19:04:05.7257911-06:00", "temperatureC": 52, "temperatureF": 125, "summary": "Mild" }, { "date": "2019-07-17T19:04:05.7258461-06:00", "temperatureC": 36, "temperatureF": 96, "summary": "Warm" }, { "date": "2019-07-18T19:04:05.7258467-06:00", "temperatureC": 39, "temperatureF": 102, "summary": "Cool" }, { "date": "2019-07-19T19:04:05.7258471-06:00", "temperatureC": 10, "temperatureF": 49, "summary": "Bracing" }, { "date": "2019-07-20T19:04:05.7258474-06:00", "temperatureC": -1, "temperatureF": 31, "summary": "Chilly" } ] 37 trong các lệnh sau:

Kiểm tra các phương pháp GET

• Hai điểm cuối được thực hiện:

  dotnet dev-certs https --trust
  

  0

• Bạn chỉ thấy một ví dụ về tuyến đường

  dotnet dev-certs https --trust
  

  46. Kiểm tra tuyến đường

  dotnet dev-certs https --trust
  

  47:TodoItemsController, so the controller name is "TodoItems". ASP.NET Core routing is case insensitive.

• Lần này, JSON trở lại là một mảng của một mục.

Ứng dụng này sử dụng cơ sở dữ liệu trong bộ nhớ. Nếu ứng dụng được dừng và bắt đầu, yêu cầu GET trước sẽ không trả về bất kỳ dữ liệu nào. Nếu không có dữ liệu được trả về, hãy đăng dữ liệu lên ứng dụng.

dotnet dev-certs https --trust

Định tuyến và đường dẫn URL

Thuộc tính

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

• Nếu không có mục nào khớp với ID được yêu cầu, phương thức sẽ trả về mã lỗi trạng thái 404.
• Mặt khác, phương pháp trả về 200 với cơ thể phản hồi JSON. Trở lại

  dotnet dev-certs https --trust
  

  63 dẫn đến phản hồi HTTP 200.

Phương pháp puttodoitem

Kiểm tra phương pháp

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Nếu bạn gặp lỗi khi gọi

dotnet dev-certs https --trust

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Kiểm tra phương pháp puttodoitem

Mẫu này sử dụng cơ sở dữ liệu trong bộ nhớ phải được khởi tạo mỗi khi ứng dụng được bắt đầu. Phải có một mục trong cơ sở dữ liệu trước khi bạn thực hiện cuộc gọi. Gọi nhận để đảm bảo có một mục trong cơ sở dữ liệu trước khi thực hiện cuộc gọi.

Cập nhật mục việc cần làm có ID = 1 và đặt tên của nó thành

dotnet dev-certs https --trust

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

Dưới đây là một ví dụ về đầu ra từ lệnh:

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

Phương thức Deletetodoitem

Kiểm tra phương pháp

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Kiểm tra phương thức DeletetOdoItem

Xóa mục việc cần làm có ID = 1:

using Microsoft.EntityFrameworkCore;

namespace TodoApi.Models;

public class TodoContext : DbContext
{
    public TodoContext(DbContextOptions options)
        : base(options)
    {
    }

    public DbSet TodoItems { get; set; } = null!;
}

Dưới đây là một ví dụ về đầu ra từ lệnh:

using Microsoft.EntityFrameworkCore;

namespace TodoApi.Models;

public class TodoContext : DbContext
{
    public TodoContext(DbContextOptions options)
        : base(options)
    {
    }

    public DbSet TodoItems { get; set; } = null!;
}

Phương thức Deletetodoitem

Kiểm tra phương pháp

dotnet dev-certs https --trust

Kiểm tra phương thức DeletetOdoItem

• Xóa mục việc cần làm có ID = 1:
• Ngăn chặn quá mức
• Hiện tại ứng dụng mẫu hiển thị toàn bộ đối tượng

  dotnet dev-certs https --trust
  

  05. Các ứng dụng sản xuất thường giới hạn dữ liệu đầu vào và được trả về bằng cách sử dụng một tập hợp con của mô hình. Có nhiều lý do đằng sau điều này, và bảo mật là một lý do chính. Tập hợp con của mô hình thường được gọi là đối tượng truyền dữ liệu (DTO), mô hình đầu vào hoặc mô hình xem. DTO được sử dụng trong hướng dẫn này.
• Một DTO có thể được sử dụng để:

Ngăn chặn quá mức.

dotnet dev-certs https --trust

Ẩn các thuộc tính mà khách hàng không được phép xem.

Bỏ qua một số thuộc tính để giảm kích thước tải trọng.

Biểu đồ đối tượng phẳng có chứa các đối tượng lồng nhau. Biểu đồ đối tượng phẳng có thể thuận tiện hơn cho khách hàng.

using Microsoft.EntityFrameworkCore;

namespace TodoApi.Models;

public class TodoContext : DbContext
{
    public TodoContext(DbContextOptions options)
        : base(options)
    {
    }

    public DbSet TodoItems { get; set; } = null!;
}

Để chứng minh phương pháp DTO, hãy cập nhật lớp

dotnet dev-certs https --trust

using Microsoft.EntityFrameworkCore;

namespace TodoApi.Models;

public class TodoContext : DbContext
{
    public TodoContext(DbContextOptions options)
        : base(options)
    {
    }

    public DbSet TodoItems { get; set; } = null!;
}

Trường bí mật cần được ẩn khỏi ứng dụng này, nhưng một ứng dụng hành chính có thể chọn để lộ nó.

Xác minh bạn có thể đăng và nhận trường bí mật.

Tạo mô hình DTO:

Cập nhật dotnet dev-certs https --trust 24 để sử dụng dotnet dev-certs https --trust 83:

Xác minh bạn không thể đăng hoặc nhận trường bí mật.

Gọi API Web với JavaScript

• Xem Hướng dẫn: Gọi API Web ASP.NET Core với JavaScript.
• Loạt video API Web
• Xem video: Sê -ri của người mới bắt đầu: API Web.
• Trong hướng dẫn này, bạn học cách:
• Tạo một dự án API Web.

Thêm một lớp mô hình và bối cảnh cơ sở dữ liệu.

Giàn giáo Một bộ điều khiển với các phương pháp CRUD.

Định cấu hình định tuyến, đường dẫn URL và trả về giá trị.

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

Cơ thể phản ứng

[HttpPost] public async Task> PostTodoItem(TodoItem todoItem) { _context.TodoItems.Add(todoItem); await _context.SaveChangesAsync(); // return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem); return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem); } 3

Nhận tất cả các mặt hàng cần làm

• Không có
• Mảng các mặt hàng cần làm

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  4

• Nhận một mục theo IDFile menu, select New > Project.
• Mục cần làmASP.NET Core Web API template and click Next.

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  5Create.
• Thêm một mục mớiCreate a new ASP.NET Core Web Application dialog, confirm that .NET Core and ASP.NET Core 5.0 are selected. Select the API template and click Create.

dotnet dev-certs https --trust

Kiểm tra dự án

Mẫu dự án tạo API

{
  "name": "walk dog",
  "isComplete": true
}

• Visual Studio
• Visual Studio Code
• Visual Studio cho Mac

Nhấn Ctrl+F5 để chạy mà không cần trình gỡ lỗi.

Visual Studio hiển thị hộp thoại sau khi một dự án chưa được cấu hình để sử dụng SSL:

Chọn Có nếu bạn tin tưởng chứng chỉ SSL IIS Express.Yes if you trust the IIS Express SSL certificate.

Hộp thoại sau được hiển thị:

Chọn Có nếu bạn đồng ý tin tưởng chứng chỉ phát triển.Yes if you agree to trust the development certificate.

Để biết thông tin về việc tin tưởng trình duyệt Firefox, hãy xem Firefox Sec_error_inadequation_key_usage Lỗi chứng chỉ.

Visual Studio ra mắt:

• Máy chủ web IIS Express.
• Trình duyệt mặc định và điều hướng đến

  {
    "name": "walk dog",
    "isComplete": true
  }
  

  1, trong đó

  {
    "name": "walk dog",
    "isComplete": true
  }
  

  2 là số cổng được chọn ngẫu nhiên.

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

Trình duyệt mặc định và điều hướng đến

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

• Tin tưởng chứng chỉ phát triển HTTPS bằng cách chạy lệnh sau:
• Lệnh trước không hoạt động trên Linux. Xem tài liệu của phân phối Linux của bạn để tin vào chứng chỉ.
• Lệnh trước hiển thị hộp thoại sau, miễn là chứng chỉ không được tin cậy trước đó:
• Xem Trust The ASP.NET Core HTTPS Chứng chỉ Phát triển để biết thêm thông tin.

Nhấn Ctrl+F5 để chạy ứng dụng. Trong trình duyệt, hãy đi theo URL theo dõi:

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Chọn Run> Bắt đầu gỡ lỗi để khởi chạy ứng dụng. Visual Studio cho Mac ra mắt trình duyệt và điều hướng đến

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

Trang Swagger

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Lệnh Curl để kiểm tra API WeatherForecast.

Mã phản hồi, cơ thể và tiêu đề.

Một hộp danh sách thả xuống với các loại phương tiện và giá trị ví dụ và lược đồ.

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Nếu trang Swagger không xuất hiện, hãy xem vấn đề GitHub này.

Swagger được sử dụng để tạo tài liệu hữu ích và các trang trợ giúp cho API Web. Hướng dẫn này tập trung vào việc tạo API Web. Để biết thêm thông tin về Swagger, hãy xem Tài liệu API API ASP.NET Core với Swagger / Openapi.

Sao chép và dán URL yêu cầu vào trình duyệt:

dotnet dev-certs https --trust

• Visual Studio
• Visual Studio Code
• Visual Studio cho Mac

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Hộp thoại sau được hiển thị:

Chọn Có nếu bạn đồng ý tin tưởng chứng chỉ phát triển.

Để biết thông tin về việc tin tưởng trình duyệt Firefox, hãy xem Firefox Sec_error_inadequation_key_usage Lỗi chứng chỉ.

Visual Studio ra mắt:

• Visual Studio
• Visual Studio Code

Visual Studio cho Mac

• Nhấn Ctrl+F5 để chạy mà không cần trình gỡ lỗi.Tools menu, select NuGet Package Manager > Manage NuGet Packages for Solution.
• Visual Studio hiển thị hộp thoại sau khi một dự án chưa được cấu hình để sử dụng SSL:Browse tab, and then enter

  [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  9 in the search box.
• Chọn

  [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  9 ở khung bên trái.
• Chọn hộp kiểm Dự án ở khung bên phải và sau đó chọn Cài đặt.Project checkbox in the right pane and then select Install.

Thêm bối cảnh cơ sở dữ liệu Todocontext

• Nhấp chuột phải vào thư mục

  dotnet dev-certs https --trust
  

  06 và chọn Thêm> Lớp. Kể tên lớp Todocontext và nhấp vào Thêm.Add > Class. Name the class TodoContext and click Add.

• Nhập mã sau:

  using Microsoft.EntityFrameworkCore;
  using TodoApi.Models;
  
  var builder = WebApplication.CreateBuilder(args);
  
  builder.Services.AddControllers();
  builder.Services.AddDbContext(opt =>
      opt.UseInMemoryDatabase("TodoList"));
  builder.Services.AddEndpointsApiExplorer();
  builder.Services.AddSwaggerGen();
  
  var app = builder.Build();
  
  if (app.Environment.IsDevelopment())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  
  app.UseHttpsRedirection();
  
  app.UseAuthorization();
  
  app.MapControllers();
  
  app.Run();
  

  1

Đăng ký bối cảnh cơ sở dữ liệu

Trong ASP.NET Core, các dịch vụ như bối cảnh DB phải được đăng ký với thùng chứa tiêm phụ thuộc (DI). Container cung cấp dịch vụ cho bộ điều khiển.

Cập nhật

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Mã trước:

• Xóa các cuộc gọi vênh.
• Loại bỏ các khai báo

  dotnet dev-certs https --trust
  

  21 chưa được sử dụng.
• Thêm bối cảnh cơ sở dữ liệu vào thùng chứa DI.
• Chỉ định rằng bối cảnh cơ sở dữ liệu sẽ sử dụng cơ sở dữ liệu trong bộ nhớ.

Giàn giáo một bộ điều khiển

• Visual Studio
• Visual Studio Code / Visual Studio cho Mac

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Mã được tạo:

• Đánh dấu lớp với thuộc tính

  dotnet dev-certs https --trust
  

  25. Thuộc tính này chỉ ra rằng bộ điều khiển đáp ứng các yêu cầu API Web. Để biết thông tin về các hành vi cụ thể mà thuộc tính cho phép, hãy xem Tạo API Web với ASP.NET Core.
• Sử dụng DI để tiêm bối cảnh cơ sở dữ liệu (

  dotnet dev-certs https --trust
  

  26) vào bộ điều khiển. Bối cảnh cơ sở dữ liệu được sử dụng trong mỗi phương thức CRUD trong bộ điều khiển.

Các mẫu lõi ASP.NET cho:

• Bộ điều khiển có chế độ xem bao gồm

  dotnet dev-certs https --trust
  

  27 trong mẫu tuyến đường.
• Bộ điều khiển API không bao gồm

  dotnet dev-certs https --trust
  

  27 trong mẫu tuyến đường.

Khi mã thông báo

dotnet dev-certs https --trust

Cập nhật phương thức tạo posttodoitem

Cập nhật câu lệnh trả về trong

dotnet dev-certs https --trust

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Mã trước là một phương thức bài HTTP, như được biểu thị bằng thuộc tính

dotnet dev-certs https --trust

Để biết thêm thông tin, hãy xem định tuyến thuộc tính với các thuộc tính HTTP [động từ].

Phương thức tạo ra:

• Trả về mã trạng thái HTTP 201 nếu thành công. HTTP 201 là phản hồi tiêu chuẩn cho phương thức bài HTTP tạo ra tài nguyên mới trên máy chủ.
• Thêm một tiêu đề vị trí vào phản hồi. Tiêu đề

  dotnet dev-certs https --trust
  

  36 chỉ định URI của mục việc cần làm mới được tạo. Để biết thêm thông tin, xem 10.2.2 201 được tạo.
• Tài liệu tham khảo hành động

  dotnet dev-certs https --trust
  

  37 để tạo URI tiêu đề

  dotnet dev-certs https --trust
  

  36. Từ khóa C#

  dotnet dev-certs https --trust
  

  39 được sử dụng để tránh mã hóa cứng tên hành động trong cuộc gọi

  dotnet dev-certs https --trust
  

  40.

Cài đặt người đưa thư

Hướng dẫn này sử dụng Postman để kiểm tra API Web.

• Cài đặt người đưa thư
• Hướng dẫn này sử dụng Postman để kiểm tra API Web.
• Bắt đầu ứng dụng web.
• Bắt đầu người đưa thư.SSL certificate verification:
  • Tắt xác minh chứng chỉ SSL:File > Settings (General tab), disable SSL certificate verification.
  • Postman cho Windows: Chọn Tệp> Cài đặt (tab Chung), Tắt xác minh chứng chỉ SSL SSL.Postman > Settings (General tab), disable SSL certificate verification.

    Postman for MacOS: Chọn Postman> Cài đặt (Tab chung), Tắt xác minh chứng chỉ SSL SSL.

    Cảnh báo

Xác minh chứng chỉ SSL kích hoạt lại sau khi kiểm tra bộ điều khiển.

• Kiểm tra posttodoitem với người đưa thư

• Tạo một yêu cầu mới.

• Đặt phương thức HTTP thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  19.

• Đặt URI thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  20. Ví dụ,

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  21.Body tab.

• Chọn tab Body.raw radio button.

• Chọn nút radio thô.JSON (application/json).

• Đặt loại thành JSON (Ứng dụng/JSON).

  using Microsoft.EntityFrameworkCore;
  using TodoApi.Models;
  
  var builder = WebApplication.CreateBuilder(args);
  
  builder.Services.AddControllers();
  builder.Services.AddDbContext(opt =>
      opt.UseInMemoryDatabase("TodoList"));
  builder.Services.AddEndpointsApiExplorer();
  builder.Services.AddSwaggerGen();
  
  var app = builder.Build();
  
  if (app.Environment.IsDevelopment())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  
  app.UseHttpsRedirection();
  
  app.UseAuthorization();
  
  app.MapControllers();
  
  app.Run();
  

  5

• Trong phần thân yêu cầu nhập JSON cho một mục việc cần làm:Send.

Chọn Gửi.

Kiểm tra URI tiêu đề vị trí

URI tiêu đề vị trí có thể được kiểm tra trong trình duyệt. Sao chép và dán URI tiêu đề vị trí vào trình duyệt.

• Để kiểm tra trong Postman:Headers tab in the Response pane.

• Chọn tab Tiêu đề trong ngăn Phản hồi.Location header value:

• Sao chép giá trị tiêu đề vị trí:

• Đặt phương thức HTTP thành

  [
      {
          "date": "2019-07-16T19:04:05.7257911-06:00",
          "temperatureC": 52,
          "temperatureF": 125,
          "summary": "Mild"
      },
      {
          "date": "2019-07-17T19:04:05.7258461-06:00",
          "temperatureC": 36,
          "temperatureF": 96,
          "summary": "Warm"
      },
      {
          "date": "2019-07-18T19:04:05.7258467-06:00",
          "temperatureC": 39,
          "temperatureF": 102,
          "summary": "Cool"
      },
      {
          "date": "2019-07-19T19:04:05.7258471-06:00",
          "temperatureC": 10,
          "temperatureF": 49,
          "summary": "Bracing"
      },
      {
          "date": "2019-07-20T19:04:05.7258474-06:00",
          "temperatureC": -1,
          "temperatureF": 31,
          "summary": "Chilly"
      }
  ]
  

  61.

• Trong phần thân yêu cầu nhập JSON cho một mục việc cần làm:Send.

Chọn Gửi.

Kiểm tra URI tiêu đề vị trí

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  3

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  4

URI tiêu đề vị trí có thể được kiểm tra trong trình duyệt. Sao chép và dán URI tiêu đề vị trí vào trình duyệt.

• namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  21

• namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  24

Để kiểm tra trong Postman:

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Chọn tab Tiêu đề trong ngăn Phản hồi.

• Kiểm tra posttodoitem với người đưa thư
• Tạo một yêu cầu mới.GET.
• Đặt phương thức HTTP thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  19.
• Đặt URI thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  20. Ví dụ,

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  21.Two pane view in Postman.
• Trong phần thân yêu cầu nhập JSON cho một mục việc cần làm:Send.

Chọn Gửi.

Định tuyến và đường dẫn URL

Thuộc tính

dotnet dev-certs https --trust

• Bắt đầu với chuỗi mẫu trong thuộc tính

  dotnet dev-certs https --trust
  

  50 của bộ điều khiển:

  using Microsoft.EntityFrameworkCore;
  using TodoApi.Models;
  
  var builder = WebApplication.CreateBuilder(args);
  
  builder.Services.AddControllers();
  builder.Services.AddDbContext(opt =>
      opt.UseInMemoryDatabase("TodoList"));
  builder.Services.AddEndpointsApiExplorer();
  builder.Services.AddSwaggerGen();
  
  var app = builder.Build();
  
  if (app.Environment.IsDevelopment())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  
  app.UseHttpsRedirection();
  
  app.UseAuthorization();
  
  app.MapControllers();
  
  app.Run();
  

  7

• Thay thế

  dotnet dev-certs https --trust
  

  51 bằng tên của bộ điều khiển, theo quy ước là tên lớp bộ điều khiển trừ đi hậu tố "bộ điều khiển". Đối với mẫu này, tên lớp bộ điều khiển là TODOITEMSControll, vì vậy tên bộ điều khiển là "TODOITEMS". Định tuyến cốt lõi ASP.NET là trường hợp không nhạy cảm.TodoItemsController, so the controller name is "TodoItems". ASP.NET Core routing is case insensitive.

• Nếu thuộc tính

  dotnet dev-certs https --trust
  

  48 có mẫu tuyến đường (ví dụ:

  dotnet dev-certs https --trust
  

  53), hãy nối nó vào đường dẫn. Mẫu này không sử dụng một mẫu. Để biết thêm thông tin, hãy xem định tuyến thuộc tính với các thuộc tính HTTP [động từ].

Trong phương thức

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Trả về giá trị

Loại trả về của các phương thức

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

• Nếu không có mục nào khớp với ID được yêu cầu, phương thức sẽ trả về mã lỗi trạng thái 404.
• Mặt khác, phương pháp trả về 200 với cơ thể phản hồi JSON. Trở lại

  dotnet dev-certs https --trust
  

  63 dẫn đến phản hồi HTTP 200.

Phương pháp puttodoitem

Kiểm tra phương pháp

dotnet dev-certs https --trust

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Nếu bạn gặp lỗi khi gọi

dotnet dev-certs https --trust

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Kiểm tra phương pháp puttodoitem

Mẫu này sử dụng cơ sở dữ liệu trong bộ nhớ phải được khởi tạo mỗi khi ứng dụng được bắt đầu. Phải có một mục trong cơ sở dữ liệu trước khi bạn thực hiện cuộc gọi. Gọi nhận để đảm bảo có một mục trong cơ sở dữ liệu trước khi thực hiện cuộc gọi.

Cập nhật mục việc cần làm có ID = 1 và đặt tên của nó thành

dotnet dev-certs https --trust

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.SqlServer -v 7.0.0-*
dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

Hình ảnh sau đây cho thấy bản cập nhật Postman:

Phương thức Deletetodoitem

Kiểm tra phương pháp

dotnet dev-certs https --trust

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.SqlServer -v 7.0.0-*
dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

Kiểm tra phương thức DeletetOdoItem

Sử dụng Postman để xóa một mục việc cần làm:

• Đặt phương thức thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  54.
• Đặt URI của đối tượng để xóa (ví dụ

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  24).
• Chọn Gửi.Send.

Ngăn chặn quá mức

Hiện tại ứng dụng mẫu hiển thị toàn bộ đối tượng

dotnet dev-certs https --trust

Một DTO có thể được sử dụng để:

• Ngăn chặn quá mức.
• Ẩn các thuộc tính mà khách hàng không được phép xem.
• Bỏ qua một số thuộc tính để giảm kích thước tải trọng.
• Biểu đồ đối tượng phẳng có chứa các đối tượng lồng nhau. Biểu đồ đối tượng phẳng có thể thuận tiện hơn cho khách hàng.

Để chứng minh phương pháp DTO, hãy cập nhật lớp

dotnet dev-certs https --trust

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.SqlServer -v 7.0.0-*
dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

Trường bí mật cần được ẩn khỏi ứng dụng này, nhưng một ứng dụng hành chính có thể chọn để lộ nó.

Xác minh bạn có thể đăng và nhận trường bí mật.

Tạo mô hình DTO:

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.SqlServer -v 7.0.0-*
dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

Cập nhật

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.SqlServer -v 7.0.0-*
dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

Xác minh bạn không thể đăng hoặc nhận trường bí mật.

Gọi API Web với JavaScript

Xem Hướng dẫn: Gọi API Web ASP.NET Core với JavaScript.

Trong hướng dẫn này, bạn học cách:

• Tạo một dự án API Web.
• Thêm một lớp mô hình và bối cảnh cơ sở dữ liệu.
• Giàn giáo Một bộ điều khiển với các phương pháp CRUD.
• Định cấu hình định tuyến, đường dẫn URL và trả về giá trị.
• Gọi API Web với Postman.

Cuối cùng, bạn có một API web có thể quản lý các mục "Việc cần làm" được lưu trữ trong cơ sở dữ liệu.

Tổng quan

Hướng dẫn này tạo ra API sau:

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

Mảng các mặt hàng cần làm

Điều kiện tiên quyết

Tạo một dự án web

• Visual Studio
• Visual Studio Code
• Visual Studio cho Mac

• Từ menu Tệp, chọn New> Project.File menu, select New > Project.
• Chọn mẫu ứng dụng web ASP.NET Core và nhấp vào Tiếp theo.ASP.NET Core Web Application template and click Next.
• Đặt tên cho dự án TODOAPI và nhấp vào Tạo.Create.
• Trong hộp thoại Tạo ứng dụng web ASP.NET Core mới, xác nhận rằng .NET Core và ASP.NET Core 3.1 được chọn. Chọn mẫu API và nhấp vào Tạo.Create a new ASP.NET Core Web Application dialog, confirm that .NET Core and ASP.NET Core 3.1 are selected. Select the API template and click Create.

dotnet dev-certs https --trust

Kiểm tra API

Mẫu dự án tạo API

{
  "name": "walk dog",
  "isComplete": true
}

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

• Visual Studio
• Visual Studio Code
• Visual Studio cho Mac

{
  "name": "walk dog",
  "isComplete": true
}

{
  "name": "walk dog",
  "isComplete": true
}

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

dotnet dev-certs https --trust

Mở thiết bị đầu cuối tích hợp.

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Thay đổi thư mục ([HttpPost] public async Task> PostTodoItem(TodoItem todoItem) { _context.TodoItems.Add(todoItem); await _context.SaveChangesAsync(); // return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem); return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem); } 8) vào thư mục sẽ chứa thư mục dự án.

Chạy các lệnh sau:

• Khi một hộp thoại hỏi bạn có muốn thêm tài sản cần thiết vào dự án không, chọn Có.
• Visual Studio Code
• Visual Studio cho Mac

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.SqlServer -v 7.0.0-*
dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

Chọn Tệp> Giải pháp mới.

Trong Visual Studio cho Mac sớm hơn phiên bản 8.6, chọn .NET Core> Ứng dụng> API> Tiếp theo. Trong phiên bản 8.6 trở lên, chọn Web và Bảng điều khiển> Ứng dụng> API> Tiếp theo.

Trong cấu hình hộp thoại API API ASP.NET Core mới, chọn khung đích .NET Core 3.x mới nhất. Chọn Tiếp theo.

Nhập TODOAPI cho tên dự án và sau đó chọn Tạo.

• Visual Studio
• Truy cập một thiết bị đầu cuối lệnh trên Mac

Lần đầu tiên truy cập vào một thiết bị đầu tiên trên Mac yêu cầu cấu hình cài đặt sau:

• Điều hướng đến Tùy chọn hệ thống> Bàn phím> Phím tắt> Dịch vụ.Tools menu, select NuGet Package Manager > Manage NuGet Packages for Solution.
• Trong các tệp và thư mục, xác minh thiết bị đầu cuối mới tại thư mục được chọn.Browse tab, and then enter Microsoft.EntityFrameworkCore.InMemory in the search box.
• Các hướng dẫn trước cho phép truy cập vào một thiết bị đầu cuối lệnh theo hai cách: từ bên trong Visual Studio hoặc từ Finder.Microsoft.EntityFrameworkCore.InMemory in the left pane.
• Để truy cập một thiết bị đầu cuối lệnh từ Visual Studio cho Mac:Project checkbox in the right pane and then select Install.

Nhấp chuột phải vào tên dự án.

• Điều hướng đến Công cụ> Mở trong thiết bị đầu cuối.Add > Class. Name the class TodoContext and click Add.

• Nhấp chuột phải vào thư mục mong muốn.

  using Microsoft.EntityFrameworkCore;
  using TodoApi.Models;
  
  var builder = WebApplication.CreateBuilder(args);
  
  builder.Services.AddControllers();
  builder.Services.AddDbContext(opt =>
      opt.UseInMemoryDatabase("TodoList"));
  builder.Services.AddEndpointsApiExplorer();
  builder.Services.AddSwaggerGen();
  
  var app = builder.Build();
  
  if (app.Environment.IsDevelopment())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  
  app.UseHttpsRedirection();
  
  app.UseAuthorization();
  
  app.MapControllers();
  
  app.Run();
  

  1

Đăng ký bối cảnh cơ sở dữ liệu

Trong ASP.NET Core, các dịch vụ như bối cảnh DB phải được đăng ký với thùng chứa tiêm phụ thuộc (DI). Container cung cấp dịch vụ cho bộ điều khiển.

Cập nhật

namespace TodoApi.Models;

public class TodoItem
{
    public long Id { get; set; }
    public string? Name { get; set; }
    public bool IsComplete { get; set; }
}

dotnet-aspnet-codegenerator controller -name TodoItemsController -async -api -m TodoItem -dc TodoContext -outDir Controllers

Mã trước:

• Loại bỏ các khai báo

  dotnet dev-certs https --trust
  

  21 chưa được sử dụng.
• Thêm bối cảnh cơ sở dữ liệu vào thùng chứa DI.
• Chỉ định rằng bối cảnh cơ sở dữ liệu sẽ sử dụng cơ sở dữ liệu trong bộ nhớ.

Giàn giáo một bộ điều khiển

• Visual Studio
• Visual Studio Code / Visual Studio cho Mac

dotnet-aspnet-codegenerator controller -name TodoItemsController -async -api -m TodoItem -dc TodoContext -outDir Controllers

Mã được tạo:

• Đánh dấu lớp với thuộc tính

  dotnet dev-certs https --trust
  

  25. Thuộc tính này chỉ ra rằng bộ điều khiển đáp ứng các yêu cầu API Web. Để biết thông tin về các hành vi cụ thể mà thuộc tính cho phép, hãy xem Tạo API Web với ASP.NET Core.
• Sử dụng DI để tiêm bối cảnh cơ sở dữ liệu (

  dotnet dev-certs https --trust
  

  26) vào bộ điều khiển. Bối cảnh cơ sở dữ liệu được sử dụng trong mỗi phương thức CRUD trong bộ điều khiển.

Các mẫu lõi ASP.NET cho:

• Bộ điều khiển có chế độ xem bao gồm

  dotnet dev-certs https --trust
  

  27 trong mẫu tuyến đường.
• Bộ điều khiển API không bao gồm

  dotnet dev-certs https --trust
  

  27 trong mẫu tuyến đường.

Khi mã thông báo

dotnet dev-certs https --trust

Kiểm tra phương thức tạo posttodoitem

Thay thế câu lệnh trả về trong

dotnet dev-certs https --trust

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Mã trước là một phương thức bài HTTP, như được biểu thị bằng thuộc tính

dotnet dev-certs https --trust

Để biết thêm thông tin, hãy xem định tuyến thuộc tính với các thuộc tính HTTP [động từ].

Phương thức tạo ra:

• Trả về mã trạng thái HTTP 201 nếu thành công. HTTP 201 là phản hồi tiêu chuẩn cho phương thức bài HTTP tạo ra tài nguyên mới trên máy chủ.
• Thêm một tiêu đề vị trí vào phản hồi. Tiêu đề

  dotnet dev-certs https --trust
  

  36 chỉ định URI của mục việc cần làm mới được tạo. Để biết thêm thông tin, xem 10.2.2 201 được tạo.
• Tài liệu tham khảo hành động

  dotnet dev-certs https --trust
  

  37 để tạo URI tiêu đề

  dotnet dev-certs https --trust
  

  36. Từ khóa C#

  dotnet dev-certs https --trust
  

  39 được sử dụng để tránh mã hóa cứng tên hành động trong cuộc gọi

  dotnet dev-certs https --trust
  

  40.

Cài đặt người đưa thư

Hướng dẫn này sử dụng Postman để kiểm tra API Web.

• Cài đặt người đưa thư
• Hướng dẫn này sử dụng Postman để kiểm tra API Web.
• Bắt đầu ứng dụng web.
• Bắt đầu người đưa thư.SSL certificate verification:
  • Tắt xác minh chứng chỉ SSL:File > Settings (General tab), disable SSL certificate verification.
  • Postman cho Windows: Postman cho Tệp Windows> Cài đặt (Tab chung), Tắt xác minh chứng chỉ SSL.Postman > Settings (General tab), disable SSL certificate verification.

    Postman cho MacOS: Postman cho Windows Postman> Cài đặt (Tab chung), Tắt xác minh chứng chỉ SSL.

    Cảnh báo

Xác minh chứng chỉ SSL kích hoạt lại sau khi kiểm tra bộ điều khiển.

• Kiểm tra posttodoitem với người đưa thư

• Tạo một yêu cầu mới.

• Đặt phương thức HTTP thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  19.

• Đặt URI thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  20. Ví dụ,

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  21.Body tab.

• Chọn tab Body.raw radio button.

• Chọn nút radio thô.JSON (application/json).

• Đặt loại thành JSON (Ứng dụng/JSON).

  using Microsoft.EntityFrameworkCore;
  using TodoApi.Models;
  
  var builder = WebApplication.CreateBuilder(args);
  
  builder.Services.AddControllers();
  builder.Services.AddDbContext(opt =>
      opt.UseInMemoryDatabase("TodoList"));
  builder.Services.AddEndpointsApiExplorer();
  builder.Services.AddSwaggerGen();
  
  var app = builder.Build();
  
  if (app.Environment.IsDevelopment())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  
  app.UseHttpsRedirection();
  
  app.UseAuthorization();
  
  app.MapControllers();
  
  app.Run();
  

  5

• Trong phần thân yêu cầu nhập JSON cho một mục việc cần làm:Send.

Chọn Gửi.

• Kiểm tra URI tiêu đề vị trí với người đưa thưHeaders tab in the Response pane.

• Chọn tab Tiêu đề trong ngăn Phản hồi.Location header value:

• Sao chép giá trị tiêu đề vị trí:

• Đặt phương thức HTTP thành

  [
      {
          "date": "2019-07-16T19:04:05.7257911-06:00",
          "temperatureC": 52,
          "temperatureF": 125,
          "summary": "Mild"
      },
      {
          "date": "2019-07-17T19:04:05.7258461-06:00",
          "temperatureC": 36,
          "temperatureF": 96,
          "summary": "Warm"
      },
      {
          "date": "2019-07-18T19:04:05.7258467-06:00",
          "temperatureC": 39,
          "temperatureF": 102,
          "summary": "Cool"
      },
      {
          "date": "2019-07-19T19:04:05.7258471-06:00",
          "temperatureC": 10,
          "temperatureF": 49,
          "summary": "Bracing"
      },
      {
          "date": "2019-07-20T19:04:05.7258474-06:00",
          "temperatureC": -1,
          "temperatureF": 31,
          "summary": "Chilly"
      }
  ]
  

  61.

• Trong phần thân yêu cầu nhập JSON cho một mục việc cần làm:Send.

Chọn Gửi.

Kiểm tra URI tiêu đề vị trí với người đưa thư

• [HttpPost]
  public async Task> PostTodoItem(TodoItem todoItem)
  {
      _context.TodoItems.Add(todoItem);
      await _context.SaveChangesAsync();
  
      //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
      return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
  }
  

  3
• Chọn tab Tiêu đề trong ngăn Phản hồi.

Sao chép giá trị tiêu đề vị trí:

• namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  21

• namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  24

Đặt phương thức HTTP thành

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Đặt URI thành namespace TodoApi.Models; public class TodoItem { public long Id { get; set; } public string? Name { get; set; } public bool IsComplete { get; set; } } 23. Ví dụ, namespace TodoApi.Models; public class TodoItem { public long Id { get; set; } public string? Name { get; set; } public bool IsComplete { get; set; } } 24.

• Kiểm tra posttodoitem với người đưa thư
• Tạo một yêu cầu mới.GET.
• Đặt phương thức HTTP thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  19.
• Đặt URI thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  20. Ví dụ,

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  21.Two pane view in Postman.
• Trong phần thân yêu cầu nhập JSON cho một mục việc cần làm:Send.

Chọn Gửi.

Kiểm tra URI tiêu đề vị trí với người đưa thư

Chọn tab Tiêu đề trong ngăn Phản hồi.

• Sao chép giá trị tiêu đề vị trí:

  using Microsoft.EntityFrameworkCore;
  using TodoApi.Models;
  
  var builder = WebApplication.CreateBuilder(args);
  
  builder.Services.AddControllers();
  builder.Services.AddDbContext(opt =>
      opt.UseInMemoryDatabase("TodoList"));
  builder.Services.AddEndpointsApiExplorer();
  builder.Services.AddSwaggerGen();
  
  var app = builder.Build();
  
  if (app.Environment.IsDevelopment())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  
  app.UseHttpsRedirection();
  
  app.UseAuthorization();
  
  app.MapControllers();
  
  app.Run();
  

  7

• Đặt phương thức HTTP thành

  [
      {
          "date": "2019-07-16T19:04:05.7257911-06:00",
          "temperatureC": 52,
          "temperatureF": 125,
          "summary": "Mild"
      },
      {
          "date": "2019-07-17T19:04:05.7258461-06:00",
          "temperatureC": 36,
          "temperatureF": 96,
          "summary": "Warm"
      },
      {
          "date": "2019-07-18T19:04:05.7258467-06:00",
          "temperatureC": 39,
          "temperatureF": 102,
          "summary": "Cool"
      },
      {
          "date": "2019-07-19T19:04:05.7258471-06:00",
          "temperatureC": 10,
          "temperatureF": 49,
          "summary": "Bracing"
      },
      {
          "date": "2019-07-20T19:04:05.7258474-06:00",
          "temperatureC": -1,
          "temperatureF": 31,
          "summary": "Chilly"
      }
  ]
  

  61.TodoItemsController, so the controller name is "TodoItems". ASP.NET Core routing is case insensitive.

• Nếu thuộc tính

  dotnet dev-certs https --trust
  

  48 có mẫu tuyến đường (ví dụ:

  dotnet dev-certs https --trust
  

  53), hãy nối nó vào đường dẫn. Mẫu này không sử dụng một mẫu. Để biết thêm thông tin, hãy xem định tuyến thuộc tính với các thuộc tính HTTP [động từ].

Trong phương thức

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

Trả về giá trị

Loại trả về của các phương thức

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

dotnet dev-certs https --trust

• Nếu không có mục nào khớp với ID được yêu cầu, phương thức sẽ trả về mã lỗi 404.
• Mặt khác, phương pháp trả về 200 với cơ thể phản hồi JSON. Trở lại

  dotnet dev-certs https --trust
  

  63 dẫn đến phản hồi HTTP 200.

Phương pháp puttodoitem

Kiểm tra phương pháp

dotnet dev-certs https --trust

using Microsoft.EntityFrameworkCore;
using TodoApi.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
builder.Services.AddDbContext(opt =>
    opt.UseInMemoryDatabase("TodoList"));
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

dotnet dev-certs https --trust

dotnet dev-certs https --trust

Nếu bạn gặp lỗi khi gọi

dotnet dev-certs https --trust

[
    {
        "date": "2019-07-16T19:04:05.7257911-06:00",
        "temperatureC": 52,
        "temperatureF": 125,
        "summary": "Mild"
    },
    {
        "date": "2019-07-17T19:04:05.7258461-06:00",
        "temperatureC": 36,
        "temperatureF": 96,
        "summary": "Warm"
    },
    {
        "date": "2019-07-18T19:04:05.7258467-06:00",
        "temperatureC": 39,
        "temperatureF": 102,
        "summary": "Cool"
    },
    {
        "date": "2019-07-19T19:04:05.7258471-06:00",
        "temperatureC": 10,
        "temperatureF": 49,
        "summary": "Bracing"
    },
    {
        "date": "2019-07-20T19:04:05.7258474-06:00",
        "temperatureC": -1,
        "temperatureF": 31,
        "summary": "Chilly"
    }
]

Kiểm tra phương pháp puttodoitem

Mẫu này sử dụng cơ sở dữ liệu trong bộ nhớ phải được khởi tạo mỗi khi ứng dụng được bắt đầu. Phải có một mục trong cơ sở dữ liệu trước khi bạn thực hiện cuộc gọi. Gọi nhận để đảm bảo có một mục trong cơ sở dữ liệu trước khi thực hiện cuộc gọi.

Cập nhật mục việc cần làm có ID = 1 và đặt tên thành "Feed Fish":

dotnet-aspnet-codegenerator controller -name TodoItemsController -async -api -m TodoItem -dc TodoContext -outDir Controllers

Hình ảnh sau đây cho thấy bản cập nhật Postman:

Phương thức Deletetodoitem

Kiểm tra phương pháp

dotnet dev-certs https --trust

dotnet-aspnet-codegenerator controller -name TodoItemsController -async -api -m TodoItem -dc TodoContext -outDir Controllers

Kiểm tra phương thức DeletetOdoItem

Sử dụng Postman để xóa một mục việc cần làm:

• Đặt phương thức thành

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  54.
• Đặt URI của đối tượng để xóa (ví dụ

  namespace TodoApi.Models;
  
  public class TodoItem
  {
      public long Id { get; set; }
      public string? Name { get; set; }
      public bool IsComplete { get; set; }
  }
  

  24).
• Chọn Gửi.Send.

Ngăn chặn quá mức

Hiện tại ứng dụng mẫu hiển thị toàn bộ đối tượng

dotnet dev-certs https --trust

Một DTO có thể được sử dụng để:

• Ngăn chặn quá mức.
• Ẩn các thuộc tính mà khách hàng không được phép xem.
• Bỏ qua một số thuộc tính để giảm kích thước tải trọng.
• Biểu đồ đối tượng phẳng có chứa các đối tượng lồng nhau. Biểu đồ đối tượng phẳng có thể thuận tiện hơn cho khách hàng.

Để chứng minh phương pháp DTO, hãy cập nhật lớp

dotnet dev-certs https --trust

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

Trường bí mật cần được ẩn khỏi ứng dụng này, nhưng một ứng dụng hành chính có thể chọn để lộ nó.

Xác minh bạn có thể đăng và nhận trường bí mật.

Tạo mô hình DTO:

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.Design -v 7.0.0-*
dotnet add package Microsoft.EntityFrameworkCore.SqlServer -v 7.0.0-*
dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

Cập nhật

dotnet dev-certs https --trust

dotnet dev-certs https --trust

[HttpPost]
public async Task> PostTodoItem(TodoItem todoItem)
{
    _context.TodoItems.Add(todoItem);
    await _context.SaveChangesAsync();

    //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
    return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
}

Xác minh bạn không thể đăng hoặc nhận trường bí mật.

Gọi API Web với JavaScript

Xem Hướng dẫn: Gọi API Web ASP.NET Core với JavaScript.

Thêm hỗ trợ xác thực vào API Web

Nhận dạng Core ASP.NET thêm chức năng đăng nhập giao diện người dùng (UI) vào các ứng dụng web ASP.NET Core. Để bảo mật API và SPA Web, hãy sử dụng một trong những điều sau đây:

• Azure Active Directory
• Azure Active Directory B2C (Azure AD B2C)
• Máy chủ nhận dạng Duende

Duende Identity Server là một Framework OpenID Connect và OAuth 2.0 cho ASP.NET Core. Máy chủ nhận dạng Duende cho phép các tính năng bảo mật sau:

• Xác thực như một dịch vụ (AAAS)
• Đăng nhập/Tắt (SSO) một lần trên nhiều loại ứng dụng
• Kiểm soát truy cập cho API
• Cổng liên đoàn

Để biết thêm thông tin, hãy xem Tài liệu Máy chủ Nhận dạng Duende (Trang web phần mềm Duende).

Xuất bản lên Azure

Để biết thông tin về triển khai Azure, hãy xem QuickStart: Triển khai ứng dụng web ASP.NET.

Tài nguyên bổ sung

Xem hoặc tải về mã mẫu cho hướng dẫn này. Xem cách tải xuống.

Để biết thêm thông tin, hãy xem các tài nguyên sau:

• Tạo API Web với ASP.NET Core
• Hướng dẫn: Tạo API Web tối thiểu với ASP.NET Core
• Tài liệu API Web ASP.NET Core với Swagger / Openapi
• Các trang dao cạo với cốt lõi khung thực thể trong ASP.NET Core - Hướng dẫn 1 trên 8
• Định tuyến đến các hành động của bộ điều khiển trong ASP.NET Core
• Bộ điều khiển Các loại trả về hành động trong API API ASP.NET Core
• Triển khai các ứng dụng ASP.NET Core cho Dịch vụ ứng dụng Azure
• Máy chủ và triển khai ASP.NET Core
• Tạo API Web với ASP.NET Core