rservicebus2 0.0.1

data/bin/rservicebus2-transport

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# The application 'rservicebus-transport' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'rubygems'
+require 'rservicebus'
+require 'rservicebus/Transporter'
+
+def run_rservicebus_transport()
+	RServiceBus::Transporter.new().Run()
+end
+
+run_rservicebus_transport
+

data/bin/send_empty_message

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+require 'rservicebus'
+require 'rservicebus/Agent'
+
+
+abort( "Usage: #{File.basename($0)} <Msg Name> <Queue Name> [Response Queue Name] [Beanstalk Host]" ) unless ARGV.length >=2 && ARGV.length <=4
+msg_name = ARGV[0]
+queue_name = ARGV[1]
+response_queue_name = "#{queue_name}Response" if ARGV.length >= 3
+beanstalkHost = 'beanstalk://localhost' if ARGV.length <= 4
+
+agent = RServiceBus::Agent.new.getAgent( URI.parse( beanstalkHost) )
+msg = RServiceBus.createAnonymousClass( msg_name )
+agent.sendMsg(msg, queue_name, response_queue_name)

data/lib/rservicebus.rb

@@ -0,0 +1,59 @@
+# Add the currently running directory to the start of the load path
+# $:.unshift File.dirname(__FILE__) + '/../../lib'
+
+# Don't buffer stdout
+$stdout.sync = true
+
+require 'rubygems'
+require 'yaml'
+require 'uuidtools'
+require 'json'
+require 'uri'
+
+require 'rservicebus/helper_functions'
+require 'rservicebus/errormessage'
+require 'rservicebus/handler_loader'
+require 'rservicebus/handler_manager'
+require 'rservicebus/appresource_configure'
+require 'rservicebus/mq'
+require 'rservicebus/host'
+require 'rservicebus/config'
+require 'rservicebus/endpointmapping'
+require 'rservicebus/stats'
+require 'rservicebus/statistic_manager'
+require 'rservicebus/audit'
+
+require 'rservicebus/message'
+require 'rservicebus/message/subscription'
+require 'rservicebus/message/statisticoutput'
+require 'rservicebus/message/verboseoutput'
+
+require 'rservicebus/usermessage/withpayload'
+
+require 'rservicebus/state_manager'
+require 'rservicebus/cron_manager'
+require 'rservicebus/circuitbreaker'
+
+require 'rservicebus/appresource'
+require 'rservicebus/resource_manager'
+
+require 'rservicebus/subscription_manager'
+require 'rservicebus/subscription_storage'
+require 'rservicebus/subscription_storage_configure'
+
+require 'rservicebus/monitor_configure'
+
+require 'rservicebus/agent'
+
+require 'rservicebus/saga_loader.rb'
+require 'rservicebus/saga/manager.rb'
+require 'rservicebus/saga/data.rb'
+require 'rservicebus/saga/base.rb'
+
+require 'rservicebus/saga_storage'
+
+require 'rservicebus/sendat_manager'
+
+# Initial definition of the namespace
+module RServiceBus
+end

data/lib/rservicebus/agent.rb

@@ -0,0 +1,54 @@
+module RServiceBus
+  class QueueNotFoundForMsg < StandardError
+  end
+
+  # A means for a stand-alone process to interact with the bus, without being
+  # a full rservicebus application
+  class Agent
+    def get_agent(uri)
+      ENV['RSBMQ'] = uri.to_s
+
+      RServiceBus.rlog '*** Agent.getAgent has been deprecated. Set the
+                      environment variable, RSBMQ, and simply create the class'
+      Agent.new
+    end
+
+    def initialize
+      @mq = MQ.get
+    end
+
+    # Put a msg on the bus
+    #
+    # @param [Object] messageObj The msg to be sent
+    # @param [String] queueName the name of the queue to be send the msg to
+    # @param [String] returnAddress the name of a queue to send replies to
+    def send_msg(message_obj, queue_name, return_address = nil)
+      fail QueueNotFoundForMsg, message_obj.class.name if queue_name.nil?
+
+      msg = RServiceBus::Message.new(message_obj, return_address)
+      if queue_name.index('@').nil?
+        q = queue_name
+      else
+        parts = queueName.split('@')
+        msg.set_remote_queue_name(parts[0])
+        msg.set_remote_host_name(parts[1])
+        q = 'transport-out'
+      end
+
+      serialized_object = YAML.dump(msg)
+
+      @mq.send(q, serialized_object)
+    end
+
+    # Gives an agent the means to receive a reply
+    #
+    # @param [String] queueName the name of the queue to monitor for messages
+    def check_for_reply(queue_name)
+      @mq.subscribe(queue_name)
+      body = @mq.pop
+      @msg = YAML.load(body)
+      @mq.ack
+      @msg.msg
+    end
+  end
+end

