synapse-core 0.5.1 → 0.5.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: baa532559d58992e62cae2cc5b843a9485bd10af
+  data.tar.gz: 5d63dd14c2598d92034db8fb45d7e37958a45f98
+SHA512:
+  metadata.gz: 5264e9b6b99b0da204d4c0dc9d28f4b1624c1ac28e6ae9e47b5f89d441a4b2a41fe2a4fcde4e25801d7f2aa676b615728881fb4656132f7ed2d5e9f42edcc7e7
+  data.tar.gz: fe5bc48121cacff34fb1ef50a43159902de2d5bf93b34ee5504e440e5a0dd76ea5caa66b5a441d55f154259a271feea30cbe523d8d180f67f7983d1889cdff18

data/lib/synapse.rb

@@ -14,10 +14,10 @@ module Synapse
     autoload :Command
     autoload :Domain
     autoload :EventBus
+    autoload :Mapping
     autoload :Repository
     autoload :Serialization
     autoload :UnitOfWork, 'synapse/uow'
-    autoload :Wiring
   end
 
   # Optional components

data/lib/synapse/command.rb

@@ -29,10 +29,10 @@ require 'synapse/command/command_handler'
 require 'synapse/command/dispatch_interceptor'
 require 'synapse/command/errors'
 require 'synapse/command/interceptor_chain'
+require 'synapse/command/mapping'
 require 'synapse/command/message'
 require 'synapse/command/rollback_policy'
 require 'synapse/command/simple_command_bus'
-require 'synapse/command/wiring'
 
 require 'synapse/command/gateway'
 require 'synapse/command/gateway/retry_scheduler'

data/lib/synapse/command/command_handler.rb

@@ -2,7 +2,7 @@ module Synapse
   module Command
     # Mixin for an object capable of handling commands
     #
-    # Consider using the command handler mixin that uses message wiring.
+    # Consider using the command handler mixin that uses the mapping DSL.
     module CommandHandler
       # Handles the given command
       #

data/lib/synapse/command/mapping.rb

@@ -0,0 +1,71 @@
+module Synapse
+  module Command
+    # Mixin for a command handler that uses the mapping DSL
+    #
+    # @example
+    #   class OrderBookCommandHandler
+    #     include MappingCommandHandler
+    #
+    #     map_command CreateOrderbook do |command|
+    #       # ...
+    #     end
+    #
+    #     map_command PlaceBuyOrder, :to => :on_buy_order
+    #     map_command PlaceSellOrder, :to => :on_sell_order
+    #   end
+    module MappingCommandHandler
+      extend ActiveSupport::Concern
+      include CommandHandler
+
+      included do
+        # @return [Mapping::Mapper]
+        class_attribute :command_mapper
+        self.command_mapper = Mapping::Mapper.new false
+      end
+
+      module ClassMethods
+        # @see Mapper#map
+        # @param [Class] type
+        # @param [Object...] args
+        # @param [Proc] block
+        # @return [undefined]
+        def map_command(type, *args, &block)
+          command_mapper.map type, *args, &block
+        end
+      end
+
+      # @param [CommandMessage] command
+      # @param [UnitOfWork] current_unit Current unit of work
+      # @return [Object] The result of handling the given command
+      def handle(command, current_unit)
+        mapping = command_mapper.mapping_for command.payload_type
+
+        unless mapping
+          raise ArgumentError, 'Not capable of handling [%s] commands' % command.payload_type
+        end
+
+        mapping.invoke self, command.payload
+      end
+
+      # Subscribes this handler to the given command bus for any types that have been mapped
+      #
+      # @param [CommandBus] command_bus
+      # @return [undefined]
+      def subscribe(command_bus)
+        command_mapper.each_type do |type|
+          command_bus.subscribe type, self
+        end
+      end
+
+      # Unsubscribes this handler from the given command bus for any types that have been mapped
+      #
+      # @param [CommandBus] command_bus
+      # @return [undefined]
+      def unsubscribe(command_bus)
+        command_mapper.each_type do |type|
+          command_bus.unsubscribe type, self
+        end
+      end
+    end # MappingCommandHandler
+  end # Command
+end

data/lib/synapse/command/message.rb

@@ -6,22 +6,6 @@ module Synapse
       def self.builder
         CommandMessageBuilder
       end
-
-      # Creates a command message using the given command object
-      #
-      # If the given object is an command message, it will be returned unchanged.
-      #
-      # @param [Object] command
-      # @return [CommandMessage]
-      def self.as_message(command)
-        unless command.is_a? CommandMessage
-          command = self.build do |builder|
-            builder.payload = command
-          end
-        end
-
-        command
-      end
     end
 
     # Message builder capable of producing CommandMessage instances

data/lib/synapse/command/simple_command_bus.rb

@@ -15,12 +15,15 @@ module Synapse
       # @param [UnitOfWorkFactory] unit_factory
       # @return [undefined]
       def initialize(unit_factory)
+        @unit_factory = unit_factory
+
         @handlers = Hash.new
         @filters = Array.new
         @interceptors = Array.new
-        @logger = Logging.logger[self.class]
+
         @rollback_policy = RollbackOnAnyExceptionPolicy.new
