concurrent-ruby 0.8.0.pre2-java → 0.9.0-java

data/lib/concurrent/executor/fixed_thread_pool.rb

@@ -1,33 +1,206 @@
-require 'concurrent/executor/ruby_fixed_thread_pool'
+require 'concurrent/utility/engine'
+require 'concurrent/executor/thread_pool_executor'
 
 module Concurrent
 
-  if RUBY_PLATFORM == 'java'
-    require 'concurrent/executor/java_fixed_thread_pool'
-    # @!macro [attach] fixed_thread_pool
-    #
-    #   A thread pool with a set number of threads. The number of threads in the pool
-    #   is set on construction and remains constant. When all threads are busy new
-    #   tasks `#post` to the thread pool are enqueued until a thread becomes available.
-    #   Should a thread crash for any reason the thread will immediately be removed
-    #   from the pool and replaced.
+  # @!macro [new] thread_pool_executor_constant_default_max_pool_size
+  #   Default maximum number of threads that will be created in the pool.
+
+  # @!macro [new] thread_pool_executor_constant_default_min_pool_size
+  #   Default minimum number of threads that will be retained in the pool.
+
+  # @!macro [new] thread_pool_executor_constant_default_max_queue_size
+  #   Default maximum number of tasks that may be added to the task queue.
+
+  # @!macro [new] thread_pool_executor_constant_default_thread_timeout
+  #   Default maximum number of seconds a thread in the pool may remain idle
+  #   before being reclaimed.
+
+  # @!macro [new] thread_pool_executor_attr_reader_max_length
+  #   The maximum number of threads that may be created in the pool.
+  #   @return [Integer] The maximum number of threads that may be created in the pool.
+
+  # @!macro [new] thread_pool_executor_attr_reader_min_length
+  #   The minimum number of threads that may be retained in the pool.
+  #   @return [Integer] The minimum number of threads that may be retained in the pool.
+
+  # @!macro [new] thread_pool_executor_attr_reader_largest_length
+  #   The largest number of threads that have been created in the pool since construction.
+  #   @return [Integer] The largest number of threads that have been created in the pool since construction.
+
+  # @!macro [new] thread_pool_executor_attr_reader_scheduled_task_count
+  #   The number of tasks that have been scheduled for execution on the pool since construction.
+  #   @return [Integer] The number of tasks that have been scheduled for execution on the pool since construction.
+
+  # @!macro [new] thread_pool_executor_attr_reader_completed_task_count
+  #   The number of tasks that have been completed by the pool since construction.
+  #   @return [Integer] The number of tasks that have been completed by the pool since construction.
+
+  # @!macro [new] thread_pool_executor_attr_reader_idletime
+  #   The number of seconds that a thread may be idle before being reclaimed.
+  #   @return [Integer] The number of seconds that a thread may be idle before being reclaimed.
+
+  # @!macro [new] thread_pool_executor_attr_reader_max_queue
+  #   The maximum number of tasks that may be waiting in the work queue at any one time.
+  #   When the queue size reaches `max_queue` subsequent tasks will be rejected in
+  #   accordance with the configured `fallback_policy`.
+  #
+  #   @return [Integer] The maximum number of tasks that may be waiting in the work queue at any one time.
+  #     When the queue size reaches `max_queue` subsequent tasks will be rejected in
+  #     accordance with the configured `fallback_policy`.
+
+  # @!macro [new] thread_pool_executor_attr_reader_length
+  #   The number of threads currently in the pool.
+  #   @return [Integer] The number of threads currently in the pool.
+
+  # @!macro [new] thread_pool_executor_attr_reader_queue_length
+  #   The number of tasks in the queue awaiting execution.
+  #   @return [Integer] The number of tasks in the queue awaiting execution.
+
+  # @!macro [new] thread_pool_executor_attr_reader_remaining_capacity
+  #   Number of tasks that may be enqueued before reaching `max_queue` and rejecting
+  #   new tasks. A value of -1 indicates that the queue may grow without bound.
+  #
+  #   @return [Integer] Number of tasks that may be enqueued before reaching `max_queue` and rejecting
+  #     new tasks. A value of -1 indicates that the queue may grow without bound.
+
+
+
+
+
+  # @!macro [new] thread_pool_executor_public_api
+  #
+  #   @!macro abstract_executor_service_public_api
+  #
+  #   @!attribute [r] max_length
+  #     @!macro thread_pool_executor_attr_reader_max_length
+  #
+  #   @!attribute [r] min_length
+  #     @!macro thread_pool_executor_attr_reader_min_length
+  #
+  #   @!attribute [r] largest_length
+  #     @!macro thread_pool_executor_attr_reader_largest_length
+  #
+  #   @!attribute [r] scheduled_task_count
+  #     @!macro thread_pool_executor_attr_reader_scheduled_task_count
+  #
+  #   @!attribute [r] completed_task_count
+  #     @!macro thread_pool_executor_attr_reader_completed_task_count
+  #
+  #   @!attribute [r] idletime
+  #     @!macro thread_pool_executor_attr_reader_idletime
+  #
+  #   @!attribute [r] max_queue
+  #     @!macro thread_pool_executor_attr_reader_max_queue
+  #
+  #   @!attribute [r] length
+  #     @!macro thread_pool_executor_attr_reader_length
+  #
+  #   @!attribute [r] queue_length
+  #     @!macro thread_pool_executor_attr_reader_queue_length
+  #
+  #   @!attribute [r] remaining_capacity
+  #     @!macro thread_pool_executor_attr_reader_remaining_capacity
+  #
+  #   @!method can_overflow?
+  #     @!macro executor_service_method_can_overflow_question
+
+
+
+
+  # @!macro [new] thread_pool_options
+  #
+  #   **Thread Pool Options**
+  #
+  #   Thread pools support several configuration options:
+  #
+  #   * `idletime`: The number of seconds that a thread may be idle before being reclaimed.
+  #   * `max_queue`: The maximum number of tasks that may be waiting in the work queue at
+  #     any one time. When the queue size reaches `max_queue` subsequent tasks will be
+  #     rejected in accordance with the configured `fallback_policy`.
+  #   * `auto_terminate`: When true (default) an `at_exit` handler will be registered which
+  #     will stop the thread pool when the application exits. See below for more information
+  #     on shutting down thread pools.
+  #   * `fallback_policy`: The policy defining how rejected tasks are handled.
+  #
+  #   Three fallback policies are supported:
+  #
+  #   * `:abort`: Raise a `RejectedExecutionError` exception and discard the task.
+  #   * `:discard`: Discard the task and return false.
+  #   * `:caller_runs`: Execute the task on the calling thread.
+  #
+  #   **Shutting Down Thread Pools**
+  #
+  #   Killing a thread pool while tasks are still being processed, either by calling
+  #   the `#kill` method or at application exit, will have unpredictable results. There
+  #   is no way for the thread pool to know what resources are being used by the
+  #   in-progress tasks. When those tasks are killed the impact on those resources
+  #   cannot be predicted. The *best* practice is to explicitly shutdown all thread
+  #   pools using the provided methods:
+  #
+  #   * Call `#shutdown` to initiate an orderly termination of all in-progress tasks
+  #   * Call `#wait_for_termination` with an appropriate timeout interval an allow
+  #     the orderly shutdown to complete
+  #   * Call `#kill` *only when* the thread pool fails to shutdown in the allotted time
+  #
+  #   On some runtime platforms (most notably the JVM) the application will not
+  #   exit until all thread pools have been shutdown. To prevent applications from
+  #   "hanging" on exit all thread pools include an `at_exit` handler that will
+  #   stop the thread pool when the application exists. This handler uses a brute
+  #   force method to stop the pool and makes no guarantees regarding resources being
+  #   used by any tasks still running. Registration of this `at_exit` handler can be
+  #   prevented by setting the thread pool's constructor `:auto_terminate` option to
+  #   `false` when the thread pool is created. All thread pools support this option.
+  #
+  #   ```ruby
+  #   pool1 = Concurrent::FixedThreadPool.new(5) # an `at_exit` handler will be registered
+  #   pool2 = Concurrent::FixedThreadPool.new(5, auto_terminate: false) # prevent `at_exit` handler registration
+  #   ```
+  #
+  #   @note Failure to properly shutdown a thread pool can lead to unpredictable results.
+  #     Please read *Shutting Down Thread Pools* for more information.
+  #
+  #   @see http://docs.oracle.com/javase/tutorial/essential/concurrency/pools.html Java Tutorials: Thread Pools
+  #   @see http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Executors.html Java Executors class
+  #   @see http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ExecutorService.html Java ExecutorService interface
+  #   @see http://ruby-doc.org//core-2.2.0/Kernel.html#method-i-at_exit Kernel#at_exit
+
+
+
+
+
+  # @!macro [attach] fixed_thread_pool
+  #
+  #   A thread pool with a set number of threads. The number of threads in the pool
+  #   is set on construction and remains constant. When all threads are busy new
+  #   tasks `#post` to the thread pool are enqueued until a thread becomes available.
+  #   Should a thread crash for any reason the thread will immediately be removed
+  #   from the pool and replaced.
+  #
+  #   The API and behavior of this class are based on Java's `FixedThreadPool`
+  #
+  # @!macro thread_pool_options
+  class FixedThreadPool < ThreadPoolExecutor
+
+    # @!macro [attach] fixed_thread_pool_method_initialize
     #
