Java’da Açıklama Satırları

Java’da açıklama satırları, programcıların kodlarının anlaşılabilirliğini artırmak ve kodlarını belgelemek için kullanılan metinlerdir. Açıklama satırları, derleyici tarafından kod olarak işlenmez ve programın çalışmasını etkilemez. Bunun yerine, yalnızca insanlar tarafından okunur ve anlaşılır.

Java’da iki tür açıklama satırı bulunur:

1. Tek satırlı açıklama: Tek satırı açıklamak için “//” işareti kullanılır. Bu işaretten sonra gelen tüm metin, o satırın sonuna kadar açıklama olarak kabul edilir. Örneğin:

int x = 10;   // x değişkenine 10 değeri atanıyor

Çok satırlı açıklama: Çok satırlı açıklamalar, /* ile başlar ve */ ile biter. İçerisine yazılan tüm metin, bu iki işaret arasında yer alır. Çok satırlı açıklamalar, birden fazla satırı kapsayabilir ve genellikle daha uzun açıklamalar veya belgeler için kullanılır. Örneğin:

/*
Bu programda, iki sayının toplamını hesaplayan
basit bir Java fonksiyonu yer almaktadır.
*/
int toplam (int a, int b) {
    return a + b;
}

Açıklama satırlarının kullanım amaçları şunlardır:

1. Kodun anlaşılabilirliğini artırmak: Açıklama satırları, kodun nasıl çalıştığını veya niçin belirli bir yaklaşımın tercih edildiğini açıklar. Bu sayede diğer programcılar veya gelecekteki siz, kodu daha kolay bir şekilde okuyabilir ve anlayabilirsiniz.
2. Kodu belgelemek: Açıklama satırları, kodun işlevlerini, değişkenlerini veya sınıflarını belgelemek için kullanılabilir. Bu sayede başkaları kodu kullanırken veya siz ileride kodu tekrar inceleyip değiştirirken daha iyi bir anlayışa sahip olursunuz.
3. Geçici kodu devre dışı bırakmak: Açıklama satırları, belirli bir kod parçasını geçici olarak devre dışı bırakmak için kullanılabilir. Bu, hata ayıklama veya deneme amaçlı kod yazarken faydalı olabilir.

Örnek olarak, aşağıda bir Java sınıfı ve içerisinde açıklama satırlarıyla belgelenmiş bir metot bulunmaktadır:

public class HesapMakinesi {
    
    // İki sayının toplamını hesaplar
    public int toplama(int sayi1, int sayi2) {
        return sayi1 + sayi2;
    }
    
    // İki sayının farkını hesaplar
    public int cikarma(int sayi1, int sayi2) {
        return sayi1 - sayi2;
    }
    
    public static void main(String[] args) {
        HesapMakinesi hesap = new HesapMakinesi();
        int sonuc = hesap.toplama(5, 3);
        System.out.println("Toplama Sonucu: " + sonuc);
    }
}

Yukarıdaki örnekte, her metot için açıklama satırları kullanılmış ve metotların ne yaptıkları açıklanmıştır. Bu sayede kodun anlaşılabilirliği artmış ve kodu kullanan kişi veya gelecekteki geliştiriciler, metotları daha iyi anlayabilmiş olurlar.