Java Class'tan JSON Schema Üretici

Java kodu Girdisi

Editör yükleniyor…

JSON Schema Çıktısı

Ayarlar

Şema üretilirken hangi class'ın kök olarak kullanılacağını seçin.

Ayrıştırma tamamen tarayıcınızda çalışır. Kaynağınız sayfadan asla çıkmaz.

JSON Schema üretmek için Java class'larınızı yapıştırın.

Collection'lar, iç içe nesneler, Map'ler ve yaygın anotasyonlar desteklenir.

Java class ve record'lar için JSON Schema üretme — adım adım kılavuz

Bu çevrimiçi Java class'tan JSON Schema dönüştürücü; gerçek modellerden (DTO, struct, class) JSON Schema üretmenize yardımcı olur. Böylece payload'ları doğrulayabilir, sözleşmeleri paylaşabilir ve mock JSON üretebilirsiniz.

  1. Adım 1 – Java kaynağınızı yapıştırın

    • Belgelemek istediğiniz modelleri sol editöre yapıştırın.
    • Şemanın definitions üretebilmesi için referans verilen türleri aynı snippet'e dahil edin.
    • Örnek yüklemek ve beklenen giriş formatını görmek için Örnek düğmesini kullanın.
  2. Adım 2 – Kök class seçin (gerekirse)

    • Birden fazla tanım algılanırsa, API payload'unuzla eşleşen kökü seçin.
    • Çıktı şema, seçilen köke göre oluşturulur ve referans türler için ek definitions içerebilir.
  3. Adım 3 – JSON Schema çıktısını inceleyin

    • Türleri, required/optional alanları ve iç içe nesne/dizi yapılarını kontrol edin.
    • Şunlara dikkat edin: definitions ve $ref modelleriniz diğer modelleri referansladığında.
    • Doğrulama, dokümantasyon veya şema-önce geliştirme için şemayı kopyalayın veya indirin.
  4. Adım 4 – Doğrulayın veya mock JSON üretin

    • Tıklayın Mock Veri Üret ve şema ön yüklü şekilde mock üreticiyi açın.
    • Kırılma yaratan değişiklikleri erken yakalamak için gerçek payload'ları şemanıza göre doğrulayın.
    • Gelişmiş şema bileşimine (örn. anyOf/oneOf/allOf) dayanıyorsanız sonucu Ajv gibi tam bir doğrulayıcıyla doğrulayın.

Şema anahtar kelime desteği notu

Üretilen şemalar $ref içerebilir ve ayrıca anyOf, oneOf, veya allOf. Karmaşık şemalar için tam bir JSON Schema doğrulayıcı kullanın ve gerekirse mock üretiminden önce dereference edin.

İlgili JSON Schema ve kod üretim araçları

Şemaları doğrulamak, mock payload üretmek, JSON örneklerini biçimlendirmek ve kod ile sözleşmeleri senkron tutmak için bu araçları kullanın.

Sık Sorulan Sorular

Hangi Java kodları destekleniyor?

Dönüştürücü; yaygın POJO'lar, Lombok data class'ları, record'lar, builder'lar ve iç içe nesneler, generics, diziler, List/Set ve Map içeren DTO'ları anlar. @JsonProperty, @SerializedName, @JsonInclude gibi anotasyonları ve nullable ipuçlarını okuyarak adlandırma ve isteğe bağlılık davranışını serileştirme çatınızla uyumlu tutar.

Veri türü tespiti ne kadar doğru?

Primitive wrapper'lar (Integer, Double, Boolean vb.), Java time türleri, enum'lar, Optional'lar ve generic koleksiyonlar en yakın JSON Schema karşılıklarına eşlenir. Tür bilgisi eksikse (ör. generic olmayan ham List alanları) uyarı verilir ve şemanın geçerli kalması için makul varsayımlar yapılır.

Şemadan mock JSON verisi nasıl üretirim?

Şema üretildikten sonra "Mock Veri Üret" düğmesine tıklayarak Mock Üretici'yi şema ön yüklü şekilde açın. Locale ve dizi sayıları gibi seçenekleri ayarlayıp anında gerçekçi örnek payload'lar oluşturun.

Birden fazla class olduğunda kök class'ı nasıl seçerim?

Ayarlar panelini açıp listeden ayrıştırılan herhangi bir class'ı seçin. Varsayılan olarak ilk public class seçilir, ancak sayfayı yeniden yüklemeden dilediğiniz zaman nested class'lara veya dosyada daha sonra tanımlanan DTO'lara geçebilirsiniz.

Java Class'tan JSON Schema Üretici | JSONSwiss