Java İle Internationalization Kullanarak Çok Dilli Uygulama Nasıl Yapılır?

Ön Hazırlık ve Gereksinimler

Bu rehberi takip edebilmek için sisteminizde Java Development Kit (JDK) 17 veya daha güncel bir sürümün yüklü olması gerekmektedir. Uygulama geliştirme ortamı olarak IntelliJ IDEA, Eclipse veya VS Code kullanabilirsiniz. Projenizde herhangi bir harici kütüphaneye ihtiyaç duymadan, Java'nın kendi java.util.ResourceBundle ve java.text.MessageFormat sınıflarını kullanacağız.

• JDK 17+ (LTS sürümü önerilir)
• Temel Java sözdizimi bilgisi
• IDE (Entegre Geliştirme Ortamı)

ResourceBundle ile Dil Dosyalarını Yapılandırma

Java'da çok dilli destek sağlamanın en temel yolu ResourceBundle sınıfıdır. Bu sınıf, anahtar-değer çiftlerini içeren özel dosyalardan (Properties dosyaları) verileri okur. Her dil için ayrı bir dosya oluşturarak uygulamanızın metinlerini koddan tamamen ayırırız.

Aşağıdaki örnekte, varsayılan dil (İngilizce) ve Türkçe için iki farklı dosya oluşturacağız. Dosya isimleri MessagesBundle_en_US.properties ve MessagesBundle_tr_TR.properties şeklinde olmalıdır.

# MessagesBundle_en_US.properties
greeting=Hello
welcome.message=Welcome to our application!

# MessagesBundle_tr_TR.properties
greeting=Merhaba
welcome.message=Uygulamamıza hoş geldiniz!

Bu dosyalar, projenizin src/main/resources dizini altında bulunmalıdır. Java, Locale nesnesine göre otomatik olarak doğru dosyayı seçecektir.

Locale Kullanımı ve Dil Seçimi

Locale sınıfı, belirli bir coğrafi, politik veya kültürel bölgeyi temsil eder. Kullanıcının tarayıcı ayarlarından veya uygulama içi bir menüden seçtiği dili belirlemek için kullanılır. Aşağıdaki kod bloğu, belirli bir Locale için nasıl kaynak yükleneceğini gösterir.

import java.util.Locale;
import java.util.ResourceBundle;

public class LocalizationDemo {
    public static void main(String[] args) {
        Locale trLocale = new Locale("tr", "TR");
        ResourceBundle bundle = ResourceBundle.getBundle("MessagesBundle", trLocale);

        System.out.println(bundle.getString("greeting"));
        System.out.println(bundle.getString("welcome.message"));
    }
}

Bu kod, MessagesBundle_tr_TR.properties dosyasını arar ve içerisindeki değerleri ekrana yazdırır. Eğer belirtilen Locale bulunamazsa, Java otomatik olarak varsayılan MessagesBundle.properties dosyasına döner.

Dinamik İçerik ve MessageFormat Kullanımı

Uygulamalarınızda sadece sabit metinler bulunmaz. Örneğin, "Merhaba, Ahmet" gibi dinamik veriler içeren cümleleri çevirirken MessageFormat sınıfından faydalanırız. Bu, çevirinin dilbilgisi yapısını bozmadan değişken eklememizi sağlar.

# Properties dosyasına ekleyin
user.greeting=Merhaba, {0}! Bugün tarih: {1}

import java.text.MessageFormat;
import java.util.ResourceBundle;
import java.util.Date;

// ...
ResourceBundle bundle = ResourceBundle.getBundle("MessagesBundle", new Locale("tr", "TR"));
String pattern = bundle.getString("user.greeting");
String formattedMessage = MessageFormat.format(pattern, "Ahmet", new Date().toString());
System.out.println(formattedMessage);

