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

java.lang.Object 
  java.util.AbstractCollection <E>
      java.util.AbstractSet <E>
          java.util.concurrent.CopyOnWriteArraySet<E>

형태 파라미터:

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

모든 구현된 인터페이스:

Serializable , Iterable <E>, Collection <E>, Set <E>

public class CopyOnWriteArraySet<E>
extends AbstractSet <E>
implements Serializable 

모든 조작으로 내부 CopyOnWriteArrayList 를 사용하는 Set . 이 때문에, 같은 기본 프로퍼티이 공유됩니다.

• 설정 사이즈가 일반적으로 작고, 읽기 전용 조작이 변경 조작보다 훨씬 많은 어플리케이션에 최적이다. 또, traversal중에 thread간의 간섭을 막을 필요가 있다.
• thread 세이프이다.
• 변경 조작 (add,set,remove 등)은, 일반적으로, 기본으로 되는 배열 전체의 카피가 필요하게 되기 (위해)때문에, 부하가 크다.
• 반복자는,remove 조작을 지원하지 않는다.
• 반복자를 사용한 traversal는 고속으로 있어, 다른 thread로부터의 간섭에 조우할 것은 없다. 반복자는, 그 구축된 시점에서의 변경되지 않는 배열 snapshot에 의존한다.

사용예. 다음의 코드예에서는, copy-on-write 설정을 사용해, 상태가 갱신되었을 때에 특정의 액션을 실행하는 Handler 객체세트를 관리합니다.

class Handler { void handle(); ... }

class X {
private final CopyOnWriteArraySet<Handler> handlers
= new CopyOnWriteArraySet<Handler>();
public void addHandler(Handler h) { handlers.add(h); }

private long internalState;
private synchronized void changeState() { internalState = ...; }

public void update() {
changeState();
for (Handler handler :handlers)
handler.handle();
    }
 }
 

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

도입된 버젼:

1.5

관련 항목:

CopyOnWriteArrayList , 직렬화 된 형식

생성자 의 개요

CopyOnWriteArraySet ()
빈 상태(empty)세트를 작성합니다.

CopyOnWriteArraySet (Collection <? extends E > c)
지정된 컬렉션의 요소 모든 것을 포함한 세트를 작성합니다.

메소드의 개요

boolean	add (E e) 지정된 요소가 이 세트의 요소로서 존재하지 않는 경우에, 그 요소를 세트에 추가합니다.
boolean	addAll (Collection <? extends E > c) 지정된 컬렉션의 모든 요소에 대해, 그 요소가 이 세트내에 없는 경우, 세트에 추가합니다.
void	clear () 모든 요소를 세트로부터 삭제합니다.
boolean	contains (Object o) 세트가, 지정된 요소를 보관 유지하고 있는 경우에 true 를 돌려줍니다.
boolean	containsAll (Collection <? > c) 지정된 컬렉션의 모든 요소가 세트내에 있는 경우에 true 를 돌려줍니다.
boolean	equals (Object o) 지정된 객체가 세트와 같은가 어떤가를 비교합니다.
boolean	isEmpty () 세트가 요소를 1 개나 보관 유지하고 있지 않는 경우에 true 를 돌려줍니다.
Iterator <E >	iterator () 이 세트에 포함되는 각 요소에 대한 반복자를, 이러한 요소가 추가된 순서로 돌려줍니다.
boolean	remove (Object o) 지정된 요소가 이 세트에 존재하는 경우에, 요소를 세트로부터 삭제합니다.
boolean	removeAll (Collection <? > c) 세트로부터, 지정된 컬렉션내에 보관 유지 떠날 수 있어 모든 요소를 삭제합니다.
boolean	retainAll (Collection <? > c) 지정된 컬렉션내에 보관 유지되고 있는, 세트내의 요소만을 보관 유지합니다.
int	size () 이 세트중의 요소의 수를 돌려줍니다.
Object []	toArray () 세트내의 모든 요소가 포함되고 있는 배열을 돌려줍니다.
<T> T[]	toArray (T[] a) 세트내의 모든 요소를 포함하고 있는 배열을 돌려줍니다.

클래스 java.util. AbstractSet 로부터 상속된 메소드

hashCode

클래스 java.util. AbstractCollection 로부터 상속된 메소드

toString

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

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

생성자 의 상세

CopyOnWriteArraySet

public CopyOnWriteArraySet()

빈 상태(empty)세트를 작성합니다.

CopyOnWriteArraySet

public CopyOnWriteArraySet(Collection <?  extends E > c)

지정된 컬렉션의 요소 모든 것을 포함한 세트를 작성합니다.

파라미터:

c - 초기 상태로 포함한 요소의 컬렉션

예외:

NullPointerException - 지정된 컬렉션이 null 인 경우

메소드의 상세

size

public int size()

이 세트중의 요소의 수를 돌려줍니다.

정의:

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

정의:

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

정의:

클래스 AbstractCollection <E > 내의 size

반환값:

세트의 요소수

isEmpty

public boolean isEmpty()

세트가 요소를 1 개나 보관 유지하고 있지 않는 경우에 true 를 돌려줍니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 isEmpty

반환값:

