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 세이프이다
• 변경 조작 (추가 설정, 삭제등)은 보통, 기본으로 되는 배열 전체의 카피가 필요하게 되기 때문에 부하가 크다
• 반복자는 삭제 조작을 지원 하지 않는다
• 반복자를 사용한 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 ()
빈세트를 작성합니다.

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

메서드 개요

boolean	add (E o) 지정된 요소가 이 컬렉션에 포함되고 있는 것을 보증합니다 (임의의 오퍼레이션).
boolean	addAll (Collection <? extends E > c) 지정된 컬렉션의 모든 요소를 이 컬렉션에 추가합니다 (임의의 오퍼레이션).
void	clear () 이 컬렉션으로부터 모든 요소를 삭제합니다 (임의의 오퍼레이션).
boolean	contains (Object o) 컬렉션으로 지정된 요소가 있는 경우에 true를 리턴합니다.
boolean	containsAll (Collection <? > c) 이 컬렉션내에 지정된 컬렉션의 모든 요소가 있는 경우에 true를 리턴합니다.
boolean	isEmpty () 컬렉션에 요소가 없는 경우에 true를 리턴합니다.
Iterator <E >	iterator () 이 컬렉션중의 요소에 관계된 반복자를 리턴합니다.
boolean	remove (Object o) 지정된 요소의 인스턴스가 이 컬렉션에 있으면, 그 인스턴스를 컬렉션으로부터 1개 삭제합니다 (임의의 오퍼레이션).
boolean	removeAll (Collection <? > c) 이 세트로부터, 지정된 컬렉션에 포함되는 요소를 모두 삭제합니다 (임의의 오퍼레이션).
boolean	retainAll (Collection <? > c) 이 컬렉션에 대해, 지정된 컬렉션에 포함되고 있는 요소만을 보관 유지합니다 (임의의 오퍼레이션).
int	size () 이 컬렉션중의 요소의 수를 리턴합니다.
Object []	toArray () 이 컬렉션의 요소가 모두 포함되고 있는 배열을 리턴합니다.
<T> T[]	toArray (T[] a) 이 컬렉션내의 모든 요소를 보관 유지하는 배열을 리턴합니다.

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

equals, hashCode

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

toString

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

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

생성자 상세

CopyOnWriteArraySet

public CopyOnWriteArraySet()

빈세트를 작성합니다.

CopyOnWriteArraySet

public CopyOnWriteArraySet(Collection <?  extends E > c)

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

파라미터:

c - 컬렉션

메서드의 상세

size

public int size()

클래스 AbstractCollection 기술:

이 컬렉션중의 요소의 수를 리턴합니다. 컬렉션에 Integer.MAX_VALUE 보다 많은 요소가 있는 경우는 Integer.MAX_VALUE를 리턴합니다.

정의:

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

정의:

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

정의:

클래스 AbstractCollection <E > 내의 size

반환값:

컬렉션의 요소수

isEmpty

public boolean isEmpty()

클래스 AbstractCollection 기술:

컬렉션에 요소가 없는 경우에 true를 리턴합니다.

이 구현은 size() == 0 결과를 리턴합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 isEmpty

반환값:

컬렉션에 요소가 없는 경우는 true

contains

public boolean contains(Object  o)

클래스 AbstractCollection 기술:

컬렉션으로 지정된 요소가 있는 경우에 true를 리턴합니다. 즉, 이 컬렉션에 (o==null ? e==null : o.equals(e)) 인 요소 e가 1개 이상 있는 경우에만 true를 리턴합니다.

이 구현은 컬렉션의 각 요소에 대해, 지정된 요소와 동일한지 어떤지를 순서에 반복해 확인합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 contains

파라미터:

o - 이 컬렉션에 있을지 어떨지를 조사하는 객체

반환값:

컬렉션으로 지정된 요소가 있는 경우는 true

toArray

public Object [] toArray()

클래스 AbstractCollection 기술:

이 컬렉션의 요소가 모두 포함되고 있는 배열을 리턴합니다. 반복자에 의해 리턴된 요소의 차례를 컬렉션이 보증하는 경우, 이 메서드는 그것과 같은 차례로 요소를 리턴합니다. 리턴된 배열은 컬렉션에 의해 관리되는 참조 관계를 가지지 않는 점으로써 안전성이 보증됩니다. 즉, 이 메서드는 컬렉션의 기가 Array 인 경우에서도, 새롭게 배열을 할당합니다. 이 때문에 호출측은 리턴된 배열을 자유롭게 변경할 수 있습니다.