-    #   The API and behavior of this class are based on Java's `FixedThreadPool`
+    #   Create a new thread pool.
     #
-    #   @note When running on the JVM (JRuby) this class will inherit from `JavaFixedThreadPool`.
-    #     On all other platforms it will inherit from `RubyFixedThreadPool`.
+    #   @param [Integer] num_threads the number of threads to allocate
+    #   @param [Hash] opts the options defining pool behavior.
+    #   @option opts [Symbol] :fallback_policy (`:abort`) the fallback policy
     #
-    #   @see Concurrent::RubyFixedThreadPool
-    #   @see Concurrent::JavaFixedThreadPool
+    #   @raise [ArgumentError] if `num_threads` is less than or equal to zero
+    #   @raise [ArgumentError] if `fallback_policy` is not a known policy
     #
-    #   @see http://docs.oracle.com/javase/tutorial/essential/concurrency/pools.html
-    #   @see http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Executors.html
-    #   @see http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ExecutorService.html
-    class FixedThreadPool < JavaFixedThreadPool
-    end
-  else
-    # @!macro fixed_thread_pool
-    class FixedThreadPool < RubyFixedThreadPool
+    #   @see http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/Executors.html#newFixedThreadPool-int-
+    def initialize(num_threads, opts = {})
+      raise ArgumentError.new('number of threads must be greater than zero') if num_threads.to_i < 1
+      defaults  = { max_queue:   DEFAULT_MAX_QUEUE_SIZE,
+                    idletime:    DEFAULT_THREAD_IDLETIMEOUT }
+      overrides = { min_threads: num_threads,
+                    max_threads: num_threads }
+      super(defaults.merge(opts).merge(overrides))
     end
   end
 end