세트가 요소를 1 개나 보관 유지하고 있지 않는 경우는 true

contains

public boolean contains(Object  o)

세트가, 지정된 요소를 보관 유지하고 있는 경우에 true 를 돌려줍니다. 즉, 세트에,(o==null ? e==null : o.equals(e)) 가 되는 요소 e 가 포함되어 있는 경우에만 true 를 돌려줍니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 contains

파라미터:

o - 세트에 있을지 어떨지를 조사하는 요소

반환값:

세트가, 지정된 요소를 보관 유지하고 있는 경우는 true

toArray

public Object [] toArray()

세트내의 모든 요소가 포함되고 있는 배열을 돌려줍니다. 반복자에 의해 요소가 반환되는 순서를 세트가 보증하는 경우, 이 메소드는 같은 순서로 요소를 돌려주지 않으면 안됩니다.

반환되는 배열에의 참조를 세트가 유지하지 않는다고 하는 점으로써, 이 배열은 안전합니다. 즉, 이 메소드는, 세트가 배열에 연동하고 있는 경우에서도 새로운 배열을 할당합니다. 이 때문에, 호출측은, 반환된 배열을 자유롭게 변경할 수 있습니다.

메소드는, 배열 베이스의 API 와 컬렉션 베이스의 API 의 사이의 중개역으로서 기능합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 toArray

반환값:

세트내의 모든 요소를 보관 유지하고 있는 배열

toArray

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

세트내의 모든 요소를 포함하고 있는 배열을 돌려줍니다. 반환되는 배열의 실행시의 형태는, 지정된 배열의 형태가 됩니다. 세트가 지정된 배열에 들어가는 경우는, 그 중에 돌려주어집니다. 그렇지 않은 경우는, 지정된 배열의 실행시의 형태와 세트의 사이즈를 가지는 새로운 배열을 할당할 수 있습니다.

세트가 지정된 배열에 들어가, 그 배열에 한층 더 여유가 있는 경우 (즉, 배열이 세트보다 많은 요소를 가지는 경우), 그 배열내에서 세트의 끝보다 나머지의 요소는 null 로 설정됩니다. 세트에 null 요소가 없는 것을 호출해 옆이 알고 있는 경우에만, 이 특성을 이용해 세트의 길이를 판단할 수 있습니다.

반복자에 의해 요소가 반환되는 순서를 세트가 보증하는 경우, 이 메소드는 같은 순서로 요소를 돌려주지 않으면 안됩니다.

toArray() 메소드와 같이, 이 메소드는, 배열 베이스의 API 와 컬렉션 베이스의 API 의 사이의 중개역으로서 기능합니다. 게다가 이 메소드에서는, 출력 배열의 실행시의 형태를 정확하게 제어할 수 있기 (위해)때문에, 환경에 따라서는 할당의 수고를 억제할 수가 있습니다.

x 가, 캐릭터 라인만으로부터 되는 세트인 것을 알 수 있고 있으면(자) 가정합니다. 다음의 코드를 사용하면(자), 새롭게 할당할 수 있었던 String 의 배열에 세트를 덤프 할 수 있습니다.

String[] y = x.toArray(new String[0]);

toArray(new Object[0]) 는, 기능의 점으로써 toArray() 와 동일합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 toArray

파라미터:

a - 세트의 요소의 포함처의 배열. 배열의 사이즈가 충분하지 않은 경우는, 같은 실행시의 형태로 새로운 배열이 포함용으로서 할당할 수 있다

반환값:

세트내의 모든 요소를 보관 유지하고 있는 배열

예외:

ArrayStoreException - 지정된 배열의 실행시의 형태가, 세트내의 각 요소의 실행시의 형태의 슈퍼타입이 아닌 경우

NullPointerException - 지정된 배열이 null 인 경우

clear

public void clear()

모든 요소를 세트로부터 삭제합니다. 이 호출이 돌아오면(자), 세트는 비웁니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 clear

remove

public boolean remove(Object  o)

지정된 요소가 이 세트에 존재하는 경우에, 요소를 세트로부터 삭제합니다. 즉, 세트내에,(o==null ? e==null : o.equals(e)) 에 해당하는 요소 e 가 포함되어 있는 경우는, 그러한 요소를 삭제합니다. 지정된 요소가 세트내에 포함되어 있었을 경우 (세트가 호출의 결과로서 변경되었을 경우)는,true 를 돌려줍니다. 호출이 복귀한 뒤는, 세트는 그 요소를 가지지 않게 됩니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 remove

파라미터:

o - 세트에 존재하면 삭제되는 객체

반환값:

세트가, 지정된 요소를 보관 유지하고 있는 경우는 true

add

public boolean add(E  e)

지정된 요소가 이 세트의 요소로서 존재하지 않는 경우에, 그 요소를 세트에 추가합니다. 즉, 세트내에,(e==null ? e2==null : e.equals(e2)) 에 해당하는 요소 e2 가 없었던 경우는, 지정된 요소 e 를 세트에 추가합니다. 세트내에 벌써 요소가 있는 경우, 호출은 세트를 변경하지 않고 false 를 돌려줍니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 add

파라미터:

