torquebox-core 3.2.0-java → 4.0.0.alpha1-java

data/lib/torquebox/registry.rb

@@ -1,52 +0,0 @@
-# Copyright 2008-2013 Red Hat, Inc, and individual contributors.
-# 
-# This is free software; you can redistribute it and/or modify it
-# under the terms of the GNU Lesser General Public License as
-# published by the Free Software Foundation; either version 2.1 of
-# the License, or (at your option) any later version.
-# 
-# This software is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-# Lesser General Public License for more details.
-# 
-# You should have received a copy of the GNU Lesser General Public
-# License along with this software; if not, write to the Free
-# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-# 02110-1301 USA, or see the FSF site: http://www.fsf.org.
-
-require 'thread'
-
-module TorqueBox
-  class Registry
-    # @api private
-    MUTEX = Mutex.new
-
-    class << self
-      def merge!(hash)
-        MUTEX.synchronize do
-          registry.merge!(hash)
-        end
-      end
-
-      def [](key)
-        value = nil
-        MUTEX.synchronize do
-          value = registry[key]
-        end
-        value
-      end
-
-      def has_key?(key)
-        MUTEX.synchronize do
-          registry.has_key?(key)
-        end
-      end
-
-      def registry
-        @registry ||= {}
-      end
-    end
-
-  end
-end

data/lib/torquebox/scheduled_job.rb

