class 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 секунд,