{0} ve {1} ifadeleri, çalışma zamanında gönderdiğimiz değerlerle yer değiştirir. Bu yöntem, farklı dillerde kelime dizilimleri değişse bile doğru bir çeviri yapılmasına olanak tanır.

Sayı ve Para Birimi Formatlama

Farklı ülkelerde sayı ve para birimi formatları değişiklik gösterir. Örneğin, Türkiye'de ondalık ayırıcı virgül (,) iken, ABD'de noktadır (.). Java'nın NumberFormat sınıfı bu karmaşıklığı bizim yerimize çözer.

import java.text.NumberFormat;
import java.util.Locale;

public class FormattingDemo {
    public static void main(String[] args) {
        double fiyat = 1250.50;
        
        NumberFormat trFormat = NumberFormat.getCurrencyInstance(new Locale("tr", "TR"));
        NumberFormat usFormat = NumberFormat.getCurrencyInstance(Locale.US);
        
        System.out.println("Türkiye: " + trFormat.format(fiyat));
        System.out.println("ABD: " + usFormat.format(fiyat));
    }
}

Bu yöntem, kullanıcının yerel ayarlarına göre para birimi sembolünü ve sayı formatını otomatik olarak ayarlar. Bu, finansal uygulamalarda hata payını sıfıra indirir.

Internationalization Yöntemlerinin Karşılaştırılması

Kritik Güvenlik Uyarısı: Kullanıcıdan gelen metinleri veya Locale bilgilerini doğrudan sistem komutlarında veya SQL sorgularında kullanmayın. Her zaman girdi doğrulaması (input validation) yaparak XSS ve SQL Injection risklerine karşı önleminizi alın. Çeviri dosyalarını dışarıdan yüklüyorsanız, dosya yolu manipülasyonuna karşı (Path Traversal) gerekli kontrolleri sağlayın.

Sıkça Sorulan Sorular

ResourceBundle neden bulunamadı hatası alıyorum?

Properties dosyalarınızın src/main/resources klasöründe olduğundan ve derleme sonrası target/classes veya bin dizinine kopyalandığından emin olun. Ayrıca dosya adının tam olarak kodda belirttiğiniz isimle eşleşmesi gerekir.

Çeviri dosyalarımda Türkçe karakter sorunu yaşıyorum, ne yapmalıyım?

Java'nın eski sürümlerinde properties dosyaları ISO-8859-1 kodlamasını beklerdi. Ancak modern Java uygulamalarında UTF-8 kodlamasını kullanmalısınız. IDE ayarlarınızdan dosya kodlamasını UTF-8 olarak değiştirin.

Uygulamanın varsayılan dilini nasıl ayarlarım?

Locale.setDefault(new Locale("tr", "TR")); komutunu uygulamanızın giriş noktasında (main metodu) kullanarak varsayılan dili belirleyebilirsiniz.

Çok fazla dil desteği eklemek performansı düşürür mü?

ResourceBundle nesneleri Java tarafından önbelleğe alınır. Bu nedenle, çok sayıda dil dosyası olsa bile performans kaybı ihmal edilebilir düzeydedir.

Tarih formatlarını nasıl yerelleştiririm?

Tarih formatları için java.time.format.DateTimeFormatter sınıfını kullanın. Bu sınıf, withLocale(Locale) metodu ile yerelleştirilmiş tarih çıktıları üretmenizi sağlar.

Internationalization Süreçlerinde İleri Seviye Test Stratejileri

Çok dilli bir uygulamayı yayına almadan önce, metinlerin uzunluklarının farklı dillerde nasıl değiştiğini ve karakter kodlamalarının doğru çalışıp çalışmadığını test etmek kritik bir süreçtir. Özellikle Almanca gibi kelime uzunluklarının İngilizceye göre çok daha fazla olduğu dillerde, arayüzdeki butonların veya etiketlerin taşması sık karşılaşılan bir sorundur.

Pseudo-Localization (Sözde Yerelleştirme) Uygulaması

