synapse-core 0.5.1 → 0.5.2

data/lib/synapse/{wiring/wire.rb → mapping/mapping.rb}

@@ -1,17 +1,17 @@
 module Synapse
-  module Wiring
+  module Mapping
     # Represents a mapping between a payload type and a handler method or block
     #
-    # Wires are ordered by the depth of the payload type that they handle. Wires that are
-    # for a more specific class are preferred over wires for an abstract class.
-    class Wire
-      # @return [Class] The type of payload that a handler is being wired to
+    # Mappings are ordered by the depth of the payload type that they handle. Mappings that are
+    # for a more specific class are preferred over mappings for an abstract class.
+    class Mapping
+      # @return [Class] The type of payload that a handler is being mapped to
       attr_reader :type
 
       # @return [Object] Either a method symbol or block
       attr_reader :handler
 
-      # @return [Hash] Options specific to the component being wired
+      # @return [Hash] Options specific to the component being mapped
       attr_reader :options
 
       # @param [Class] type
@@ -35,13 +35,13 @@ module Synapse
         end
       end
 
-      # @param [Wire] other
+      # @param [Mapping] other
       # @return [Integer]
       def <=>(other)
         (@type <=> other.type) or 0
       end
 
-      # @param [Wire] other
+      # @param [Mapping] other
       # @return [Boolean]
       def ==(other)
         self.class === other and

data/lib/synapse/process_manager.rb

@@ -12,7 +12,7 @@ require 'synapse/process_manager/resource_injector'
 require 'synapse/process_manager/container_resource_injector'
 require 'synapse/process_manager/simple_process_manager'
 
-require 'synapse/process_manager/wiring/process'
-require 'synapse/process_manager/wiring/process_manager'
+require 'synapse/process_manager/mapping/process'
+require 'synapse/process_manager/mapping/process_manager'
 
 require 'synapse/process_manager/repository/in_memory'

data/lib/synapse/process_manager/mapping/process.rb

@@ -0,0 +1,44 @@
+module Synapse
+  module ProcessManager
+    # Process that has the mapping DSL built-in
+    #
+    # @example
+    #   class OrderProcess < MappingProcess
+    #     map_event OrderCreatedEvent, correlate: :order_id, start: true do |event|
+    #       # ...
+    #     end
+    #
+    #     map_event OrderFinishedEvent, correlate: :order_id, finish: true, to: :on_finish
+    #   end
+    #
+    # @abstract
+    class MappingProcess < Process
+      # @return [Mapping::Mapper]
+      class_attribute :event_mapper
+
+      self.event_mapper = Mapping::Mapper.new true
+
+      # @see Mapper#map
+      # @param [Class] type
+      # @param [Object...] args
+      # @param [Proc] block
+      # @return [undefined]
+      def self.map_event(type, *args, &block)
+        event_mapper.map type, *args, &block
+      end
+
+      # @param [EventMessage] event
+      # @return [undefined]
+      def handle(event)
+        return unless @active
+
+        mapping = event_mapper.mapping_for event.payload_type
+
+        return unless mapping
+
+        mapping.invoke self, event.payload
+        finish if mapping.options[:finish]
+      end
+    end # MappingProcess
+  end # ProcessManager
+end

data/lib/synapse/process_manager/{wiring → mapping}/process_manager.rb

@@ -1,9 +1,9 @@
 module Synapse
   module ProcessManager
-    # Process manager that is aware of processes that use the wiring DSL
-    # @see WiringProcess
-    class WiringProcessManager < ProcessManager
-      # @raise [ArgumentError] If a process type is given that doesn't support the wiring DSL
+    # Process manager that is aware of processes that use the mapping DSL
+    # @see MappingProcess
+    class MappingProcessManager < ProcessManager
+      # @raise [ArgumentError] If a process type is given that doesn't support the mapping DSL
       # @param [ProcessRepository] repository
       # @param [ProcessFactory] factory
       # @param [LockManager] lock_manager