-        @unit_factory = unit_factory
+
+        @logger = Logging.logger[self.class]
       end
 
       # @api public

data/lib/synapse/common/message.rb

@@ -66,6 +66,22 @@ module Synapse
       builder.build
     end
 
+    # Wraps an object into a message as its payload
+    #
+    # If the given object is an message, it will be returned unchanged.
+    #
+    # @param [Object] object
+    # @return [Message]
+    def self.as_message(object)
+      unless object.is_a? Message
+        object = self.build do |builder|
+          builder.payload = object
+        end
+      end
+
+      object
+    end
+
     # Yields a message builder that can be used to produce a message
     #
     # @see MessageBuilder#build

data/lib/synapse/configuration.rb

@@ -6,27 +6,10 @@ require 'synapse/configuration/dependent'
 require 'synapse/configuration/ext'
 
 require 'synapse/configuration/component/command_bus'
-# Has to be loaded before asynchronous command bus definition builder
-require 'synapse/configuration/component/command_bus/simple_command_bus'
-require 'synapse/configuration/component/command_bus/async_command_bus'
-
 require 'synapse/configuration/component/event_bus'
-require 'synapse/configuration/component/event_bus/simple_event_bus'
-
+# Has to be loaded before event sourcing
 require 'synapse/configuration/component/repository'
-# Has to be loaded before event sourcing or simple repository definition builders
-require 'synapse/configuration/component/repository/locking_repository'
-require 'synapse/configuration/component/repository/simple_repository'
-
 require 'synapse/configuration/component/event_sourcing'
-require 'synapse/configuration/component/event_sourcing/repository'
-
 require 'synapse/configuration/component/serialization'
-require 'synapse/configuration/component/serialization/converter_factory'
-require 'synapse/configuration/component/serialization/serializer'
-
 require 'synapse/configuration/component/uow'
-require 'synapse/configuration/component/uow/unit_factory'
-
 require 'synapse/configuration/component/upcasting'
-require 'synapse/configuration/component/upcasting/upcaster_chain'

data/lib/synapse/configuration/component/command_bus.rb

@@ -1,35 +1,18 @@
+require 'synapse/configuration/component/command_bus/simple_command_bus'
+require 'synapse/configuration/component/command_bus/async_command_bus'
+require 'synapse/configuration/component/command_bus/gateway'
+
 module Synapse
   module Configuration
     class ContainerBuilder
       # Creates and configures an asynchronous command bus
-      #
-      # @see AsynchronousCommandBusDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def async_command_bus(identifier = nil, &block)
-        with_definition_builder AsynchronousCommandBusDefinitionBuilder, identifier, &block
-      end
+      builder :async_command_bus, AsynchronousCommandBusDefinitionBuilder
 
       # Creates and configures a simple command bus
-      #
-      # @see SimpleCommandBusDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def simple_command_bus(identifier = nil, &block)
-        with_definition_builder SimpleCommandBusDefinitionBuilder, identifier, &block
-      end
+      builder :simple_command_bus, SimpleCommandBusDefinitionBuilder
 
       # Creates and configures a command gateway
-      #
-      # @see CommandGatewayBusDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def gateway(identifier = nil, &block)
-        with_definition_builder CommandGatewayBusDefinitionBuilder, identifier, &block
-      end
+      builder :gateway, CommandGatewayDefinitionBuilder
     end # ContainerBuilder
   end # Configuration
 end

data/lib/synapse/configuration/component/command_bus/simple_command_bus.rb

@@ -5,12 +5,12 @@ module Synapse
     # @example The minimum possible effort to build a command bus
     #   simple_command_bus
     #
-    # @example Create a command bus with an alternate identifier and handler tag
+    # @example Create a command bus with an alternate identifier and tags
     #   simple_command_bus :alt_command_bus do
     #     use_handler_tag :alt_command_handler
+    #     use_filter_tag :alt_command_filter
+    #     use_interceptor_tag :alt_dispatch_interceptor
     #   end
-    #
-    # @todo Support for interceptors and filters
     class SimpleCommandBusDefinitionBuilder < DefinitionBuilder
       # Changes the tag to use to automatically subscribe command handlers
       #
@@ -23,6 +23,22 @@ module Synapse
         @handler_tag = handler_tag
       end
 
+      # Changes the tag to use to automatically register command filters
+      #
+      # @param [Symbol] filter_tag
+      # @return [undefined]
+      def use_filter_tag(filter_tag)
+        @filter_tag = filter_tag
+      end
+
+      # Changes the tag to use to automatically register command filters
+      #
+      # @param [Symbol] interceptor_tag
+      # @return [undefined]
+      def use_interceptor_tag(interceptor_tag)
+        @interceptor_tag = interceptor_tag
+      end
+
       # Changes the rollback policy to use for the command bus
       #
       # By default, the command bus will always rollback on an exception
@@ -48,21 +64,29 @@ module Synapse
         identified_by :command_bus
 
         use_handler_tag :command_handler
+        use_filter_tag :command_filter
+        use_interceptor_tag :dispatch_interceptor
+
         use_unit_factory :unit_factory
 
         use_factory do
           unit_factory = resolve @unit_factory
 
           command_bus = create_command_bus unit_factory
