Video: Java 4 - Java için ne Gerekiyor? 2024
Bu Java listesi, bir örnek programın gelişmiş bir sürümüne sahiptir. Tüm anahtar kelimelere, tanımlayıcılara ve noktalama işaretlerine ek olarak, insanların okumak için hazırlanmış bir metni vardır.
/ * * "Java İçin Aptallar, 6. Baskı" da 3-6. "* * Telif Hakkı 2014 Wiley Publishing, Inc. * Tüm hakları saklıdır. * / / ** * Displayer sınıfı bilgisayar ekranında * metin görüntüler *. * * @author Barry Burd * @version 1. 0 10/24/13 * @see java. Lang. System * / public class Displayer {/ ** * Ana yöntem, * kodun çalıştırılmasının başladığı yerdir. * * @param args (Bkz. Bölüm 11.) * / public static void main (Dizge args []) {System. dışarı. println ("Java'yı seviyorum!"); //BEN? Siz?}}
Bir yorumu , bir programın içinde bulunan, insanlara programı anlamalarına yardımcı olacak özel bir metin bölümüdür. Bir açıklama iyi bir program belgelerinin bir parçasıdır.
Java programlama dili üç çeşit yoruma sahiptir:
-
Geleneksel yorumlar: Girişin ilk beş satırı bir geleneksel yorumu oluşturur. Yorum, / * ile başlar ve * / ile sona erer. Açılış / * ve kapatma * arasındaki her şey sadece insan gözü içindir. "Java For Aptallar, 6. Baskı" ya da Wiley Publishing, Inc. hakkında hiçbir bilgi derleyici tarafından çevrilmedi.
Liste 3-6'daki ikinci, üçüncü, dördüncü ve beşinci satırların ekstra yıldızları (*) var. Ekstra denir çünkü bir yorum yarattığınızda bu yıldızlar gerekli değildir. Sadece yorumları güzel gibi gösteriyorlar.
-
Satır sonu yorumları: Metin // I? Sen?, satır sonu yorumu. Satır Sonu Yorumu, iki eğik çizgi ile başlar ve bir satır türünün sonuna gider. Derleyici, satır sonu açıklamasının içindeki metni bir kez daha çevirmez.
-
Javadoc yorumları: A javadoc yorumu bir eğik çizgi ve iki yıldızla başlar (/ **). Girişin iki javadoc yorumu var - Biri The Displayer sınıfı metniyle … ve diğeri metnin ana yöntemi olduğu yerde ….
Bir javadoc yorumu özel bir tür geleneksel yorumdur. Bir javadoc yorumu, Java koduna hiç bakmayan insanlar tarafından okunması içindir. Fakat bu mantıklı değil. Javadoc yorumlarını nasıl görebiliyorsunuz?
Evet, javadoc olarak adlandırılan belirli bir program (başka ne var?) Listede bulunan tüm javadoc açıklamalarını bulabilir ve bu yorumları güzel görünümlü bir web sayfasına dönüştürebilir. Bu şekil sayfayı göstermektedir.
Javadoc yorumları harika. İşte onlar hakkında birkaç harika şey:
-
Java koduna bakmak zorunda olan tek kişi kod yazan programcı.Kodu kullanan diğer kişiler, otomatik olarak oluşturulan web sayfasını görüntüleyerek kodun ne yaptığını öğrenebilirler.
-
Diğer insanlar Java koduna bakmadığından, başkaları Java kodunda herhangi bir değişiklik yapmazlar. (Diğer bir deyişle, diğerleri mevcut Java koduna hata girmezler.)
-
Diğer insanlar Java koduna bakmadığından, diğer insanlar Java kodunun iç işleyişini çözmek zorunda değildirler. Tüm bu insanlar kod hakkında bilmek istedikleri kodun web sayfasında okudukları şey.
-
Programcı iki ayrı şey yaratmaz - burada bir Java kodu ve oradaki kodla ilgili bazı belgeler. Bunun yerine, programcı bir parça Java kodu oluşturur ve belgeyi (javadoc yorumları şeklinde) doğrudan kodun içine gömer.
-
En iyisi, web sayfalarının javadoc yorumlarından otomatik oluşturulması. Dolayısıyla herkesin belgeleri aynı biçime sahip. Java kodunu kimin kullandığına bakmaksızın, bu kod hakkında bir resim okuyarak öğrenebilirsiniz. Bu iyi, çünkü formatı Java kullanan herkes biliyor.
