Java veri kaynağı, Kuika platformunda özel fonksiyonlar ve iş mantıkları geliştirmenizi sağlayan entegrasyon yöntemlerinden biridir. Java kullanarak uygulamanız içerisinde özel işlemler tanımlayabilir, parametre alan metodlar oluşturabilir ve bu metodları uygulama akışlarında kullanabilirsiniz.

Java veri kaynağı sayesinde hazır aksiyonların dışında kalan ihtiyaçlar için özel kod yazabilir, veri işleme süreçlerini özelleştirebilir ve tekrar kullanılabilir fonksiyonlar oluşturabilirsiniz.

Java ile Uygulamanıza Veri Kaynağı Bağlantısı Ekleyin

1. Kuika platformuna giriş yapın ve Apps ekranından çalışacağınız projeyi açın.
2. Data Sources modülünü açın.
   
   • Burada mevcut veri kaynaklarını görebilir ve yeni veri kaynağı ekleyebilirsiniz.
3. Sol panelde Sources başlığı yanındaki + ikonuna tıklayın.
4. Açılan Add a new Datasource ekranında Development kategorisi altından Java seçeneğini belirleyin.
5. Veri kaynağınız için bir isim girin.
6. CREATE butonuna tıklayarak işlemi tamamlayın.

Java Action Modalının Anatomisi

A. Üst Menü

• Başlık (Java Action): Modalın başlığı, oluşturulan veri kaynağının Java tabanlı bir aksiyon olduğunu belirtir.
• CREATE Butonu: Hazırladığınız Java veri kaynağını kaydetmek için kullanılır.
• Kapat Butonu (X): Ekranı kapatmak ve işlemden çıkmak için kullanılır.

B. Üst Ayarlar Alanı

• Name: Fonksiyonunuzun ne işe yaradığına dair açıklama girebileceğiniz bir alandır. Diğer geliştiricilerin veya ileride sizin kodun amacını hatırlamanıza yardımcı olur.
• External Libraries (BETA): Java kodunuzda kullanmak üzere harici kütüphaneler (JAR/bağımlılık) eklemenizi sağlayan alandır. Şu anda BETA etiketiyle sunulmaktadır.

• Java version: Kodunuzun hangi Java sürümüyle derlenip çalıştırılacağını belirlemenizi sağlayan açılır menüdür. Desteklenen sürümler:
  
  • Java 21 (LTS)
  • Java 17 (LTS)
  • Java 11 (LTS)
  • Java 8 (LTS)
• Varsayılan olarak en güncel LTS sürümü (Java 21) seçili gelir; ihtiyacınıza göre daha eski bir LTS sürümü seçilebilir.
• Generate with AI: Yapay zekâ desteği ile otomatik Java kodu oluşturmak için kullanılan seçenektir. Açık konuma getirildiğinde sistemden kod önerisi alınabilir.

C. Java Editor

• Kod yazma alanıdır.
• Tüm özel metodlar burada tanımlanır.
• Varsayılan örnek yapı:

public class Main {
  public static String greet(String name) {
    return "Hello, " + name;
  }
}

Bu yapı aşağıdakileri gösterir:

• Kodlar bir class içerisinde tanımlanır (varsayılan sınıf adı Main).
• Metodlar static olarak oluşturulur.
• Parametre alabilir.
• Parametre tipi belirlenebilir (örn. String).
• Dönüş tipi tanımlanabilir (örn. String).

D. TIDY UP Butonu

• Kod editörünün sağ üst bölümünde yer alır.
• Yazılmış kodu düzenlemek, hizalamak ve okunabilir hale getirmek için kullanılır.

E. Test Console

• Ekranın alt kısmında yer alan, yazdığınız metodları test etmek için kullanılan alandır.
• Bu bölümde:
  
  • Metod listesi görüntülenir.
  • Parametre giriş alanları oluşur.
  • Sonuç çıktısı görüntülenebilir.

Java Veri Kaynağı Ayarlarını Yapılandırma

Manuel Kod Yazma

Generate with AI kapalıysa tüm kodlar doğrudan editör üzerinden manuel olarak yazılır.

Örnek:

public class Main {
  public static String toUpperCase(String text) {
    return text.toUpperCase();
  }
}

AI ile Kod Oluşturma

Generate with AI özelliğini aktif ederseniz, açıklama yazarak otomatik kod oluşturabilirsiniz.

Örnek komut:

Girilen metni büyük harfe çeviren metod oluştur.

Java Version Seçimi

Kodunuzun derleneceği/çalışacağı Java sürümünü Java version açılır menüsünden seçebilirsiniz. Farklı sürümler arasında dil özellikleri veya kütüphane uyumluluğu farklılık gösterebileceğinden, projenizin ihtiyaçlarına uygun LTS sürümünü seçmeniz önerilir.

External Libraries Kullanımı (BETA)

External Libraries alanı üzerinden, standart Java kütüphanelerinin dışında ek bağımlılıklar projenize dahil edilebilir. Bu özellik şu an BETA aşamasındadır.

Parametre Tanımlama

Metodlarınıza parametre ekleyebilirsiniz.

Örnek:

public class Main {
  public static double sum(double value1, double value2) {
    return value1 + value2;
  }
}

Bu metod iki sayı alır ve toplamını döndürür.

Dönüş Tipi Belirleme

Metod tanımının başında dönecek veri tipi belirtilmelidir.

Örnek tipler:

• String
• int
• double
• boolean
• Object
• List<T>

Test Console ile Metod Test Etme

Kodunuzu yazdıktan sonra alt bölümdeki Test Console alanını kullanabilirsiniz.

1. Test etmek istediğiniz metodu seçin.
2. Parametre alanlarına örnek veri girin.
3. Metodu çalıştırın.
4. Dönen sonucu kontrol edin.

Örnek:

public class Main {
  public static String hello(String name) {
    return "Hello " + name;
  }
}

Parametre: Kuika Beklenen çıktı: Hello Kuika

CREATE ile Veri Kaynağını Kaydetme

Kodunuzu tamamladıktan ve test ettikten sonra CREATE butonuna tıklayarak Java veri kaynağını kaydedebilirsiniz. Kaydedilen veri kaynağı uygulama içerisinde kullanılabilir hale gelir.

Beklenen Çıktı / Sonuç

Bu adımlar tamamlandığında:

• Java veri kaynağı Sources listesine eklenir.
• Tanımlanan metodlar sistemde kullanılabilir hale gelir.
• Özel iş kuralları kod ile yönetilebilir.
• Tekrar kullanılabilir fonksiyon yapısı oluşturulur.