@@ -13,7 +13,7 @@ module Synapse
         super
 
         @process_types.each do |process_type|
-          unless process_type.respond_to? :wire_registry
+          unless process_type.respond_to? :event_mapper
             raise ArgumentError, 'Incompatible process type %s' % process_type
           end
         end
@@ -25,12 +25,12 @@ module Synapse
       # @param [EventMessage] event
       # @return [Symbol]
       def creation_policy_for(process_type, event)
-        wire = process_type.wire_registry.wire_for event.payload_type
+        mapping = process_type.event_mapper.mapping_for event.payload_type
 
-        if wire
-          if !wire.options[:start]
+        if mapping
+          if !mapping.options[:start]
             :none
-          elsif wire.options[:force_new]
+          elsif mapping.options[:force_new]
             :always
           else
             :if_none_found
@@ -42,11 +42,11 @@ module Synapse
       # @param [EventMessage] event
       # @return [Correlation] Returns nil if no correlation could be extracted
       def extract_correlation(process_type, event)
-        wire = process_type.wire_registry.wire_for event.payload_type
+        mapping = process_type.event_mapper.mapping_for event.payload_type
 
-        return unless wire
+        return unless mapping
 
-        correlation_key = wire.options[:correlate]
+        correlation_key = mapping.options[:correlate]
         if correlation_key
           correlation_value event.payload, correlation_key
         end
@@ -67,6 +67,6 @@ module Synapse
           Correlation.new correlation_key, value
         end
       end
-    end # WiringProcessManager
+    end # MappingProcessManager
   end # ProcessManager
 end

data/lib/synapse/process_manager/process.rb

@@ -6,7 +6,7 @@ module Synapse
     # "maintain the state of the sequence and determine the next processing step based on
     # intermediate results" (Hohpe 279). Processes are also called sagas in some CQRS frameworks.
     #
-    # Consider using the implementation of a process that uses message wiring.
+    # Consider using the implementation of a process that uses the mapping DSL.
     #
     # @abstract
     class Process
@@ -72,6 +72,6 @@ module Synapse
       def finish
         @active = false
       end
-    end
-  end
+    end # Process
+  end # ProcessManager
 end

data/lib/synapse/repository/locking.rb

@@ -10,7 +10,6 @@ module Synapse
       # @return [undefined]
       def initialize(lock_manager)
         @lock_manager = lock_manager
-        @logger = Logging.logger[self.class]
       end
 
       # @api public
@@ -27,12 +26,13 @@ module Synapse
         begin
           aggregate = perform_load aggregate_id, expected_version
 
-          register_aggregate(aggregate).tap do
-            register_listener LockCleaningUnitOfWorkListener.new aggregate_id, @lock_manager
-          end
-        rescue
-          @logger.debug 'Excepton raised while loading an aggregate, releasing lock'
+          register_aggregate aggregate
+          register_listener LockCleaningUnitOfWorkListener.new aggregate_id, @lock_manager
+
+          post_registration aggregate
 
+          aggregate
+        rescue
           @lock_manager.release_lock aggregate_id
           raise
         end
@@ -50,9 +50,9 @@ module Synapse
 
           register_aggregate aggregate
           register_listener LockCleaningUnitOfWorkListener.new aggregate.id, @lock_manager
-        rescue
-          @logger.debug 'Exception raised while adding an aggregate, releasing lock'
 
+          post_registration aggregate
+        rescue
           @lock_manager.release_lock aggregate.id
           raise
         end
@@ -71,6 +71,12 @@ module Synapse
       # @param [Integer] expected_version
       # @return [AggregateRoot]
       def perform_load(aggregate_id, expected_version); end
+
+      # Hook that is called after an aggregate is registered to the current unit of work
+      #
+      # @param [AggregateRoot] aggregate
+      # @return [undefined]
+      def post_registration(aggregate); end
     end # LockingRepository
 
     # Unit of work listener that releases the lock on an aggregate when the unit of work

