java.util.concurrent
클래스 CopyOnWriteArrayList<E>

java.lang.Object 
  java.util.concurrent.CopyOnWriteArrayList<E>

형태 파라미터:

E - 컬렉션내에 존재하는 요소의 형태

모든 구현된 인터페이스:

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

public class CopyOnWriteArrayList<E>
extends Object 
implements List <E>, RandomAccess,
 Cloneable,
 Serializable 

기본으로 되는 배열의 새로운 복사본을 작성함으로써 모든 변경 조작 (추가 설정등)이 구현되는 ArrayList thread 세이프인 변수입니다.

보통, 이것은 매우 효율이 나쁩니다만, traversal 조작이 변경을 수의 점으로써 큰폭으로 웃도는 경우에는 대체 수단보다 효율이 좋은 경우가 있습니다. 또, 이것은 traversal을 동기 할 수 없는지, 그렇게 하는 것을 바라지 않지만, 병행 thread간의 간섭을 배제할 필요가 있는 경우에 유용합니다. 「snapshot」스타일의 반복자 메서드는 반복자의 작성 시점에서의 배열 상태에의 참조를 사용합니다. 이 배열이, 반복자의 유효기간내로 변경되는 것은 결코 없기 때문에 간섭은 불가능하고, 반복자는 ConcurrentModificationException을 Throw 하지 않는 것이 보증됩니다. 반복자는 반복자의 작성 이후의 리스트에의 추가 삭제, 또는 변경을 반영하지 않습니다. 반복자 자신에 대한 요소 변경 조작 (삭제, 설정 및 추가)은 지원 되지 않습니다. 이러한 메서드는 UnsupportedOperationException을 Throw 합니다.

이 클래스는 Java Collections Framework 멤버입니다.

도입된 버전 :

1.5

관련 항목:

직렬화 된 형식

생성자 개요

CopyOnWriteArrayList ()
비어있는 리스트를 작성합니다.

CopyOnWriteArrayList (Collection <? extends E > c)
지정된 Collection 요소를 포함한 리스트를, Collection 반복자에 의해 리턴된 순서로 작성합니다.

CopyOnWriteArrayList (E [] toCopyIn)
지정된 배열의 복사본을 보관 유지하는 CopyOnWriteArrayList를 새롭게 작성합니다.

메서드 개요

