你的第一個Java 程序外文文獻翻譯、中英文翻譯、外文翻譯

1、1 外文資料翻譯譯文你的第一個Java 程序最后，這里有第一個完整的程序。它以通過打印字符串開始，接下來就是日期，使用的是來自Java的標準庫的日期類。/ HelloDate.java import java.util.*; public class HelloDate public static void main(String args) System.out.println("Hello, its: "); System.out.println(new Date(); 在每一個程序文件的開頭，你必須放置一個import 語句，去引用那些額外的類當然是你需要的文件代碼。

2、請注意我說它們是“額外”的。那是因為有一個會自動導入每個Java 文件的特殊類庫：java.lang。啟動您的Web 瀏覽器，查看由Sun 提供的用戶文檔（如果尚未從 下載，或用其他方式安裝了Java 文檔，請立即下載）。在packages.html 文件里，可找到Java 配套提供的所有類庫名稱。請選擇其中的java.lang。在“Class Index”下面，可找到屬于那個庫的全部類的列表。由于java.lang 默認進入每個Java 代碼文件，所以這些類在任何時候都可直接使用。在這個列表里，可發(fā)現(xiàn)System 和Runtime，我們在Property.java 里用到了它們。java.l

3、ang 里沒有列出Date 類，所以必須導入另一個類庫才能使用它。如果不清楚一個特定的類在哪個類庫里，或者想檢視所有的類，可在Java 用戶文檔里選擇“Class Hierarchy”（類分級結(jié)構(gòu)）。在Web 瀏覽器中，雖然要花不短的時間來建立這個結(jié)構(gòu)，但可清楚找到與Java 配套提供的每一個類。隨后，可用瀏覽器的“查找”（Find）功能搜索關(guān)鍵字“Date”。經(jīng)這樣處理后，可發(fā)現(xiàn)我們的搜索目標以java.util.Date 的形式列出。我們終于知道它位于util 庫里，所以必須導入java.util.*；否則便不能使用Date。觀察packages.html 文檔最開頭的部分，請選擇java

4、.lang，再選System,這時可看到System 類有幾個字段。若選擇out，就可知道它是一個static PrintStream 對象。由于它是“靜態(tài)”的，所以你不需要用new關(guān)鍵字創(chuàng)建任何東西。因為out 對象一直都在，所以你可以直接使用它。我們能對這個out 對象做的事情由它的類型決定：PrintStream。PrintStream 在說明文字中以一個超鏈接的形式列出，這一點做得非常方便。所以假若單擊那個鏈接，就可看到能夠為PrintStream 調(diào)用的所有方法。方法的數(shù)量不少，本書后面會詳細介紹。就目前來說，我們感興趣的只有println()，它的意思是“把我給你的東西打印到控制臺

5、，并用一個新行結(jié)束”。所以在任何Java 程序中，一旦要把某些內(nèi)容打印到控制臺，就可條件反射地寫上System.out.println("A String of things")。 類名與文件是一樣的。若像現(xiàn)在這樣創(chuàng)建一個獨立的程序，文件中的一個類必須與文件同名（如果沒這樣做，編譯器會及時作出反應(yīng)）。類里必須包含一個名為main()的方法，形式如下： public static void main(String args) 其中，關(guān)鍵字“public”意味著方法可由外部世界調(diào)用（在Access Control 這一章節(jié)里面會詳細解釋）。main()的自變量是包含了Strin

6、g 對象的一個數(shù)組。args 不會在本程序中用到，但需要在這個地方列出，因為它們保存了在命令行調(diào)用的自變量。程序的第一行非常有趣： System.out.println(new Date();請觀察它的自變量：創(chuàng)建Date 對象唯一的目的就是將它的值發(fā)送給println()。一旦這個語句執(zhí)行完畢，Date 就不再需要。隨之而來的“垃圾收集器”會發(fā)現(xiàn)這一情況，并在任何可能的時候?qū)⑵浠厥铡Ｎ覀儧]太大的必要關(guān)心“清除”的細節(jié)。當你看到從 JDK文檔中，你會發(fā)現(xiàn)系統(tǒng)有很多其他的方法可以產(chǎn)生有趣的效果（Java的最強大的資產(chǎn)之一是它的大套標準庫）。 例如：/: object/ShowProperties

