java.util.concurrent
클래스 Semaphore

java.lang.Object 
  java.util.concurrent.Semaphore

모든 구현된 인터페이스:

Serializable

public class Semaphore
extends Object 
implements Serializable 

카운트에 사용되는 semaphore. 개념적으로는 semaphore는 허가 세트를 관리합니다. 각 acquire() 는 필요하게 응해 파 미트가 이용 가능하게 될 때까지 블록을 실행해, 이용 가능하게 되면 그것을 취득합니다. 각 release() 는 파 미트를 추가합니다만, 그 때 블록 취득자를 해방할 가능성이 있습니다. 다만, 실제의 파 미트 객체는 사용되지 않습니다. Semaphore는 이용 가능한 수의 카운트를 유지해, 거기에 응해 동작할 뿐입니다.

semaphore는 일부의 (물리 또는 논리) 자원에 액세스 가능한 thread의 수를 제한하는 경우에 자주 사용됩니다. 예를 들어이하에 나타내는 클래스는 항목의 풀에의 액세스 제어에 semaphore를 사용합니다.

 class Pool {
   private static final MAX_AVAILABLE = 100;
   private final Semaphore available = new Semaphore(MAX_AVAILABLE, true);

   public Object getItem() throws InterruptedException {
     available.acquire();
     return getNextAvailableItem();
   }

   public void putItem(Object x) {
     if (markAsUnused(x))
       available.release();
   }

   // Not a particularly efficient data structure; just for demo

   protected Object[] items = ... whatever kinds of items being managed
   protected boolean[] used = new boolean[MAX_AVAILABLE];

   protected synchronized Object getNextAvailableItem() {
     for (int i = 0; i < MAX_AVAILABLE; ++i) {
       if (! used[i]) {
          used[i] = true;
          return items[i];
       }
     }
     return null; // not reached
   }

   protected synchronized boolean markAsUnused(Object item) {
     for (int i = 0; i < MAX_AVAILABLE; ++i) {
       if (item == items[i]) {
          if (used[i]) {
            used[i] = false;
            return true;
          } else
            return false;
       }
     }
     return false;
   }

 }
 

항목을 취득하기 전에 각 thread는 semaphore로부터 항목이 사용 가능한 것을 보증하는 파 미트를 취득할 필요가 있습니다. 항목 처리가 완료하면 thread는 풀로 돌아가 파 미트가 semaphore에 돌려주고져 다른 thread가 항목을 취득할 수 있게 됩니다. acquire() 호출시에 동기 락은 보관 유지되지 않습니다. 동기 락이 보관 유지되면, 항목을 풀에 돌려줄 수가 없게 되기 때문에입니다. semaphore는 풀에의 액세스 제한으로 필요한 동기를, 풀 자체의 일관성 유지에 필요한 동기와는 별개에 캡슐화합니다.

semaphore는 초기화되면, 파 미트를 최대 1개 사용 가능하게 하기 위한, 상호 배타 락으로서 기능하는 것이 가능합니다. 이것은 1개의 파 미트를 사용 가능하게 하는 상태와 제로의 파 미트를 사용 가능하게 하는 상태의 2개 만을 보관 유지하기 위해, 일반적으로는 「바이너리 semaphore」로서 알려져 있습니다. 이 방법으로 사용되는 경우, 바이너리 semaphore는 (많은 Lock 구현과는 달라) 「락」을 소유자 이외의 thread에 의해 해방 가능하다라고 말하는 프로퍼티를 보관 유지합니다 (semaphore에는 소유권이라고 하는 개념이 없기 때문에). 이것은 데드 록의 복원 등, 일부의 특수한 컨텍스트에 서는 유용합니다.

이 클래스의 생성자는 옵션으로 fairness 파라미터를 받아들입니다. 이것을 false 로 설정하면, 이 클래스는 thread가 파 미트를 얻는 차례를 보증하지 않습니다. 특히, 「바징」이 허가됩니다. 이것은, acquire()를 호출하는 thread가 대기하고 있던 thread에 앞서 파 미트를 할당할 수 있는 것을의미합니다. 논리적이게는 새로운 (분)편의 thread가 대기중의 thread의 큐의 선두에 배치되게 됩니다. fairness가 true 로 설정되면, semaphore는 몇개의 취득 메서드를 호출하는 thread가 이러한 메서드가 처리되는 차례 (선입처 방편; FIFO)로 파 미트를 취득하도록 선택되는 것을 보증합니다. FIFO 순서는 필연적으로 이러한 메서드내의 특정의 내부 실행 포인트에 적용됩니다. 이 때문에 어느 thread가 다른 thread보다 전에 acquire를 호출하지만, 다른 thread보다 후에 순서 포인트에 이르는 경우가 있습니다. 또, 메서드로부터의 복귀시에 같은 일이 일어날 가능성도 있습니다. 게다가 시간 설정되어 있지 않은 tryAcquire 메서드는 균등 설정을 존중합니다만, 사용 가능한 파 미트는 받아들입니다.