data/lib/rservicebus/appresource.rb

@@ -0,0 +1,65 @@
+require 'uri'
+
+module RServiceBus
+  # Wrapper base class for resources used by applications, allowing rservicebus
+  # to configure the resource - dependency injection.
+  class AppResource
+    attr_reader :connection
+
+    # The method which actually connects to the resource.
+    def connect(_uri)
+      fail 'Method, connect, needs to be implemented for resource'
+    end
+
+    def _connect
+      @connection = connect(@uri)
+      RServiceBus.rlog "#{self.class.name}. Connected to, #{@uri}"
+    end
+
+    def get_resource
+      @connection
+    end
+
+    # Resources are attached, and can be specified using the URI syntax.
+    # @param [String] uri a location for the resource to which we will attach,
+    #  eg redis://127.0.0.1/foo
+    def initialize(host, uri)
+      @host = host
+      @uri = uri
+      # Do a connect / disconnect loop on startup to validate the connection
+      _connect
+      finished
+    end
+
+    # A notification that ocurs after getResource, to allow cleanup
+    def finished
+      @connection.close
+    end
+
+    # At least called in the Host rescue block, to ensure all network links are
+    #  healthy
+    def reconnect
+      begin
+        finished
+      rescue StandardError => e
+        puts '** AppResource. An error was raised while closing connection
+              to, ' + @uri
+        puts 'Message: ' + e.message
+        puts e.backtrace
+      end
+      _connect
+    end
+
+    # Transaction Semantics
+    def begin
+    end
+
+    # Transaction Semantics
+    def commit
+    end
+
+    # Transaction Semantics
+    def rollback
+    end
+  end
+end

data/lib/rservicebus/appresource/dir.rb

@@ -0,0 +1,29 @@
+module RServiceBus
+  # AppResourceDir
+  class AppResourceDir < AppResource
+    def connect(uri)
+      begin
+        input_dir = Dir.new(uri.path)
+        unless File.writable?(uri.path)
+          puts "*** Warning. Directory is not writable, #{uri.path}."
+          puts "*** Warning. Make the directory, #{uri.path}, writable and try
+                again."
+        end
+      rescue Errno::ENOENT
+        puts "***** Directory does not exist, #{uri.path}."
+        puts "***** Create the directory, #{uri.path}, and try again."
+        puts "***** eg, mkdir #{uri.path}"
+        abort
+      rescue Errno::ENOTDIR
+        puts "***** The specified path does not point to a directory,
+              #{uri.path}."
+        puts "***** Either repoint path to a directory, or remove, #{uri.path},
+              and create it as a directory."
+        puts "***** eg, rm #{uri.path} && mkdir #{uri.path}"
+        abort
+      end
+
+      input_dir
+    end
+  end
+end

data/lib/rservicebus/appresource/file.rb

@@ -0,0 +1,8 @@
+module RServiceBus
+  # App Resource File
+  class AppResourceFile < AppResource
+    def connect(uri)
+      File.new(uri.path)
+    end
+  end
+end

data/lib/rservicebus/appresource/fluiddb.rb

@@ -0,0 +1,24 @@
+require 'FluidDb/Db'
+module RServiceBus
+  # Implementation of an AppResource - FluidDb
+  class AppResourceFluidDb < AppResource
+    def connect(uri)
+      FluidDb::Db(uri)
+    end
+
+    # Transaction Semantics
+    def begin
+      @connection.begin
+    end
+
+    # Transaction Semantics
+    def commit
+      @connection.commit
+    end
+
+    # Transaction Semantics
+    def rollback
+      @connection.rollback
+    end
+  end
+end

data/lib/rservicebus/appresource_configure.rb

