Có rất nhiều tài liệu về cách viết dịch vụ, trong đó đầu tiên bạn cần chọn một số khung để sử dụng, sau đó là hệ thống xử lý, cấu hình, nhật ký, lưu trữ, v.v., chưa kể đến việc triển khai dịch vụ đó ở đâu đó. Chúng tôi đã viết các dịch vụ được một thời gian và thường xuyên hơn là bạn chỉ muốn bỏ qua tất cả quá trình tẻ nhạt này để dán các thứ lại với nhau và chỉ cần viết một số mã hữu ích. Đó là lý do tại sao chúng tôi tạo ra một công cụ, có tên là Mify — đó là một trình tạo bản soạn sẵn cơ sở hạ tầng nguồn mở, sẽ giúp bạn xây dựng một dịch vụ, áp dụng các phương pháp hay nhất được sử dụng cho đến nay. Vì vậy, trong hướng dẫn này, chúng tôi sẽ trình bày cách tạo một dịch vụ đơn giản bằng Mify với một ví dụ cổ điển — một ứng dụng việc cần làm. điều kiện tiên quyết Cài đặt 1.18+, Go Docker Nhận Mify từ GitHub của chúng tôi: https://github.com/mify-io/mify Cài đặt hoặc curl để kiểm tra các điểm cuối Postman Trước khi bắt đầu hướng dẫn này, đây là liên kết đến ví dụ hoàn chỉnh: https://github.com/mify-io/todo-app-example Tạo dự án Sau khi cài đặt Mify, để bắt đầu dự án, bạn cần tạo không gian làm việc: $ mify init todo-app $ cd todo-app Sau khi vào không gian làm việc mới, hãy chạy: $ mify add service todo-backend Bây giờ, thao tác này sẽ tạo mẫu Go cho chương trình phụ trợ việc cần làm của bạn. Đây là một cây không gian làm việc được đơn giản hóa với tất cả các tệp được tạo: . ├── go-services │ ├── cmd │ │ ├── dev-runner │ │ │ └── main.go │ │ └── todo-backend │ │ ├── Dockerfile │ │ └── main.go │ ├── go.mod │ ├── go.sum │ └── internal │ ├── pkg │ │ └── generated │ │ ├── configs │ │ │ └── ... │ │ ├── consul │ │ │ └── ... │ │ ├── logs │ │ │ └── ... │ │ └── metrics │ │ └── ... │ └── todo-backend │ ├── app │ │ ├── request_extra.go │ │ ├── router │ │ │ └── router.go │ │ └── service_extra.go │ └── generated │ ├── api | | └── ... │ ├── app │ │ └── ... │ ├── apputil │ │ └── ... │ └── core │ └── ... ├── schemas │ └── todo-backend │ ├── api │ │ └── api.yaml │ └── service.mify.yaml └── workspace.mify.yaml Mify tuân theo một cách lỏng lẻo một trong các bố cục phổ biến của Go, phù hợp với nhiều dịch vụ trong một kho lưu trữ. Trong có các thư viện chung dành cho cấu hình, nhật ký và số liệu có thể được sử dụng lại cho nhiều dịch vụ. Thư mục truy cập dịch vụ của bạn nằm trong . internal/pkg/generated internal/todo-backend Tại thời điểm này, dịch vụ này khá trống, vì vậy chúng tôi cần thêm API vào nó. Định nghĩa API Bạn có thể tìm lược đồ OpenAPI cho todo-backend trong tệp . Thư mục lược đồ trong thư mục gốc của không gian làm việc là nơi lưu trữ tất cả các cấu hình dịch vụ liên quan đến Mify. schemas/todo-backend/api/api.yaml Hãy tạo một API CRUD đơn giản cho phần phụ trợ việc cần làm của bạn: để thêm ghi chú việc cần làm mới. POST /todos để cập nhật, truy xuất và xóa chúng. PUT,GET,DELETE /todos/{id} Đây là cách lược đồ OpenAPI của bạn sẽ tìm kiếm API này: https://gist.github.com/chebykinn/5dc7b30a2a57a1ab4584895131295e1f Thay thế lược đồ trước đó bằng lược đồ này và chạy . Bạn có thể chạy nó mỗi khi bạn cập nhật lược đồ và nó sẽ tạo lại tất cả những thứ đã thay đổi. mify generate Xây dựng và thử nghiệm $ cd go-services $ go mod tidy $ go run ./cmd/todo-backend Bạn sẽ thấy nhật ký khởi động như thế: Bạn có thể thấy cổng dịch vụ khi , sao chép nó vào Postman và thử gọi một số trình xử lý API: starting api server Bạn có thể thấy rằng trình xử lý không trả lại kết quả nào, điều này được mong đợi vì như lỗi cho thấy, trình xử lý chưa được triển khai. Thêm mô hình và lưu trữ giả Đầu tiên, chúng ta cần tạo một model cho todo note, chúng ta sẽ đặt nó trong package domain trong : go-services/internal/todo-backend/domain/todo.go https://gist.github.com/chebykinn/0c2905f07d76082bd9d63a56a720371c?embedable=true Đây cũng là một nơi tốt để xác định giao diện cho bộ lưu trữ, rất hữu ích để tách logic liên tục khỏi ứng dụng. Trong hướng dẫn này, chúng ta sẽ sử dụng lưu trữ mô phỏng, trong bộ nhớ, nhưng Mify cũng hỗ trợ Postgres, mà chúng ta có thể bổ sung sau trong bài viết tiếp theo. Hãy đặt dung lượng lưu trữ vào go-services/internal/todo-backend/storage/todo_mem.go: https://gist.github.com/chebykinn/1769d6881e929bfb225fc203c48e1496?embedable=true Đó là tất cả về logic, chúng ta chỉ cần thêm nó vào bộ xử lý. Trình xử lý triển khai cho phương thức POST và go-services/internal/todo-backend/handlers/todos/service.go cho những người khác. go-services/internal/todo-backend/handlers/todos/id/service.go Đây là một ví dụ về sơ khai của phương thức POST: https://Gist.github.com/chebykinn/e49b483330ea7c84a1b8082b0a86fc01?embedable=true Bây giờ, hãy triển khai tất cả các trình xử lý. : go-services/internal/todo-backend/handlers/todos/service.go https://Gist.github.com/chebykinn/6f88c03680167c4dc286f1b6226341f9?embedable=true Đừng quên cập nhật nhập khẩu: import ( "net/http" "strconv" "example.com/namespace/todo-app/go-services/internal/todo-backend/domain" "example.com/namespace/todo-app/go-services/internal/todo-backend/generated/api" "example.com/namespace/todo-app/go-services/internal/todo-backend/generated/apputil" "example.com/namespace/todo-app/go-services/internal/todo-backend/generated/core" "example.com/namespace/todo-app/go-services/internal/todo-backend/handlers" ) : go-services/internal/todo-backend/handlers/todos/id/service.go https://Gist.github.com/chebykinn/98d2d051671dfbefb464b1f59b159d15?embedable=true Và đây là nhập khẩu cho họ: import ( "errors" "fmt" "net/http" "strconv" "example.com/namespace/todo-app/go-services/internal/todo-backend/domain" "example.com/namespace/todo-app/go-services/internal/todo-backend/generated/api" "example.com/namespace/todo-app/go-services/internal/todo-backend/generated/apputil" "example.com/namespace/todo-app/go-services/internal/todo-backend/generated/core" "example.com/namespace/todo-app/go-services/internal/todo-backend/handlers" "example.com/namespace/todo-app/go-services/internal/todo-backend/storage" ) Logic của trình xử lý khá đơn giản, chúng tôi chỉ chuyển đổi các mô hình OpenAPI đã tạo sang ứng dụng của chúng tôi và ngược lại, đồng thời để tránh trùng lặp mã, đây là trình trợ giúp để tạo phản hồi TodoNode, được sử dụng trong các triển khai này: : go-services/internal/todo-backend/handlers/common.go https://Gist.github.com/chebykinn/702f24abe035cd99dbc06c4447ecc755?embedable=true Kiểm tra lại Đầu tiên, chúng ta có thể thêm ghi chú việc cần làm mới với yêu cầu POST: Kiểm tra xem nó có được thêm bằng yêu cầu GET không: Cập nhật nó với yêu cầu PUT: Xóa đi: Và chạy GET một lần nữa để kiểm tra xem nó đã bị xóa chưa: Cái gì tiếp theo Lưu trữ liên tục, như Postgres, Cấu hình, Phần mềm trung gian xác thực, Triển khai lên đám mây. Hầu hết nội dung này đều có trong tài liệu của chúng tôi, vì vậy hãy xem chúng: , nhưng hãy chú ý theo dõi các bài viết tiếp theo. https://mify.io/docs Cũng được xuất bản ở đây

Nghe bài viết này bằng Tiếng Anh, đọc bởi robot thông minh của HackerNoon

dài quá đọc không nổi

Making security fun one episode at a time

Xây dựng dịch vụ API RESTful trong Go mà không cần có bản soạn sẵn lặp đi lặp lại

dài quá đọc không nổi

Mify

About Author

chuyên mục

Languages

BÀI VIẾT NÀY CŨNG CÓ MẶT TẠI...

Xây dựng dịch vụ API RESTful trong Go mà không cần có bản soạn sẵn lặp đi lặp lại

dài quá đọc không nổi

Mify

About Author

chuyên mục

Languages

BÀI VIẾT NÀY CŨNG CÓ MẶT TẠI...

NHỮNG BÀI VIẾT LIÊN QUAN