보통, 자원에의 액세스 제어에 사용하는 semaphore는 균등성을 유지하도록 초기화해, 자원에의 액세스가 곤란하게 되는 thread가 존재하지 않게 할 필요가 있습니다. 다른 종류의 동기 제어로 semaphore를 사용하는 경우, 비균등의 순서부에 한 throughput의 이점이 균등성의 고려보다 자주 중요하게 됩니다.

이 클래스는 한 번에 복수의 파 미트를취득 및해방 하기 위한 편리한 메서드도 제공합니다. 균등성을 true 로 설정하지 않고 이러한 메서드를 사용하는 경우, 무제한하게 연기되는 위험이 늘어나는 것에 유의해 주세요.

도입된 버전 :

1.5

관련 항목:

직렬화 된 형식

생성자 개요

Semaphore (int permits)
지정된 수의 파 미트 및 비균등 설정을 사용해 Semaphore를 작성합니다.

Semaphore (int permits, boolean fair)
지정수의 파 미트 및 지정된 균등 설정을 사용해 Semaphore를 작성합니다.

메서드 개요

void	acquire () 이 semaphore로부터 파 미트를 취득해, 이용 가능하게 될 때까지 블록을 실행합니다.
void	acquire (int permits) 이 semaphore로부터 지정수의 파 미트를 취득해, 모든 것이 이용 가능하게 될 때까지 블록을 실행합니다.
void	acquireUninterruptibly () 이 semaphore로부터 파 미트를 취득합니다.
void	acquireUninterruptibly (int permits) 지정수의 파 미트를 이 semaphore로부터 취득해, 모든 것이 이용 가능하게 될 때까지 블록 합니다.
int	availablePermits () 이 semaphore로 이용 가능한 현재의 파 미트수를 리턴합니다.
int	drainPermits () 곧바로 이용 가능한 파 미트를 모두 취득해 돌려준다
protected Collection <Thread >	getQueuedThreads () 취득을 대기하고 있는 thread를 포함한 컬렉션을 리턴합니다.
int	getQueueLength () 취득을 대기중의 thread의 추정수를 리턴합니다.
boolean	hasQueuedThreads () 취득을 대기중의 thread가 존재할지 어떨지를 조회합니다.
boolean	isFair () 이 semaphore로 균등성이 true 로 설정되어 있는 경우는 true를 리턴합니다.
protected void	reducePermits (int reduction) 이용 가능한 파 미트의 수를, 지정된 수만큼 줄입니다.
void	release () 파 미트를 해방해 semaphore에 리턴합니다.
void	release (int permits) 지정수의 파 미트를 해방해, semaphore에 리턴합니다.
String	toString () 이 semaphore 및 그 상태를 식별하는 캐릭터 라인을 리턴합니다.
boolean	tryAcquire () 호출시에 파 미트가 이용 가능한 경우에게만, 이 semaphore로부터 파 미트를 취득합니다.
boolean	tryAcquire (int permits) 호출시로 지정수의 파 미트를 모두 이용 가능한 경우에게만, 파 미트를 이 semaphore로부터 취득합니다.
boolean	tryAcquire (int permits, long timeout, TimeUnit unit) 지정된 대기 시간내로 지정수의 파 미트가 모두 이용 가능하게 되어, 현재의 thread로인터럽트가 발생하고 있지 않는 경우에 그러한 파 미트를 이 semaphore로부터 취득합니다.
boolean	tryAcquire (long timeout, TimeUnit unit) 지정된 대기 시간내에 파 미트가 이용 가능하게 되어, 현재의 thread로인터럽트가 발생하고 있지 않는 경우에 이 semaphore로부터 파 미트를 취득합니다.

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

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

생성자 상세

Semaphore

public Semaphore(int permits)

지정된 수의 파 미트 및 비균등 설정을 사용해 Semaphore를 작성합니다.

파라미터:

permits - 사용 가능한 파 미트의 초기수. 이것은 잘못된 값 으로 할 수도 있습니다. 값이 부의 경우, 어느 취득이 허가되는 것보다도 전에 해방을 실시할 필요가 있습니다.

Semaphore

public Semaphore(int permits,
                 boolean fair)

지정수의 파 미트 및 지정된 균등 설정을 사용해 Semaphore를 작성합니다.

파라미터:

permits - 사용 가능한 파 미트의 초기수. 이것은 잘못된 값 으로 할 수도 있습니다. 값이 부의 경우, 어느 취득이 허가되는 것보다도 전에 해방을 실시할 필요가 있습니다.

fair - 경합의 발생시에 이 semaphore가 선입처 방편의 파 미트 허가를 보증하는 경우는 true, 그렇지 않은 경우는 false

메서드의 상세

acquire

public void acquire()
             throws InterruptedException 

이 semaphore로부터 파 미트를 취득해, 이용 가능하게 될 때까지 블록을 실행합니다. 그 외의 경우, thread로인터럽트가 발생합니다.

파 미트가 이용 가능한 경우는 그것을 취득해 즉시 복귀해, 이용 가능한 파 미트의 수를 1개 줄입니다.

파 미트를 이용할 수 없는 경우, 현재의 thread는 thread의 스케줄링에 관해서 무효가 되어, 다음의 2개 중 한쪽이 일어날 때까지 대기합니다.

• 다른 thread가 이 semaphore용의 release() 메서드를 호출해, 현재의 thread가 다음에 파 미트를 할당할 수 있다
• 다른 thread가 현재의 thread에인터럽트를 실시한다

현재의 thread로

• 이 메서드에의 엔트리상에서 설정된 인터럽트 스테이터스가 보관 유지되는지,
• 파 미트의 대기중에인터럽트가 발생했을 경우,

InterruptedException이 Throw 되어 현재의 thread의 인터럽트 스테이터스가 클리어 됩니다.

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생했을 경우

관련 항목:

Thread.interrupt()

acquireUninterruptibly

public void acquireUninterruptibly()

이 semaphore로부터 파 미트를 취득합니다. 파 미트가 이용 가능하게 될 때까지 블록을 실행합니다.

파 미트가 이용 가능한 경우는 그것을 취득해 즉시 복귀해, 이용 가능한 파 미트의 수를 1개 줄입니다.

파 미트를 이용할 수 없는 경우, 현재의 thread는 thread의 스케줄링에 관해서 무효가 되어, 다른 thread가 이 semaphore에 대해서 release() 메서드를 호출해, 다음에 파 미트를 할당할 수 있는 것이 현재의 thread가 될 때까지 대기합니다.

파 미트의 대기중에 현재의 thread로인터럽트가 발생했을 경우, 대기는 속행됩니다만, thread가 파 미트를 할당할 수 있을 때는 파 미트로 인터럽트가 발생하지 않았던 경우에 받을 때와는 다른 경우가 있습니다. thread가 메서드로부터 복귀할 때에 인터럽트 상태가 설정됩니다.

tryAcquire

public boolean tryAcquire()

호출시에 파 미트가 이용 가능한 경우에게만, 이 semaphore로부터 파 미트를 취득합니다.

파 미트가 이용 가능한 경우는 그것을 취득해, 값 true로 즉시 복귀해, 이용 가능한 파 미트의 수를 1개 줄입니다.

파 미트를 이용할 수 없는 경우, 이 메서드는 값 false로 즉시 복귀합니다.

이 semaphore가 균등 순서부 정책를 사용하도록 설정되어 있는 경우에서도, 파 미트가 이용 가능하면, 다른 thread가 현재, 대기중일지 어떨지에 관계없이, tryAcquire() 호출에 의해 즉시 그것을 취득합니다. 이 「바징」동작은 균등성을 해친다고 해도, 특정의 상황으로 유용한 것이 됩니다. 균등 설정을 중시하는 경우, 거의 등가인 tryAcquire(0, TimeUnit.SECONDS) 를 사용해 주세요 (이것도 인터럽트를 검출한다).

반환값:

파 미트가 취득되었을 경우는 true, 그렇지 않은 경우는 false

tryAcquire

public boolean tryAcquire(long timeout,
                          TimeUnit  unit)
                   throws InterruptedException 

지정된 대기 시간내에 파 미트가 이용 가능하게 되어, 현재의 thread로인터럽트가 발생하고 있지 않는 경우에 이 semaphore로부터 파 미트를 취득합니다.

