Bài viết này mình sẽ giới thiệu đến mọi người một công cụ có tên là Swagger
Swagger là gì?
Swagger là một phần mềm mã nguồn mở được sử dụng để phát triển thiết kế và làm các document cho các restapi và còn có một số tính năng khác các bạn có thể vào link sau để xem https://swagger.io/docs/specification/2-0/what-is-swagger/
Có một số phần mềm swagger như Swagger Editor, Swagger Codegen, Swagger Inspector, Swagger UI. Trong đó swagger UI được sử dụng nhiều nhất
Vậy tại sao ta nên dùng Swagger? Swagger sẽ hỗ trợ các annoutation giúp cho ứng dụng spring của ta có thể mô tả đươc các restapi, và đồng thơi build một giao diện giúp người dùng có thể tương tác trực tiếp với các rest api đó.
Sau khi bạn truy cập vào trang web bạn có thể thấy được đang có những api nào trong ứng dụng này và cả những method tương ứng của nó
Và đối với mỗi api chúng ta có thể biết được
input và output của chúng cũng như những status có thể trả về của api này
Ở trên là ví dụ sơ qua của mình về swagger các bạn
có thể truy cập vào trang web trên để tự mình trải nghiệm. Ở bài viết sau mình
sẽ hướng dẫn các bạn cách tích hợp swagger này vào trong ứng dụng Spring Boot
