java.util
클래스 AbstractQueue<E>

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

형태 파라미터:

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

모든 구현된 인터페이스:

Iterable <E>, Collection <E>, Queue <E>

알려진 직계 서브 클래스:

ArrayBlockingQueue, ConcurrentLinkedQueue, DelayQueue, LinkedBlockingQueue, PriorityBlockingQueue, PriorityQueue, SynchronousQueue

public abstract class AbstractQueue<E>
extends AbstractCollection <E>
implements Queue <E>

이 클래스는 몇개의 Queue 오퍼레이션의 스켈레톤 구현을 제공합니다. 이 클래스내의 구현이 적절한 것은 베이스 구현으로 null 요소가 허가되지 않는 경우입니다. add, remove 및 element 메서드는 각각 offer, poll 및 peek에 근거하고 있습니다만, false 또는 null을 돌려주고 실패를 나타내는 대신에 예외를 Throw 합니다.

이 클래스를 확장하는 Queue 구현은, Iterator.remove()를 지원하는 Queue.peek(), Queue.poll(), Collection.size() 및 Collection.iterator() 와 함께, null 요소의 삽입을 허가하지 않는 Queue.offer(E) 메서드를 최저한 정의해야 합니다. 보통, 추가 메서드도 오버라이드(override) 됩니다. 이러한 요건을 채울 수가 없는 경우, AbstractCollection 상속 고려해 주세요.

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

도입된 버전 :

1.5

생성자 개요

protected

AbstractQueue () 서브 클래스에 의해 사용되는 생성자 입니다.

메서드 개요

boolean	add (E o) 지정된 요소를 이 큐에 추가합니다.
boolean	addAll (Collection <? extends E > c) 지정된 컬렉션내의 모든 요소를 이 큐에 추가합니다.
void	clear () 이 컬렉션으로부터 모든 요소를 삭제합니다.
E	element () 이 큐의 헤더를 취득합니다만, 삭제하지 않습니다.
E	remove () 이 큐의 헤더를 취득 및 삭제합니다.

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

contains, containsAll, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString

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

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

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

offer, peek, poll

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

contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray

생성자 상세

AbstractQueue

protected AbstractQueue()

서브 클래스에 의해 사용되는 생성자 입니다.

메서드의 상세

add

public boolean add(E  o)

지정된 요소를 이 큐에 추가합니다. 이 구현은, offer가 성공했을 경우는 true를 돌려주고, 그렇지 않은 경우에는 IllegalStateException을 Throw 합니다.

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 add

파라미터:

o - 요소

반환값:

true (Collection.add 일반 규약에 따른다)

예외:

NullPointerException - 지정된 요소가 null 인 경우

IllegalStateException - 요소를 추가할 수 없는 경우

remove

public E  remove()

이 큐의 헤더를 취득 및 삭제합니다. 큐가 비어있지 않은 한, 이 구현은 poll 결과를 리턴합니다.

정의:

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

반환값:

이 큐의 헤더

예외:

NoSuchElementException - 큐가 비어있는 경우

element

public E  element()

이 큐의 헤더를 취득합니다만, 삭제하지 않습니다. 큐가 비어있지 않은 한, 이 구현은 peek 결과를 리턴합니다.

정의:

인터페이스 Queue <E > 내의 element

반환값:

이 큐의 헤더

예외:

NoSuchElementException - 큐가 비어있는 경우

clear

public void clear()

이 컬렉션으로부터 모든 요소를 삭제합니다. 이 호출이 돌아오면, 컬렉션은 비웁니다.

이 구현은, null가 돌려주고질 때까지, 반복 poll를 호출합니다.

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 clear

addAll

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

지정된 컬렉션내의 모든 요소를 이 큐에 추가합니다. 큐의 모든 것을 그 자체에 추가하려고 하면, IllegalArgumentException이 발생 됩니다. 또, 오퍼레이션의 진행중으로 지정된 컬렉션이 변경되었을 경우의, 이 오퍼레이션의 동작은 정의되지 않습니다.

이 구현은 지정된 컬렉션에 대해서 처리를 반복해 실행해, 반복자에 의해 리턴된 각 요소를 이 컬렉션에 차례로 추가합니다. 요소 (null 요소를 포함한다)의 추가중에 실행시 예외에 조우하는 경우, 관련된 예외의 Throw시에 요소의 일부만이 추가에 성공하고 있을 가능성이 있습니다.

정의:

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

오버라이드(override):

클래스 AbstractCollection <E > 내의 addAll

파라미터:

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

반환값:

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

예외:

NullPointerException - 지정된 컬렉션 또는 그 요소의 어떤 것인가가 null인 경우

IllegalArgumentException - c가 이 큐인 경우

관련 항목:

add(Object)