Gerçek çeviriler gelmeden önce uygulamanızın yerelleştirme yeteneklerini test etmek için "Pseudo-Localization" yöntemini kullanabilirsiniz. Bu yöntem, mevcut metinlerinizi özel karakterlerle (örneğin: [éxámpĺé]) değiştirerek arayüzün yerelleştirmeye hazır olup olmadığını görmenizi sağlar.

import java.util.Locale;
import java.util.ResourceBundle;

public class LocalizationTester {
    public static void main(String[] args) {
        // Test için özel bir Locale oluşturma
        Locale pseudoLocale = new Locale("en", "US", "PS");
        ResourceBundle bundle = ResourceBundle.getBundle("Messages", pseudoLocale);
        
        System.out.println("Test Metni: " + bundle.getString("welcome.message"));
    }
}

Bu test yöntemi sayesinde, uygulamanızın farklı karakter setlerini (Unicode) destekleyip desteklemediğini ve metin alanlarının genişletilebilir olup olmadığını kolayca gözlemleyebilirsiniz.

Spring Boot ile Otomatik Yerelleştirme Yönetimi

Java'nın standart ResourceBundle yapısı küçük projeler için yeterli olsa da, kurumsal ölçekli Spring Boot uygulamalarında MessageSource arayüzü çok daha esnek çözümler sunar. Spring Boot, istek bazlı dil algılama (LocaleResolver) mekanizması ile kullanıcının tarayıcı ayarlarını otomatik olarak tanıyabilir.

LocaleResolver Yapılandırması

Spring Boot uygulamanızda kullanıcının dil tercihini bir çerez (cookie) veya HTTP başlığı (header) üzerinden yönetmek için aşağıdaki konfigürasyonu kullanabilirsiniz:

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.i18n.CookieLocaleResolver;
import java.util.Locale;

@Configuration
public class WebConfig {

    @Bean
    public CookieLocaleResolver localeResolver() {
        CookieLocaleResolver resolver = new CookieLocaleResolver();
        resolver.setDefaultLocale(Locale.ENGLISH);
        resolver.setCookieName("lang_pref");
        return resolver;
    }
}

Bu yapılandırma ile kullanıcı dil değiştirdiğinde, tercih sunucu tarafında bir çerezde saklanır ve uygulamanızın her sayfasında bu tercih otomatik olarak uygulanır. Ayrıca, MessageSource kullanarak veritabanı tabanlı çeviri dosyaları yükleyebilir, böylece uygulamayı yeniden başlatmadan çevirileri güncelleyebilirsiniz.

Performans İçin İpucu: Cache Yönetimi

Çok dilli uygulamalarda çeviri dosyalarının her istekte tekrar okunması ciddi bir performans kaybına yol açar. Spring Boot, MessageSource üzerinde varsayılan olarak bir önbellekleme mekanizması sunar. Üretim ortamında spring.messages.cache-duration özelliğini kullanarak bu süreyi optimize etmeniz, uygulamanızın yanıt süresini (latency) düşürecektir.

Sonuç

Java ile Internationalization uygulamak, uygulamanızın küresel ölçekte profesyonel görünmesini sağlar. ResourceBundle ile metinleri ayırmak, MessageFormat ile dinamik içerik yönetmek ve NumberFormat ile yerel standartlara uyum sağlamak, sürdürülebilir bir yazılım mimarisinin temel taşlarıdır. Bir sonraki adım olarak, bu yapıları Spring Boot gibi modern framework'lerde nasıl otomatik hale getirebileceğinizi araştırmanızı öneririm.

Kod güvenliği sorumluluk reddi: Bu rehberdeki kod örnekleri eğitim amaçlıdır. Üretim ortamına almadan önce tüm güvenlik açıklarını (SQL Injection, XSS, Buffer Overflow vb.) gözden geçirmeli ve gerekli güvenlik testlerini yapmalısınız.