synapse-core 0.5.5 → 0.5.6

data/lib/synapse/process_manager/process_repository.rb

@@ -12,7 +12,9 @@ module Synapse
       # @param [Class] type
       # @param [Correlation] correlation
       # @return [Set]
-      def find(type, correlation); end
+      def find(type, correlation)
+        raise NotImplementedError
+      end
 
       # Loads a known process by its unique identifier
       #
@@ -25,7 +27,9 @@ module Synapse
       # @abstract
       # @param [String] id
       # @return [Process] Returns nil if process could not be found
-      def load(id); end
+      def load(id)
+        raise NotImplementedError
+      end
 
       # Commits the changes made to the process instance
       #
@@ -35,7 +39,9 @@ module Synapse
       # @abstract
       # @param [Process] process
       # @return [undefined]
-      def commit(process); end
+      def commit(process)
+        raise NotImplementedError
+      end
 
       # Registers a newly created process with the repository
       #
@@ -47,7 +53,9 @@ module Synapse
       # @abstract
       # @param [Process] process
       # @return [undefined]
-      def add(process); end
-    end
-  end
+      def add(process)
+        raise NotImplementedError
+      end
+    end # ProcessRepository
+  end # ProcessManager
 end

data/lib/synapse/repository/lock_manager.rb

@@ -8,7 +8,9 @@ module Synapse
       # @abstract
       # @param [AggregateRoot] aggregate
       # @return [Boolean]
-      def validate_lock(aggregate); end
+      def validate_lock(aggregate)
+        raise NotImplementedError
+      end
 
       # Obtains a lock for an aggregate with the given aggregate identifier. Depending on
       # the strategy, this method may return immediately or block until a lock is held.
@@ -16,7 +18,9 @@ module Synapse
       # @abstract
       # @param [Object] aggregate_id
       # @return [undefined]
-      def obtain_lock(aggregate_id); end
+      def obtain_lock(aggregate_id)
+        raise NotImplementedError
+      end
 
       # Releases the lock held for an aggregate with the given aggregate identifier. The caller
       # of this method must ensure a valid lock was requested using {#obtain_lock}. If no lock
@@ -25,7 +29,9 @@ module Synapse
       # @abstract
       # @param [Object] aggregate_id
       # @return [undefined]
-      def release_lock(aggregate_id); end
+      def release_lock(aggregate_id)
+        raise NotImplementedError
+      end
     end # LockManager
 
     # Implementation of a lock manager that does no locking
@@ -35,6 +41,14 @@ module Synapse
       def validate_lock(aggregate)
         true
       end
+
+      # @param [Object] aggregate_id
+      # @return [undefined]
+      def obtain_lock(aggregate_id); end
+
+      # @param [Object] aggregate_id
+      # @return [undefined]
+      def release_lock(aggregate_id); end
     end # NullLockManager
   end # Repository
 end

data/lib/synapse/repository/locking.rb

@@ -70,7 +70,9 @@ module Synapse
       # @param [Object] aggregate_id
       # @param [Integer] expected_version
       # @return [AggregateRoot]
-      def perform_load(aggregate_id, expected_version); end
+      def perform_load(aggregate_id, expected_version)
+        raise NotImplementedError
+      end
 
       # Hook that is called after an aggregate is registered to the current unit of work
       #

data/lib/synapse/repository/repository.rb

@@ -26,7 +26,9 @@ module Synapse
       # @param [Object] aggregate_id
       # @param [Integer] expected_version If this is nil, no version validation is performed
       # @return [AggregateRoot]
-      def load(aggregate_id, expected_version = nil); end
+      def load(aggregate_id, expected_version = nil)
+        raise NotImplementedError
+      end
 
       # Adds a new, unmanaged aggregate to the repository
       #
@@ -38,7 +40,9 @@ module Synapse
       # @raise [ArgumentError] If the version of the aggregate is not null
       # @param [AggregateRoot] aggregate
       # @return [undefined]
-      def add(aggregate); end
+      def add(aggregate)
+        raise NotImplementedError
+      end
 
     protected
 
@@ -46,21 +50,27 @@ module Synapse
       #
       # @abstract
       # @return [Class]
-      def aggregate_type; end
+      def aggregate_type
+        raise NotImplementedError
+      end
 
       # Deletes the given aggregate from the underlying storage mechanism
       #
       # @abstract
       # @param [AggregateRoot] aggregate
       # @return [undefined]
-      def delete_aggregate(aggregate); end
+      def delete_aggregate(aggregate)
+        raise NotImplementedError
+      end
 
       # Saves the given aggregate using the underlying storage mechanism
       #
       # @abstract
       # @param [AggregateRoot] aggregate
       # @return [undefined]
