Class: Moneta::Pool

### Home Classes Methods

### In Files

- lib/moneta/pool.rb

### Parent

Wrapper

### Methods

- ::new
- #adapter
- #close
- #pop
- #wrap

### Files

- LICENSE

### Class/Module Index

Quicksearch

- Moneta
- Moneta::Adapters
- Moneta::Adapters::ActiveRecord
- Moneta::Adapters::Cassandra
- Moneta::Adapters::Client
- Moneta::Adapters::Cookie
- Moneta::Adapters::Couch
- Moneta::Adapters::DBM
- Moneta::Adapters::DataMapper
- Moneta::Adapters::DataMapper::Store
- Moneta::Adapters::Daybreak
- Moneta::Adapters::File
- Moneta::Adapters::Fog
- Moneta::Adapters::GDBM
- Moneta::Adapters::HBase
- Moneta::Adapters::KyotoCabinet
- Moneta::Adapters::LMDB
- Moneta::Adapters::LRUHash
- Moneta::Adapters::LRUHash::Entry
- Moneta::Adapters::LevelDB
- Moneta::Adapters::LocalMemCache
- Moneta::Adapters::MemcachedDalli
- Moneta::Adapters::MemcachedNative
- Moneta::Adapters::Memory
- Moneta::Adapters::MongoBase
- Moneta::Adapters::MongoMoped
- Moneta::Adapters::MongoOfficial
- Moneta::Adapters::Null
- Moneta::Adapters::PStore
- Moneta::Adapters::Redis
- Moneta::Adapters::RestClient
- Moneta::Adapters::Riak
- Moneta::Adapters::SDBM
- Moneta::Adapters::Sequel
- Moneta::Adapters::Sqlite
- Moneta::Adapters::TDB
- Moneta::Adapters::TokyoCabinet
- Moneta::Adapters::TokyoTyrant
- Moneta::Adapters::YAML
- Moneta::Builder
- Moneta::Cache
- Moneta::Cache::DSL
- Moneta::CreateSupport
- Moneta::Defaults
- Moneta::Defaults::ClassMethods
- Moneta::Expires
- Moneta::ExpiresSupport
- Moneta::HashAdapter
- Moneta::IncrementSupport
- Moneta::Lock
- Moneta::Logger
- Moneta::Logger::Format
- Moneta::Mutex
- Moneta::OptionMerger
- Moneta::OptionSupport
- Moneta::Pool
- Moneta::Proxy
- Moneta::Semaphore
- Moneta::Server
- Moneta::Shared
- Moneta::Stack
- Moneta::Stack::DSL
- Moneta::SynchronizePrimitive
- Moneta::Transformer
- Moneta::Transformer::Helper
- Moneta::Utils
- Moneta::WeakCreate
- Moneta::WeakIncrement
- Moneta::Wrapper
- Rack
- Rack::Cache
- Rack::Cache::EntityStore
- Rack::Cache::EntityStore::MONETA
- Rack::Cache::EntityStore::Moneta
- Rack::Cache::MetaStore
- Rack::Cache::MetaStore::MONETA
- Rack::Cache::MetaStore::Moneta
- Rack::Cache::MonetaResolver
- Rack::MonetaCookies
- Rack::MonetaRest
- Rack::MonetaStore
- Rack::Session
- Rack::Session::Moneta
- ActionDispatch
- ActionDispatch::Session
- ActionDispatch::Session::MonetaStore
- ActiveSupport
- ActiveSupport::Cache
- ActiveSupport::Cache::MonetaStore

No matching classes.

# Moneta::Pool

Creates a pool of stores. Each thread gets its own store.

@example Add `Moneta::Pool` to proxy stack

    Moneta.build do
      use(:Pool) do
        # Every thread gets its own instance
        adapter :MemcachedNative
      end
    end

@api public

### Public Class Methods

new(options = {}, &block) click to toggle source

@param [Moneta store] adapter The underlying store @param [Hash] options @option options [String] :mutex (::Mutex.new) Mutex object

    # File lib/moneta/pool.rb, line 20
    def initialize(options = {}, &block)
      super(nil)
      @mutex = options[:mutex] || ::Mutex.new
      @id = "Moneta::Pool(#{object_id})"
      @builder = Builder.new(&block)
      @pool, @all = [], []
    end

### Public Instance Methods

close() click to toggle source

    # File lib/moneta/pool.rb, line 28
    def close
      @mutex.synchronize do
        raise '#close can only be called when no thread is using the pool' if @all.size != @pool.size
        @all.each(&:close)
        @all = @pool = nil
      end
    end

### Protected Instance Methods

adapter() click to toggle source

    # File lib/moneta/pool.rb, line 38
    def adapter
      Thread.current[@id]
    end

pop() click to toggle source

    # File lib/moneta/pool.rb, line 50
    def pop
      if @mutex.synchronize { @pool.empty? }
        store = @builder.build.last
        @mutex.synchronize { @all << store }
        store
      else
        @mutex.synchronize { @pool.pop }
      end
    end

wrap(*args) click to toggle source

    # File lib/moneta/pool.rb, line 42
    def wrap(*args)
      store = Thread.current[@id] = pop
      yield
    ensure
      Thread.current[@id] = nil
      @mutex.synchronize { @pool << store }
    end

[Validate]

Generated with the Darkfish Rdoc Generator 2.