класс 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 74
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 97
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 82
def any_waiting?
  synchronize do
    @num_waiting > 0
  end
end

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

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

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

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

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

# File activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb, line 105
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 90
def num_waiting
  synchronize do
    @num_waiting
  end
end

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

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

# File activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb, line 132
def poll(timeout = nil)
  synchronize do
    if timeout
      no_wait_poll || wait_poll(timeout)
    else
      no_wait_poll
    end
  end
end

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

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

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

Вызывает:

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

не станет доступным после timeout секунд,