@throws ne demek?

@throws etiketi, Javadoc'ta kullanılan bir blok etiketidir ve bir metot veya kurucunun hangi istisnaları fırlatabileceğini belirtmek için kullanılır. Bu etiket, kodun okunabilirliğini ve bakımını artırmaya yardımcı olur, çünkü kullanıcıya bir metodun hangi hatalarla sonuçlanabileceği hakkında bilgi verir.

Kullanımı:

/**
 * Bu metot, belirtilen dosyayı okur ve içeriğini döndürür.
 * @param dosyaAdi Okunacak dosyanın adı.
 * @return Dosyanın içeriği.
 * @throws FileNotFoundException Dosya bulunamazsa.
 * @throws IOException Dosya okuma sırasında bir hata oluşursa.
 */
public String dosyayiOku(String dosyaAdi) throws FileNotFoundException, IOException {
    // ... dosya okuma işlemleri ...
}

Yukarıdaki örnekte, @throws etiketi, dosyayiOku metodunun FileNotFoundException (dosya bulunamazsa) ve IOException (dosya okuma sırasında hata oluşursa) istisnalarını fırlatabileceğini belirtir. Bu, metodu kullanan geliştiricilere potansiyel sorunları önceden bildirir ve onları uygun hata işleme mekanizmalarını uygulamaya teşvik eder.

Özellikler:

• @throws etiketi, bir metot birden fazla istisna fırlatabiliyorsa birden çok kez kullanılabilir.
• İstisna türü ve istisnanın ne zaman fırlatılacağına dair kısa bir açıklama içermelidir.
• @throws etiketi, checked exception'lar (derleme zamanında kontrol edilen istisnalar) için özellikle önemlidir, çünkü bu istisnaların ya yakalanması ya da metot imzasına eklenerek çağırana bildirilmesi gerekir. Unchecked exception'lar (çalışma zamanında oluşan istisnalar) için de kullanılabilir, ancak zorunlu değildir.