Класс ReentrantLock

public class ReentrantLock
extends Object
implements Lock, Serializable

Рекурсивный взаимный исключающий Lock с тем же базовым поведением и семантикой, что и неявный мониторный замок, доступный с помощью synchronized методов и операторов, но с расширенными возможностями.

ReentrantLock владеет потоком, последний успешно его заблокировавший, но еще не разблокировавший. Поток, вызывающий lock, вернётся, успешно получив замок, когда замок не владеет другим потоком. Метод вернётся немедленно, если текущий поток уже владеет замком. Это можно проверить с помощью методов isHeldByCurrentThread() и getHoldCount().

Конструктор этого класса принимает необязательный параметр честности. При установке true, при возникновении конфликтов, замки отдаются потоку, который дольше всего ожидает. В противном случае этот замок не гарантирует какой-либо определённый порядок доступа. Программы, использующие честные замки, доступные многим потокам, могут демонстрировать более низкую общую производительность (то есть, медленнее; часто намного медленнее), чем те, которые используют значение по умолчанию, но имеют меньшие отклонения во времени получения замков и гарантируют отсутствие голодания. Однако обратите внимание, что честность замков не гарантирует честности планирования потоков. Таким образом, один из многих потоков, использующих честный замок, может получить его несколько раз подряд, в то время как другие активные потоки не прогрессируют и не владеют замком в данный момент. Также обратите внимание, что асинхронный метод tryLock() не учитывает установку честности. Он будет успешным, если замок доступен, даже если другие потоки ждут.

Рекомендуется всегда немедленно следовать вызову lock блоком try, чаще всего в структуре типа «до/после»:

class X {
   private final ReentrantLock lock = new ReentrantLock();
   // ...

   public void m() {
     lock.lock();  // block until condition holds
     try {
       // ... method body
     } finally {
       lock.unlock()
     }
   }
 }

Помимо реализации интерфейса Lock, этот класс определяет ряд public и protected методов для проверки состояния замка. Некоторые из этих методов полезны только для инструментирования и мониторинга.

Сериализация этого класса работает так же, как и встроенные замки: десериализованный замок находится в разблокированном состоянии, независимо от его состояния при сериализации.

Этот замок поддерживает максимум 2147483647 рекурсивных блокировок одним и тем же потоком. Попытки превысить этот предел приводят к исключению Error из методов блокировки.

Конструкторы

ReentrantLock

public ReentrantLock()

Создаёт экземпляр ReentrantLock. Это эквивалентно использованию ReentrantLock(false).

ReentrantLock

public ReentrantLock(boolean fair)

Создаёт экземпляр ReentrantLock с заданной политикой честности.

Параметры:

fair - true если этот замок должен использовать политику честного упорядочения