@@ -1,245 +0,0 @@
-# Copyright 2008-2013 Red Hat, Inc, and individual contributors.
-# 
-# This is free software; you can redistribute it and/or modify it
-# under the terms of the GNU Lesser General Public License as
-# published by the Free Software Foundation; either version 2.1 of
-# the License, or (at your option) any later version.
-# 
-# This software is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-# Lesser General Public License for more details.
-# 
-# You should have received a copy of the GNU Lesser General Public
-# License along with this software; if not, write to the Free
-# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-# 02110-1301 USA, or see the FSF site: http://www.fsf.org.
-
-module TorqueBox
-  # This class is a Ruby API to manipulating TorqueBox scheduled jobs.
-  class ScheduledJob
-    class << self
-
-      # Creates a new scheduled job.
-      #
-      # @note This is an asynchronous method.
-      # @param class_name The scheduled job implementation
-      #                   class name
-      # @param cron The cron expression defining when the job
-      #             should run
-      # @param options Optional parameters (a Hash), including:
-      # @option options [String] :name The job name unique across the application, if not provided set to the class name
-      # @option options [String] :description Job description
-      # @option options [String] :timeout The time after the job execution should be interrupted. By default it'll never interrupt the job execution. Example: '2s', '1m'
-      # @option options [Hash] :config Data that should be injected to the job constructor
-      # @option options [Boolean] :stopped If the job should be stopped after installation (default: false)
-      # @option options [Boolean] :singleton Flag to determine if the job should be executed on every node (set to true, default) in the cluster or only on one node (set to false).
-      # @return [java.util.concurrent.CountDownLatch] The latch to wait for the task completion
-      # @see http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/CountDownLatch.html
-      #
-      # @example A simple job
-      #   TorqueBox::ScheduledJob.schedule('SimpleJob', "*/10 * * * * ?")
-      #
-      # @example A simple job with custom name
-      #   TorqueBox::ScheduledJob.schedule('SimpleJob', "*/10 * * * * ?", :name => "simple.job")
-      #
-      # @example Schedule a job with data to be injected to the job constructor
-      #   ScheduledJob.schedule('SimpleJob', "*/10 * * * * ?", :name => "simple.config.job", :config => {:text => "text", :hash => {:a => 2}})
-      #
-      # @example Schedule a job stopped after creation
-      #   TorqueBox::ScheduledJob.schedule('SimpleJob', "*/10 * * * * ?", :stopped => true)
-      def schedule(class_name, cron, options = {})
-        raise "No job class name provided" if class_name.nil?
-        raise "No cron expression provided" if cron.nil?
-
-        options = {
-            :name => class_name.to_s,
-            :singleton => true,
-            :stopped => false,
-            :timeout => "0s"
-        }.merge(options)
-
-        with_schedulizer do |schedulizer|
-          schedulizer.create_job(class_name.to_s, cron, options[:timeout], options[:name], options[:description], options[:config], options[:singleton], options[:stopped])
-        end
-      end
-
-      # Creates a new scheduled job.
-      #
-      # @note This is a synchronous method.
-      # @note This method accepts the same parameters as available in the schedule method.
-      # @return [Boolean] true if the job was successfully created, false otherwise
-      # @see TorqueBox::ScheduledJob.schedule
-      def schedule_sync(class_name, cron, options = {})
-        latch = schedule(class_name, cron, options)
-        wait_for_latch(latch)
-      end
-
-      # Creates new 'at' job.
-      #
-      # @note This is an asynchronous method.
-      # @param class_name [String] The class name of the scheduled job to be executed
-      # @param options [Hash] A hash containing the at job options:
-      # @option options [Time] :at [Time] The start time of the job
-      # @option options [Fixnum] :in Specifies when the job execution should start, in ms
-      # @option options [Fixnum] :repeat Specifies the number of times to execute the job
-      # @option options [Fixnum] :every Specifies the delay (in ms) between job executions
-      # @option options [Time] :until The stop time of job execution
-      # @option options [String] :name The job name unique across the application, by default set to the job class name
-      # @option options [String] :description Job description
-      # @option options [String] :timeout The time after the job execution should be interrupted. By default it'll never interrupt the job execution. Example: '2s', '1m'
-      # @option options [Hash] :config Data that should be injected to the job constructor
-      # @option options [Boolean] :singleton Flag to determine if the job should be executed on every node (set to true) in the cluster or only on one node (set to false, default).
-      # @return [java.util.concurrent.CountDownLatch] The latch to wait for the task completion
-      # @see http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/CountDownLatch.html
-      #
-      # @example Run a job every 200 ms for over 5 seconds, from now
-      #   TorqueBox::ScheduledJob.at('SimpleJob', :every => 200, :until => Time.now + 5)
-      #
-      # @example Start in 1 second, then every 200 ms for over 4 seconds (5 seconds from now, but start is delayed):
-      #   TorqueBox::ScheduledJob.at('SimpleJob', :at => Time.now + 1, :every => 200, :until => Time.now + 5)
-      #
-      # @example Start in 1 second, then every 200 ms for over 4 seconds (5 seconds from now, but start is delayed):
-      #   TorqueBox::ScheduledJob.at('SimpleJob', :in => 1_000, :every => 200, :until => Time.now + 5)
-      #
-      # @example Start in 1 second, then repeat te job 10 times, every 200 ms
-      #   TorqueBox::ScheduledJob.at('SimpleJob', :in => 1_000, :repeat => 10, :every => 200)
-      def at(class_name, options = {})
-        raise "No job class name provided" if class_name.nil?
-        raise "Invalid options for scheduling the job" if options.nil? or !options.is_a?(Hash)
-        raise "Invalid type for :in, should be a Fixnum" if !options[:in].nil? and !options[:in].is_a?(Fixnum)
-        raise "You can't specify both :at and :in" if options.has_key?(:at) and options.has_key?(:in)
-        raise "You can't specify :repeat without :every" if options.has_key?(:repeat) and !options.has_key?(:every)
-        raise "You can't specify :until without :every" if options.has_key?(:until) and !options.has_key?(:every)
-
-        options = {
-            :singleton => false,
-            :name => class_name,
-            :timeout => "0s",
-            :repeat => 0,
-            :every => 0,
-            :at => Time.now,
-            :async => true
-        }.merge(options)
-
-        if options.has_key?(:in)
-          start = Time.now + options[:in] / 1000.0
-        else
-          start = options[:at]
-        end
-
-        with_schedulizer do |schedulizer|
-          schedulizer.create_at_job(class_name.to_s, start, options[:until], options[:every], options[:repeat], options[:timeout], options[:name], options[:description], options[:config], options[:singleton])
-        end
-      end
-
-      # Creates new 'at' job.
-      #
-      # @note This is a synchronous method.
-      # @note This method accepts the same parameters as available in the at method.
-      # @return [Boolean] true if the job was successfully created, false otherwise
-      # @see TorqueBox::ScheduledJob.at
-      def at_sync(class_name, options = {})
-        latch = at(class_name, options)
-        wait_for_latch(latch)
-      end
-
-      # Removes a scheduled job.
-      #
-      # This method removes the job asynchronously.
-      #
-      # @param name [String] The job name.
-      # @return [java.util.concurrent.CountDownLatch] The latch to wait for the task completion
-      # @see http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/CountDownLatch.html
-      def remove(name)
-        raise "No job name provided" if name.nil?
-        raise "Couldn't find a job with name '#{name}''" if TorqueBox::ScheduledJob.lookup(name).nil?
-
-        with_schedulizer do |schedulizer|
-          schedulizer.remove_job(name)
-        end
-      end
-
-      # Removes a scheduled job.
-      #
-      # @note This is a synchronous method.
-      # @note This method accepts the same parameters as available in the remove method.
-      # @return [Boolean] true if the job was successfully removed, false otherwise
-      # @see TorqueBox::ScheduledJob.remove
-      def remove_sync(name)
-        latch = remove(name)
-        wait_for_latch(latch)
-      end
-
-      # List all scheduled jobs of this application.
-      #
-      # @return [Array<org.torquebox.jobs.ScheduledJob>] the list of
-      #   ScheduledJob instances - see
-      #   {TorqueBox::ScheduledJob.lookup} for more details on these
-      #   instances
-      def list
-        prefix = job_service_name.canonical_name
-        service_names = TorqueBox::MSC.service_names.select do |service_name|
-          name = service_name.canonical_name
-          name.start_with?(prefix) && !name.end_with?('mbean')
-        end
-        service_names.map do |service_name|
-          service = TorqueBox::MSC.get_service(service_name)
-          service.nil? ? nil : service.value
-        end.select { |v| !v.nil? }
-      end
-
-      # Lookup a scheduled job of this application by name.
-      #
-      # @param [String] name the scheduled job's name (as given in
-      #   torquebox.rb or torquebox.yml)
-      #
-      # @return [org.torquebox.jobs.ScheduledJob] The ScheduledJob instance.
-      #
-      # @note The ScheduledJob instances returned by this and the
-      #   {TorqueBox::ScheduledJob.list} methods are not instances of
-      #   this class but are instead Java objects of type
-      #   org.torquebox.jobs.ScheduledJob. There are more methods
-      #   available on these instances than what's shown in the
-      #   example here, but only the methods shown are part of our
-      #   documented API.
-      #
-      # @example Stop a scheduled job
-      #   job = TorqueBox::ScheduledJob.lookup('my_job')
-      #   job.name => 'my_job'
-      #   job.started? => true
-      #   job.status => 'STARTED'
-      #   job.stop
-      #   job.status => 'STOPPED'
-      def lookup(name)
-        service_name = job_service_name.append(name)
-        service = TorqueBox::MSC.get_service(service_name)
-        service.nil? ? nil : service.value
-      end
-
-      private
-
-      # @api private
-      def job_service_name
-        TorqueBox::MSC.deployment_unit.service_name.append('scheduled_job')
-      end
-
-      # @api private
-      def with_schedulizer
-        yield TorqueBox::ServiceRegistry.lookup(TorqueBox::MSC.deployment_unit.service_name.append('job_schedulizer'))
-      end
-
-      # @api private
-      def wait_for_latch(latch)
-        begin
-          # Wait for the services to come up for up to 30 seconds
-          latch.await(30, java.util.concurrent.TimeUnit::SECONDS)
-        rescue
-          return false
-        end
-
-        true
-      end
-    end
-  end
-end