7、.java public class ShowProperties public static void main(String args) System.getProperties().list(System.out); System.out.println(System.getProperty(""); System.out.println( System.getProperty("java.library.path"); /:在第一行的main（）顯示所有的從系統(tǒng)中正在運行的程序“屬性”，所以它給你的環(huán)境信息。名單（）方法將結(jié)果發(fā)

8、送給它的參數(shù)下，System.out。你會在書中，你可以在其他地方將結(jié)果發(fā)送到文件，例如在后面看到。您也可以要求一個特定的屬性，在這種情況下，用戶名和的java.library.path。 （在開始和結(jié)束時的不同尋常的意見將在稍后說明一點。）編譯和運行要編譯并運行此程序，以及所有在這本書中的其他程序，您必須首先有一個Java編程環(huán)境。有一些第三方的開發(fā)環(huán)境，但在這本書中，我會假設(shè)你使用的是Java開發(fā)工具包（JDK）來自Sun，這是免費的。如果您使用的是另一種開發(fā)系統(tǒng)，你需要查看的文檔中該系統(tǒng)以確定如何編譯和運行程序。連接互聯(lián)網(wǎng)，并登錄。在那里，你可以找到的信息和鏈接，將引導您完成下載和安裝為

9、您的特定平臺的JDK。一旦JDK安裝，并且已經(jīng)設(shè)置了計算機的路徑信息，這樣它會尋找javac和java，下載并解壓的源代碼本書（你可以在www.MindV找到它）。這將為這本書中每一章創(chuàng)建一個子目錄。移動到以為“對象”命名的子目錄里，類型是：javac HelloDate.java 這個命令應(yīng)該不會產(chǎn)生反應(yīng)。如果你得到任何形式的錯誤信息，那說明你還沒有安裝JDK正確，你需要調(diào)查這些問題。在另一方面，如果你只是想讓你的命令提示符返回，你可以鍵入：java HelloDate 你會得到的消息和日期作為輸出。這是你可以用它來在這本書中編譯和運行的每個程序的過程。但是，你會看到，在每一個章節(jié)里面這本書

10、的源代碼也有一個名為build.xml文件，這包含了“Ant”的命令為章節(jié)自動建立的文件。構(gòu)建文件和Ant（包括在哪里可以下載）在補充更詳細地描述你會發(fā)現(xiàn)http:/MindV /ant），你可以只輸入“ant”在命令提示符下編譯和運行在每章的程序。如果你還沒有安裝Ant，你可以手動輸入的javac和java命令。注釋和嵌入文件在Java中的注釋類型中有兩種。首先是由C +繼承了傳統(tǒng)的C風格的注釋。這些注釋以/*開始，可以注釋許多行，直到*/才會結(jié)束。需要注意的是很多程序員將用*注釋每一行的開頭，所以你會經(jīng)?？吹剑?* This is a comment * that continues *

11、across lines */ 但是請記住，在/*和*/之間的任何東西都會被忽略，所以這里沒有區(qū)別：/* This is a comment that continues across lines */ 注釋的第二種形式來自于C +。它是單行注釋，它開始于一個/并且一直到這一行的結(jié)尾。由于這種注釋的便捷性，這種類型的注釋是方便和常用的。你并不需要在鍵盤上找到/和*（相反，你只需按相同的鍵兩次），而且你也不需要關(guān)閉評論。所以，你會經(jīng)?？吹剑? This is a one-line comment 注釋文檔可能記錄代碼最大的問題已經(jīng)變成維持該文檔了。如果文檔和代碼是分開的，那么每一次你改變代碼的時

12、候還要改變文檔，這是十分乏味的。解決的辦法似乎很簡單：把代碼和文檔鏈接起來。要做到這一點，最簡單的辦法就是把一切都放在同一個文件。然而，要完成這樣的圖片，你需要一個特殊的注釋語法去標記這些文檔，還有一個工具來提取這些意見，并把他們以一個有用的形式呈現(xiàn)。這就是Java所做的事情。提取注釋的工具被稱為Javadoc，它是JDK安裝的一部分。它從Java編譯器中采用的一些技術(shù)來查找你在自己編寫程序中寫過的特殊注釋標記。它不僅提取標記這些標記中的信息，也翻出鄰接注釋的類名或方法名稱。這樣你就可以逃脫一些繁瑣工作而專注編寫程序文檔。Javadoc的輸出是一個HTML文件，您可以在Web瀏覽器中查看到它的

13、樣子。因此，Javadoc允許你可以創(chuàng)建和維護一個單一的源文件，并自動生成有用的文檔。由于Javadoc，你有一個簡單的標準來創(chuàng)建文檔，所以你可以期待，甚至要求文件帶有所有Java庫。此外，你可以寫你自己的Javadoc處理程序，叫做doclet，如果你想通過Javadoc對信息進行特殊操作（例如，產(chǎn)生輸出不同的格式）。所以在網(wǎng)址http:/MindV接下來只是一個介紹和Javadoc基礎(chǔ)知識的概述。完整描述可以在JDK文檔中找到。當您打開的文檔，在“tooldocs”子目錄中尋找（或點開“tooldocs”鏈接查找）。句法所有的Javadoc命令只出現(xiàn)在/*的注釋里面。該注釋通常以* /結(jié)束

14、。有兩種主要的方式來使用的Javadoc：嵌入HTML或使用獨立文檔標簽開頭的“”，并放置在注釋行的開始命令“文檔標簽”。（一般以'*開頭'，但通常被忽略。）內(nèi)聯(lián)文檔標簽可以出現(xiàn)在Javadoc注釋的任何地方，也以“”開頭，但被大括號包圍。有三種“類型”的注釋文檔，它們對應(yīng)于位于注釋后面的元素：類，字段或方法。也就是說，一個類評論出現(xiàn)在一個類的定義前面,一個字段注釋出現(xiàn)眼前的一個字段的定義的前面,和一個方法評論出現(xiàn)在定義方法的前面。舉個簡單的例子：/: object/Documentation1.java /* A class comment */ public class D

15、ocumentation1 /* A field comment */ public int i; /* A method comment */ public void f() /: 需要注意的是Javadoc將處理注釋文檔僅用于public和protected成員。Private的注解和包訪問成員（請參閱Access Control 這一章節(jié)）將被忽略，你會看到?jīng)]有輸出。（不過，你可以使用private標記，當然也包括private成員。）這是有道理的，因為只有public和protected成員可在文件之外獲得，這是客戶程序員的角度之外。對于上述代碼的輸出是一個HTML文件，一個具有相同的

