synapse-core 0.5.1 → 0.5.2

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

@@ -6,10 +6,24 @@ module Synapse
     #   es_repository :orderbook_repository do
     #     use_aggregate_type TradeEngine::OrderBook
     #   end
+    #
+    # @example Use an event sourcing repository with snapshotting capability
+    #   aggregate_snapshot_taker
+    #
+    #   interval_snapshot_policy do
+    #     use_threshold 50
+    #   end
+    #
+    #   es_repository :orderbook_repository do
+    #     use_aggregate_type TradeEngine::OrderBook
+    #   end
     class EventSourcingRepositoryDefinitionBuilder < LockingRepositoryDefinitionBuilder
-      # Convenience method that defines an aggregate factory capable of creating aggregates 
+      # Convenience method that defines an aggregate factory capable of creating aggregates
       # of the given type
       #
+      # Definitions have to be created by aggregate factories so that aggregate factories can be
+      # registered to an aggregate snapshot taker.
+      #
       # @param [Class] aggregate_type
       # @return [undefined]
       def use_aggregate_type(aggregate_type)
@@ -40,13 +54,28 @@ module Synapse
         @event_store = event_store
       end
 
+      # @param [Symbol] snapshot_policy
+      # @return [undefined]
+      def use_snapshot_policy(snapshot_policy)
+        @snapshot_policy = snapshot_policy
+      end
+
+      # @param [Symbol] snapshot_taker
+      # @return [undefined]
+      def use_snapshot_taker(snapshot_taker)
+        @snapshot_taker = snapshot_taker
+      end
+
     protected
 
       # @return [undefined]
       def populate_defaults
         super
 
+        use_conflict_resolver :conflict_resolver
         use_event_store :event_store
+        use_snapshot_policy :snapshot_policy
+        use_snapshot_taker :snapshot_taker
 
         use_factory do
           aggregate_factory = resolve @aggregate_factory
@@ -54,6 +83,12 @@ module Synapse
           lock_manager = build_lock_manager
 
           repository = EventSourcing::EventSourcingRepository.new aggregate_factory, event_store, lock_manager
+
+          # Optional dependencies
+          repository.conflict_resolver = resolve @conflict_resolver, true
+          repository.snapshot_policy = resolve @snapshot_policy, true
+          repository.snapshot_taker = resolve @snapshot_taker, true
+
           inject_base_dependencies repository
         end
       end

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

@@ -1,15 +1,11 @@
+require 'synapse/configuration/component/repository/locking_repository'
+require 'synapse/configuration/component/repository/simple_repository'
+
 module Synapse
   module Configuration
     class ContainerBuilder
       # Creates and configures a simple repository
-      #
-      # @see SimpleRepositoryDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def simple_repository(identifier = nil, &block)
-        with_definition_builder SimpleRepositoryDefinitionBuilder, identifier, &block
-      end
+      builder :simple_repository, SimpleRepositoryDefinitionBuilder
     end # ContainerBuilder
   end # Configuration
 end

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

@@ -1,25 +1,14 @@
+require 'synapse/configuration/component/serialization/converter_factory'
+require 'synapse/configuration/component/serialization/serializer'
+
 module Synapse
   module Configuration
     class ContainerBuilder
       # Creates and configures a converter factory for serialization
-      #
-      # @see ConverterFactoryDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def converter_factory(identifier = nil, &block)
-        with_definition_builder ConverterFactoryDefinitionBuilder, identifier, &block
-      end
+      builder :converter_factory, ConverterFactoryDefinitionBuilder
 
       # Creates and configures a serializer for partitioning, event storage, etc.
-      #
-      # @see SerializerDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def serializer(identifier = nil, &block)
-        with_definition_builder SerializerDefinitionBuilder, identifier, &block
-      end
+      builder :serializer, SerializerDefinitionBuilder
     end # ContainerBuilder
   end # Configuration
 end

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

@@ -1,3 +1,5 @@
+require 'synapse/configuration/component/uow/unit_factory'
+
 module Synapse
   module Configuration
     class ContainerBuilder
@@ -9,14 +11,7 @@ module Synapse
       end
 
       # Creates and configures a unit of work factory
-      #
-      # @see UnitOfWorkFactoryDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def unit_factory(identifier = nil, &block)
-        with_definition_builder UnitOfWorkFactoryDefinitionBuilder, identifier, &block
-      end
+      builder :unit_factory, UnitOfWorkFactoryDefinitionBuilder
     end # ContainerBuilder
   end # Configuration
 end

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

