класс ActiveRecord::ConnectionAdapters::ConnectionPool::Queue

Родитель:: Объект

Потокобезопасная, справедливая очередь FIFO. Предназначена для использования классом ConnectionPool, с которым она разделяет монитор. Но может быть универсальной очередью Queue.

Очередь Queue из стандартной библиотеки 'thread' могла бы заменить этот класс, за исключением того, что стандартная библиотека не поддерживает ожидание с таймаутом.

Публичные методы класса

new(lock = Monitor.new) Показать исходный код

# File activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb, line 89
def initialize(lock = Monitor.new)
  @lock = lock
  @cond = @lock.new_cond
  @num_waiting = 0
  @queue = []
end

Публичные методы экземпляра

add(element) Показать исходный код

# File activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb, line 112
def add(element)
  synchronize do
    @queue.push element
    @cond.signal
  end
end

Добавить element в очередь. Никогда не блокирует.

any_waiting?() Показать исходный код

# File activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb, line 97
def any_waiting?
  synchronize do
    @num_waiting > 0
  end
end

Проверить, ожидают ли в данный момент какие-либо потоки в очереди.

clear() Показать исходный код

# File activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb, line 127
def clear
  synchronize do
    @queue.clear
  end
end

Удалить все элементы из очереди.

delete(element) Показать исходный код

# File activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb, line 120
def delete(element)
  synchronize do
    @queue.delete(element)
  end
end

Если element находится в очереди, удалить и вернуть его, или nil.

num_waiting() Показать исходный код

# File activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb, line 105
def num_waiting
  synchronize do
    @num_waiting
  end
end

Возвращает количество потоков, которые в данный момент ожидают в этой очереди.

poll(timeout = nil) Показать исходный код

# File activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb, line 147
def poll(timeout = nil)
  synchronize { internal_poll(timeout) }
end

Удалить первый элемент из очереди.

Если timeout не задан, удалить и вернуть первый элемент из очереди, если количество доступных элементов строго больше количества потоков, которые в настоящее время ожидают (то есть, не вырываться вперёд в очереди). В противном случае вернуть nil.

Если timeout задан, заблокировать, если доступного элемента нет, ожидая до timeout секунд, пока элемент не станет доступным.

Вызывает:

ActiveRecord::ConnectionTimeoutError, если timeout задан и ни один элемент

не станет доступным в течение timeout секунд,