16、標準格式作為Java文檔其余部分的文件，因此用戶可以輕松的格式化，并且可以輕松地瀏覽你的類。進入前面的代碼是很值得的，通過Javadoc發(fā)送它，并查看生成結(jié)果的HTML文件。嵌入式HTMLJavadoc通過HTML命令來生成的HTML文檔。這允許你的充分利用HTML;然而，主要的目的是為了讓你格式化代碼，如：/: object/Documentation2.java /* * <pre> * System.out.println(new Date(); * </pre> */ /您還可以使用HTML就像任何其他Web文檔用你自己的描述來格式的普通文本：/: object

17、/Documentation3.java /* * You can <em>even</em> insert a list: * <ol> * <li> Item one * <li> Item two * <li> Item three * </ol> */ /請注意在文檔注釋中，星號在一行的開頭是被Javadoc忽略的，隨著空格。 Javadoc將一切重新格式化，使其符合標準文檔的外觀。不要使用標題，如<H1>和<HR>來嵌入HTML，因為Javadoc會加上自己的標題，而你將影響他

18、們。所有類型的注釋文檔-類，字段和方法，能夠支持嵌入式HTML。一些示例代碼下面是一些可用于代碼文檔的Javadoc標簽。在試圖做任何嚴重的使用Javadoc之前，您應(yīng)該咨詢JDK文檔參考Javadoc，了解所有可以在Javadoc中使用的不同方法。see 這個標簽可以讓你引用其他類的文檔。 Javadoc將生成的HTML超鏈接到其他文檔的see標簽。的形式是：see classname see fully-qualified-classname see fully-qualified-classname#method-name 每添加一個超鏈接“另見”項生成的文檔。 Javadoc將不檢查你

