27 Temmuz 2016 Çarşamba

Swagger-Codegen ile Kod Oluşturma

Selamlar, bu yazımda Swagger araçlarından biri olan Swagger-Codegen ile var olan bir apiyi generate etmekten bahsedeceğim.

Öncelikle Kod Oluşturma nedir bunu açıklayacak olursam;
Var olan kodlara kod yazma yeteneği kazandırma işlemidir diyebiliriz. Örneğin elimizde herhangi bir dilde yazılmış bir api var. Biz bunu başka bir dile çevirmek istiyoruz. Bu noktada Kod Oluşturma yapmamız gerekmektedir. Birçok dilde bu işleme özel araçlar bulunmaktadır.

Ben bu yazımda bahsettiğim örneği açıklayacağım. Bir dilde yazılmış örnek bir apiyi Swagger-Codegen aracını kullanarak başka bir dile generate edilişinden bahsedeceğim.

*Swagger-Codegen

 Apiyi generate ederken Java kullanacağım.

-> Öncelikle Swagger-Codegen .jar dosyasını buradan indirmemiz gerekiyor.

-> Daha sonra aşağıdaki komutları sırasıyla uygulayarak elimizde bulunan apiyi istediğimiz bir dile çevirebiliriz.

$ git clone https://github.com/swagger-api/swagger-codegen

$ cd swagger-codegen

$ mvn clean package

$ java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar
        generate \
    -i  http://petstore.swagger.io/v2/swagger.json \
    -l  php \
    -o /var/tmp/php_api_client

Adımlarını takip ederek apiyi php dilindeki haline generate etmiş oluruz.

Buradaki parametrelere bakacak olursak;
i: Apinin .json linki
l: Generate etmek istediğimiz dil
o: Generate etmek istediğimiz yerin uzantısı

Hangi dillere generate edebileceğimizi öğrenmek için;

$ ls -1 modules/swagger-codegen/src/main/java/io/swagger/codegen/languages/

Daha fazla bilgiyi Swagger-Codegen Github sayfasından edinebilirisiniz.
Umarım faydalı olmuştur iyi çalışmalar.

Hiç yorum yok:

Yorum Gönder