data/lib/concurrent/executor/immediate_executor.rb

@@ -1,5 +1,5 @@
 require 'concurrent/atomic/event'
-require 'concurrent/executor/executor'
+require 'concurrent/executor/executor_service'
 
 module Concurrent
 
@@ -14,14 +14,14 @@ module Concurrent
   #
   # @note Intended for use primarily in testing and debugging.
   class ImmediateExecutor
-    include SerialExecutor
+    include SerialExecutorService
 
     # Creates a new executor
     def initialize
       @stopped = Concurrent::Event.new
     end
 
-    # @!macro executor_method_post
+    # @!macro executor_service_method_post
     def post(*args, &task)
       raise ArgumentError.new('no block given') unless block_given?
       return false unless running?
@@ -29,35 +29,35 @@ module Concurrent
       true
     end
 
-    # @!macro executor_method_left_shift
+    # @!macro executor_service_method_left_shift
     def <<(task)
       post(&task)
       self
     end
 
-    # @!macro executor_method_running_question
+    # @!macro executor_service_method_running_question
     def running?
       ! shutdown?
     end
 
-    # @!macro executor_method_shuttingdown_question
+    # @!macro executor_service_method_shuttingdown_question
     def shuttingdown?
       false
     end
 
-    # @!macro executor_method_shutdown_question
+    # @!macro executor_service_method_shutdown_question
     def shutdown?
       @stopped.set?
     end
 
-    # @!macro executor_method_shutdown
+    # @!macro executor_service_method_shutdown
     def shutdown
       @stopped.set
       true
     end
     alias_method :kill, :shutdown
 
-    # @!macro executor_method_wait_for_termination
+    # @!macro executor_service_method_wait_for_termination
     def wait_for_termination(timeout = nil)
       @stopped.wait(timeout)
     end