19、給它，以確保它們是有效的超鏈接。link package.class#member label 非常相似see，但它可以通過內(nèi)聯(lián)用，并使用標簽作為超鏈接文本，而不是“另見?！眃ocRoot 生產(chǎn)的相對路徑文檔根目錄。在文檔樹頁中有用的明確的超鏈接。inheritDoc 繼承這個類的最近基類的文檔到當前文檔注釋。version格式如下： version version-information 其中，“版本信息”代表任何適合作為版本說明的資料。若在javadoc 命令行使用了“-version”標記，就會從生成的HTML 文檔里提取出版本信息。author格式如下：author author-in

20、formation 其中，“作者信息”包括您的姓名、電子函件地址或者其他任何適宜的資料。若在javadoc 命令行使用了“-author”標記，就會專門從生成的HTML 文檔里提取出作者信息?？蔀橐幌盗凶髡呤褂枚鄠€這樣的標記，但它們必須連續(xù)放置。全部作者信息會一起存入最終HTML 代碼的單獨一個段落里。since 這個標簽可以讓你以表明這段代碼中開始使用特定功能的版本。你會看到它出現(xiàn)在HTML Java文檔中說明哪些版本的JDK使用。 param這是用于方法的文檔，并具有以下形式：param parameter-name description 其中，“參數(shù)名”是指參數(shù)列表內(nèi)的標識符，而“說明

21、”代表一些可延續(xù)到后續(xù)行內(nèi)的說明文字。一旦遇到一個新文檔標記，就認為前一個說明結(jié)束?？墒褂萌我鈹?shù)量的說明，每個參數(shù)一個。return這是用于方法的文檔，而且看起來是這樣的： return description 其中，“說明”是指返回值的含義。它可延續(xù)到后面的行內(nèi)。throws 異常將在錯誤處理異常這一章被證明。簡單地說，如果一個方法失敗，它們是可以被“拋出”的方法。盡管當你調(diào)用一個方法，只有一個例外對象可以出現(xiàn)，一個特定的方法可能會產(chǎn)生許多不同類型的異常，所有這些都需要描述。所以，形式異常標簽：throws fully-qualified-class-name description 在完全

