lib/acfs/global.rb in acfs-0.29.1.1.b257 vs lib/acfs/global.rb in acfs-0.29.1.1.b259

@@ -38,7 +38,30 @@
     #
     def reset
       self.runner.clear
       Acfs::Stub.clear
     end
+
+    # @api public
+    #
+    # Add an additional callback hook to not loaded resource.
+    # If given resource already loaded callback will be invoked immediately.
+    #
+    # This method will be replaced by explicit callback handling when query methods
+    # return explicit future objects.
+    #
+    # @example
+    #   user = MyUser.find 1, &callback_one
+    #   Acfs.add_callback(user, &callback_two)
+    #
+    def add_callback(resource, &block)
+      raise ArgumentError.new "Given resource is not an Acfs resource but a: #{resource.class.name}" unless resource.respond_to?(:__callbacks__)
+      return false if block.nil?
+
+      if resource.loaded?
+        block.call resource
+      else
+        resource.__callbacks__ << block
+      end
+    end
   end
 end