@@ -0,0 +1,33 @@
+require 'uri'
+
+module RServiceBus
+  # Configure AppResources for an rservicebus host
+  class ConfigureAppResource
+    def get_resources(env, host, state_manager, saga_storage)
+      # rm = resource_manager
+      rm = ResourceManager.new(state_manager, saga_storage)
+      env.each do |k, v|
+        if v.is_a?(String) && k.start_with?('RSBFDB_')
+          uri = URI.parse(v)
+          require 'rservicebus/appresource/fluiddb'
+          rm.add k.sub('RSBFDB_', ''), AppResourceFluidDb.new(host, uri)
+        elsif v.is_a?(String) && k.start_with?('RSB_')
+          uri = URI.parse(v)
+          case uri.scheme
+          when 'dir'
+            require 'rservicebus/appresource/dir'
+            rm.add k.sub('RSB_', ''), AppResourceDir.new(host, uri)
+          when 'file'
+            require 'rservicebus/appresource/file'
+            rm.add k.sub('RSB_', ''), AppResourceFile.new(host, uri)
+          else
+            abort("Scheme, #{uri.scheme}, not recognised when configuring
+                  app resource, #{k}=#{v}")
+          end
+        end
+      end
+
+      rm
+    end
+  end
+end

data/lib/rservicebus/audit.rb

@@ -0,0 +1,28 @@
+module RServiceBus
+  # Audit Class
+  class Audit
+    def initialize(mq)
+      @mq = mq
+      audit_queue_name = RServiceBus.get_value('AUDIT_QUEUE_NAME')
+      if audit_queue_name.nil?
+        @sent_messages_to = RServiceBus.get_value('sent_messages_to')
+        @received_messages_to = RServiceBus.get_value('received_messages_to')
+      else
+        @sent_messages_to = audit_queue_name
+        @received_messages_to = audit_queue_name
+      end
+    end
+
+    def audit_to_queue(obj)
+      @mq.send_msg(obj, @sent_messages_to)
+    end
+
+    def audit_outgoing(obj)
+      audit_to_queue(obj) unless @sent_messages_to.nil?
+    end
+
+    def audit_incoming(obj)
+      audit_to_queue(obj) unless @received_messages_to.nil?
+    end
+  end
+end

data/lib/rservicebus/circuitbreaker.rb

@@ -0,0 +1,79 @@
+module RServiceBus
+  class MessageArrivedWhileCricuitBroken < StandardError
+  end
+
+  # An implementation of Michael Nygard's Circuit Breaker pattern.
+  class CircuitBreaker
+    def reset
+      @broken = false
+
+      @number_of_failures = 0
+      @time_of_first_failure = nil
+
+      @time_to_break = nil
+      @time_to_reset = nil
+    end
+
+    def initialize(host)
+      @host = host
+      @maxnumber_of_failures = RServiceBus.get_value('RSBCB_MAX', 5)
+      @seconds_to_break = RServiceBus.get_value('RSBCB_SECONDS_TO_BREAK', 60).to_i
+      @seconds_to_reset = RServiceBus.get_value('RSBCB_SECONDS_TO_RESET', 60).to_i
+      @reset_on_success = RServiceBus.get_value('RSBCB_RESET_ON_SUCCESS', false)
+
+      reset
+    end
+
+    ####### Public Interface
+    # Broken will be called before processing a message.
+    #  => Broken will be called before Failure
+    def broken
+      reset if !@time_to_reset.nil? && Time.now > @time_to_reset
+      @broken
+    end
+
+    def live
+      !broken
+    end
+
+    ## This should be called less than success.
+    ## If there is a failure, then taking a bit longer gives time to settle.
+    def failure
+      message_arrived
+
+      ## logFirstFailure
+      if @number_of_failures == 0
+        @number_of_failures = 1
+        @time_of_first_failure = Time.now
+        @time_to_break = @time_of_first_failure + @seconds_to_break
+      else
+        @number_of_failures += 1
+      end
+
+      ## checkToBreakCircuit
+      break_circuit if @number_of_failures >= @maxnumber_of_failures
+    end
+
+    def success
+      if @reset_on_success == true
+        reset
+        return
+      end
+
+      message_arrived
+    end
+
+    protected
+
+    def message_arrived
+      reset if !@time_to_break.nil? && Time.now > @time_to_break
+
+      fail MessageArrivedWhileCricuitBroken if @broken == true
+    end
+
+    def break_circuit
+      @broken = true
+      @time_to_reset = Time.now + @seconds_to_reset
+    end
+  end
+end

data/lib/rservicebus/config.rb

@@ -0,0 +1,168 @@
+module RServiceBus
+  # Marshals configuration information for an rservicebus host
+  class Config
+    attr_reader :app_name, :message_endpoint_mappings, :handler_path_list,
+                :saga_path_list, :error_queue_name, :max_retries,
+                :forward_received_messages_to, :subscription_uri,
+                :stat_output_countdown, :contract_list, :lib_list,
+                :forward_sent_messages_to, :mq_host
+
+    def initialize
+      puts 'Cannot instantiate config directly.'
+      puts 'For production, use ConfigFromEnv.'
+      puts 'For debugging or testing, you could try ConfigFromSetter'
+      abort
+    end
+
+    def log(string)
+      puts string
+    end
+
+    def get_value(name, default = nil)
+      value = (ENV[name].nil? || ENV[name] == '') ? default : ENV[name]
+      log "Env value: #{name}: #{value}"
+      value
+    end
+
+    # Marshals paths for message handlers
+    # Note. trailing slashs will be stripped
+    # Expected format: <path 1>;<path 2>
+    def load_handler_path_list
+      paths = get_value('MSGHANDLERPATH', './MessageHandler')
+      @handler_path_list = []
+      paths.split(';').each do |path|
+        @handler_path_list << path.strip.chomp('/')
+      end
+
+      self
+    end
+
+    def load_saga_path_list
+      paths = get_value('SAGAPATH', './Saga')
+      @saga_path_list = []
+      paths.split(';').each do |path|
+        @saga_path_list << path.strip.chomp('/')
+      end
+
+      self
+    end
+
+    def load_host_section
+      @app_name = get_value('APPNAME', 'RServiceBus')
+      @error_queue_name = get_value('ERROR_QUEUE_NAME', 'error')
+      @max_retries = get_value('MAX_RETRIES', '5').to_i
+      @stat_output_countdown = get_value('STAT_OUTPUT_COUNTDOWN', '100').to_i
+      @subscription_uri = get_value('SUBSCRIPTION_URI',
+                                    "file:///tmp/#{app_name}_subscriptions.yaml")
+
+      audit_queue_name = get_value('AUDIT_QUEUE_NAME')
+      if audit_queue_name.nil?
+        @forward_sent_messages_to = get_value('FORWARD_SENT_MESSAGES_TO')
+        @forward_received_messages_to = get_value('FORWARD_RECEIVED_MESSAGES_TO')
+      else
+        @forward_sent_messages_to = audit_queue_name
+        @forward_received_messages_to = audit_queue_name
+      end
+
+      self
+    end
+
+    def ensure_contract_file_exists(path)
+      unless File.exist?(path) || File.exist?("#{path}.rb")
+        puts 'Error while processing contracts'
+        puts "*** path, #{path}, provided does not exist as a file"
+        abort
+      end
+      unless File.extname(path) == '' || File.extname(path) == '.rb'
+        puts 'Error while processing contracts'
+        puts "*** path, #{path}, should point to a ruby file, with extention .rb"
+        abort
+      end
+    end
+
+    # Marshals paths for contracts
+    # Note. .rb extension is optional
+    # Expected format: /one/two/Contracts
+    def load_contracts
+      @contract_list = []
+      # This is a guard clause in case no Contracts have been specified
+      # If any guard clauses have been specified, then execution should drop
+      #   to the second block
+      puts "Config.load_contracts, #{@contract_list}"
+      return self if get_value('CONTRACTS').nil?
+
+      get_value('CONTRACTS', './Contract').split(';').each do |path|
+        ensure_contract_file_exists(path)
+        @contract_list << path
+      end
+      self
+    end
+
+    # Marshals paths for lib
+    # Note. .rb extension is optional
+    # Expected format: /one/two/Contracts
+    def load_libs
+      @lib_list = []
+
+      paths = get_value('LIB')
+      paths = './lib' if paths.nil? && File.exist?('./lib')
+      return self if paths.nil?
+
+      paths.split(';').each do |path|
+        log "Loading libs from, #{path}"
+        unless File.exist?(path)
+          puts 'Error while processing libs'
+          puts "*** path, #{path}, should point to a ruby file, with extention
+                .rb, or"
+          puts "*** path, #{path}, should point to a directory than conatins
+                ruby files, that have extention .rb"
+          abort
+        end
+        @lib_list << path
+      end
+      self
+    end
+
+    def configure_mq
+      @mq_host = get_value('MQ', 'beanstalk://localhost')
+      self
+    end
+
+    # Marshals paths for working_dirs
+    # Note. trailing slashs will be stripped
+    # Expected format: <path 1>;<path 2>
+    def load_working_dir_list
+      puts "Config.load_working_dir_list.1"
+      puts "Config.load_working_dir_list.2 #{@contract_list}"
+      path_list = get_value('WORKING_DIR')
+      return self if path_list.nil?
+
+      path_list.split(';').each do |path|
+        path = path.strip.chomp('/')
+        unless Dir.exist?("#{path}")
+          puts 'Error while processing working directory list'
+          puts "*** path, #{path}, does not exist"
+          abort
+        end
+        @handler_path_list << "#{path}/MessageHandler" if Dir.exist?("#{path}/MessageHandler")
+        @saga_path_list << "#{path}/Saga" if Dir.exist?("#{path}/Saga")
+        @contract_list << "#{path}/Contract.rb" if File.exist?( "#{path}/Contract.rb" )
+        @lib_list << "#{path}/lib" if File.exist?("#{path}/lib")
+      end
+      self
+    end
+  end
+
+  # Class
+  class ConfigFromEnv < Config
+    def initialize
+    end
+  end
+
+  # Class
+  class ConfigFromSetter < Config
+    attr_writer :appName, :messageEndpointMappings, :handler_path_list, :errorQueueName, :maxRetries, :forward_received_messages_to, :beanstalkHost
+    def initialize
+    end
+  end
+end