파 미트가 이용 가능한 경우는 그것을 취득해, 값 true로 즉시 복귀해, 이용 가능한 파 미트의 수를 1개 줄입니다.

파 미트를 이용할 수 없는 경우, 현재의 thread는 thread의 스케줄링에 관해서 무효가 되어, 다음의 3 개중 한쪽이 일어날 때까지 대기합니다.

• 다른 thread가 이 semaphore용의 release() 메서드를 호출해, 현재의 thread가 다음에 파 미트를 할당할 수 있다
• 다른 thread가 현재의 thread에인터럽트를 실시한다
• 지정된 대기 시간이 경과한다

파 미트가 취득되면, 값 true가 리턴됩니다 .

현재의 thread로

• 이 메서드에의 엔트리상에서 설정된 인터럽트 스테이터스가 보관 유지되는지,
• 파 미트의 취득 대기중에인터럽트가 발생했을 경우,

InterruptedException이 Throw 되어 현재의 thread의 인터럽트 스테이터스가 클리어 됩니다.

지정된 대기 시간이 경과하면, 값 false가 리턴됩니다 . 시간이 제로 또는 그것보다 작은 경우, 메서드는 대기하지 않습니다.

파라미터:

timeout - 파 미트의 최장 대기 시간

unit - timeout 인수의 시간 단위

반환값:

파 미트가 취득되었을 경우는 true, 파 미트가 취득되기 전에 대기 시간이 경과했을 경우는 false

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생했을 경우

관련 항목:

Thread.interrupt()

release

public void release()

파 미트를 해방해 semaphore에 리턴합니다.

파 미트를 해방해, 이용 가능한 파 미트의 수를 1 늘립니다. 몇개의 thread가 파 미트의 취득을 시도하는 경우, 그것이 선택되어 해방된지 얼마 안된 파 미트가 주어집니다. 그 thread는 thread 스케줄링에 관해서 재차 유효하게 됩니다.

파 미트를 해방하는 thread가acquire()를 호출해 파 미트를 취득이 끝난 상태일 필요는 없습니다. semaphore의 적정한 사용법은 어플리케이션의 프로그래밍 규약에 의해 확립됩니다.

acquire

public void acquire(int permits)
             throws InterruptedException 

이 semaphore로부터 지정수의 파 미트를 취득해, 모든 것이 이용 가능하게 될 때까지 블록을 실행합니다. 그 외의 경우, thread로인터럽트가 발생합니다.

지정수의 파 미트가 이용 가능한 경우에 그것을 취득해, 즉시 복귀해, 이용 가능한 파 미트의 수를 지정수만큼 줄입니다.

이용 가능한 파 미트의 수가 부족한 경우, 현재의 thread는 thread의 스케줄링에 관해서 무효가 되어, 다음의 2개 중 한쪽이 일어날 때까지 대기합니다.

• 다른 thread가 이 semaphore용의 release 메서드의 어느쪽이든을 호출해, 다음에 파 미트를 할당할 수 있는 것이 현재의 thread로 이용 가능한 파 미트의 수가 이 요구를 채운다
• 다른 thread가 현재의 thread에인터럽트를 실시한다

현재의 thread로

• 이 메서드에의 엔트리상에서 설정된 인터럽트 스테이터스가 보관 유지되는지,
• 파 미트의 대기중에인터럽트가 발생했을 경우,

InterruptedException이 Throw 되어 현재의 thread의 인터럽트 상태가 클리어 됩니다. 이 thread에 할당할 수 있어야할 파 미트는 release() 호출로 이용 가능하게 되었는지와 같이, 파 미트의 취득을 시도하는 다른 thread에 할당할 수 있습니다.

파라미터:

permits - 얻는 파 미트의 수

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생했을 경우

IllegalArgumentException - 파 미트가 제로 미만의 경우

관련 항목:

Thread.interrupt()

acquireUninterruptibly

public void acquireUninterruptibly(int permits)

지정수의 파 미트를 이 semaphore로부터 취득해, 모든 것이 이용 가능하게 될 때까지 블록 합니다.

지정수의 파 미트가 이용 가능한 경우에 그것을 취득해, 즉시 복귀해, 이용 가능한 파 미트의 수를 지정수만큼 줄입니다.

충분한 수의 파 미트를 이용할 수 없는 경우, 현재의 thread는 thread의 스케줄링에 관해서 무효가 됩니다. 그 후, 다른 thread가 이 semaphore에 대해서 release 메서드의 어느쪽이든을 호출해, 다음번 파 미트를 할당할 수 있는 것이 현재의 thread로 이용 가능한 파 미트의 수가 이 요구를 채울 때까지 대기합니다.

