javax.management.relation
類別 RoleList

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractList<E>
          java.util.ArrayList<Object>
              javax.management.relation.RoleList

所有已實作的介面：

Serializable, Cloneable, Iterable<Object>, Collection<Object>, List<Object>, RandomAccess

public class RoleList
extends ArrayList<Object>

RoleList 表示角色（Role 物件）的列表。它在創建關係和試圖在關係中設置幾個角色（通過 'setRoles()'方法）時用作參數。它將作為 RoleResult 的一部分返回，以提供成功檢索的角色。

從以下版本開始：

1.5

另請參見：

序列化表格

欄位摘要

從類別 java.util.AbstractList 繼承的欄位

modCount

建構子摘要

RoleList()
建構一個空的 RoleList。

RoleList(int initialCapacity)
建構一個具有指定初始容量的空 RoleList。

RoleList(List<Role> list)
建構一個套件含指定 List 元素的 RoleList，這些元素按 List 迭代器返回的順序排列。

方法摘要

void	add(int index, Object element) 將指定的元素插入此列表中的指定位置。
void	add(int index, Role role) 插入指定為指定位置處的元素的角色。
boolean	add(Object o) 將指定的元素添加到此列表的尾部。
void	add(Role role) 添加指定為列表中最後一個元素的 Role。
boolean	addAll(Collection<?> c) 按照指定 collection 的迭代器所返回的元素順序，將該 collection 中的所有元素添加到此列表的尾部。
boolean	addAll(int index, Collection<?> c) 從指定的位置開始，將指定 collection 中的所有元素插入到此列表中。
boolean	addAll(int index, RoleList roleList) 從指定位置開始，將指定 RoleList 中的所有元素插入此列表，這些元素按指定 RoleList 的迭代器返回的順序排列。
boolean	addAll(RoleList roleList) 將指定 RoleList 中的所有元素追加到列表末尾，這些元素按指定 RoleList 的迭代器返回的順序排列。
List<Role>	asList() 以 List<Role> 的形式返回此列表的示圖。
Object	set(int index, Object element) 用指定的元素替代此列表中指定位置上的元素。
void	set(int index, Role role) 將指定位置處的元素設置為指定角色。

從類別 java.util.ArrayList 繼承的方法

clear, clone, contains, ensureCapacity, get, indexOf, isEmpty, lastIndexOf, remove, remove, removeRange, size, toArray, toArray, trimToSize

從類別 java.util.AbstractList 繼承的方法

equals, hashCode, iterator, listIterator, listIterator, subList

從類別 java.util.AbstractCollection 繼承的方法

containsAll, removeAll, retainAll, toString

從類別 java.lang.Object 繼承的方法

finalize, getClass, notify, notifyAll, wait, wait, wait

從介面 java.util.List 繼承的方法

containsAll, equals, hashCode, iterator, listIterator, listIterator, removeAll, retainAll, subList

建構子詳細資訊

RoleList

public RoleList()

建構一個空的 RoleList。

RoleList

public RoleList(int initialCapacity)

建構一個具有指定初始容量的空 RoleList。

參數：

initialCapacity - 初始容量

RoleList

public RoleList(List<Role> list)
         throws IllegalArgumentException

建構一個套件含指定 List 元素的 RoleList，這些元素按 List 迭代器返回的順序排列。RoleList 實例的初始容量是指定 List 大小的 110％。

參數：

list - 定義新 RoleList 初始內容的 List。

拋出：

IllegalArgumentException - 如果 list 參數為 null 或者 list 參數包含任何非 Role 物件。

另請參見：

ArrayList.ArrayList(java.util.Collection)

方法詳細資訊

asList

public List<Role> asList()

以 List<Role> 的形式返回此列表的示圖。對返回值的更改將通過對原 RoleList 的更改反映出來，反之亦然。

返回：

一個 List<Role>，其內容反映此 RoleList 的內容。

如果曾經對給定的 RoleList 實例調用過此方法，則之後試圖對該實例添加非 Role 物件的操作將會失敗，並拋出 IllegalArgumentException。出於相容性原因，允許向從未調用過此方法的 RoleList 添加非 Role 物件。

拋出：

IllegalArgumentException - 如果此 RoleList 套件含非 Role 元素。

從以下版本開始：

1.6

add

public void add(Role role)
         throws IllegalArgumentException

添加指定為列表中最後一個元素的 Role。

參數：

role - 要添加的角色。

拋出：

IllegalArgumentException - 如果角色為 null。

add