data/lib/torquebox/service.rb

@@ -1,77 +0,0 @@
-# Copyright 2008-2013 Red Hat, Inc, and individual contributors.
-# 
-# This is free software; you can redistribute it and/or modify it
-# under the terms of the GNU Lesser General Public License as
-# published by the Free Software Foundation; either version 2.1 of
-# the License, or (at your option) any later version.
-# 
-# This software is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-# Lesser General Public License for more details.
-# 
-# You should have received a copy of the GNU Lesser General Public
-# License along with this software; if not, write to the Free
-# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-# 02110-1301 USA, or see the FSF site: http://www.fsf.org.
-
-module TorqueBox
-  # This class is a Ruby API to manipulating TorqueBox services (daemons).
-  class Service
-    class << self
-
-      # List all services of this application.
-      #
-      # @return [Array<org.torquebox.services.RubyService>] the list
-      #   of RubyService instances - see {TorqueBox::Service.lookup}
-      #   for more details on these instances
-      def list
-        prefix = service_prefix.canonical_name
-        suffix = '.create'
-        service_names = TorqueBox::MSC.service_names.select do |service_name|
-          name = service_name.canonical_name
-          name.start_with?(prefix) && name.end_with?(suffix)
-        end
-        service_names.map do |service_name|
-          TorqueBox::MSC.get_service(service_name).value
-        end
-      end
-
-      # Lookup a service of this application by name.
-      #
-      # @param [String] name the service's name (as given in
-      #   torquebox.rb or torquebox.yml)
-      #
-      # @return [org.torquebox.services.RubyService] The RubyService
-      #   instance.
-      #
-      # @note The RubyService instances returned by this and the
-      #   {TorqueBox::Service.list} methods are not instances of this
-      #   class but are instead Java objects of type
-      #   org.torquebox.services.RubyService. There are more methods
-      #   available on these instances than what's shown in the
-      #   example here, but only the methods shown are part of our
-      #   documented API.
-      #
-      # @example Stop a running service
-      #   service = TorqueBox::Service.lookup('my_service')
-      #   service.name => 'my_service'
-      #   service.started? => true
-      #   service.status => 'STARTED'
-      #   service.stop
-      #   service.status => 'STOPPED'
-      def lookup(name)
-        service_name = service_prefix.append(name).append('create')
-        service = TorqueBox::MSC.get_service(service_name)
-        service.nil? ? nil : service.value
-      end
-
-      private
-
-      def service_prefix
-        TorqueBox::MSC.deployment_unit.service_name.append('service')
-      end
-
-    end
-  end
-end

