本節書摘來異步社群《android遊戲開發詳解》一書中的第2章，第2.19節，作者： 【美】jonathan s. harbour 譯者： 李強 責編： 陳冀康，更多章節内容可以通路雲栖社群“異步社群”公衆号檢視。
android遊戲開發詳解
讓我們通過使用熟悉的一個類string，來練習一下如何使用java文檔。建立一個名為funwithstrings的新的java項目，并且建立一個名為stringtester的、帶有main方法的新的類，如程式清單2.18所示。
程式清單2.18 stringtester.java——空的版本
string類（它隐藏于java庫之中）允許我們在自己的代碼中建立string對象。讓我們使用用于初始化對象的new關鍵字，來初始化一個string對象。在main方法中添加如下代碼。
字元串是如此的常用，以至于java提供了一種特殊的方法來初始化它們。再添加如下的一行代碼。
程式清單2.19給出了更新後的類。
程式清單2.19 stringtester.java——更新的版本
像其他的java對象一樣，strings也有狀态和行為。在本書中，我們将隻關注strings的行為，其狀态對于我們來說沒有用。
讓我們現在來使用java文檔。搜尋string 類，并且向下滾動到method summary。你會發現，這裡給出了string對象可用的方法的一個清單。如圖2-24所示。
這個表中的單個條目，告訴我們每個方法的傳回類型，以及方法名、所需的參數（輸入）和方法概覽。
string有一個方法，可以從一個指定的位置（稱為索引）擷取一個單個的字元（類型為char）。這個方法名為charat()，它接受一個整數值，表示想要的字元的索引。
java中的索引值是基于0的，這意味着，第一個字元的索引為0。讓我們看一下這在代碼中意味着什麼。我們将調用charat()方法，并且檢視string s中的第3個字元（索引2），如程式清單2.20中第7行代碼所示。
程式清單2.20 列印出一個字元串中的字元
相應的輸出如下所示。
讓我們來看看使用java文檔的另一個例子。查找method summary。能否找到一個方法，它傳回給定的string的長度。浏覽method summary，會找到圖2-25所示的内容。
這張圖告訴我們要使用length()方法所需的所有資訊。我們知道，它傳回一個整數來表示調用該方法的string的長度。該方法沒有參數。讓我們嘗試得到s和s2的長度，并且判定哪一個更長。修改stringtester類，使其如程式清單2.21所示；新的代碼在第10行到第19行。
程式清單2.21 stringtester.java（更新版本）
運作該代碼，将會得到如下所示的結果。
我鼓勵你嘗試一下java文檔中列出的其他方法。能夠使用java文檔，這是一項重要的技能。和其他所有值得做的事情一樣，隻有通過練習才能較好地掌握。記住如下幾件事情。
① 傳回類型：（這決定了需要在結果中存儲什麼類型的變量）。
② 方法名稱：（必須完全像顯示的那樣拼寫。方法名稱是區分大小寫的）。
③ 輸入：（必須總是提供為了讓方法工作而所需的參數。這包括提供正确的參數個數和正确的類型）。
④ 一些方法要求charsequence類型的輸入。當你遇到這樣的方法的時候，你可能要提供一個string。這是因為有一種有趣的特性叫作多态（polymorphism，即一個對象能夠采取多種形式的能力），我們将會在下一章中詳細讨論它。