boolean	add (E element) 리스트의 마지막으로 지정된 요소를 추가합니다.
void	add (int index, E element) 리스트의 지정된 위치에 지정된 요소를 삽입합니다.
boolean	addAll (Collection <? extends E > c) 지정된 Collection 내의 모든 요소를, 지정된 Collection 반복자에 의해 리턴된 순서로 이 리스트의 마지막에 추가합니다.
boolean	addAll (int index, Collection <? extends E > c) 리스트내의 지정된 위치로부터, 지정된 Collection 모든 요소를 삽입합니다.
int	addAllAbsent (Collection <? extends E > c) 이 리스트에 포함되지 않은 지정된 Collection 내의 모든 요소를, 지정된 Collection 반복자에 의해 리턴된 순서로 이 리스트의 마지막에 추가합니다.
boolean	addIfAbsent (E element) 요소가 존재하지 않는 경우, 요소를 추가합니다.
void	clear () 리스트로부터 모든 요소를 삭제합니다.
Object	clone () 리스트의 샤로코피를 리턴합니다.
boolean	contains (Object elem) 리스트로 지정된 요소가 있는 경우에 true를 리턴합니다.
boolean	containsAll (Collection <? > c) 이 Collection 내에 지정된 Collection 모든 요소가 있는 경우에 true를 리턴합니다.
boolean	equals (Object o) 지정된 Object가 List와 동일한지 어떤지를 비교합니다.
E	get (int index) 리스트내의 지정된 위치에 있는 요소를 리턴합니다.
int	hashCode () 이 List 해시 코드값을 리턴합니다.
int	indexOf (E elem, int index) equals 메서드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소가 지정된 index로 부터 검색합니다.
int	indexOf (Object elem) equals 메서드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소를 선두로부터 검색합니다.
boolean	isEmpty () 리스트에 요소가 있는지 없는지를 판정합니다.
Iterator <E >	iterator () 이 컬렉션에 포함되는 요소의 Iterator를 리턴합니다.
int	lastIndexOf (E elem, int index) 지정된 인덱스로부터 후 방향으로 지정된 객체를 검색해, 검출된 인덱스를 리턴합니다.
int	lastIndexOf (Object elem) 지정된 객체가 리스트내에서 마지막에 나타나는 인덱스를 리턴합니다.
ListIterator <E >	listIterator () 이 List 내의 요소의 Iterator를 적절한 순서로 리턴합니다.
ListIterator <E >	listIterator (int index) 이 List 내의 요소의 ListIterator를, List 내의 지정된 위치로부터 시작되어 적절한 순서로 리턴합니다.
E	remove (int index) 리스트내의 지정된 위치로부터 요소를 삭제합니다.
boolean	remove (Object o) 지정된 요소의 인스턴스가 이 리스트에 있으면, 그 인스턴스를 리스트로부터 1개 삭제합니다 (임의의 오퍼레이션).
boolean	removeAll (Collection <? > c) 지정된 Collection에 포함되는 모든 요소를, 이 Collection 로부터 삭제합니다.
boolean	retainAll (Collection <? > c) 이 Collection에 대해, 지정된 Collection에 포함되고 있는 요소만을 보관 유지합니다 (임의의 오퍼레이션).
E	set (int index, E element) 리스트의 지정된 위치에 있는 요소를, 지정된 요소로 옮겨놓습니다.
int	size () 리스트내에 있는 요소의 수를 리턴합니다.
List <E >	subList (int fromIndex, int toIndex) 이 List fromIndex (이것을 포함한다)와 toIndex (이것을 포함하지 않는다)의 사이의 부분의 뷰를 리턴합니다.
Object []	toArray () 리스트내의 모든 요소가 올바른 순서로 포함되고 있는 배열을 리턴합니다.
<T> T[]	toArray (T[] a) 리스트내의 모든 요소가 올바른 순서로 포함되고 있는 배열을 리턴합니다.
String	toString () 각 요소의 String 표현을 보관 유지하고 있는 Collection 캐릭터 라인 표현을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

CopyOnWriteArrayList

public CopyOnWriteArrayList()

비어있는 리스트를 작성합니다.

CopyOnWriteArrayList

public CopyOnWriteArrayList(Collection <?  extends E > c)

지정된 Collection 요소를 포함한 리스트를, Collection 반복자에 의해 리턴된 순서로 작성합니다.

파라미터:

c - 최초로 보관 유지하고 있던 요소의 컬렉션

CopyOnWriteArrayList

public CopyOnWriteArrayList(E [] toCopyIn)

지정된 배열의 복사본을 보관 유지하는 CopyOnWriteArrayList를 새롭게 작성합니다.

파라미터:

toCopyIn - 배열 (이 배열의 카피는 내부 배열로서 사용된다)

메서드의 상세

size

public int size()

리스트내에 있는 요소의 수를 리턴합니다.

정의:

인터페이스 Collection <E > 내의 size

정의:

인터페이스 List <E > 내의 size

반환값:

리스트내의 요소수

isEmpty

public boolean isEmpty()

리스트에 요소가 있는지 없는지를 판정합니다.

정의:

인터페이스 Collection <E > 내의 isEmpty

정의:

인터페이스 List <E > 내의 isEmpty

반환값:

리스트에 요소가 없는 경우는 true, 그렇지 않은 경우는 false

contains

public boolean contains(Object  elem)

리스트로 지정된 요소가 있는 경우에 true를 리턴합니다.

정의:

인터페이스 Collection <E > 내의 contains

정의:

인터페이스 List <E > 내의 contains

파라미터:

elem - 리스트에 있을지 어떨지를 조사하는 요소

반환값:

지정된 요소가 있는 경우는 true, 그렇지 않은 경우는 false