-      def save_aggregate(aggregate); end
+      def save_aggregate(aggregate)
+        raise NotImplementedError
+      end
 
       # Asserts that an aggregate being added is compatible with this repository and is newly
       # created

data/lib/synapse/serialization/converter.rb

@@ -33,7 +33,9 @@ module Synapse
       # @abstract
       # @param [Object] original
       # @return [Object]
-      def convert_content(original); end
+      def convert_content(original)
+        raise NotImplementedError
+      end
     end # Converter
   end # Serialization
 end

data/lib/synapse/serialization/message/serialization_aware.rb

@@ -6,12 +6,16 @@ module Synapse
       # @param [Serializer] serializer
       # @param [Class] expected_type
       # @return [SerializedObject]
-      def serialize_metadata(serializer, expected_type); end
+      def serialize_metadata(serializer, expected_type)
+        raise NotImplementedError
+      end
 
       # @param [Serializer] serializer
       # @param [Class] expected_type
       # @return [SerializedObject]
-      def serialize_payload(serializer, expected_type); end
+      def serialize_payload(serializer, expected_type)
+        raise NotImplementedError
+      end
     end # SerializationAware
   end # Serialization
 end

data/lib/synapse/serialization/revision_resolver.rb

@@ -8,7 +8,9 @@ module Synapse
       # @abstract
       # @param [Class] payload_type
       # @return [String] The revision of the given payload type
-      def revision_of(payload_type); end
+      def revision_of(payload_type)
+        raise NotImplementedError
+      end
     end # RevisionResolver
 
     # Implementation of a revision resolver that returns a fixed value. This could be an

data/lib/synapse/serialization/serializer.rb

@@ -68,7 +68,9 @@ module Synapse
       # @abstract
       # @param [Object] content The original Ruby object to serialize
       # @return [Object] Should be in the native content type of the serializer
-      def perform_serialize(content); end
+      def perform_serialize(content)
+        raise NotImplementedError
+      end
 
       # Deserializes the given serialized content into the given Ruby type
       #
@@ -76,13 +78,17 @@ module Synapse
       # @param [Object] content Should be in the native content type of the serializer
       # @param [Class] type The class type to be deserialized into
       # @return [Object] The deserialized object
-      def perform_deserialize(content, type); end
+      def perform_deserialize(content, type)
+        raise NotImplementedError
+      end
 
       # Returns the native content type that the serializer works with
       #
       # @abstract
       # @return [Class]
-      def native_content_type; end
+      def native_content_type
+        raise NotImplementedError
+      end
 
     private
 

data/lib/synapse/uow/nesting.rb

@@ -121,38 +121,50 @@ module Synapse
       #
       # @abstract
       # @return [undefined]
-      def perform_commit; end
+      def perform_commit
+        raise NotImplementedError
+      end
 
       # Executes logic required to rollback this unit of work
       #
       # @abstract
       # @param [Error] cause
       # @return [undefined]
-      def perform_rollback(cause = nil); end
+      def perform_rollback(cause = nil)
+        raise NotImplementedError
+      end
 
       # Notifies listeners that this unit of work is cleaning up
       #
       # @abstract
       # @return [undefined]
-      def notify_cleanup; end
+      def notify_cleanup
+        raise NotImplementedError
+      end
 
       # Notifies listeners that this unit of work is preparing to be committed
       #
       # @abstract
       # @return [undefined]
-      def notify_prepare_commit; end
+      def notify_prepare_commit
+        raise NotImplementedError
+      end
 
       # Executes logic required when starting this unit of work
       #
       # @abstract
       # @return [undefined]
-      def perform_start; end
+      def perform_start
+        raise NotImplementedError
+      end
 
       # Storages aggregates registered with this unit of work
       #
       # @abstract
       # @return [undefined]
-      def store_aggregates; end
+      def store_aggregates
+        raise NotImplementedError
+      end
 
       # Commits all registered inner units of work. This should be invoked after events have been
       # dispatched and before any listeners are notified of the commit.

data/lib/synapse/uow/transaction_manager.rb

@@ -9,19 +9,25 @@ module Synapse
       #
       # @abstract
       # @return [Object]
-      def start; end
+      def start
+        raise NotImplementedError
+      end
 
       # Commits the given transaction
       #
       # @param [Object] transaction
       # @return [undefined]
-      def commit(transaction); end
+      def commit(transaction)
+        raise NotImplementedError
+      end
 
       # Rolls back the given transaction
       #
       # @param [Object] transaction
       # @return [undefined]
-      def rollback(transaction); end
-    end
-  end
+      def rollback(transaction)
+        raise NotImplementedError
+      end
+    end # TransactionManager
+  end # UnitOfWork
 end

