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. Üst menüden Datasources modülünü açın.
3. Açılan Datasources ekranında mevcut veri kaynaklarınızı Recently modified ve Data sources sekmeleri altında görüntüleyebilir, Search by name alanı ile arama yapabilirsiniz.
4. Ekranın üst kısmındaki kartlardan Create a Function kartına tıklayın. Bu kart C#, TypeScript, Python, Java, Go ve Rust ile özel fonksiyon oluşturmanızı sağlar.
5. Açılan Development listesinden Java (Custom Java functions) seçeneğini belirleyin. Listede gezinmek için ↑/↓ tuşlarını, seçim yapmak için Enter tuşunu da kullanabilirsiniz.

6. Name alanına veri kaynağınız için bir isim girin (örn. userguidejava).
7. CREATE butonuna tıklayarak işlemi tamamlayın. İşlemden vazgeçmek için CANCEL butonunu, dil seçimine geri dönmek için < Java bağlantısını kullanabilirsiniz.

Not: Sol paneldeki Sources başlığının yanında yer alan + ikonu ile de yeni veri kaynağı ekleme işlemini başlatabilirsiniz.

Java Editör Ekranının Anatomisi

A. Üst Menü

• Geri Butonu (←): Datasources ekranına geri dönmenizi sağlar.
• Veri Kaynağı Adı: Oluşturduğunuz Java veri kaynağının adı (örn. userguidejava) Java ikonu ile birlikte görüntülenir. Yanındaki açılır ok ile veri kaynakları arasında geçiş yapabilir, kalem ikonu ile adı düzenleyebilirsiniz.
• CREATE Butonu: Hazırladığınız Java veri kaynağını kaydetmek için kullanılır.

B. Editör Araç Çubuğu

• Geri Al / Yinele: Yapılan değişiklikleri geri almanızı veya tekrar uygulamanızı sağlar.
• Kopyala / Yapıştır: Kodu kopyalamak ve editöre yapıştırmak için kullanılır.
• Kodu Düzenle (Tidy Up): Sihirli değnek ikonu ile yazılmış kodu düzenleyebilir, hizalayabilir ve okunabilir hale getirebilirsiniz.
• Satır Kaydırma (Word Wrap): Uzun satırların editör genişliğine göre alt satıra kaydırılmasını açıp kapatır.
• Yazı Boyutu (− 12 +): Editördeki yazı boyutunu küçültüp büyütmenizi sağlar; yanındaki ikon ile varsayılan boyuta dönebilirsiniz.
• External Libraries (BETA): Java kodunuzda kullanmak üzere harici kütüphaneler (JAR/bağımlılık) eklemenizi sağlayan açılır menüdü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. Menünün yanındaki yeşil onay ikonu, kodunuzun seçili sürümle geçerli olduğunu gösterir.

C. Java Editor

Kod yazma alanıdır. Tüm özel metodlar burada tanımlanır.

Varsayılan örnek yapı:

java

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. Kuika AI Paneli

Ekranın sağ tarafında yer alan yapay zekâ asistanıdır. Type here... alanına ihtiyacınızı yazarak Java aksiyonlarınız için kod önerisi alabilir, örneklerden yararlanabilirsiniz.

E. Test Console

Ekranın alt kısmında yer alan, yazdığınız metodları test etmek için kullanılan alandır. Sağındaki ok ile açılıp kapatılabilir.

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

Kodlarınızı doğrudan editör üzerinden manuel olarak yazabilirsiniz.

Örnek:

java

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

Kuika AI ile Kod Oluşturma

Sağ paneldeki Kuika AI alanına 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ü araç çubuğundaki JAVA açılır menüsünden seçebilirsiniz (bkz. java_1.png). 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 açılır menüsü ü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:

java

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ı açarak 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:

java

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 sağ üstteki 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.