이 구현은 리턴된 배열을 할당해 컬렉션의 각 요소에 대해 반복합니다. 즉, 각 객체 참조를 배열의 다음의 요소에 포함한다고 하는 처리를, 제 0 요소로부터 개시합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 toArray

반환값:

컬렉션의 모든 요소가 포함되고 있는 배열

toArray

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

클래스 AbstractCollection 기술:

이 컬렉션내의 모든 요소를 보관 유지하는 배열을 리턴합니다. 리턴된 배열의 실행시의 형태는 지정된 배열의 형태입니다. 컬렉션이 지정된 배열에 들어가는 경우는 그 중에 리턴됩니다 . 그렇지 않은 경우는 지정된 배열의 실행시의 형태와 컬렉션의 사이즈를 가지는 새로운 배열을 할당할 수 있습니다.

지정된 배열에 컬렉션이 들어가 또한 빈 곳이 있는 경우, 즉 배열에 컬렉션 이상의 요소수 있는인 경우에는 컬렉션의 종단의 직후에 있는 배열의 요소가 null로 설정됩니다. 컬렉션에 null 요소가 없는 것이 호출해 옆으로 밝혀지고 있는 경우에는 이것에 의해 컬렉션의 길이를 판정할 수 있습니다.

반복자에 의해 요소가 리턴된 순서를 컬렉션이 보증하는 경우, 이 메서드는 같은 순서로 요소를 돌려주지 않으면 안됩니다.

이 구현은 배열이 컬렉션의 포함에 충분한 크기인지를 확인합니다. 불충분한 경우, 이 구현은 리플렉션을 사용해, 적절한 사이즈 및 형태의 배열을 새롭게 할당합니다. 다음에 컬렉션에 대해서 0 으로부터 순서에 배열이 연속하는 요소에 각 객체 참조를 포함하는 조작을 반복합니다. 배열이 컬렉션보다 큰 경우, 컬렉션의 종단보다 후의 최초의 위치에 null가 포함됩니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 toArray

파라미터:

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

반환값:

컬렉션의 요소를 포함한 배열

clear

public void clear()

클래스 AbstractCollection 기술:

이 컬렉션으로부터 모든 요소를 삭제합니다 (임의의 오퍼레이션). 이 호출이 돌아온 뒤는 예외가 Throw 되지 않는 이상 컬렉션은 비웁니다.

이 구현은 컬렉션에 대해서 Iterator.remove 오퍼레이션을 사용해 각 요소를 삭제하는 조작을 반복합니다. 대부분의 구현에서는 이 메서드를 오버라이드(override) 한 (분)편이 보다 효율적입니다.

이 컬렉션의 iterator 메서드로 리턴된 반복자가 remove 메서드를 구현하지 않고, 이 컬렉션이 비어있지 않은 경우, 이 구현은 UnsupportedOperationException을 Throw 합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 clear

iterator

public Iterator <E > iterator()

클래스 AbstractCollection 기술:

이 컬렉션중의 요소에 관계된 반복자를 리턴합니다.

정의:

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

정의:

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

정의:

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

정의:

클래스 AbstractCollection <E > 내의 iterator

반환값:

이 컬렉션중의 요소에 관계된 반복자를 돌려준다

remove

public boolean remove(Object  o)

클래스 AbstractCollection 기술:

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

이 구현은 컬렉션의 내용을 차례차례 조사해 지정된 요소를 찾습니다. 요소가 있으면, 반복자의 remove 메서드를 사용해 컬렉션으로부터 요소를 삭제합니다.

이 컬렉션의 iterator 메서드가 돌려주는 반복자가 remove 메서드를 구현하지 않고, 지정된 객체가 이 컬렉션내에 있는 경우, 이 구현은 UnsupportedOperationException을 Throw 합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 remove

파라미터:

o - 컬렉션으로부터 삭제되는 요소 (그 요소가 있는 경우)

반환값:

컬렉션으로 지정된 요소가 있는 경우는 true

add

public boolean add(E  o)

클래스 AbstractCollection 기술:

지정된 요소가 이 컬렉션에 포함되고 있는 것을 보증합니다 (임의의 오퍼레이션). 호출의 결과 컬렉션이 변경되었을 경우에 true를 리턴합니다. 이 컬렉션이 요소의 중복을 허가하지 않고, 지정된 요소가 이미 포함되어 있는 경우는 false를 리턴합니다. 이 오퍼레이션을 지원하는 컬렉션에서는 컬렉션에 추가할 수 있는 요소에 제한을 더할 수 있습니다 . 예를 들어 컬렉션에 따라서는 null 요소의 추가가 허가되지 않는 것이나, 추가되는 요소의 형태를 제한하는 일이 있습니다. 추가되는 요소에 관해서 제한이 있는 경우는 그 Collection 클래스의 문서에 명시해야 하겠지요.

