Gin ialah rangka kerja web yang ditulis dalam Golang Ia mempunyai kelebihan kecekapan, ringan, fleksibiliti, prestasi yang agak tinggi dan mudah digunakan. Dalam pembangunan rangka kerja Gin, dokumentasi API dan ujian automatik adalah sangat penting. Artikel ini akan melihat secara mendalam dokumentasi API dan ujian automatik dalam rangka kerja Gin.
1. Dokumentasi API
Dokumentasi API digunakan untuk merekodkan maklumat terperinci semua antara muka API untuk memudahkan penggunaan dan pemahaman pembangun lain. Rangka kerja Gin menyediakan pelbagai alat dokumentasi API, termasuk Swagger, Go Swagger, ReDoc, dll. Artikel ini menggunakan Swagger sebagai contoh untuk menerangkan.
Sangat mudah untuk rangka kerja Gin untuk menyepadukan Swagger Mula-mula, anda perlu memasang Swagger menggunakan arahan berikut dalam terminal:
$ go get -u github.com/swaggo/swag/cmd/swag
Selepas pemasangan selesai, kami Anda boleh menggunakan arahan berikut untuk menjana dokumen Swagger:
$ swag init
Apabila menulis komen untuk antara muka API, mereka perlu ditulis dalam format tertentu. Contohnya:
// @Summary Get user by ID // @Description Get user information by ID // @Tags Users // @Produce json // @Param id path int true "User ID" // @Success 200 {object} User // @Router /users/{id} [get]
di mana, @Summary
mewakili penerangan ringkas antara muka, @Description
mewakili penerangan terperinci antara muka, @Tags
mewakili label yang dimiliki antara muka, @Produce
mewakili jenis kandungan tindak balas antara muka, @Param
mewakili parameter antara muka, @Success
mewakili tindak balas antara muka dan @Router
mewakili laluan antara muka.
Selepas komen ditulis, kita perlu menjana dokumentasi Swagger. Hanya gunakan arahan berikut:
$ swag init
Selepas berjaya menjana dokumen, lawati http://localhost:8080/swagger/index.html
dalam penyemak imbas untuk melihat dokumen Swagger.
2. Ujian automatik
Pengujian automatik merujuk kepada proses menggunakan program untuk menjalankan kes ujian secara automatik untuk menggantikan ujian manual. Dalam pembangunan rangka kerja Gin, ujian automatik boleh menjimatkan masa ujian dan meningkatkan kecekapan ujian.
Ginkgo ialah rangka kerja ujian Golang yang boleh menjalankan ujian gaya BDD (Behavior Driven Development). Gomega ialah perpustakaan pemadan yang boleh menyemak keputusan ujian dengan mudah. Untuk memasang kedua-dua perpustakaan ini, kita boleh menggunakan arahan berikut:
$ go get -u github.com/onsi/ginkgo/ginkgo $ go get -u github.com/onsi/gomega/...
Apabila menulis ujian, kita perlu mencipta fail _test.go baharu dan gunakan Tulis kod ujian dalam gaya BDD. Contohnya:
Describe("User Handler", func() { Context("when getting user information", func() { It("should return status code 200", func() { // 发起HTTP请求 r, _ := http.NewRequest(http.MethodGet, "/users/1", nil) w := httptest.NewRecorder() router.ServeHTTP(w, r) // 验证状态码 Expect(w.Code).To(Equal(http.StatusOK)) }) }) })
Dalam kod ujian di atas, kami mula-mula mentakrifkan nama ujian menggunakan Describe
. Kami kemudiannya mentakrifkan senario ujian menggunakan Context
dan kes ujian menggunakan It
. Dalam kes ujian, kami memulakan permintaan HTTP dan menggunakan pemadan untuk mengesahkan keputusan ujian.
Selepas kod ujian ditulis, kita boleh menggunakan arahan berikut untuk menjalankan ujian:
$ ginkgo -r
Dengan arahan ini, kita boleh menjalankan keseluruhan suite ujian dan melihat keputusan ujian.
Ringkasan
Artikel ini memperkenalkan dokumentasi API dan ujian automatik dalam rangka kerja Gin saya harap ia dapat membantu pembaca. Dalam pembangunan, kami perlu menumpukan pada penulisan dan penggunaan dokumentasi API dan ujian automatik untuk meningkatkan kecekapan dan kualiti pembangunan.
Atas ialah kandungan terperinci Penjelasan terperinci tentang dokumentasi API dan ujian automatik dalam rangka kerja Gin. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!