@@ -1,15 +1,10 @@
+require 'synapse/configuration/component/upcasting/upcaster_chain'
+
 module Synapse
   module Configuration
     class ContainerBuilder
       # Creates and configures an upcaster chain
-      #
-      # @see UpcasterChainDefinitionBuilder
-      # @param [Symbol] identifier
-      # @param [Proc] block
-      # @return [undefined]
-      def upcaster_chain(identifier = nil, &block)
-        with_definition_builder UpcasterChainDefinitionBuilder, identifier, &block
-      end
+      builder :upcaster_chain, UpcasterChainDefinitionBuilder
     end # ContainerBuilder
   end # Configuration
 end

data/lib/synapse/configuration/container_builder.rb

@@ -19,6 +19,29 @@ module Synapse
         self.initializers.push initializer
       end
 
+      # Registers a definition builder that can be used as a shortcut for configuration
+      #
+      # @example
+      #   class ContainerBuilder
+      #     builder :simple_event_bus, SimpleEventBusDefinitionBuilder
+      #   end
+      #
+      # @!macro attach
+      #   @!method $1(identifier = nil, &block)
+      #   @see $2
+      #   @param [Symbol] identifier Identifier of the definition
+      #   @param [Proc] block Executed in the context of the definition builder
+      #   @return [undefined]
+      #
+      # @param [Symbol] name
+      # @param [Class] builder_class
+      # @return [undefined]
+      def self.builder(name, builder_class)
+        define_method name do |identifier = nil, &block|
+          with_definition_builder builder_class, identifier, &block
+        end
+      end
+
       # @return [Container]
       attr_reader :container
 
@@ -36,6 +59,7 @@ module Synapse
 
       # Executes the given block in the context of the container builder
       #
+      # @api public
       # @param [Proc] block
       # @return [undefined]
       def build_with(&block)
@@ -54,6 +78,7 @@ module Synapse
       #
       # @see #factory If the definition being created is simple
       # @see DefinitionBuilder
+      # @api public
       # @param [Symbol] id
       # @param [Proc] block
       # @return [undefined]
@@ -75,6 +100,7 @@ module Synapse
       #   end
       #
       # @see DefinitionBuilder#use_factory
+      # @api public
       # @param [Symbol] id
       # @param [Object...] args
       # @param [Proc] block
@@ -96,6 +122,7 @@ module Synapse
       # executes the block in the context of the definition builder, then finally builds and
       # registers the definition with this builder's associate container.
       #
+      # @api public
       # @param [Class] builder_type
       # @param [Symbol] id
       # @param [Proc] block
@@ -103,6 +130,6 @@ module Synapse
       def with_definition_builder(builder_type, id, &block)
         builder_type.build @container, id, &block
       end
-    end
-  end
+    end # ContainerBuilder
+  end # Configuration
 end

data/lib/synapse/configuration/definition_builder.rb

@@ -11,8 +11,8 @@ module Synapse
       # @param [Proc] block
       # @return [undefined]
       def self.build(container, id = nil, &block)
-        builder = self.new container, id
-        builder.instance_exec(&block) if block
+        builder = new container, id
+        builder.instance_exec &block if block
         builder.register_definition
 
         builder.id
@@ -31,33 +31,39 @@ module Synapse
         @id = id.to_sym if id
       end
 
+      # @api public
       # @param [Symbol] id
       # @return [undefined]
       def identified_by(id)
         @id = id.to_sym
       end
 
+      # @api public
       # @return [undefined]
       def anonymous
         identified_by SecureRandom.hex 8
       end
 
+      # @api public
       # @param [Symbol...] tags
       # @return [undefined]
       def tag(*tags)
         @tags.merge tags.flatten
       end
 
+      # @api public
       # @return [undefined]
       def as_prototype
         @prototype = true
       end
 
+      # @api public
       # @return [undefined]
       def as_singleton
         @prototype = false
       end
 
+      # @api public
       # @param [Proc] factory
       # @return [undefined]
       def use_factory(&factory)
@@ -66,37 +72,18 @@ module Synapse
         end
       end
 
+      # @api public
       # @param [Object] instance
       # @return [undefined]
       def use_instance(instance)
         @instance = instance
       end
 