data/lib/torquebox/service_registry.rb

@@ -1,68 +0,0 @@
-# Copyright 2008-2013 Red Hat, Inc, and individual contributors.
-# 
-# This is free software; you can redistribute it and/or modify it
-# under the terms of the GNU Lesser General Public License as
-# published by the Free Software Foundation; either version 2.1 of
-# the License, or (at your option) any later version.
-# 
-# This software is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-# Lesser General Public License for more details.
-# 
-# You should have received a copy of the GNU Lesser General Public
-# License along with this software; if not, write to the Free
-# Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-# 02110-1301 USA, or see the FSF site: http://www.fsf.org.
-
-require 'java'
-module TorqueBox
-  class ServiceRegistry
-
-    def self.service_registry=(service_registry)
-      @service_registry = service_registry 
-      blocks.keys.each do |name|
-        blocks.delete(name).each do |block|
-          lookup name, &block
-        end
-      end
-      registry
-    end
-
-    # blocks are not allowed on the method named :[]
-    def self.[](name)
-      self.lookup(name)
-    end
-
-    def self.lookup(name, &block)
-      if registry.nil?
-        self.blocks[name] << block
-        nil
-      else
-        name = TorqueBox::ServiceRegistry.service_name_for( name ) if name.is_a? String
-        entry = registry.getService( name )
-        return nil unless entry
-        if block_given?
-          yield entry.getValue()
-        else
-          entry.getValue()
-        end
-      end
-    end
-
-    def self.blocks
-      @blocks ||= Hash.new{|h, k| h[k] = []}
-    end
-
-    def self.service_name_for( name )
-      Java::org.jboss.msc.service.ServiceName.parse( name )
-    end
-
-    def self.registry
-      @service_registry
-    end
-
-  end
-
-end
-

data/licenses/cc0-1.0.txt