22、合格的類名給出了某個地方定義的異常類的一個明確的名稱和說明（可延續(xù)到后續(xù)行），告訴你為什么這種特殊類型的異?？梢詮姆椒ㄕ{(diào)用中出現(xiàn)。deprecated這是Java 1.1 的新特性。該標記用于指出一些舊功能已由改進過的新功能取代。該標記的作用是建議用戶不必再使用一種特定的功能，因為未來改版時可能摒棄這一功能。若將一個方法標記為deprecated，則使用該方法時會收到編譯器的警告。文檔示例下面還是我們的第一個Java 程序，只不過已加入了完整的文檔注釋： /: object/HelloDate.java import java.util.*; /* The first Thinking in

23、Java example program. * Displays a string and todays date. * author Bruce Eckel * author www.MindV * version 4.0 */ public class HelloDate /* Entry point to class & application. * param args array of string arguments * throws exceptions No exceptions thrown */ public static void main(String args

24、) System.out.println("Hello, its: "); System.out.println(new Date(); /* Output: (55% match) Hello, its: Wed Oct 05 14:39:36 MDT 2005 */: 該文件的第一行使用我自己的方法“/：”對于包含源文件名的注釋行特殊的標記。該行中包含的路徑信息的文件（對象指示本章）和緊跟其后的文件名。最后一行也是以注釋結(jié)尾，這個（'/：'）表示源代碼列表的結(jié)束，這使得它被檢查編譯之后，能夠被自動更新到這本書的文本。這個/*Output：標簽指示了輸出的

25、開始將由此文件生成。在這種形式中，它可以被自動地進行測試，以驗證其準確性。在這種情況下，（55匹配）指示去測試系統(tǒng)，該系統(tǒng)的輸出將是從一個運行相當不同的下一個，所以應(yīng)該只期望與這里示出的輸出55的相關(guān)性。大多數(shù)的例子在這本書產(chǎn)生輸出將包含在此評論的形式輸出，所以你可以看到輸出，并知道它是正確的。編碼樣式一個非正式的Java 編程標準是大寫一個類名的首字母。若類名由幾個單詞構(gòu)成，那么把它們緊靠到一起（也就是說，不要用下劃線來分隔名字）。此外，每個嵌入單詞的首字母都采用大寫形式。例如： class AllTheColorsOfTheRainbow / .對于其他幾乎所有內(nèi)容：方法、字段（成員變量）

26、以及對象句柄名稱，可接受的樣式與類樣式差不多，只是標識符的第一個字母采用小寫。例如：class AllTheColorsOfTheRainbow int anIntegerRepresentingColors;void changeTheHueOfTheColor(int newHue) / ./ .當然，要注意用戶也必須鍵入所有這些長名字，而且不能輸錯?？偨Y(jié)通過本章的學習，大家已接觸了足夠多的Java 編程知識，已知道如何自行編寫一個簡單的程序。此外，對語言的總體情況以及一些基本思想也有了一定程度的認識。然而，本章所有例子的模式都是單線形式的“這樣做，再那樣做，然后再做另一些事情”。接下來的

27、兩章將介紹在Java編程中使用的基本操作,然后向您展示如何控制程序的流程。2.外文原文Your first Java programFinally, heres the first complete program. It starts by printing a string, an d then the date, using the Date class from the Java standard library. / HelloDate.java import java.util.*; public class HelloDate public static void main(St

28、ring args) System.out.println("Hello, its: "); System.out.println(new Date(); At the beginning of each program file, you must place any necessary import statements to bring in extra classes youll need for the code in that file. Note that I say “extra”. Thats because theres a certain librar

29、y of classes that are automatically brought into every Java file: java.lang. Start up your Web browser and look at the documentation from Sun. (If you havent downloaded the JDK documentation from , do so now.5 Note that this documentation doesnt come packed with the JDK; you must do a separate downl

30、oad to get it.) If you look at the list of the packages, youll see all the different class libraries that come with Java. Select java.lang. This will bring up a list of all the classes that are part of that library. Since java.lang is implicitly included in every Java code file, these classes are au

31、tomatically available. Theres no Date class listed in java.lang, which means you must import another library to use that. If you dont know the library where a particular class is, or if you want to see all of the classes, you can select “Tree” in the Java documentation. Now you can find every single

32、 class that comes with Java. Then you can use the browsers “find” function to find Date. When you do youll see it listed as java.util.Date, which lets you know that its in the util library and that you must import java.util.* in order to use Date. If you go back to the beginning, select java.lang an

33、d then System, youll see that the System class has several fields, and if you select out, youll discover that its a static PrintStream object. Since its static, you dont need to create anything with new. The out object is always there, and you can just use it. What you can do with this out object is

34、 determined by its type: PrintStream. Conveniently, PrintStream is shown in the description as a hyperlink, so if you click on that, youll see a list of all the methods you can call for PrintStream. There are quite a few, and these will be covered later in the book. For now all were interested in is

35、 println( ), which in effect means “Print what Im giving you out to the console and end with a newline.” Thus, in any Java program you write you can write something like this: System.out.println("A String of things"); whenever you want to display information to the console. The name of the

36、 class is the same as the name of the file. When youre creating a standalone program such as this one, one of the classes in the file must have the same name as the file. (The compiler complains if you dont do this.) That class must contain a method called main( ) with this signature and return type

37、: public static void main(String args) The public keyword means that the method is available to the outside world (described in detail in the Access Control chapter). The argument to main( ) is an array of String objects. The args wont be used in this program, but the Java compiler insists that they

38、 be there because they hold the arguments from the command line. The line that prints the date is quite interesting: System.out.println(new Date(); The argument is a Date object that is being created just to send its value (which is automatically converted to a String) to println( ). As soon as this

39、 statement is finished, that Date is unnecessary, and the garbage collector can come along and get it anytime. We dont need to worry about cleaning it up. When you look at the JDK documentation from , you will see that System has many other methods that allow you to produce interesting effects (one

40、of Javas most powerful assets is its large set of standard libraries). For example: /: object/ShowProperties.java public class ShowProperties public static void main(String args) System.getProperties().list(System.out); System.out.println(System.getProperty(""); System.out.println

41、( System.getProperty("java.library.path"); /: The first line in main( ) displays all of the “properties” from the system where you are running the program, so it gives you environment information. The list( ) method sends the results to its argument, System.out. You will see later in the b

42、ook that you can send the results elsewhere, to a file, for example. You can also ask for a specific propertyin this case, the user name and java.library.path. (The unusual comments at the beginning and end will be explained a little later.) Compiling and running To compile and run this program, and

43、 all the other programs in this book, you must first have a Java programming environment. There are a number of third-party development environments, but in this book I will assume that you are using the Java Developers Kit (JDK) from Sun, which is free. If you are using another development system,6

44、 you will need to look in the documentation for that system to determine how to compile and run programs. Get on the Internet and go to . There you will find information and links that will lead you through the process of downloading and installing the JDK for your particular platform. Once the JDK

45、is installed, and youve set up your computers path information so that it will find javac and java, download and unpack the source code for this book (you can find it at www.MindV). This will create a subdirectory for each chapter in this book. Move to the subdirectory named objects and type: javac

46、HelloDate.java This command should produce no response. If you get any kind of an error message, it means you havent installed the JDK properly and you need to investigate those problems. On the other hand, if you just get your command prompt back, you can type: java HelloDate and youll get the mess

47、age and the date as output. This is the process you can use to compile and run each of the programs in this book. However, you will see that the source code for this book also has a file called build.xml in each chapter, and this contains “Ant” commands for automatically building the files for that

48、chapter. Buildfiles and Ant (including where to download it) are described more fully in the supplement you will find at http:/MindV but once you have Ant installed (from /ant) you can just type ant at the command prompt to compile and run the programs in each chapter. If you

49、 havent installed Ant yet, you can just type the javac and java commands by hand. Comments and embedded documentation There are two types of comments in Java. The first is the traditional C-style comment that was inherited by C+. These comments begin with a /* and continue, possibly across many line

50、s, until a */. Note that many programmers will begin each line of a continued comment with a *, so youll often see: /* This is a comment * that continues * across lines */ Remember, however, that everything inside the /* and */ is ignored, so theres no difference in saying: /* This is a comment that

51、 continues across lines */ The second form of comment comes from C+. It is the single-line comment, which starts with a / and continues until the end of the line. This type of comment is convenient and commonly used because its easy. You dont need to hunt on the keyboard to find / and then * (instea

52、d, you just press the same key twice), and you dont need to close the comment. So you will often see: / This is a one-line comment Comment documentation Possibly the biggest problem with documenting code has been maintaining that documentation. If the documentation and the code are separate, it beco

53、mes tedious to change the documentation every time you change the code. The solution seems simple: Link the code to the documentation. The easiest way to do this is to put everything in the same file. To complete the picture, however, you need a special comment syntax to mark the documentation and a

54、 tool to extract those comments and put them in a useful form. This is what Java has done. The tool to extract the comments is called Javadoc, and it is part of the JDK installation. It uses some of the technology from the Java compiler to look for special comment tags that you put in your programs.

55、 It not only extracts the information marked by these tags, but it also pulls out the class name or method name that adjoins the comment. This way you can get away with the minimal amount of work to generate decent program documentation. The output of Javadoc is an HTML file that you can view with y

56、our Web browser. Thus, Javadoc allows you to create and maintain a single source file and automatically generate useful documentation. Because of Javadoc, you have a straightforward standard for creating documentation, so you can expect or even demand documentation with all Java libraries. In additi

57、on, you can write your own Javadoc handlers, called doclets, if you want to perform special operations on the information processed by Javadoc (to produce output in a different format, for example). Doclets are introduced in the supplement at http:/MindV What follows is only an introduction and overview of the basics of Javadoc. A thorough description can be found in the JDK documentation. When you unp