Tích hợp Swagger vào API NancyFX: Hướng dẫn Nancy.Swagger
Bài viết này sẽ hướng dẫn bạn cách tích hợp và sử dụng thư viện mã nguồn mở Nancy.Swagger để cung cấp hỗ trợ Swagger cho các Web API xây dựng trên nền tảng NancyFX. Việc này giúp tự động hóa tài liệu hóa và kiểm thử API của bạn một cách hiệu quả. Chúng ta sẽ cùng tìm hiểu ba thành phần chính của Nancy.Swagger: cấu trúc thư mục dự án, logic khởi ...
Đăng vào ngày 28 tháng 7 lúc 03:59
Tích hợp Swagger vào RESTful API trong Spring Boot
Khi mới bắt đầu học Spring Boot, mình từng gặp khó khăn khi tiếp cận RESTful service và Swagger. Sau một thời gian tìm hiểu, mọi thứ trở nên đơn giản hơn rất nhiều. Trong quá trình làm một dự án quản lý linh kiện, mình đã áp dụng phong cách RESTful chuẩn hóa theo hướng dẫn từ video. Việc sử dụng giao diện thống nhất giúp giảm thiểu các rắc rối ...
Đăng vào ngày 11 tháng 7 lúc 12:55
Chuyển đổi danh sách lồng ghép thành chuỗi định dạng bằng StringBuilder trong Java
Trong các ứng dụng quản lý vật tư, việc biểu diễn dữ liệu từ cấu trúc phân cấp (danh sách con nằm trong đối tượng cha) dưới dạng chuỗi dễ đọc là một yêu cầu phổ biến. Bài viết này trình bày cách sử dụng StringBuilder để xây dựng trường materialNames từ danh sách formMaterialList, đảm bảo hiệu suất và tính rõ ràng.
Dữ liệu đầu vào mẫu
Dữ liệu ...
Đăng vào ngày 10 tháng 7 lúc 14:40
Quy ước Thiết kế API
Nguyên tắc Thiết kế API
Giữ mức độ chi tiết và số lượng endpoint hợp lý
Tên gọi đơn giản, dễ hiểu và nhất quán
Ưu tiên thiết kế trước khi triển khai mã
Thiết kế URL
Phương thức HTTP
GET: Đọc dữ liệu
POST: Tạo mới tài nguyên
PUT: Cập nhật toàn bộ
PATCH: Cập nhật một phần
DELETE: Xóa tài nguyên
Quy tắc Đặt tên
...
Đăng vào ngày 5 tháng 7 lúc 21:33
Cấu hình Swagger trong .NET Core 2.1
1. Tạo ứng dụng Web .NET Core mới với mẫu API
2. Cài đặt gói NuGet: Swashbuckle.AspNetCore
Install-Package Swashbuckle.AspNetCore -Version 4.0.1
Hoặc mở giao diện quản lý NuGet và tìm kiếm Swashbuckle.AspNetCore (phiên bản tôi sử dụng là 4.0.1)
3. Đăng ký dịch vụ phụ thuộc
Sửa phương thức ConfigureServices trong file Startup.cs
public voi ...
Đăng vào ngày 27 tháng 6 lúc 19:04
Giới thiệu về Swagger và SpringFox
Cài đặt Swagger với SpringFox
Để tích hợp Swagger vào dự án Maven, bạn cần thêm các dependency sau:
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.5.0</version>
</dependency>
<dependency>
<groupId>io.springfox</gr ...
Đăng vào ngày 23 tháng 6 lúc 17:45
Hướng dẫn sử dụng Spring Boot 2.7.5 để xây dựng API RESTful
Spring MVC và xử lý yêu cầu HTTP
Định nghĩa endpoint
Sử dụng @RestController để tự động trả về dữ liệu JSON, tương đương với @Controller + @ResponseBody.
Ánh xạ URL bằng @RequestMapping hoặc các biến thể cụ thể như @GetMapping, @PostMapping để ràng buộc phương thức HTTP.
Nhận tham số từ client
Không dùng annotation: Spring tự động bind tha ...
Đăng vào ngày 12 tháng 6 lúc 21:14
Cấu hình Swagger hỗ trợ phiên bản API trong ASP.NET Core
Để triển khai kiểm soát phiên bản API kết hợp với tài liệu Swagger trong ứng dụng ASP.NET Core, cần sử dụng các thư viện sau:
Microsoft.AspNetCore.Mvc.Versioning
Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer
Đăng ký dịch vụ phiên bản API
builder.Services.AddApiVersioning(options =>
{
options.AssumeDefaultVersionWhenUnspecified ...
Đăng vào ngày 24 tháng 5 lúc 00:15