data/lib/concurrent/executor/indirect_immediate_executor.rb

@@ -1,4 +1,5 @@
-require 'concurrent/executor/executor'
+require 'concurrent/executor/immediate_executor'
+require 'concurrent/executor/simple_executor_service'
 
 module Concurrent
   # An executor service which runs all operations on a new thread, blocking
@@ -19,10 +20,10 @@ module Concurrent
     # Creates a new executor
     def initialize
       super
-      @internal_executor = PerThreadExecutor.new
+      @internal_executor = SimpleExecutorService.new
     end
 
-    # @!macro executor_method_post
+    # @!macro executor_service_method_post
     def post(*args, &task)
       raise ArgumentError.new("no block given") unless block_given?
       return false unless running?

data/lib/concurrent/executor/java_single_thread_executor.rb

@@ -1,27 +1,28 @@
-if RUBY_PLATFORM == 'java'
-  require_relative 'executor'
+if Concurrent.on_jruby?
+
+  require 'concurrent/executor/executor_service'
 
   module Concurrent
 
     # @!macro single_thread_executor
-    class JavaSingleThreadExecutor
-      include JavaExecutor
-      include SerialExecutor
+    # @!macro thread_pool_options
+    # @!macro abstract_executor_service_public_api
+    # @!visibility private
+    class JavaSingleThreadExecutor < JavaExecutorService
+      include SerialExecutorService
 
-      # Create a new thread pool.
-      #
-      # @option opts [Symbol] :fallback_policy (:discard) the policy
-      #   for handling new tasks that are received when the queue size
-      #   has reached `max_queue` or after the executor has shut down
-      #
-      # @see http://docs.oracle.com/javase/tutorial/essential/concurrency/pools.html
-      # @see http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Executors.html
-      # @see http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ExecutorService.html
+      # @!macro single_thread_executor_method_initialize
       def initialize(opts = {})
+        super(opts)
+      end
+
+      protected
+      
+      def ns_initialize(opts)
         @executor = java.util.concurrent.Executors.newSingleThreadExecutor
         @fallback_policy = opts.fetch(:fallback_policy, :discard)
-        raise ArgumentError.new("#{@fallback_policy} is not a valid fallback policy") unless FALLBACK_POLICIES.keys.include?(@fallback_policy)
-        set_shutdown_hook
+        raise ArgumentError.new("#{@fallback_policy} is not a valid fallback policy") unless FALLBACK_POLICY_CLASSES.keys.include?(@fallback_policy)
+        self.auto_terminate = opts.fetch(:auto_terminate, true)
       end
     end
   end

data/lib/concurrent/executor/java_thread_pool_executor.rb

@@ -1,168 +1,121 @@
-if RUBY_PLATFORM == 'java'
-  require_relative 'executor'
+if Concurrent.on_jruby?
+
+  require 'concurrent/executor/executor_service'
 
   module Concurrent
 
     # @!macro thread_pool_executor
-    class JavaThreadPoolExecutor
-      include JavaExecutor
+    # @!macro thread_pool_options
+    # @!visibility private
+    class JavaThreadPoolExecutor < JavaExecutorService
 
-      # Default maximum number of threads that will be created in the pool.
+      # @!macro thread_pool_executor_constant_default_max_pool_size
       DEFAULT_MAX_POOL_SIZE = java.lang.Integer::MAX_VALUE # 2147483647
 
-      # Default minimum number of threads that will be retained in the pool.
+      # @!macro thread_pool_executor_constant_default_min_pool_size
       DEFAULT_MIN_POOL_SIZE = 0
 
-      # Default maximum number of tasks that may be added to the task queue.
+      # @!macro thread_pool_executor_constant_default_max_queue_size
       DEFAULT_MAX_QUEUE_SIZE = 0
 
-      # Default maximum number of seconds a thread in the pool may remain idle
-      # before being reclaimed.
+      # @!macro thread_pool_executor_constant_default_thread_timeout
       DEFAULT_THREAD_IDLETIMEOUT = 60
 
-      # The maximum number of threads that may be created in the pool.
+      # @!macro thread_pool_executor_attr_reader_max_length
       attr_reader :max_length
 