data/lib/synapse/upcasting/single_upcaster.rb

@@ -6,21 +6,18 @@ module Synapse
     # This mixin is not suitable if an upcaster needs to upcast a  serialized object into multiple
     # newer serialized objects, or when the output representation type is not the same as the
     # expected representation type.
-    module SingleUpcaster
-      extend ActiveSupport::Concern
-      include Upcaster
-
+    #
+    # @abstract
+    class SingleUpcaster < Upcaster
       # @param [SerialiedObject] intermediate
       # @param [Array<SerializedType>] expected_types
       # @param [UpcastingContext] upcast_context
       # @return [Array<SerializedObject>]
       def upcast(intermediate, expected_types, upcast_context)
-        upcast_content = perform_upcast(intermediate, upcast_context)
+        upcast_content = perform_upcast intermediate, upcast_context
         upcast_objects = Array.new
 
-        unless upcast_content
-          return upcast_objects
-        end
+        return upcast_objects unless upcast_content
 
         upcast_objects.push Serialization::SerializedObject.new(upcast_content, expected_content_type, expected_types.at(0))
         upcast_objects
@@ -29,12 +26,10 @@ module Synapse
       # @param [SerializedType] serialized_type
       # @return [Array<SerializedType>]
       def upcast_type(serialized_type)
-        upcast_type = perform_upcast_type(serialized_type)
+        upcast_type = perform_upcast_type serialized_type
         upcast_types = Array.new
 
-        unless upcast_type
-          return upcast_types
-        end
+        return upcast_types unless upcast_type
 
         upcast_types.push upcast_type
         upcast_types
@@ -46,12 +41,16 @@ module Synapse
       # @param [SerializedObject] intermediate
       # @param [UpcastingContext] upcast_context
       # @return [Object] If nil is returned, the serialized object will be dropped
-      def perform_upcast(intermediate, upcast_context); end
+      def perform_upcast(intermediate, upcast_context)
+        raise NotImplementedError
+      end
 
       # @abstract
       # @param [SerializedType] serialized_type
       # @return [SerializedType] If nil is returned, the serialized object will be dropped
-      def perform_upcast_type(serialized_type); end
-    end
-  end
+      def perform_upcast_type(serialized_type)
+        raise NotImplementedError
+      end
+    end # SingleUpcaster
+  end # Upcasting
 end

data/lib/synapse/upcasting/upcaster.rb

@@ -10,19 +10,16 @@ module Synapse
     #
     # For performance reasons, it is advisable to ensure that all upcasters in the same chain use
     # the same intermediate representation type.
-    module Upcaster
-      extend ActiveSupport::Concern
-
-      included do
-        class_attribute :expected_content_type
-      end
+    #
+    # @abstract
+    class Upcaster
+      # @return [Class]
+      class_attribute :expected_content_type
 
-      module ClassMethods
-        # @param [Class] type
-        # @return [undefined]
-        def expects_content_type(type)
-          self.expected_content_type = type
-        end
+      # @param [Class] type
+      # @return [undefined]
+      def self.expects_content_type(type)
+        self.expected_content_type = type
       end
 
       # Returns true if this upcaster is capable of upcasting the given type
@@ -30,7 +27,9 @@ module Synapse
       # @abstract
       # @param [SerializedType] serialized_type
       # @return [Boolean]
-      def can_upcast?(serialized_type); end
+      def can_upcast?(serialized_type)
+        raise NotImplementedError
+      end
 
       # Upcasts a given serialized object to zero or more upcast objects
       #
@@ -42,14 +41,18 @@ module Synapse
       # @param [Array<SerializedType>] expected_types
       # @param [UpcastingContext] upcast_context
       # @return [Array<SerializedObject>]
-      def upcast(intermediate, expected_types, upcast_context); end
+      def upcast(intermediate, expected_types, upcast_context)
+        raise NotImplementedError
+      end
 
       # Upcasts a given serialized type to zero or more upcast types
       #
       # @abstract
       # @param [SerializedType] serialized_type
       # @return [Array<SerializedType>]
-      def upcast_type(serialized_type); end
-    end
-  end
+      def upcast_type(serialized_type)
+        raise NotImplementedError
+      end
+    end # Upcaster
+  end # Upcasting
 end

data/lib/synapse/upcasting/upcaster_chain.rb

@@ -32,7 +32,7 @@ module Synapse
         serialized_objects.push serialized_object
 
         @upcasters.each do |upcaster|
-          serialized_objects = upcast_objects(upcaster, serialized_objects, upcast_context)
+          serialized_objects = upcast_objects upcaster, serialized_objects, upcast_context
         end
 
         serialized_objects