-      # If the given value is a symbol, it will be resolved using the container. Otherwise, it
-      # will be passed through
-      #
-      # @param [Object] value
-      # @return [Object]
-      def resolve(value, optional = false)
-        if value.is_a? Symbol
-          @container.resolve value, optional
-        else
-          value
-        end
-      end
-
-      # Resolves all services that have the given tag
-      #
-      # @param [Symbol] tag
-      # @return [Array]
-      def resolve_tagged(tag)
-        @container.resolve_tagged tag
-      end
-
       # Convenience method for building composite services
       #
       # The given block will be executed in the context of the definition builder
       #
+      # @api public
       # @param [Class] builder_type Defaults to DefinitionBuilder
       # @param [Proc] block
       # @return [Symbol] The identifier of the newly created service
@@ -124,8 +111,45 @@ module Synapse
       # @return [undefined]
       def populate_defaults; end
 
+      # Injects any configured dependencies into the given object
+      #
+      # @api public
+      # @param [Dependent] object
+      # @return [Dependent]
+      def inject_into(object)
+        @container.inject_into object
+        object
+      end
+
+      # If the given value is a symbol, it will be resolved using the container. Otherwise, it
+      # will be passed through
+      #
+      # @api public
+      # @raise [ConfigurationError] If value is required but was not set
+      # @param [Object] value
+      # @return [Object]
+      def resolve(value, optional = false)
+        if value.is_a? Symbol
+          @container.resolve value, optional
+        elsif value.nil? and not optional
+          raise ConfigurationError, 'Value was not set'
+        else
+          value
+        end
+      end
+
+      # Resolves all services that have the given tag
+      #
+      # @api public
+      # @param [Symbol] tag
+      # @return [Array]
+      def resolve_tagged(tag)
+        @container.resolve_tagged tag
+      end
+
       # Resolves any services with the given tag and yields them
       #
+      # @api public
       # @yield [Object]
       # @param [Symbol] tag
       # @return [undefined]

data/lib/synapse/domain/message.rb

@@ -23,22 +23,6 @@ module Synapse
         EventMessageBuilder
       end
 
-      # Creates an event message using the given event object
-      #
-      # If the given object is an event message, it will be returned unchanged.
-      #
-      # @param [Object] event
-      # @return [EventMessage]
-      def self.as_message(event)
-        unless event.is_a? EventMessage
-          event = self.build do |builder|
-            builder.payload = event
-          end
-        end
-
-        event
-      end
-
     protected
 
       # @param [EventMessageBuilder] builder

data/lib/synapse/event_bus.rb

@@ -1,5 +1,5 @@
 require 'synapse/event_bus/event_bus'
 require 'synapse/event_bus/event_listener'
 require 'synapse/event_bus/event_publisher'
+require 'synapse/event_bus/mapping'
 require 'synapse/event_bus/simple_event_bus'
-require 'synapse/event_bus/wiring'

data/lib/synapse/event_bus/event_listener.rb

@@ -3,7 +3,7 @@ module Synapse
     # Represents a listener that can be notified of events from an event bus. Implementations are
     # highly discouraged from throwing exceptions.
     #
-    # Consider using the event listener mixin that uses message wiring.
+    # Consider using the event listener mixin that uses the mapping DSL.
     #
     # @abstract
     module EventListener

data/lib/synapse/event_bus/mapping.rb

@@ -0,0 +1,47 @@
+module Synapse
+  module EventBus
+    # Mixin for an event listener that wishes to use the mapping DSL
+    #
+    # @example
+    #   class OrderBookManagementListener
+    #     include MappingEventListener
+    #
+    #     map_event UserRegistered do |event|
+    #       # ...
+    #     end
+    #
+    #     map_event UserBanned, :to => :on_banned
+    #   end
+    module MappingEventListener
+      extend ActiveSupport::Concern
+      include EventListener
+
+      included do
+        # @return [Mapping::Mapper]
+        class_attribute :event_mapper
+        self.event_mapper = Mapping::Mapper.new true
+      end
+
+      module ClassMethods
+        # @see Mapper#map
+        # @param [Class] type
+        # @param [Object...] args
+        # @param [Proc] block
+        # @return [undefined]
+        def map_event(type, *args, &block)
+          event_mapper.map type, *args, &block
+        end
+      end
+
+      # @param [EventMessage] event
+      # @return [undefined]
+      def notify(event)
+        mapping = event_mapper.mapping_for event.payload_type
+
+        return unless mapping
+
+        mapping.invoke self, event.payload
+      end
+    end # MappingEventListener
+  end # EventBus
+end