marples 1.0.2 → 1.0.4

data/README.md

@@ -12,7 +12,8 @@ As Postmaster, Ernest Marples introduced postcodes to the UK, making message
 routing easier.
 
 Marples, this gem, removes any uncertainty about which destination our messages
-go to by enforcing a naming scheme.
+go to by enforcing a naming scheme, and means we don't care about which
+transport representation is used, because these details are hidden from us.
 
 
 ## Usage
@@ -27,13 +28,38 @@ go to by enforcing a naming scheme.
 ### Listening for messages
 
     stomp = Stomp::Client.new ...
-    m = Marples::Client.new stomp
+    m = Marples::Client.new transport: stomp
     m.when 'publisher', 'publication', 'updated' do |publication|
       puts publication['slug']
       # => "how-postcodes-work"
     end
     m.join # Join the listening thread
 
+### Adding more content to a message
+
+Some objects are only useful with more information eg an Account object is maybe
+only useful when it has a list of all customers as well.
+
+It's possible that you could override `#to_xml` for each object, but that feels
+a little messy.
+
+Normally of course you'd use an implementation of
+[Data Enricher](http://eaipatterns.com/DataEnricher.html) but if, for some
+reason, you don't have anywhere to implement these integration patterns, you can
+choose to implement your own message payload generator:
+
+    stomp = Stomp::Client.new ...
+    m = Marples::Client.new transport: stomp, client_name: "publisher"
+    m.payload_for Account do |account|
+      account.to_xml :include => :customers
+    end
+
+    account = Account.find ...
+    m.updated account
+
+Marples expects XML data to be put on the bus, if you choose to return something
+that's not XML then you're on your own.
+
 
 ## Logging
 

data/lib/marples/client.rb

@@ -58,12 +58,27 @@ module Marples
       destination = destination_for client_name, object_type, action
       logger.debug "Using transport #{transport}"
       logger.debug "Sending XML to #{destination}"
-      logger.debug "XML: #{object.to_xml}"
-      transport.publish destination, object.to_xml
+      payload = generate_payload_for object
+      logger.debug "XML: #{payload}"
+      transport.publish destination, payload
       logger.debug "Message sent"
     end
     private :publish
 
+    def payload_for klass, &block
+      payload_generator[klass] = block
+    end
+
+    def generate_payload_for object
+      payload_generator[object.class].call object
+    end
+    private :generate_payload_for
+
+    def payload_generator
+      @payload_generator ||= Hash.new(lambda { |o| o.to_xml })
+    end
+    private :payload_generator
+
     def destination_for application_name, object_type, action
       "/topic/marples.#{application_name}.#{object_type}.#{action}"
     end

data/lib/marples/model_action_broadcast.rb

@@ -13,7 +13,7 @@ module Marples
         # If you'd like the actions performed by Marples to be logged, set a
         # logger. By default this uses the NullLogger.
         class_attribute :marples_logger
-        self.marples_logger = Rails.logger
+        self.marples_logger = NullLogger.instance
 
         CALLBACKS.each do |callback|
           callback_action = callback.to_s =~ /e$/ ? "#{callback}d" : "#{callback}ed"

data/lib/marples/version.rb

@@ -1,3 +1,3 @@
 module Marples
-  VERSION = "1.0.2"
+  VERSION = "1.0.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: marples
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-25 00:00:00.000000000 Z
+date: 2011-12-02 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: null_logger
-  requirement: &70212070634820 !ruby/object:Gem::Requirement
+  requirement: &70125815622680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70212070634820
+  version_requirements: *70125815622680
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &70212070633860 !ruby/object:Gem::Requirement
+  requirement: &70125815621380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -33,10 +33,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70212070633860
+  version_requirements: *70125815621380
 - !ruby/object:Gem::Dependency
   name: i18n
-  requirement: &70212070632780 !ruby/object:Gem::Requirement
+  requirement: &70125815620380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -44,10 +44,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70212070632780
+  version_requirements: *70125815620380
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70212070631880 !ruby/object:Gem::Requirement
+  requirement: &70125815619300 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -55,10 +55,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70212070631880
+  version_requirements: *70125815619300
 - !ruby/object:Gem::Dependency
   name: activerecord
-  requirement: &70212070630920 !ruby/object:Gem::Requirement
+  requirement: &70125815618520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -66,10 +66,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70212070630920
+  version_requirements: *70125815618520
 - !ruby/object:Gem::Dependency
   name: activerecord-nulldb-adapter
-  requirement: &70212070629780 !ruby/object:Gem::Requirement
+  requirement: &70125815617880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -77,7 +77,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70212070629780
+  version_requirements: *70125815617880
 description: Message destination arbiter
 email:
 - craig@barkingiguana.com
@@ -113,18 +113,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 2905283016913556502
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 2905283016913556502
 requirements: []
 rubyforge_project: marples
 rubygems_version: 1.8.10