對於Java語言，最體貼的一項設計就是它並沒有打算讓人們為了寫程序而寫程序——人們也需要考慮程序的文檔化問題。對於程序的文

所有javadoc命令都只能出現於“/**”注釋中。但和平常一樣，注釋結束於一個“*/”。主要通過

javadoc將HTML命令傳遞給最終生成的HTML文檔。這便使我們能夠充分利用HTML的巨大威力。當然，我們的最終動機是格式化代碼，不是為了嘩眾

所有三種類型的注釋文檔都可包含@see標記，它允許我們引用其他類裡的文檔。對於這個標記，javadoc會生成相應的HTML，將其直接鏈接到其他文檔

隨同嵌入HTML和@see引用，類文檔還可以包括用於版本信息以及作者姓名的標記。類文檔亦可用於“接口”目的（本書後面會詳細

除嵌入HTML和@see引用之外，方法還允許使用針對參數、返回值以及違例的文檔標記。1. @param格式如下：@param 參數名 說明其中，&

一個非正式的Java編程標准是大寫一個類名的首字母。若類名由幾個單詞構成，那麼把它們緊靠到一起（也就是說，不要用下劃線來分隔名字）。此外，每個嵌入

運算符以一個或多個自變量為基礎，可生成一個新值。自變量采用與原始方法調用不同的一種形式，但效果是相同的。根據以前寫程序的經驗，運算符的常規概念應該

運算符的優先級決定了存在多個運算符時一個表達式各部分的計算順序。Java對計算順序作出了特別的規定。其中，最簡單的規則就是乘法和除法在加法和減法之

賦值是用等號運算符（=）進行的。它的意思是“取得右邊的值，把它復制到左邊”。右邊的值可以是任何常數、變量或者表達式，只要能

Java的基本算術運算符與其他大多數程序設計語言是相同的。其中包括加號（+）、減號（-）、除號（/）、乘號（*）以及模數（%，從整數除法中獲得余數

和C類似，Java提供了豐富的快捷運算方式。這些快捷運算可使代碼更清爽，更易錄入，也更易讀者辨讀。兩種很不錯的快捷運算方式是遞增和遞減運算符（常稱

關系運算符生成的是一個“布爾”（Boolean）結果。它們評價的是運算對象值之間的關系。若關系是真實的，關系表達式會生成t

邏輯運算符AND（&&）、OR（||）以及NOT（!）能生成一個布爾值（true或false）——以自變量

按位運算符允許我們操作一個整數主數據類型中的單個“比特”，即二進制位。按位運算符會對兩個自變量中對應的位執行布爾代數，並最

移位運算符面向的運算對象也是二進制的“位”。可單獨用它們處理整數類型（主類型的一種）。左移位運算符（<<）能將

這種運算符比較罕見，因為它有三個運算對象。但它確實屬於運算符的一種，因為它最終也會生成一個值。這與本章後一節要講述的普通if-else語句是不同的

這個運算符在Java裡有一項特殊用途：連接不同的字串。這一點已在前面的例子中展示過了。盡管與+的傳統意義不符，但用+來做這件事情仍然是非常自然的。

使用運算符的一個缺點是括號的運用經常容易搞錯。即使對一個表達式如何計算有絲毫不確定的因素，都容易混淆括號的用法。這個問題在Java裡仍然存在。在C

“造型”（Cast）的作用是“與一個模型匹配”。在適當的時候，Java會將一種數據類型自動轉換成另