@@ -1,121 +0,0 @@
-Creative Commons Legal Code
-
-CC0 1.0 Universal
-
-    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
-    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
-    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
-    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
-    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
-    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
-    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
-    HEREUNDER.
-
-Statement of Purpose
-
-The laws of most jurisdictions throughout the world automatically confer
-exclusive Copyright and Related Rights (defined below) upon the creator
-and subsequent owner(s) (each and all, an "owner") of an original work of
-authorship and/or a database (each, a "Work").
-
-Certain owners wish to permanently relinquish those rights to a Work for
-the purpose of contributing to a commons of creative, cultural and
-scientific works ("Commons") that the public can reliably and without fear
-of later claims of infringement build upon, modify, incorporate in other
-works, reuse and redistribute as freely as possible in any form whatsoever
-and for any purposes, including without limitation commercial purposes.
-These owners may contribute to the Commons to promote the ideal of a free
-culture and the further production of creative, cultural and scientific
-works, or to gain reputation or greater distribution for their Work in
-part through the use and efforts of others.
-
-For these and/or other purposes and motivations, and without any
-expectation of additional consideration or compensation, the person
-associating CC0 with a Work (the "Affirmer"), to the extent that he or she
-is an owner of Copyright and Related Rights in the Work, voluntarily
-elects to apply CC0 to the Work and publicly distribute the Work under its
-terms, with knowledge of his or her Copyright and Related Rights in the
-Work and the meaning and intended legal effect of CC0 on those rights.
-
-1. Copyright and Related Rights. A Work made available under CC0 may be
-protected by copyright and related or neighboring rights ("Copyright and
-Related Rights"). Copyright and Related Rights include, but are not
-limited to, the following:
-
-  i. the right to reproduce, adapt, distribute, perform, display,
-     communicate, and translate a Work;
- ii. moral rights retained by the original author(s) and/or performer(s);
-iii. publicity and privacy rights pertaining to a person's image or
-     likeness depicted in a Work;
- iv. rights protecting against unfair competition in regards to a Work,
-     subject to the limitations in paragraph 4(a), below;
-  v. rights protecting the extraction, dissemination, use and reuse of data
-     in a Work;
- vi. database rights (such as those arising under Directive 96/9/EC of the
-     European Parliament and of the Council of 11 March 1996 on the legal
-     protection of databases, and under any national implementation
-     thereof, including any amended or successor version of such
-     directive); and
-vii. other similar, equivalent or corresponding rights throughout the
-     world based on applicable law or treaty, and any national
-     implementations thereof.
-
-2. Waiver. To the greatest extent permitted by, but not in contravention
-of, applicable law, Affirmer hereby overtly, fully, permanently,
-irrevocably and unconditionally waives, abandons, and surrenders all of
-Affirmer's Copyright and Related Rights and associated claims and causes
-of action, whether now known or unknown (including existing as well as
-future claims and causes of action), in the Work (i) in all territories
-worldwide, (ii) for the maximum duration provided by applicable law or
-treaty (including future time extensions), (iii) in any current or future
-medium and for any number of copies, and (iv) for any purpose whatsoever,
-including without limitation commercial, advertising or promotional
-purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
-member of the public at large and to the detriment of Affirmer's heirs and
-successors, fully intending that such Waiver shall not be subject to
-revocation, rescission, cancellation, termination, or any other legal or
-equitable action to disrupt the quiet enjoyment of the Work by the public
-as contemplated by Affirmer's express Statement of Purpose.
-
-3. Public License Fallback. Should any part of the Waiver for any reason
-be judged legally invalid or ineffective under applicable law, then the
-Waiver shall be preserved to the maximum extent permitted taking into
-account Affirmer's express Statement of Purpose. In addition, to the
-extent the Waiver is so judged Affirmer hereby grants to each affected
-person a royalty-free, non transferable, non sublicensable, non exclusive,
-irrevocable and unconditional license to exercise Affirmer's Copyright and
-Related Rights in the Work (i) in all territories worldwide, (ii) for the
-maximum duration provided by applicable law or treaty (including future
-time extensions), (iii) in any current or future medium and for any number
-of copies, and (iv) for any purpose whatsoever, including without
-limitation commercial, advertising or promotional purposes (the
-"License"). The License shall be deemed effective as of the date CC0 was
-applied by Affirmer to the Work. Should any part of the License for any
-reason be judged legally invalid or ineffective under applicable law, such
-partial invalidity or ineffectiveness shall not invalidate the remainder
-of the License, and in such case Affirmer hereby affirms that he or she
-will not (i) exercise any of his or her remaining Copyright and Related
-Rights in the Work or (ii) assert any associated claims and causes of
-action with respect to the Work, in either case contrary to Affirmer's
-express Statement of Purpose.
-
-4. Limitations and Disclaimers.
-
- a. No trademark or patent rights held by Affirmer are waived, abandoned,
-    surrendered, licensed or otherwise affected by this document.
- b. Affirmer offers the Work as-is and makes no representations or
-    warranties of any kind concerning the Work, express, implied,
-    statutory or otherwise, including without limitation warranties of
-    title, merchantability, fitness for a particular purpose, non
-    infringement, or the absence of latent or other defects, accuracy, or
-    the present or absence of errors, whether or not discoverable, all to
-    the greatest extent permissible under applicable law.
- c. Affirmer disclaims responsibility for clearing rights of other persons
-    that may apply to the Work or any use thereof, including without
-    limitation any person's Copyright and Related Rights in the Work.
-    Further, Affirmer disclaims responsibility for obtaining any necessary
-    consents, permissions or other rights required for any use of the
-    Work.
- d. Affirmer understands and acknowledges that Creative Commons is not a
-    party to this document and has no duty or obligation with respect to
-    this CC0 or use of the Work.