이 구현은 항상 UnsupportedOperationException을 Throw 합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 add

파라미터:

o - 컬렉션에 있을지 어떨지를 조사하는 요소

반환값:

이 호출의 결과, 컬렉션이 변경되었을 경우는 true

containsAll

public boolean containsAll(Collection <? > c)

클래스 AbstractCollection 기술:

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

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

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 containsAll

파라미터:

c - 이 컬렉션에 있을지 어떨지를 조사하는 컬렉션

반환값:

지정된 컬렉션의 모든 요소가 이 컬렉션내에 있는 경우는 true

관련 항목:

AbstractCollection.contains(Object)

addAll

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

클래스 AbstractCollection 기술:

지정된 컬렉션의 모든 요소를 이 컬렉션에 추가합니다 (임의의 오퍼레이션). 오퍼레이션의 진행중에 지정된 컬렉션이 변경되었을 경우의, 이 오퍼레이션의 동작은 정의되지 않습니다. 따라서, 지정된 컬렉션이 이 컬렉션 자신이며, 이 컬렉션이 비어있지 않은 경우, 이 호출의 동작은 정의되지 않습니다.

이 구현은 지정된 컬렉션에 대해서 반복을 실시해, 반복자가 돌려주는 객체를 이 컬렉션에 순서에 추가해 나가는 조작을 반복합니다.

지정된 컬렉션이 비어있지 않은 경우는 add 메서드가 오버라이드(override) 되지 않는 이상 이 구현은 UnsupportedOperationException을 Throw 합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 addAll

파라미터:

c - 요소가 이 컬렉션에 추가되는 컬렉션

반환값:

이 호출의 결과, 이 컬렉션이 변경되었을 경우는 true

관련 항목:

AbstractCollection.add(Object)

removeAll

public boolean removeAll(Collection <? > c)

클래스 AbstractSet 기술:

이 세트로부터, 지정된 컬렉션에 포함되는 요소를 모두 삭제합니다 (임의의 오퍼레이션).

이 구현은, size 메서드를 호출해, 이 세트 및 지정된 컬렉션의 어느 쪽이 작은가를 판별합니다. 이 세트에 요소가 그다지 없는 경우, 구현으로 이 세트를 반복해, 각 요소가 반복자로 리턴된 것을 확인해, 지정된 컬렉션에 포함되는 것을 확인합니다. 요소가 포함되는 경우는 반복자의 remove 메서드를 사용해 이 세트로부터 삭제됩니다. 지정된 컬렉션에서는 요소가 적은 경우, 지정된 컬렉션으로 구현을 반복해, 이 세트의 remove 메서드를 이용해, 반복자가 돌려준 각 요소를 이 세트로부터 삭제합니다.

iterator 메서드로 리턴된 반복자가 remove 메서드를 구현하고 있지 않는 경우, 이 구현은 UnsupportedOperationException을 Throw 합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractSet <E > 내의 removeAll

파라미터:

c - 이 세트로부터 삭제되는 요소

반환값:

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

관련 항목:

AbstractCollection.remove(Object), AbstractCollection.contains(Object)

retainAll

public boolean retainAll(Collection <? > c)

클래스 AbstractCollection 기술:

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

이 구현은 이 컬렉션의 내용을 차례차례 조사해 반복자에 의해 리턴된 각 요소에 대해, 지정된 컬렉션에 포함될지 어떨지를 차례로 확인합니다. 포함되지 않는 요소가 있으면, 반복자의 remove 메서드를 사용해 이 컬렉션으로부터 삭제합니다.

iterator 메서드로 리턴된 반복자가 remove 메서드를 구현하지 않고, 지정된 컬렉션에 포함되지 않는 요소가 1개에 서도 이 컬렉션내에 있는 경우는 이 구현은 UnsupportedOperationException을 Throw 합니다.

정의:

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

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 retainAll

파라미터:

c - 컬렉션으로 보관 유지되는 요소

반환값:

이 호출의 결과, 이 컬렉션이 변경되었을 경우는 true

관련 항목:

AbstractCollection.remove(Object), AbstractCollection.contains(Object)