java.util.List

public interface List<E>

有序的 collection（也稱為序列）。此介面的使用者可以對列表中每個元素的插入位置進行精確地控制。使用者可以根據元素的整數索引（在列表中的位置）訪問元素，並搜尋列表中的元素。

與 set 不同，列表通常允許重複的元素。更確切地講，列表通常允許滿足 e1.equals(e2) 的元素對 e1 和 e2，並且如果列表本身允許 null 元素的話，通常它們允許多個 null 元素。難免有人希望通過在使用者嘗試插入重複元素時丟擲執行時異常的方法來禁止重複的列表，但我們希望這種用法越少越好。

List 介面在 iterator、add、remove、equals 和 hashCode 方法的協定上加了一些其他約定，超過了 Collection 介面中指定的約定。為方便起見，這裡也包括了其他繼承方法的宣告。

List 介面提供了 4 種對列表元素進行定位（索引）訪問方法。列表（像 Java 陣列一樣）是基於 0 的。注意，這些操作可能在和某些實現（例如 LinkedList 類）的索引值成比例的時間內執行。因此，如果呼叫者不知道實現，那麼在列表元素上迭代通常優於用索引遍歷列表。

List 介面提供了特殊的迭代器，稱為 ListIterator，除了允許 Iterator 介面提供的正常操作外，該迭代器還允許元素插入和替換，以及雙向訪問。還提供了一個方法來獲取從列表中指定位置開始的列表迭代器。

List 介面提供了兩種搜尋指定物件的方法。從效能的觀點來看，應該小心使用這些方法。在很多實現中，它們將執行高開銷的線性搜尋。

List 介面提供了兩種在列表的任意位置高效插入和移除多個元素的方法。

注意：儘管列表允許把自身作為元素包含在內，但建議要特別小心：在這樣的列表上，equals 和 hashCode 方法不再是定義良好的。

某些列表實現對列表可能包含的元素有限制。例如，某些實現禁止 null 元素，而某些實現則對元素的型別有限制。試圖新增不合格的元素會丟擲未經檢查的異常，通常是 NullPointerException 或 ClassCastException。試圖查詢不合格的元素是否存在可能會丟擲異常，也可能簡單地返回 false；某些實現會採用前一種行為，而某些則採用後者。概括地說，試圖對不合格元素執行操作時，如果完成該操作後不會導致在列表中插入不合格的元素，則該操作可能丟擲一個異常，也可能成功，這取決於實現的選擇。此介面的規範中將這樣的異常標記為“可選”。

java.awt.List

public class List

List 元件為使用者提供了一個可滾動的文字項列表。可設定此 list，使其允許使用者進行單項或多項選擇。

例如以下程式碼：

 List lst = new List(4, false);
 lst.add("Mercury");
 lst.add("Venus");
 lst.add("Earth");
 lst.add("JavaSoft");
 lst.add("Mars");
 lst.add("Jupiter");
 lst.add("Saturn");
 lst.add("Uranus");
 lst.add("Neptune");
 lst.add("Pluto");
 cnt.add(lst);
 

當 cnt 為容器時，將生成以下滾動列表：

如果 List 允許進行多項選擇，則單擊已選中的項時，將取消選中該項。在上面的示例中，一次只能從滾動列表中選擇一項，因為建立新的滾動列表時，第二個引數為 false。如果 List 不允許進行多項選擇，則選擇某一項會導致其他選中的項取消選中。

注意，本示例中顯示的列表是用四個可視行建立的。建立該列表之後，不可更改可視行的數量。預設的 List 是用四行建立的，所以 lst = new List() 與 list = new List(4, false) 等效。

從 Java 1.1 開始，AWT（Abstract Window Toolkit，抽象視窗工具包）會把列表上發生的所有滑鼠、鍵盤和焦點事件傳送給 List 物件。（維護舊的 AWT 事件模型的目的是為了向後相容，不推薦使用它。）

當用戶選中或取消選中某項時，AWT 將向列表傳送一個 ItemEvent 例項。當用戶雙擊滾動列表中的某一項時，AWT 會在緊隨項事件後向列表傳送一個 ActionEvent 例項。當用戶選中列表中的某項，按下 return 鍵時，AWT 也會生成一個動作事件。

如果應用程式需要基於此列表中使用者選中或啟用的項執行某個動作，則應該相應地實現 ItemListener 或 ActionListener，並註冊新的偵聽器，以便在此列表中接收事件。

對於多項選擇滾動列表，使用外部動作（如單擊按鈕）來觸發動作被認為是一種更好的使用者介面。