indexOf

public int indexOf(Object  elem)

equals 메서드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소를 선두로부터 검색합니다.

정의:

인터페이스 List <E > 내의 indexOf

파라미터:

elem - 객체

반환값:

리스트내에서 인수가 최초로 나타나는 인덱스. 객체가 발견되지 않는 경우는 -1

관련 항목:

Object.equals(Object)

indexOf

public int indexOf(E  elem,
                   int index)

equals 메서드를 사용해 동일한지 어떤지를 판정하면서, 지정된 인수와 같은 내용의 요소가 지정된 index로 부터 검색합니다.

파라미터:

elem - 객체

index - 검색을 개시하는 위치의 인덱스

반환값:

객체 인수가 List 내에서 최초로 나타나는 인덱스 (List index 또는 그 이후의 위치). 객체가 발견되지 않는 경우는 -1

관련 항목:

Object.equals(Object)

lastIndexOf

public int lastIndexOf(Object  elem)

지정된 객체가 리스트내에서 마지막에 나타나는 인덱스를 리턴합니다.

정의:

인터페이스 List <E > 내의 lastIndexOf

파라미터:

elem - 목적의 요소

반환값:

리스트로 지정된 객체와 일치하는 마지막 객체의 인덱스. 객체가 발견되지 않는 경우는 -1

lastIndexOf

public int lastIndexOf(E  elem,
                       int index)

지정된 인덱스로부터 후 방향으로 지정된 객체를 검색해, 검출된 인덱스를 리턴합니다.

파라미터:

elem - 목적의 요소

index - 검색을 개시하는 위치의 인덱스

반환값:

지정된 객체가 List 내에서 마지막에 나타나는 인덱스 (List 인덱스보다 전의 위치). 객체가 발견되지 않는 경우는 -1

clone

public Object  clone()

리스트의 샤로코피를 리턴합니다. 요소 자체는 카피되지 않습니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 리스트의 복제

관련 항목:

Cloneable

toArray

public Object [] toArray()

리스트내의 모든 요소가 올바른 순서로 포함되고 있는 배열을 리턴합니다.

정의:

인터페이스 Collection <E > 내의 toArray

정의:

인터페이스 List <E > 내의 toArray

반환값:

리스트내의 모든 요소가 올바른 순서로 포함되고 있는 배열

관련 항목:

Arrays.asList(Object[])

toArray

public <T> T[] toArray(T[] a)

리스트내의 모든 요소가 올바른 순서로 포함되고 있는 배열을 리턴합니다. 리턴된 배열의 실행시의 형태는 지정된 배열의 형태가 됩니다. 지정된 배열에 리스트가 들어가는 경우는 그 배열에 리턴됩니다 . 그 외의 경우는 지정된 배열의 실행시의 형태와 리스트의 사이즈를 사용해 새로운 배열을 할당할 수 있습니다.

지정된 배열에 리스트가 들어가도 또한 스페이스가 있는 경우, 즉 배열에 리스트보다 많은 요소가 있는 경우는 컬렉션의 마지막 직후에 있는 배열내의 요소는 null 로 설정됩니다. 이것은 호출측이 리스트에 null 요소가 포함되지 않은 것을 알고 있는 경우에는 리스트의 길이를 판정하는데 이용할 수 있습니다.

정의:

인터페이스 Collection <E > 내의 toArray

정의:

인터페이스 List <E > 내의 toArray

파라미터:

a - 배열이 충분한 크기를 가지는 경우는 리스트의 요소가 포함되는 배열. 그렇지 않은 경우는 요소를 포함하기 위해서 같은 실행시의 형태의 새로운 배열을 할당할 수 있다

반환값:

리스트의 요소가 포함되고 있는 배열

예외:

ArrayStoreException - a 실행시의 형태가 리스트내의 각 요소의 실행시의 형태의 슈퍼타입이 아닌 경우

get

public E  get(int index)

리스트내의 지정된 위치에 있는 요소를 리턴합니다.

정의:

인터페이스 List <E > 내의 get

