java.util
클래스 AbstractCollection<E>

java.lang.Object 
  java.util.AbstractCollection<E>

모든 구현된 인터페이스:

Iterable <E>, Collection <E>

알려진 직계 서브 클래스:

AbstractList, AbstractQueue, AbstractSet

public abstract class AbstractCollection<E>
extends Object 
implements Collection <E>

이 클래스는 Collection 인터페이스의 스켈레톤 구현을 제공해, 이 인터페이스를 구현하는데 필요한 작업량을 최소한으로 억제합니다.

변경 불가능한 컬렉션을 구현하려면, 이 클래스를 확장해, iterator 메서드 및 size 메서드의 구현을 제공합니다. iterator 메서드가 돌려주는 반복자는 hasNext 및 next를 구현하고 있을 필요가 있습니다.

변경 가능한 컬렉션을 구현하려면, 상기에 가세해, 이 클래스의 add 메서드를 오버라이드(override) 하는 것으로 (오버라이드(override) 하지 않았던 경우는 UnsupportedOperationException이 Throw 된다), iterator 메서드로 리턴된 반복자가 remove 메서드를 구현하고 있을 필요가 있습니다.

Collection 인터페이스의 사양으로 추천 되고 있도록, 일반적으로 인수 없음의 void 생성자 및 인수에 Collection를 취하는 생성자를 제공해 주세요.

구현의 상세한 것에 대하여는 이 클래스의 abstract 메서드 이외의 각 메서드의 문서를 참조하십시오. 보다 효율적인 구현을 할 수 있는 컬렉션의 경우는 이러한 메서드를 오버라이드(override) 해도 괜찮습니다.

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

도입된 버전 :

1.2

관련 항목:

Collection

생성자 개요

protected

AbstractCollection () 유일한 생성자 입니다.

메서드 개요

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를 리턴합니다.
abstract Iterator <E >	iterator () 이 컬렉션중의 요소에 관계된 반복자를 리턴합니다.
boolean	remove (Object o) 지정된 요소의 인스턴스가 이 컬렉션에 있으면, 그 인스턴스를 컬렉션으로부터 1개 삭제합니다 (임의의 오퍼레이션).
boolean	removeAll (Collection <? > c) 이 컬렉션으로부터, 지정된 컬렉션에 포함되는 요소를 모두 삭제합니다 (임의의 오퍼레이션).
boolean	retainAll (Collection <? > c) 이 컬렉션에 대해, 지정된 컬렉션에 포함되고 있는 요소만을 보관 유지합니다 (임의의 오퍼레이션).
abstract int	size () 이 컬렉션중의 요소의 수를 리턴합니다.
Object []	toArray () 이 컬렉션의 요소가 모두 포함되고 있는 배열을 리턴합니다.
<T> T[]	toArray (T[] a) 이 컬렉션내의 모든 요소를 보관 유지하는 배열을 리턴합니다.
String	toString () 이 컬렉션의 캐릭터 라인 표현을 리턴합니다.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

인터페이스 java.util. Collection 로부터 상속된 메서드

equals, hashCode

생성자 상세

AbstractCollection

protected AbstractCollection()

유일한 생성자 입니다. 서브 클래스의 생성자에 한 호출용으로 일반적으로 암묵적으로 호출합니다.

메서드의 상세

iterator

public abstract Iterator <E > iterator()

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

정의:

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

정의:

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

반환값:

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

size

public abstract int size()

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

정의:

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

반환값:

컬렉션의 요소수

isEmpty

public boolean isEmpty()

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

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

정의:

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

반환값:

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

contains

public boolean contains(Object  o)

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

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

정의:

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

파라미터:

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

반환값:

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

toArray

public Object [] toArray()

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

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

정의:

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

반환값:

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

toArray

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

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

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

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

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

정의:

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

파라미터:

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

반환값:

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

예외:

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

ArrayStoreException - 지정된 배열의 실행시의 형태가 이 컬렉션에 있는 각 요소의, 실행시의 형태의 슈퍼타입이 아닌 경우

add

public boolean add(E  o)

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

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

정의:

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

파라미터:

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

반환값:

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

예외:

UnsupportedOperationException - 이 컬렉션이 add 메서드를 지원 하고 있지 않는 경우

NullPointerException - 이 컬렉션이 null 요소를 허용 하지 않을 때에 지정된 요소가 null인 경우

ClassCastException - 지정된 요소의 클래스가 원인으로 컬렉션에 요소를 추가할 수 없는 경우

IllegalArgumentException - 이 요소의 특성이 원인으로 이 컬렉션에 추가할 수 없는 경우

remove

public boolean remove(Object  o)

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

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

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

정의:

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

파라미터:

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

반환값:

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

예외:

UnsupportedOperationException - 이 컬렉션이 remove 메서드를 지원 하고 있지 않는 경우

containsAll

public boolean containsAll(Collection <? > c)

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

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

정의:

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

파라미터:

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

반환값:

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

예외:

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

관련 항목:

contains(Object)

addAll

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

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

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

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

정의:

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

파라미터:

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

반환값:

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

예외:

UnsupportedOperationException - 이 컬렉션이 addAll 메서드를 지원 하지 않는 경우

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

관련 항목:

add(Object)

removeAll

public boolean removeAll(Collection <? > c)

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

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

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

정의:

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

파라미터:

c - 컬렉션으로부터 삭제되는 요소

반환값:

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

예외:

UnsupportedOperationException - 이 컬렉션이 removeAll 메서드를 지원 하지 않는 경우

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

관련 항목:

remove(Object), contains(Object)

retainAll

public boolean retainAll(Collection <? > c)

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

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

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

정의:

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

파라미터:

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

반환값:

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

예외:

UnsupportedOperationException - 컬렉션이 retainAll 메서드를 지원 하고 있지 않는 경우

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

관련 항목:

remove(Object), contains(Object)

clear

public void clear()

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

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

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

정의:

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

예외:

UnsupportedOperationException - 이 컬렉션이 clear 메서드를 지원 하지 않는 경우

toString

public String  toString()

이 컬렉션의 캐릭터 라인 표현을 리턴합니다. 캐릭터 라인 표현은 컬렉션의 요소를 그 반복자가 돌려준 순서에 꺽쇄묶음 ("[]")으로 둘러싸 가리키는 리스트입니다. 인접하는 요소는 문자 ", " (칸마와 공백 문자)에 의해 단락지어집니다. 각 요소는 String.valueOf(Object)를 실행했는지와 같이 캐릭터 라인에 변환됩니다.

이 구현은 비어있는 캐릭터 라인 버퍼를 작성해, 최초로 왼쪽 꺽쇄묶음을 부가하고 나서, 컬렉션의 내용을 차례차례 조사해, 각 요소의 캐릭터 라인 표현을 순서에 부가해 갈 것입니다. 각 요소의 뒤에는 캐릭터 라인 ", " 이 부가됩니다. 다만, 마지막 요소의 뒤에는 ", "는 아니고 오른쪽 꺽쇄묶음이 부가됩니다. 마지막에 캐릭터 라인 버퍼로부터 캐릭터 라인을 취득해, 그 캐릭터 라인을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 컬렉션의 캐릭터 라인 표현