public void add(int index,
                Role role)
         throws IllegalArgumentException,
                IndexOutOfBoundsException

插入指定為指定位置處的元素的角色。將其索引大於或等於當前位置的元素上移。

參數：

index - 在列表中要插入新 Role 物件的位置。

role - 要插入的 Role 物件。

拋出：

IllegalArgumentException - 如果角色為 null。

IndexOutOfBoundsException - 如果用列表之外的索引存取。

set

public void set(int index,
                Role role)
         throws IllegalArgumentException,
                IndexOutOfBoundsException

將指定位置處的元素設置為指定角色。丟棄該位置以前的元素。

參數：

index - 指定的位置。

role - 角色元素應該設置為的值。

拋出：

IllegalArgumentException - 如果角色為 null。

IndexOutOfBoundsException - 如果用列表之外的索引存取。

addAll

public boolean addAll(RoleList roleList)
               throws IndexOutOfBoundsException

將指定 RoleList 中的所有元素追加到列表末尾，這些元素按指定 RoleList 的迭代器返回的順序排列。

參數：

roleList - 要插入列表的元素（可以為 null）

返回：

如果此列表由於調用而更改，則返回 true。

拋出：

IndexOutOfBoundsException - 如果用列表之外的索引存取。

另請參見：

ArrayList.addAll(Collection)

addAll

public boolean addAll(int index,
                      RoleList roleList)
               throws IllegalArgumentException,
                      IndexOutOfBoundsException

從指定位置開始，將指定 RoleList 中的所有元素插入此列表，這些元素按指定 RoleList 的迭代器返回的順序排列。

參數：

index - 插入指定 RoleList 中第一個元素的位置。

roleList - 要插入該列表的元素。

返回：

如果此列表由於調用而更改，則返回 true。

拋出：

IllegalArgumentException - 如果角色為 null。

IndexOutOfBoundsException - 如果用列表之外的索引存取。

另請參見：

ArrayList.addAll(int, Collection)

add

public boolean add(Object o)

從類別 ArrayList 複製的描述

將指定的元素添加到此列表的尾部。

指定者：

介面 Collection<Object> 中的 add

指定者：

介面 List<Object> 中的 add

覆寫：

類別 ArrayList<Object> 中的 add

參數：

o - 要添加到此列表中的元素

返回：

true（按照 Collection.add(E) 的指定）

add

public void add(int index,
                Object element)

從類別 ArrayList 複製的描述

將指定的元素插入此列表中的指定位置。向右移動當前位於該位置的元素（如果有）以及所有後續元素（將其索引加 1）。

指定者：

介面 List<Object> 中的 add

覆寫：

類別 ArrayList<Object> 中的 add

參數：

index - 指定元素所插入位置的索引

element - 要插入的元素

addAll

public boolean addAll(Collection<?> c)

從類別 ArrayList 複製的描述

按照指定 collection 的迭代器所返回的元素順序，將該 collection 中的所有元素添加到此列表的尾部。如果正在進行此操作時修改指定的 collection ，那麼此操作的行為是不確定的。（這意味著如果指定的 collection 是此列表且此列表是非空(null)的，那麼此調用的行為是不確定的）。

指定者：

介面 Collection<Object> 中的 addAll

指定者：

介面 List<Object> 中的 addAll

覆寫：

類別 ArrayList<Object> 中的 addAll

參數：

c - 套件含要添加到此列表中的元素的 collection

返回：

如果此列表由於調用而發生更改，則返回 true

另請參見：

AbstractCollection.add(Object)

addAll

public boolean addAll(int index,
                      Collection<?> c)

從類別 ArrayList 複製的描述

從指定的位置開始，將指定 collection 中的所有元素插入到此列表中。向右移動當前位於該位置的元素（如果有）以及所有後續元素（增加其索引）。新元素將按照指定 collection 的迭代器所返回的元素順序出現在列表中。

指定者：

介面 List<Object> 中的 addAll

覆寫：

類別 ArrayList<Object> 中的 addAll

參數：

index - 插入指定 collection 中的首個元素的位置索引

c - 套件含要添加到此列表中元素的 collection

返回：

如果此列表由於調用而發生更改，則返回 true

set

public Object set(int index,
                  Object element)

從類別 ArrayList 複製的描述

用指定的元素替代此列表中指定位置上的元素。

指定者：

介面 List<Object> 中的 set

覆寫：

類別 ArrayList<Object> 中的 set

參數：

index - 要替代的元素的索引

element - 存儲在指定位置上的元素

返回：

以前位於該指定位置上的元素