파 미트의 대기중에 현재의 thread로인터럽트가 발생하는 경우, 대기는 계속되어 큐내의 위치는 영향을 받지 않습니다. thread가 이 메서드로부터 복귀할 때, 인터럽트 상태가 설정됩니다.

파라미터:

permits - 얻는 파 미트의 수

예외:

IllegalArgumentException - 파 미트가 제로 미만의 경우

tryAcquire

public boolean tryAcquire(int permits)

호출시로 지정수의 파 미트를 모두 이용 가능한 경우에게만, 파 미트를 이 semaphore로부터 취득합니다.

지정수의 파 미트가 이용 가능한 경우에 그것을 취득해, 즉시 true로 복귀해, 이용 가능한 파 미트의 수를 지정수만큼 줄입니다.

이용 가능한 파 미트의 수가 불충분한 경우, 이 메서드는 값 false로 즉시 복귀합니다. 이용 가능한 파 미트의 수는 변화하지 않습니다.

이 semaphore가 균등 순서부 정책를 사용하도록 설정되어 있는 경우에서도, 파 미트가 이용 가능하면, 다른 thread가 대기중일지 어떨지에 관계없이, tryAcquire 호출에 의해 즉시 그것을 취득합니다. 이 「바징」동작은 균등성을 해친다고 해도, 특정의 상황으로 유용한 것이 됩니다. 균등 설정을 중시하는 경우, 거의 등가인 tryAcquire(permits, 0, TimeUnit.SECONDS) 를 사용해 주세요 (이것도 인터럽트를 검출한다).

파라미터:

permits - 얻는 파 미트의 수

반환값:

파 미트가 취득되었을 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalArgumentException - 파 미트가 제로 미만의 경우

tryAcquire

public boolean tryAcquire(int permits,
                          long timeout,
                          TimeUnit  unit)
                   throws InterruptedException 

지정된 대기 시간내로 지정수의 파 미트가 모두 이용 가능하게 되어, 현재의 thread로인터럽트가 발생하고 있지 않는 경우에 그러한 파 미트를 이 semaphore로부터 취득합니다.

지정수의 파 미트가 이용 가능한 경우에 그것을 취득해, 즉시 값 true로 복귀해, 이용 가능한 파 미트의 수를 지정수만큼 줄입니다.

이용 가능한 파 미트의 수가 부족한 경우, 현재의 thread는 thread의 스케줄링에 관해서 무효가 되어, 다음의 3 개중 한쪽이 일어날 때까지 대기합니다.

• 다른 thread가 이 semaphore용의 release 메서드의 어느쪽이든을 호출해, 다음에 파 미트를 할당할 수 있는 것이 현재의 thread로 이용 가능한 파 미트의 수가 이 요구를 채운다
• 다른 thread가 현재의 thread에인터럽트를 실시한다
• 지정된 대기 시간이 경과한다

파 미트가 취득되면, 값 true가 리턴됩니다 .

현재의 thread로

• 이 메서드에의 엔트리상에서 설정된 인터럽트 스테이터스가 보관 유지되는지,
• 파 미트의 취득 대기중에인터럽트가 발생했을 경우,

InterruptedException이 Throw 되어 현재의 thread의 인터럽트 상태가 클리어 됩니다. 이 thread에 할당할 수 있어야할 파 미트는 release() 호출로 이용 가능하게 되었는지와 같이, 파 미트의 취득을 시도하는 다른 thread에 할당할 수 있습니다.

지정된 대기 시간이 경과하면, 값 false가 리턴됩니다 . 시간이 제로 아래의 경우, 메서드는 대기하지 않습니다. 이 thread에 할당할 수 있어야할 파 미트는 모두, release() 호출에 의해 이용 가능하게 되었는지와 같이, 파 미트의 취득을 시도하는 다른 thread에 대신해에 할당할 수 있습니다.

파라미터:

permits - 얻는 파 미트의 수

timeout - 파 미트의 최장 대기 시간

unit - timeout 인수의 시간 단위

반환값:

모든 파 미트가 취득되었을 경우는 true, 모든 파 미트가 취득되기 전에 대기 시간이 경과했을 경우는 false

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생했을 경우

IllegalArgumentException - 파 미트가 제로 미만의 경우

관련 항목:

Thread.interrupt()