data/lib/synapse/upcasting/upcaster_chain.rb

@@ -2,10 +2,10 @@ module Synapse
   module Upcasting
     class UpcasterChain
       # @return [ConverterFactory]
-      attr_accessor :converter_factory
+      attr_reader :converter_factory
 
       # @return [Array<Upcaster>]
-      attr_accessor :upcasters
+      attr_reader :upcasters
 
       # @param [ConverterFactory] converter_factory
       # @return [undefined]

data/lib/synapse/version.rb

@@ -1,3 +1,3 @@
 module Synapse
-  VERSION = '0.5.1'
+  VERSION = '0.5.2'
 end

data/test/command/{wiring_test.rb → mapping_test.rb}

@@ -3,9 +3,9 @@ require 'test_helper'
 module Synapse
   module Command
 
-    class WiringCommandHandlerTest < Test::Unit::TestCase
-      should 'pass the command to the correct wire' do
-        handler = ExampleWiringCommandHandler.new
+    class MappingCommandHandlerTest < Test::Unit::TestCase
+      should 'pass the command to the correct mapped handler' do
+        handler = ExampleMappingCommandHandler.new
         unit = Object.new
 
         command = CommandMessage.build do |builder|
@@ -31,8 +31,8 @@ module Synapse
         end
       end
 
-      should 'subscribe handler to the command bus for each wired command type' do
-        handler = ExampleWiringCommandHandler.new
+      should 'subscribe handler to the command bus for each mapped command type' do
+        handler = ExampleMappingCommandHandler.new
         bus = Object.new
 
         mock(bus).subscribe(TestSubCommand, handler)
@@ -41,8 +41,8 @@ module Synapse
         handler.subscribe bus
       end
 
-      should 'unsubscribe handler from the command bus for each wired command type' do
-        handler = ExampleWiringCommandHandler.new
+      should 'unsubscribe handler from the command bus for each mapped command type' do
+        handler = ExampleMappingCommandHandler.new
         bus = Object.new
 
         mock(bus).unsubscribe(TestSubCommand, handler)
@@ -55,16 +55,16 @@ module Synapse
     class TestCommand; end
     class TestSubCommand; end
 
-    class ExampleWiringCommandHandler
-      include WiringCommandHandler
+    class ExampleMappingCommandHandler
+      include MappingCommandHandler
 
       attr_accessor :handled, :sub_handled
 
-      wire TestCommand do |command|
+      map_command TestCommand do |command|
         @handled = true
       end
 
-      wire TestSubCommand do |command|
+      map_command TestSubCommand do |command|
         @sub_handled = true
       end
     end

data/test/configuration/component/command_bus/simple_command_bus_test.rb

@@ -3,6 +3,7 @@ require 'test_helper'
 module Synapse
   module Configuration
     class SimpleCommandBusDefinitionFactoryTest < Test::Unit::TestCase
+
       def setup
         @container = Container.new
         @builder = ContainerBuilder.new @container
@@ -52,6 +53,35 @@ module Synapse
         mock(handler_b).subscribe(is_a(Command::SimpleCommandBus))
         command_bus = @container.resolve :alt_command_bus
       end
+
+      should 'build and register tagged command interceptors' do
+        @builder.factory :serialization_interceptor, :tag => :dispatch_interceptor do
+          Command::SerializationOptimizingInterceptor.new
+        end
+
+        @builder.unit_factory
+        @builder.simple_command_bus
+
+        command_bus = @container.resolve :command_bus
+        serialization_interceptor = @container.resolve :serialization_interceptor
+
+        assert_include command_bus.interceptors, serialization_interceptor
+      end
+
+      should 'build and register tagged command filters' do
+        @builder.factory :validation_filter, :tag => :command_filter do
+          Command::ActiveModelValidationFilter.new
+        end
+
+        @builder.unit_factory
+        @builder.simple_command_bus
+
+        command_bus = @container.resolve :command_bus
+        validation_filter = @container.resolve :validation_filter
+
+        assert_include command_bus.filters, validation_filter
+      end
+
     end
   end
 end