파라미터:

index - 리턴된 요소의 인덱스

반환값:

리스트내의 지정된 위치에 있는 요소

예외:

IndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index >= size())

set

public E  set(int index,
             E  element)

리스트의 지정된 위치에 있는 요소를, 지정된 요소로 옮겨놓습니다.

정의:

인터페이스 List <E > 내의 set

파라미터:

index - 치환되는 요소의 인덱스

element - 지정된 위치에 포함되는 요소

반환값:

지정된 위치에 이전 있던 요소

예외:

IndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index >= size())

add

public boolean add(E  element)

리스트의 마지막으로 지정된 요소를 추가합니다.

정의:

인터페이스 Collection <E > 내의 add

정의:

인터페이스 List <E > 내의 add

파라미터:

element - 리스트에 추가되는 요소

반환값:

true (Collection.add 범용 규약 대로)

add

public void add(int index,
                E  element)

리스트의 지정된 위치에 지정된 요소를 삽입합니다. 현재 그 위치에 있는 요소와 후속의 요소는 오른쪽으로 이동합니다 (인덱스치에 1을 가산).

정의:

인터페이스 List <E > 내의 add

파라미터:

index - 지정된 요소가 삽입되는 인덱스

element - 삽입되는 요소

예외:

IndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index > size())

remove

public E  remove(int index)

리스트내의 지정된 위치로부터 요소를 삭제합니다. 그리고, 후속의 요소를 좌측으로 이동해, 각각의 인덱스로부터 1을 감산합니다.

정의:

인터페이스 List <E > 내의 remove

파라미터:

index - 삭제되는 요소의 인덱스

반환값:

리스트로부터 삭제한 요소

예외:

IndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index >= size())

remove

public boolean remove(Object  o)

지정된 요소의 인스턴스가 이 리스트에 있으면, 그 인스턴스를 리스트로부터 1개 삭제합니다 (임의의 오퍼레이션). 보다 엄밀하게 말하면, (o==null ? e==null : o.equals(e))를 채우는 요소 e가 리스트에 1개 이상 있으면, e를 1개 삭제합니다. 지정된 요소가 리스트에 포함되어 있었을 경우, 즉, 호출의 결과로서 리스트가 변경되었을 경우에 true를 리턴합니다.

정의:

인터페이스 Collection <E > 내의 remove

정의:

인터페이스 List <E > 내의 remove

파라미터:

o - 리스트로부터 삭제되는 요소 (그 요소가 있는 경우)

반환값:

리스트에 지정된 요소가 포함되고 있는 경우는 true

addIfAbsent

public boolean addIfAbsent(E  element)

요소가 존재하지 않는 경우, 요소를 추가합니다.

파라미터:

element - Collection에 추가되는 요소 (요소가 존재하지 않는 경우)

반환값:

추가되었을 경우는 true

containsAll

public boolean containsAll(Collection <? > c)

이 Collection 내에 지정된 Collection 모든 요소가 있는 경우에 true를 리턴합니다.

이 구현은 지정된 Collection 내용을 차례차례 조사해 Iterator에 의해 리턴된 각 요소에 대해, 이 Collection에 포함될지 어떨지를 차례로 확인합니다. 모든 요소가 이 Collection에 있는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.

정의:

인터페이스 Collection <E > 내의 containsAll

정의:

인터페이스 List <E > 내의 containsAll

파라미터:

c - 컬렉션

반환값:

모든 요소가 포함되는 경우는 true

관련 항목:

Collection.contains(Object)

removeAll

public boolean removeAll(Collection <? > c)

지정된 Collection에 포함되는 모든 요소를, 이 Collection 로부터 삭제합니다. 이것은 내부에 일시 배열이 필요하게 되기 때문에 이 클래스내에서 특히 부하의 큰 동작입니다.

정의:

인터페이스 Collection <E > 내의 removeAll

정의:

인터페이스 List <E > 내의 removeAll

파라미터:

c - 컬렉션

반환값:

이 Collection가 호출의 결과로서 변경되었을 경우는 true

관련 항목:

Collection.remove(Object), Collection.contains(Object)

retainAll

public boolean retainAll(Collection <? > c)

이 Collection에 대해, 지정된 Collection에 포함되고 있는 요소만을 보관 유지합니다 (임의의 오퍼레이션). 즉, 지정된 Collection에 포함되어 있지 않은 모든 요소를 이 Collection 로부터 삭제합니다.

정의:

인터페이스 Collection <E > 내의 retainAll

정의:

인터페이스 List <E > 내의 retainAll

파라미터:

c - 컬렉션

반환값:

이 Collection가 호출의 결과로서 변경되었을 경우는 true

관련 항목:

Collection.remove(Object), Collection.contains(Object)

addAllAbsent

public int addAllAbsent(Collection <?  extends E > c)

이 리스트에 포함되지 않은 지정된 Collection 내의 모든 요소를, 지정된 Collection 반복자에 의해 리턴된 순서로 이 리스트의 마지막에 추가합니다.

파라미터:

c - 리스트에 추가되는 요소

반환값:

추가하는 요소의 수

clear

public void clear()

리스트로부터 모든 요소를 삭제합니다.

정의:

인터페이스 Collection <E > 내의 clear

정의:

인터페이스 List <E > 내의 clear

addAll

public boolean addAll(Collection <?  extends E > c)

지정된 Collection 내의 모든 요소를, 지정된 Collection 반복자에 의해 리턴된 순서로 이 리스트의 마지막에 추가합니다.

정의:

인터페이스 Collection <E > 내의 addAll

정의:

인터페이스 List <E > 내의 addAll

파라미터:

c - 리스트에 삽입되는 요소

반환값:

몇개의 요소가 추가되는 경우는 true

관련 항목:

Collection.add(Object)

addAll

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

리스트내의 지정된 위치로부터, 지정된 Collection 모든 요소를 삽입합니다. 그 시점에서 지정된 위치에 요소가 있는 경우, 그 위치의 요소를 이동시켜, 후속의 요소를 우측으로 이동해, 각각의 인덱스를 늘립니다. 새로운 요소는 지정된 Collection 반복자가 돌려주는 순서로 리스트에 포함됩니다.

정의:

인터페이스 List <E > 내의 addAll

파라미터:

index - 지정된 컬렉션으로부터 최초의 요소를 삽입하는 위치의 인덱스

c - 리스트에 삽입되는 요소

반환값:

몇개의 요소가 추가되는 경우는 true

예외:

IndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index > size())

toString

public String  toString()

각 요소의 String 표현을 보관 유지하고 있는 Collection 캐릭터 라인 표현을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 캐릭터 라인 표현

equals

public boolean equals(Object  o)

지정된 Object가 List와 동일한지 어떤지를 비교합니다. 지정된 Object도 List 로 2개의 List가 어느 쪽과도 같은 사이즈이며, 2개의 List 대응하는 요소 페어가 모두 동일한 경우에만, true를 리턴합니다. 2개의 요소 e1와 e2는 (e1==null ? e2==null : e1.equals(e2)) 인 경우에 동일해집니다. 즉, 같은 순서로 같은 요소를 보관 유지하고 있는 경우에 2개의 List는 동일한 것과 판정됩니다.

이 구현은 최초로 지정된 객체가 이 List 일지 어떨지를 조사합니다. 이 List 인 경우, 구현은 true를 리턴합니다. 그렇지 않은 경우는 지정된 객체가 List 화도인지를 조사해 List가 아니면 false를 리턴합니다. 지정된 객체가 List인 경우는 양쪽 모두의 리스트의 내용을 차례차례 조사해, 요소의 대응하는 페어를 비교합니다. 비교의 결과 false가 리턴된 일이 있으면, 이 메서드도 false를 리턴합니다. 어느 쪽인가의 Iterator 요소가 먼저 없어졌을 경우는 2개의 List 길이가 동일하지 않기 때문에 false를 리턴합니다. 그렇지 않은 경우는 반복이 완료한 시점에서 true를 리턴합니다.