-      # The maximum number of tasks that may be waiting in the work queue at any one time.
-      # When the queue size reaches `max_queue` subsequent tasks will be rejected in
-      # accordance with the configured `fallback_policy`.
+      # @!macro thread_pool_executor_attr_reader_max_queue
       attr_reader :max_queue
 
-      # Create a new thread pool.
-      #
-      # @param [Hash] opts the options which configure the thread pool
-      #
-      # @option opts [Integer] :max_threads (DEFAULT_MAX_POOL_SIZE) the maximum
-      #   number of threads to be created
-      # @option opts [Integer] :min_threads (DEFAULT_MIN_POOL_SIZE) the minimum
-      #   number of threads to be retained
-      # @option opts [Integer] :idletime (DEFAULT_THREAD_IDLETIMEOUT) the maximum
-      #   number of seconds a thread may be idle before being reclaimed
-      # @option opts [Integer] :max_queue (DEFAULT_MAX_QUEUE_SIZE) the maximum
-      #   number of tasks allowed in the work queue at any one time; a value of
-      #   zero means the queue may grow without bound
-      # @option opts [Symbol] :fallback_policy (:abort) the policy for handling new
-      #   tasks that are received when the queue size has reached
-      #   `max_queue` or the executir has shut down
-      #
-      # @raise [ArgumentError] if `:max_threads` is less than one
-      # @raise [ArgumentError] if `:min_threads` is less than zero
-      # @raise [ArgumentError] if `:fallback_policy` is not one of the values specified
-      #   in `FALLBACK_POLICIES`
-      #
-      # @see http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/ThreadPoolExecutor.html
+      # @!macro thread_pool_executor_method_initialize
       def initialize(opts = {})
-        min_length = opts.fetch(:min_threads, DEFAULT_MIN_POOL_SIZE).to_i
-        max_length = opts.fetch(:max_threads, DEFAULT_MAX_POOL_SIZE).to_i
-        idletime = opts.fetch(:idletime, DEFAULT_THREAD_IDLETIMEOUT).to_i
-        @max_queue = opts.fetch(:max_queue, DEFAULT_MAX_QUEUE_SIZE).to_i
-        @fallback_policy = opts.fetch(:fallback_policy, opts.fetch(:overflow_policy, :abort))
-        warn '[DEPRECATED] :overflow_policy is deprecated terminology, please use :fallback_policy instead' if opts.has_key?(:overflow_policy)
-
-        raise ArgumentError.new('max_threads must be greater than zero') if max_length <= 0
-        raise ArgumentError.new('min_threads cannot be less than zero') if min_length < 0
-        raise ArgumentError.new('min_threads cannot be more than max_threads') if min_length > max_length
-        raise ArgumentError.new("#{fallback_policy} is not a valid fallback policy") unless FALLBACK_POLICIES.include?(@fallback_policy)
-
-        if @max_queue == 0
-          queue = java.util.concurrent.LinkedBlockingQueue.new
-        else
-          queue = java.util.concurrent.LinkedBlockingQueue.new(@max_queue)
-        end
-
-        @executor = java.util.concurrent.ThreadPoolExecutor.new(
-          min_length, max_length,
-          idletime, java.util.concurrent.TimeUnit::SECONDS,
-          queue, FALLBACK_POLICIES[@fallback_policy].new)
-
-        set_shutdown_hook
+        super(opts)
       end
 
-      # @!macro executor_module_method_can_overflow_question
+      # @!macro executor_service_method_can_overflow_question
       def can_overflow?
         @max_queue != 0
       end
 
-      # The minimum number of threads that may be retained in the pool.
-      #
-      # @return [Integer] the min_length
+      # @!macro thread_pool_executor_attr_reader_min_length
       def min_length
         @executor.getCorePoolSize
       end
 
-      # The maximum number of threads that may be created in the pool.
-      #
-      # @return [Integer] the max_length
+      # @!macro thread_pool_executor_attr_reader_max_length
       def max_length
         @executor.getMaximumPoolSize
       end
 
-      # The number of threads currently in the pool.
-      #
-      # @return [Integer] the length
+      # @!macro thread_pool_executor_attr_reader_length
       def length
         @executor.getPoolSize
       end
-      alias_method :current_length, :length
 
-      # The largest number of threads that have been created in the pool since construction.
-      #
-      # @return [Integer] the largest_length
+      # @!macro thread_pool_executor_attr_reader_largest_length
       def largest_length
         @executor.getLargestPoolSize
       end
 
