Jika perusahaan Anda tidak menggunakan kesombongan atau bahkan mendengar tentang kesombongan, cepat dan pelajari blog ini, integrasi lima menit yang cepat, gaya bodoh, tetapi aplikasi sederhana seperti itu pasti akan mengejutkan mereka.
Pertama, mari kita berikan pengantar singkat untuk Swagger: Swagger adalah alat ajaib untuk pengembangan back-end dan saluran untuk komunikasi front-end. Apa yang dapat Anda lakukan dengan kesombongan? Pertama -tama, Anda pada dasarnya dapat mengucapkan selamat tinggal pada pengujian unit di masa depan; Kedua, Anda tidak perlu lagi menulis dokumen antarmuka, dan Anda tidak perlu memelihara dokumen setelah menulisnya. Kesombongan dapat sepenuhnya mensimulasikan permintaan HTTP, dan perbedaan antara parameter yang masuk dan keluar dan kondisi aktual hampir nol. Setelah mengatakan ini, mari kita buat beberapa informasi!
Integrated Four-Part:
Langkah 1: Impor dua dependensi. Jika Anda bukan proyek Maven, maka Anda dapat mencari paket JAR. Ingatlah bahwa hanya dua yang diperlukan. Saya melihat bahwa saya memperkenalkan tujuh atau delapan dari mereka di tutorial lain, yang merupakan sia -sia.
<dependency> <GroupId> io.springfox </groupid> <ArtifactId> springfox-swagger2 </arttifactid> <version> 2.6.1 </version> </dependency> <dependency> <roupid> IO.springfox </groupid> <ArTifacTid> Springfox-SPRINGFOX </ARTICED </ARTIFID> <ArTifacTID> Springfox-swagger-UI </ARTICE </VERSITIF> <TROGER?
Langkah 2: Tambahkan kelas (Salin yang berikut, harap perhatikan bahwa Anda dapat memodifikasi nama dan alamat paket)
/** * Konfigurasi Swagger * * @author wq * @since 2017-05-16 */ @enableWebMvc @enableSwagger2 @configurationpublic class swaggerconfig {@bean docket public createrestapi () {return new (documentationType.swagger_2) .preaterestapi () {return new (documentationType.swagger_2) .ApiInfo () {return new (DocumentationType.SWagger_2) .ApiInfo () {return new (DocumentationType.swagger_2. .apis (requesthandlerselectors.basepackage ("com.z*.b*.c*.controller")) // Perhatikan bahwa Anda memodifikasi nama paket di sini.paths (pathselectors.any ()) .build (); } private apiInfo apiInfo () {return new ApiInfoBuilder () .title ("Daftar Antarmuka v1.1.0") // Any, Harap atur sedikit. IP Anda sendiri: port .contact ("laowu") // Tidak masalah (inilah alias penulis) .version ("1.1.0") .build (); }} Langkah 3: Tambahkan konfigurasi berikut ke file konfigurasi MVC. Mungkin file Anda dapat disebut dispatcher.xml! (Cukup salin, tidak diperlukan modifikasi)
<mvc: pemetaan sumber daya = "swagger-ui.html" lokasi = "classpath:/meta-inf/sumber daya/"/>> <mvc: pemetaan sumber daya = "/webjars/**" lokasi = "classpath:/meta-inf/sumber daya/webjars/"//>
Langkah 4: Tambahkan anotasi pada metode dan parameter
Metode:
@Apioperation (value = "Tutorial", httpmethod = "Post", note = "Tutorial")
Masukkan ke dalam registri:
@Apiparam (wajib = true, name = "test", value = "parameter tutorial")
Saya khawatir beberapa teman tidak begitu mengerti, jadi mari kita berfoto!
Langkah 5: Mulai layanan dan masukkan di browser:
http: // ip: port/swagger-ui.html
Layar berikut muncul berarti tugas selesai:
Catatan: Jika Anda menggunakan pencegat di proyek Anda, silakan lepaskan sumber daya Swagger (Anda masih dapat menyalin konfigurasi berikut secara langsung, jangan ragu V2)
<MVC: Path-Mapping Path = "/Swagger*/**"> </mvc: Excule-Mapping> <mvc: Path-Mapping Path = "/v2/**"> </mvc: Excelude-Mapping> <MVC: Excule-Mapping Path = "/WebJars/**"> </mvc: Exclude-papping>
Di atas adalah semua konten artikel ini. Saya berharap ini akan membantu untuk pembelajaran semua orang dan saya harap semua orang akan lebih mendukung wulin.com.