-
-          if @rollback_policy
-            command_bus.rollback_policy = resolve @rollback_policy
-          end
+          command_bus.rollback_policy = resolve @rollback_policy, true
 
           with_tagged @handler_tag do |handler|
             handler.subscribe command_bus
           end
 
+          with_tagged @filter_tag do |filter|
+            command_bus.filters.push filter
+          end
+
+          with_tagged @interceptor_tag do |interceptor|
+            command_bus.interceptors.push interceptor
+          end
+
           command_bus
         end
       end

data/lib/synapse/configuration/component/event_bus.rb

@@ -1,15 +1,10 @@
+require 'synapse/configuration/component/event_bus/simple_event_bus'
+
 module Synapse
   module Configuration
     class ContainerBuilder
       # Creates and configures a simple event bus
-      #
-      # @see SimpleEventBusDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def simple_event_bus(identifier = nil, &block)
-        with_definition_builder SimpleEventBusDefinitionBuilder, identifier, &block
-      end
+      builder :simple_event_bus, SimpleEventBusDefinitionBuilder
     end # ContainerBuilder
   end # Configuration
 end

data/lib/synapse/configuration/component/event_sourcing.rb

@@ -1,15 +1,18 @@
+require 'synapse/configuration/component/event_sourcing/aggregate_snapshot_taker'
+require 'synapse/configuration/component/event_sourcing/interval_snapshot_policy'
+require 'synapse/configuration/component/event_sourcing/repository'
+
 module Synapse
   module Configuration
     class ContainerBuilder
       # Creates and configures an event sourcing repository
-      #
-      # @see EventSourcingRepositoryDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def es_repository(identifier = nil, &block)
-        with_definition_builder EventSourcingRepositoryDefinitionBuilder, identifier, &block
-      end
+      builder :es_repository, EventSourcingRepositoryDefinitionBuilder
+
+      # Creates and configures an aggregate snapshot taker
+      builder :aggregate_snapshot_taker, AggregateSnapshotTakerDefinitionBuilder
+
+      # Creates and configures an interval-based snapshot policy
+      builder :interval_snapshot_policy, IntervalSnapshotPolicyDefinitionBuilder
     end # ContainerBuilder
   end # Configuration
 end

data/lib/synapse/configuration/component/event_sourcing/aggregate_snapshot_taker.rb

@@ -0,0 +1,48 @@
+module Synapse
+  module Configuration
+    # Definition builder used to create aggregate snapshot takers
+    #
+    # @example The minimum possible effort to build an aggregate snapshot taker
+    #   aggregate_snapshot_taker
+    #
+    # @example Build an aggregate snapshot taker using an alternate event store and factory tag
+    #   aggregate_snapshot_taker :alt_snapshot_taker do
+    #     use_aggregate_factory_tag :alt_factory_tag
+    #     use_event_store :alt_event_store
+    #   end
+    class AggregateSnapshotTakerDefinitionBuilder < DefinitionBuilder
+      # @param [Symbol] aggregate_factory_tag
+      # @return [undefined]
+      def use_aggregate_factory_tag(aggregate_factory_tag)
+        @aggregate_factory_tag = aggregate_factory_tag
+      end
+
+      # @param [Symbol] event_store
+      # @return [undefined]
+      def use_event_store(event_store)
+        @event_store = event_store
+      end
+
+    protected
+
+      # @return [undefined]
+      def populate_defaults
+        identified_by :snapshot_taker
+
+        use_aggregate_factory_tag :aggregate_factory
+        use_event_store :event_store
+
+        use_factory do
+          event_store = resolve @event_store
+          snapshot_taker = EventSourcing::AggregateSnapshotTaker.new event_store
+
+          with_tagged @aggregate_factory_tag do |factory|
+            snapshot_taker.register_factory factory
+          end
+
+          snapshot_taker
+        end
+      end
+    end # AggregateSnapshotTakerDefinitionBuilder
+  end # Configuration
+end

data/lib/synapse/configuration/component/event_sourcing/interval_snapshot_policy.rb

@@ -0,0 +1,33 @@
+module Synapse
+  module Configuration
+    # Definition builder used to create an interval-based snapshot policy
+    #
+    # @example The minimum possible effort to build a snapshot policy
+    #   interval_snapshot_policy
+    #
+    # @example Build an aggregate snapshot taker using an alternate threshold
+    #   interval_snapshot_policy :alt_snapshot_policy do
+    #     use_threshold 50
+    #   end
+    class IntervalSnapshotPolicyDefinitionBuilder < DefinitionBuilder
+      # @param [Integer] threshold
+      # @return [undefined]
+      def use_threshold(threshold)
+        @threshold = threshold
+      end
+
+    protected
+
+      # @return [undefined]
+      def populate_defaults
+        identified_by :snapshot_policy
+
+        use_threshold 30
+
+        use_factory do
+          EventSourcing::AggregateSnapshotTaker.new @threshold
+        end
+      end
+    end # IntervalSnapshotPolicyDefinitionBuilder
+  end # Configuration
+end