정의:

인터페이스 Collection <E > 내의 equals

정의:

인터페이스 List <E > 내의 equals

오버라이드(override):

클래스 Object 내의 equals

파라미터:

o - List와 동일한지 어떤지를 비교하는 Object

반환값:

지정된 Object가 이 List와 동일한 경우는 true

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 List 해시 코드값을 리턴합니다.

이 구현은, List.hashCode() 내의 정의를 사용합니다.

정의:

인터페이스 Collection <E > 내의 hashCode

정의:

인터페이스 List <E > 내의 hashCode

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

해시 코드

관련 항목:

Object.equals(java.lang.Object), Hashtable

iterator

public Iterator <E > iterator()

이 컬렉션에 포함되는 요소의 Iterator를 리턴합니다. 반복자는 반복자 구축시의 리스트 상태의 snapshot를 제공합니다. 반복자의 traversal중에 동기화는 불필요합니다. 반복자는 remove 메서드를 지원 하지 않습니다.

정의:

인터페이스 Iterable <E > 내의 iterator

정의:

인터페이스 Collection <E > 내의 iterator

정의:

인터페이스 List <E > 내의 iterator

반환값:

반복자

listIterator

public ListIterator <E > listIterator()

이 List 내의 요소의 Iterator를 적절한 순서로 리턴합니다. 반복자는 반복자 구축시의 리스트 상태의 snapshot를 제공합니다. 반복자의 traversal중에 동기화는 불필요합니다. 반복자는 remove, set 및 add 메서드를 지원 하지 않습니다.

정의:

인터페이스 List <E > 내의 listIterator

반환값:

반복자

listIterator

public ListIterator <E > listIterator(int index)

이 List 내의 요소의 ListIterator를, List 내의 지정된 위치로부터 시작되어 적절한 순서로 리턴합니다. 지정된 인덱스는 nextElement 최초의 호출에 의해 리턴된 최초의 요소를 나타냅니다. previousElement 최초의 호출에의해 지정된 인덱스로부터 1을 감산한 값을 가지는 요소가 리턴됩니다 . 이 구현에 의해 리턴된 ListIterator는 remove, set 및 add 메서드로 UnsupportedOperationException을 Throw 합니다.

정의:

인터페이스 List <E > 내의 listIterator

파라미터:

index - getNext 호출에 의해 ListIterator 로부터 리턴된 최초의 요소의 인덱스

반환값:

반복자

예외:

IndexOutOfBoundsException - 인덱스가 범위외의 경우 (index < 0 || index > size())

subList

public List <E > subList(int fromIndex,
                       int toIndex)

이 List fromIndex (이것을 포함한다)와 toIndex (이것을 포함하지 않는다)의 사이의 부분의 뷰를 리턴합니다. 리턴된 List는 이 List에 근거하고 있기 때문에 리턴된 List 내에서의 변경은 이 List에 반영되어 이 List 내에서의 변경은 리턴된 List에 반영됩니다. 변경 조작은 지원 되고 있습니다만, 이것들이 CopyOnWriteArrayLists 도움이 되는 것은 그다지 없습니다.

기초를 두는 리스트 (즉 이 List)가 리턴된 List를 개좌도에 「구조적으로 변경」되었을 경우, 이 메서드에 의해 리턴된 List 시멘틱스는 보증되지 않습니다. 구조적인 변경이란 List 사이즈가 변경되었을 경우나, 진행중의 반복에 의해 부정한 결과가 생겼다는 등의 이유로써 List가 흐트러졌을 경우입니다.

정의:

인터페이스 List <E > 내의 subList

파라미터:

fromIndex - subList 하단점 (이것을 포함한다)

toIndex - subList 상단점 (이것을 포함하지 않는다)

반환값:

이 List 내의 지정된 범위의 뷰

예외:

IndexOutOfBoundsException - 부정한 단 점의 인덱스치 (fromIndex < 0 || toIndex > size || fromIndex > toIndex)