-      # The number of tasks that have been scheduled for execution on the pool since construction.
-      #
-      # @return [Integer] the scheduled_task_count
+      # @!macro thread_pool_executor_attr_reader_scheduled_task_count
       def scheduled_task_count
         @executor.getTaskCount
       end
 
-      # The number of tasks that have been completed by the pool since construction.
-      #
-      # @return [Integer] the completed_task_count
+      # @!macro thread_pool_executor_attr_reader_completed_task_count
       def completed_task_count
         @executor.getCompletedTaskCount
       end
 
-      # The number of seconds that a thread may be idle before being reclaimed.
-      #
-      # @return [Integer] the idletime
+      # @!macro thread_pool_executor_attr_reader_idletime
       def idletime
         @executor.getKeepAliveTime(java.util.concurrent.TimeUnit::SECONDS)
       end
 
-      # The number of tasks in the queue awaiting execution.
-      #
-      # @return [Integer] the queue_length
+      # @!macro thread_pool_executor_attr_reader_queue_length
       def queue_length
         @executor.getQueue.size
       end
 
-      # Number of tasks that may be enqueued before reaching `max_queue` and rejecting
-      # new tasks. A value of -1 indicates that the queue may grow without bound.
-      #
-      # @return [Integer] the remaining_capacity
+      # @!macro thread_pool_executor_attr_reader_remaining_capacity
       def remaining_capacity
         @max_queue == 0 ? -1 : @executor.getQueue.remainingCapacity
       end
 
-      # This method is deprecated and will be removed soon.
-      # This method is supost to return the threads status, but Java API doesn't
-      # provide a way to get the thread status. So we return an empty Array instead.
-      def status
-        warn '[DEPRECATED] `status` is deprecated and will be removed soon.'
-        warn "Calls to `status` return an empty Array. Java ThreadPoolExecutor does not provide thread's status."
-        []
-      end
-
-      # Is the thread pool running?
-      #
-      # @return [Boolean] `true` when running, `false` when shutting down or shutdown
+      # @!macro executor_service_method_running_question
       def running?
         super && !@executor.isTerminating
       end
+
+      protected
+
+      def ns_initialize(opts)
+        min_length = opts.fetch(:min_threads, DEFAULT_MIN_POOL_SIZE).to_i
+        max_length = opts.fetch(:max_threads, DEFAULT_MAX_POOL_SIZE).to_i
+        idletime = opts.fetch(:idletime, DEFAULT_THREAD_IDLETIMEOUT).to_i
+        @max_queue = opts.fetch(:max_queue, DEFAULT_MAX_QUEUE_SIZE).to_i
+        @fallback_policy = opts.fetch(:fallback_policy, opts.fetch(:overflow_policy, :abort))
+        deprecated ' :overflow_policy is deprecated terminology, please use :fallback_policy instead' if opts.has_key?(:overflow_policy)
+
+        raise ArgumentError.new("`max_threads` cannot be less than #{DEFAULT_MIN_POOL_SIZE}") if max_length < DEFAULT_MIN_POOL_SIZE
+        raise ArgumentError.new("`max_threads` cannot be greater than #{DEFAULT_MAX_POOL_SIZE}") if max_length > DEFAULT_MAX_POOL_SIZE
+        raise ArgumentError.new("`min_threads` cannot be less than #{DEFAULT_MIN_POOL_SIZE}") if min_length < DEFAULT_MIN_POOL_SIZE
+        raise ArgumentError.new("`min_threads` cannot be more than `max_threads`") if min_length > max_length
+        raise ArgumentError.new("#{fallback_policy} is not a valid fallback policy") unless FALLBACK_POLICY_CLASSES.include?(@fallback_policy)
+
+        if @max_queue == 0
+          queue = java.util.concurrent.LinkedBlockingQueue.new
+        else
+          queue = java.util.concurrent.LinkedBlockingQueue.new(@max_queue)
+        end
+
+        @executor = java.util.concurrent.ThreadPoolExecutor.new(
+          min_length, max_length,
+          idletime, java.util.concurrent.TimeUnit::SECONDS,
+          queue, FALLBACK_POLICY_CLASSES[@fallback_policy].new)
+
+        self.auto_terminate = opts.fetch(:auto_terminate, true)
+      end
     end
   end
 end