release

public void release(int permits)

지정수의 파 미트를 해방해, semaphore에 리턴합니다.

지정수의 파 미트를 해방해, 그 수만큼 이용 가능한 파 미트를 늘립니다. 파 미트의 취득을 시도하는 임의의 thread가 있는 경우, 그 중 1개의 thread가 선택되어 해방된지 얼마 안된 파 미트가 주어집니다. thread의 요구를 채우는 수의 파 미트가 있는 경우, 그 thread는 thread의 스케줄상의 목적을 유효 (재유효)로 합니다. 그렇지 않은 경우, thread는 충분한 수의 파 미트가 이용 가능하게 될 때까지 대기합니다. 이 thread의 요구가 채워진 다음에도 아직 이용 가능한 파 미트가 남아 있는 경우, 이번은 파 미트의 취득을 시도하는 다른 thread에 이러한 파 미트를 할당할 수 있습니다.

파 미트를 해방하는 thread가acquire를 호출해 파 미트를 취득이 끝난 상태일 필요는 없습니다. semaphore의 적정한 사용법은 어플리케이션의 프로그래밍 규약에 의해 확립됩니다.

파라미터:

permits - 해방하는 파 미트의 수

예외:

IllegalArgumentException - 파 미트가 제로 미만의 경우

availablePermits

public int availablePermits()

이 semaphore로 이용 가능한 현재의 파 미트수를 리턴합니다.

보통, 이 메서드는 디버그 및 테스트 목적으로 사용합니다.

반환값:

이 semaphore로 이용 가능한 파 미트의 수

drainPermits

public int drainPermits()

곧바로 이용 가능한 파 미트를 모두 취득해 돌려준다

반환값:

파 미트의 수

reducePermits

protected void reducePermits(int reduction)

이용 가능한 파 미트의 수를, 지정된 수만큼 줄입니다. 이 메서드는 semaphore를 사용해 이용 불가가 된 자원을 추적하는 서브 클래스에서 유용합니다. 이 메서드는 파 미트가 이용 가능하게 될 때까지의 대기를 블록 하지 않는다고 하는 점으로써, acquire와 다릅니다.

파라미터:

reduction - 삭제하는 파 미트의 수

예외:

IllegalArgumentException - 줄이는 수가 부의 경우

isFair

public boolean isFair()

이 semaphore로 균등성이 true 로 설정되어 있는 경우는 true를 리턴합니다.

반환값:

이 semaphore로 균등성이 true 로 설정되어 있는 경우는 true

hasQueuedThreads

public final boolean hasQueuedThreads()

취득을 대기중의 thread가 존재할지 어떨지를 조회합니다. 취소는 언제라도 발생할 가능성이 있기 때문에 true가 돌려주고져도, 다른 몇개의 thread가 얻는 것은 보증되지 않습니다. 이 메서드는 주로 시스템 상태의 감시에 사용하는 목적으로 설계되고 있습니다.

반환값:

락의 취득을 대기중의 다른 thread가 존재할 가능성이 있는 경우는 true

getQueueLength

public final int getQueueLength()

취득을 대기중의 thread의 추정수를 리턴합니다. 이 메서드가 내부의 데이터 구조를 traversal 하고 있는 동안에도, thread수가 동적으로 변화하는 경우가 있기 때문에 이 값은 추정에 지나지 않습니다. 이 메서드는 동기의 제어용은 아니고, 시스템 상태를 감시하기 위한 것입니다.

반환값:

이 락을 대기하고 있는 thread의 추정수

getQueuedThreads

protected Collection <Thread > getQueuedThreads()

취득을 대기하고 있는 thread를 포함한 컬렉션을 리턴합니다. 실제의 thread 세트는 결과의 구축중에도 동적으로 변화할 가능성이 있기 때문에 리턴된 컬렉션은 최선이 노력한 다음의 추정에 지나지 않습니다. 리턴된 컬렉션의 요소에는 특정의 순서는 존재하지 않습니다. 이 메서드는 보다 포괄적인 감시 기능을 제공하는 서브 클래스의 구축을 용이하게 하는 목적으로 설계되고 있습니다.

반환값:

thread의 컬렉션

toString

public String  toString()

이 semaphore 및 그 상태를 식별하는 캐릭터 라인을 리턴합니다. 상태는 괄호로 둘러싸여 캐릭터 라인 「Permits =」에 이어 파 미트의 수가 지정됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 semaphore 및 그 상태를 식별하는 캐릭터 라인