e - 세트에 추가되는 요소

반환값:

세트가 지정된 요소를 보관 유지하고 있지 않았던 경우는 true

containsAll

public boolean containsAll(Collection <? > c)

지정된 컬렉션의 모든 요소가 세트내에 있는 경우에 true 를 돌려줍니다. 지정된 컬렉션도 세트인 경우, 지정된 세트가 이 세트의 「부분집합」이면, 이 메소드는 true 를 돌려줍니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 containsAll

파라미터:

c - 이 세트에 포함되어 있는지 어떤지를 조사하는 컬렉션

반환값:

지정된 컬렉션의 모든 요소가 세트에 포함되어 있는 경우는 true

예외:

NullPointerException - 지정된 컬렉션이 null 인 경우

관련 항목:

contains(Object)

addAll

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

지정된 컬렉션의 모든 요소에 대해, 그 요소가 이 세트내에 없는 경우, 세트에 추가합니다. 지정된 컬렉션도 세트인 경우,addAll 오퍼레이션은 효율적으로 세트를 변경해, 그 값이 2 개세트의 「화집합」이 되도록(듯이) 합니다. 오퍼레이션의 진행중에, 지정된 컬렉션이 변경되었을 경우의, 이 오퍼레이션의 동작은 정의되고 있지 않습니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 addAll

파라미터:

c - 세트에 추가되는 요소를 포함한 컬렉션

반환값:

이 호출의 결과, 이 세트가 변경되었을 경우는 true

예외:

NullPointerException - 지정된 컬렉션이 null 인 경우

관련 항목:

add(Object)

removeAll

public boolean removeAll(Collection <? > c)

세트로부터, 지정된 컬렉션내에 보관 유지 떠날 수 있어 모든 요소를 삭제합니다. 지정된 컬렉션도 세트인 경우, 이 오퍼레이션은, 값이 2 개세트의 「비대칭 집합 차분」이 되도록(듯이) 세트를 효율적으로 변경합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractSet <E > 내의 removeAll

파라미터:

c - 이 세트로부터 삭제되는 요소를 포함한 컬렉션

반환값:

이 호출의 결과, 이 세트가 변경되었을 경우는 true

예외:

ClassCastException - 이 세트의 요소의 클래스가 지정된 컬렉션과 호환이 아닌 경우 (생략 가능)

NullPointerException - 이 세트내에 null 요소가 포함되어 지정된 컬렉션이 null 요소를 허가하지 않는 경우 (생략 가능). 또는 지정된 컬렉션이 null 의 경우

관련 항목:

remove(Object)

retainAll

public boolean retainAll(Collection <? > c)

지정된 컬렉션내에 보관 유지되고 있는, 세트내의 요소만을 보관 유지합니다. 즉, 세트로부터, 지정된 컬렉션내에 없는 요소를 모두 삭제합니다. 지정된 컬렉션도 세트인 경우, 이 오퍼레이션의 결과, 세트의 값은 2 개세트의 「공통 부분」이 됩니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 retainAll

파라미터:

c - 세트로 보관 유지되는 요소를 포함한 컬렉션

반환값:

이 호출의 결과, 이 세트가 변경되었을 경우는 true

예외:

ClassCastException - 이 세트의 요소의 클래스가 지정된 컬렉션과 호환이 아닌 경우 (생략 가능)

NullPointerException - 이 세트내에 null 요소가 포함되어 지정된 컬렉션이 null 요소를 허가하지 않는 경우 (생략 가능). 또는 지정된 컬렉션이 null 의 경우

관련 항목:

remove(Object)

iterator

public Iterator <E > iterator()

이 세트에 포함되는 각 요소에 대한 반복자를, 이러한 요소가 추가된 순서로 돌려줍니다.

반환되는 반복자는, 반복자의 구축시세트 상태의 snapshot를 제공합니다. 반복자의 traversal중에 동기화는 필요 없습니다. 반복자는,remove 메소드를 지원하지 않습니다.

정의:

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

정의:

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

정의:

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

정의:

클래스 AbstractCollection <E > 내의 iterator

반환값:

세트의 요소의 반복자

equals

public boolean equals(Object  o)

지정된 객체가 세트와 같은가 어떤가를 비교합니다. 지정된 객체가 이 객체와 같은 객체인 경우, 또는 지정된 객체가 Set 이기도 해, 지정된 세트로 iterator 에 의해 반환되는 요소가 이 세트로 반복자에 의해 반환되는 요소와 같은 경우,true 를 돌려줍니다. 즉, 이 2 개의 반복자는, 그것들이 같은 수의 요소를 돌려주어, 지정된 세트에 대한 반복자에 의해 반환되는 각 요소 e1 마다, 이 세트에 대한 반복자에 의해 반환된다 (e1==null ? e2==null :e1.equals(e2)) 에 해당하는 요소 e2 가 존재하는 경우, 같은 요소를 돌려준다고 보여집니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractSet <E > 내의 equals

파라미터:

o - 이 세트와 동일한지 어떤지가 비교되는 객체

반환값:

지정된 객체가 이 세트와 같은 경우는 true

관련 항목:

Object.hashCode() , Hashtable