@@ -46,7 +46,7 @@ module Synapse
       # @param [UpcastingContent] upcast_context
       # @return [Array<SerializedObject>]
       def perform_upcast(upcaster, representation, expected_types, upcast_context)
-        upcaster.upcast(representation, expected_types, upcast_context)
+        upcaster.upcast representation, expected_types, upcast_context
       end
 
     private

data/lib/synapse/version.rb

@@ -1,3 +1,3 @@
 module Synapse
-  VERSION = '0.5.5'
+  VERSION = '0.5.6'
 end

data/test/auditing/data_provider_test.rb

@@ -18,12 +18,20 @@ module Synapse
 
     class CorrelationDataProviderTest < Test::Unit::TestCase
       should 'provide the identifier of a command for auditing' do
-        provider = CorrelationDataProvider.new :command_id
+        provider = CorrelationDataProvider.new
         command = Command::CommandMessage.build
 
         expected = { :command_id => command.id }
         assert_equal expected, provider.provide_data_for(command)
       end
+
+      should 'provide the identifier of a command for auditing using an alternate key' do
+        provider = CorrelationDataProvider.new :correlation_id
+        command = Command::CommandMessage.build
+
+        expected = { :correlation_id => command.id }
+        assert_equal expected, provider.provide_data_for(command)
+      end
     end
 
   end

data/test/command/mapping_test.rb

@@ -60,11 +60,17 @@ module Synapse
 
       attr_accessor :handled, :sub_handled
 
-      map_command TestCommand do |command|
+      map_command TestCommand do |command, message, current_unit|
+        raise ArgumentError unless TestCommand === command
+        raise ArgumentError unless CommandMessage === message
+        raise ArgumentError if current_unit.nil?
+
         @handled = true
       end
 
-      map_command TestSubCommand do |command|
+      map_command TestSubCommand, :to => :on_sub
+
+      def on_sub(command)
         @sub_handled = true
       end
     end

data/test/event_bus/mapping_test.rb

@@ -33,11 +33,16 @@ module Synapse
 
       attr_accessor :handled, :sub_handled
 
-      map_event TestEvent do |event|
+      map_event TestEvent do |event, message|
+        raise ArgumentError unless TestEvent === event
+        raise ArgumentError unless Domain::EventMessage === message
+
         @handled = true
       end
 
-      map_event TestSubEvent do |event|
+      map_event TestSubEvent, :to => :on_sub
+
+      def on_sub(event)
         @sub_handled = true
       end
     end

data/test/event_sourcing/repository_test.rb

@@ -71,7 +71,7 @@ module Synapse
       end
 
       should 'defer version checking to a conflict resolver if one is set' do
-        @repository.conflict_resolver = ConflictResolver.new
+        @repository.conflict_resolver = AcceptAllConflictResolver.new
 
         event_a = create_event(123, 0, StubCreatedEvent.new(123))
         event_b = create_event(123, 1, StubChangedEvent.new)

data/test/repository/locking_test.rb

@@ -87,6 +87,9 @@ module Synapse
       def aggregate_type
         TestAggregateRoot
       end
+
+      def save_aggregate(aggregate); end
+      def delete_aggregate(aggregate); end
     end
   end
 end

data/test/upcasting/fixtures.rb

@@ -1,7 +1,6 @@
 module Synapse
   module Upcasting
-    class TestSplitUpcaster
-      include Upcaster
+    class TestSplitUpcaster < Upcaster
 
       expects_content_type Object
 
@@ -28,9 +27,7 @@ module Synapse
       end
     end
 
-    class TestTypeUpcaster
-      include SingleUpcaster
-
+    class TestTypeUpcaster < SingleUpcaster
       expects_content_type Object
 
       def can_upcast?(serialized_type)
@@ -48,9 +45,7 @@ module Synapse
       end
     end
 
-    class TestPhaseOutUpcaster
-      include SingleUpcaster
-
+    class TestPhaseOutUpcaster < SingleUpcaster
       expects_content_type Object
 
       def can_upcast?(serialized_type)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: synapse-core
 version: !ruby/object:Gem::Version
-  version: 0.5.5
+  version: 0.5.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-13 00:00:00.000000000 Z
+date: 2013-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -157,6 +157,9 @@ files:
 - lib/synapse/domain/simple_stream.rb
 - lib/synapse/domain/stream.rb
 - lib/synapse/domain.rb
+- lib/synapse/event_bus/clustering/cluster.rb
+- lib/synapse/event_bus/clustering/event_bus.rb
+- lib/synapse/event_bus/clustering/selector.rb
 - lib/synapse/event_bus/event_bus.rb
 - lib/synapse/event_bus/event_listener.rb
 - lib/synapse/event_bus/event_publisher.rb