data/test/configuration/component/event_bus/simple_event_bus_test.rb

@@ -49,10 +49,10 @@ module Synapse
     end
 
     class TestEventListener
-      include EventBus::WiringEventListener
+      include EventBus::MappingEventListener
     end
     class TestAltEventListener
-      include EventBus::WiringEventListener
+      include EventBus::MappingEventListener
     end
   end
 end

data/test/configuration/component/event_sourcing/repository_test.rb

@@ -0,0 +1,71 @@
+require 'test_helper'
+
+module Synapse
+  module Configuration
+    class EventSourcingRepositoryDefinitionBuilderTest < Test::Unit::TestCase
+
+      def setup
+        @container = Container.new
+        @builder = ContainerBuilder.new @container
+      end
+
+      should 'build with sensible defaults' do
+        # Repository needs unit of work provider (initialized by default)
+        # Repository needs event bus
+        @builder.simple_event_bus
+
+        # LockingRepository needs a locking manager (pessimistic by default)
+        # EventSourcingRepository needs an event store
+        @builder.factory :event_store do
+          Object.new
+        end
+
+        # EventSourcingRepository needs an aggregate factory
+        @builder.es_repository :account_repository do
+          use_aggregate_type Object
+        end
+
+        repository = @container.resolve :account_repository
+
+        event_bus = @container.resolve :event_bus
+        event_store = @container.resolve :event_store
+        unit_provider = @container.resolve :unit_provider
+
+        assert_same event_bus, repository.event_bus
+        assert_same event_store, repository.event_store
+        assert_same unit_provider, repository.unit_provider
+
+        assert_instance_of Repository::PessimisticLockManager, repository.lock_manager
+      end
+
+      should 'build with optional components' do
+        @builder.simple_event_bus
+        @builder.factory :event_store do
+          Object.new
+        end
+
+        @builder.aggregate_snapshot_taker
+        @builder.interval_snapshot_policy
+
+        @builder.factory :conflict_resolver do
+          EventSourcing::ConflictResolver.new
+        end
+
+        @builder.es_repository :account_repository do
+          use_aggregate_type Object
+        end
+
+        repository = @container.resolve :account_repository
+
+        conflict_resolver = @container.resolve :conflict_resolver
+        snapshot_policy = @container.resolve :snapshot_policy
+        snapshot_taker = @container.resolve :snapshot_taker
+
+        assert_same conflict_resolver, repository.conflict_resolver
+        assert_same snapshot_policy, repository.snapshot_policy
+        assert_same snapshot_taker, repository.snapshot_taker
+      end
+
+    end
+  end
+end

data/test/configuration/component/repository/simple_repository_test.rb

@@ -0,0 +1,35 @@
+require 'test_helper'
+
+module Synapse
+  module Configuration
+    class SimpleRepositoryDefinitionBuilderTest < Test::Unit::TestCase
+
+      def setup
+        @container = Container.new
+        @builder = ContainerBuilder.new @container
+      end
+
+      should 'build with sensible defaults' do
+        # Repository needs unit of work provider (initialized by default)
+        # Repository needs event bus
+        @builder.simple_event_bus
+
+        # SimpleRepository needs an aggregate type
+        @builder.simple_repository :account_repository do
+          use_aggregate_type Object
+        end
+
+        repository = @container.resolve :account_repository
+
+        event_bus = @container.resolve :event_bus
+        unit_provider = @container.resolve :unit_provider
+
+        assert_same event_bus, repository.event_bus
+        assert_same unit_provider, repository.unit_provider
+
+        assert_instance_of Repository::PessimisticLockManager, repository.lock_manager
+      end
+
+    end
+  end
+end