restforce-db 1.2.7 → 1.2.8

data/test/cassettes/Restforce_DB_Associations_HasOne/with_an_inverse_mapping/_build/when_the_associated_record_has_been_cached/uses_the_cached_record.yml

@@ -0,0 +1,271 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://<host>/services/oauth2/token
+    body:
+      encoding: US-ASCII
+      string: grant_type=password&client_id=<client_id>&client_secret=<client_secret>&username=<username>&password=<password><security_token>
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 01 May 2015 16:33:17 GMT
+      Set-Cookie:
+      - BrowserId=LtTu8_z3Sp2cm5mkBgsGTw;Path=/;Domain=.salesforce.com;Expires=Tue,
+        30-Jun-2015 16:33:17 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Pragma:
+      - no-cache
+      Cache-Control:
+      - no-cache, no-store
+      Content-Type:
+      - application/json;charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"id":"https://login.salesforce.com/id/00D1a000000H3O9EAK/0051a000000UGT8AAO","issued_at":"1430497997739","token_type":"Bearer","instance_url":"https://<host>","signature":"f4tQcugKKSE9kjNZgHUkr/ZXGP27pEKiZGfEskeGWgY=","access_token":"00D1a000000H3O9!AQ4AQDv3Hk9TRSKHVK.6TQHDjiXPpFDEH7AxoxdK.ytZcKr4gkBGokBh2ZhUcaf0_eFqhFa6YVCzmfP.bUKsz9xIJOy41iQD"}'
+    http_version: 
+  recorded_at: Fri, 01 May 2015 16:33:18 GMT
+- request:
+    method: post
+    uri: https://<host>/services/data/v26.0/sobjects/Contact
+    body:
+      encoding: UTF-8
+      string: '{"Email":"somebody@example.com","LastName":"Somebody"}'
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Content-Type:
+      - application/json
+      Authorization:
+      - OAuth 00D1a000000H3O9!AQ4AQDv3Hk9TRSKHVK.6TQHDjiXPpFDEH7AxoxdK.ytZcKr4gkBGokBh2ZhUcaf0_eFqhFa6YVCzmfP.bUKsz9xIJOy41iQD
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 201
+      message: Created
+    headers:
+      Date:
+      - Fri, 01 May 2015 16:33:17 GMT
+      Set-Cookie:
+      - BrowserId=tLtZK_c5SrWi7_EH1k-1uA;Path=/;Domain=.salesforce.com;Expires=Tue,
+        30-Jun-2015 16:33:17 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Sforce-Limit-Info:
+      - api-usage=11/15000
+      Location:
+      - "/services/data/v26.0/sobjects/Contact/0031a000002jr5oAAA"
+      Content-Type:
+      - application/json;charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"id":"0031a000002jr5oAAA","success":true,"errors":[]}'
+    http_version: 
+  recorded_at: Fri, 01 May 2015 16:33:18 GMT
+- request:
+    method: post
+    uri: https://<host>/services/data/v26.0/sobjects/CustomObject__c
+    body:
+      encoding: UTF-8
+      string: '{"Friend__c":"0031a000002jr5oAAA"}'
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Content-Type:
+      - application/json
+      Authorization:
+      - OAuth 00D1a000000H3O9!AQ4AQDv3Hk9TRSKHVK.6TQHDjiXPpFDEH7AxoxdK.ytZcKr4gkBGokBh2ZhUcaf0_eFqhFa6YVCzmfP.bUKsz9xIJOy41iQD
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 201
+      message: Created
+    headers:
+      Date:
+      - Fri, 01 May 2015 16:33:18 GMT
+      Set-Cookie:
+      - BrowserId=jN5M9ObZTi-rz1DyxbAeZw;Path=/;Domain=.salesforce.com;Expires=Tue,
+        30-Jun-2015 16:33:18 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Sforce-Limit-Info:
+      - api-usage=11/15000
+      Location:
+      - "/services/data/v26.0/sobjects/CustomObject__c/a001a000001TuP2AAK"
+      Content-Type:
+      - application/json;charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"id":"a001a000001TuP2AAK","success":true,"errors":[]}'
+    http_version: 
+  recorded_at: Fri, 01 May 2015 16:33:18 GMT
+- request:
+    method: get
+    uri: https://<host>/services/data/v26.0/query?q=select%20Id,%20SystemModstamp,%20Email%20from%20Contact%20where%20Id%20=%20%270031a000002jr5oAAA%27
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Authorization:
+      - OAuth 00D1a000000H3O9!AQ4AQDv3Hk9TRSKHVK.6TQHDjiXPpFDEH7AxoxdK.ytZcKr4gkBGokBh2ZhUcaf0_eFqhFa6YVCzmfP.bUKsz9xIJOy41iQD
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 01 May 2015 16:33:18 GMT
+      Set-Cookie:
+      - BrowserId=CSF-VoOoS5ChC6rHiA3_Xw;Path=/;Domain=.salesforce.com;Expires=Tue,
+        30-Jun-2015 16:33:18 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Sforce-Limit-Info:
+      - api-usage=11/15000
+      Content-Type:
+      - application/json;charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"totalSize":1,"done":true,"records":[{"attributes":{"type":"Contact","url":"/services/data/v26.0/sobjects/Contact/0031a000002jr5oAAA"},"Id":"0031a000002jr5oAAA","SystemModstamp":"2015-05-01T16:33:18.000+0000","Email":"somebody@example.com"}]}'
+    http_version: 
+  recorded_at: Fri, 01 May 2015 16:33:18 GMT
+- request:
+    method: get
+    uri: https://<host>/services/data/v26.0/query?q=select%20Id,%20SystemModstamp,%20Name,%20Example_Field__c,%20Friend__c%20from%20CustomObject__c%20where%20Friend__c%20=%20%270031a000002jr5oAAA%27
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Authorization:
+      - OAuth 00D1a000000H3O9!AQ4AQDv3Hk9TRSKHVK.6TQHDjiXPpFDEH7AxoxdK.ytZcKr4gkBGokBh2ZhUcaf0_eFqhFa6YVCzmfP.bUKsz9xIJOy41iQD
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 01 May 2015 16:33:18 GMT
+      Set-Cookie:
+      - BrowserId=SWCHmZA9RwC4OyFZ5smP4g;Path=/;Domain=.salesforce.com;Expires=Tue,
+        30-Jun-2015 16:33:18 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Sforce-Limit-Info:
+      - api-usage=11/15000
+      Content-Type:
+      - application/json;charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+    body:
+      encoding: ASCII-8BIT
+      string: '{"totalSize":1,"done":true,"records":[{"attributes":{"type":"CustomObject__c","url":"/services/data/v26.0/sobjects/CustomObject__c/a001a000001TuP2AAK"},"Id":"a001a000001TuP2AAK","SystemModstamp":"2015-05-01T16:33:18.000+0000","Name":"a001a000001TuP2","Example_Field__c":null,"Friend__c":"0031a000002jr5oAAA"}]}'
+    http_version: 
+  recorded_at: Fri, 01 May 2015 16:33:19 GMT
+- request:
+    method: delete
+    uri: https://<host>/services/data/v26.0/sobjects/Contact/0031a000002jr5oAAA
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Authorization:
+      - OAuth 00D1a000000H3O9!AQ4AQDv3Hk9TRSKHVK.6TQHDjiXPpFDEH7AxoxdK.ytZcKr4gkBGokBh2ZhUcaf0_eFqhFa6YVCzmfP.bUKsz9xIJOy41iQD
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 204
+      message: No Content
+    headers:
+      Date:
+      - Fri, 01 May 2015 16:33:18 GMT
+      Set-Cookie:
+      - BrowserId=Wu08XNSWRJWJeDbodhrnRw;Path=/;Domain=.salesforce.com;Expires=Tue,
+        30-Jun-2015 16:33:18 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Sforce-Limit-Info:
+      - api-usage=11/15000
+    body:
+      encoding: UTF-8
+      string: ''
+    http_version: 
+  recorded_at: Fri, 01 May 2015 16:33:19 GMT
+- request:
+    method: delete
+    uri: https://<host>/services/data/v26.0/sobjects/CustomObject__c/a001a000001TuP2AAK
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+      Authorization:
+      - OAuth 00D1a000000H3O9!AQ4AQDv3Hk9TRSKHVK.6TQHDjiXPpFDEH7AxoxdK.ytZcKr4gkBGokBh2ZhUcaf0_eFqhFa6YVCzmfP.bUKsz9xIJOy41iQD
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 204
+      message: No Content
+    headers:
+      Date:
+      - Fri, 01 May 2015 16:33:19 GMT
+      Set-Cookie:
+      - BrowserId=NbXpvQcjQ-eN2Vw0MceMMg;Path=/;Domain=.salesforce.com;Expires=Tue,
+        30-Jun-2015 16:33:19 GMT
+      Expires:
+      - Thu, 01 Jan 1970 00:00:00 GMT
+      Sforce-Limit-Info:
+      - api-usage=11/15000
+    body:
+      encoding: UTF-8
+      string: ''
+    http_version: 
+  recorded_at: Fri, 01 May 2015 16:33:19 GMT
+recorded_with: VCR 2.9.3

data/test/lib/restforce/db/association_cache_test.rb

@@ -0,0 +1,63 @@
+require_relative "../../../test_helper"
+
+describe Restforce::DB::AssociationCache do
+
+  configure!
+
+  let(:cache) { Restforce::DB::AssociationCache.new }
+  let(:database_model) { CustomObject }
+  let(:lookups) { { salesforce_id: "a001a000001E1vREAL" } }
+  let(:record) { database_model.new(lookups) }
+
+  describe "#<<" do
+    before do
+      cache << record
+    end
+
+    it "caches the appended record by class" do
+      expect(cache.cache[database_model]).to_equal [record]
+    end
+  end
+
+  describe "#find" do
+    let(:found) { cache.find(database_model, lookups) }
+
+    describe "when the record has been added to the cache" do
+      before do
+        cache << record
+      end
+
+      it "finds the record" do
+        expect(found).to_equal record
+      end
+    end
+
+    describe "when the record has been persisted" do
+      before do
+        record.save!
+      end
+
+      it "finds the persisted record by its lookups" do
+        expect(found).to_equal record
+      end
+    end
+
+    describe "when a record of another class has been added with the same lookups" do
+      before do
+        cache << User.new(lookups)
+      end
+
+      it "returns nil" do
+        expect(found).to_be_nil
+      end
+    end
+
+    describe "when no record has been added or persisted" do
+
+      it "returns nil" do
+        expect(found).to_be_nil
+      end
+    end
+  end
+
+end

data/test/lib/restforce/db/associations/belongs_to_test.rb

@@ -99,8 +99,7 @@ describe Restforce::DB::Associations::BelongsTo do
         end
       end
 
-      describe "when the associated record has alrady been persisted" do
-        let(:database_record) { CustomObject.new }
+      describe "when the associated record has already been persisted" do
         let(:user) { User.create!(salesforce_id: user_salesforce_id) }
 
         before { user }
@@ -110,6 +109,19 @@ describe Restforce::DB::Associations::BelongsTo do
           expect(database_record.user).to_equal user
         end
       end
+
+      describe "when the associated record has been cached" do
+        let(:user) { User.new(salesforce_id: user_salesforce_id) }
+        let(:cache) { Restforce::DB::AssociationCache.new }
+        let(:associated) { association.build(database_record, salesforce_record, cache) }
+
+        before { cache << user }
+
+        it "uses the cached record" do
+          expect(associated).to_be :empty?
+          expect(database_record.user).to_equal user
+        end
+      end
     end
   end
 

data/test/lib/restforce/db/associations/has_many_test.rb

@@ -102,7 +102,6 @@ describe Restforce::DB::Associations::HasMany do
       end
 
       describe "when the associated records have alrady been persisted" do
-        let(:database_record) { CustomObject.new }
         let(:details) { detail_salesforce_ids.map { |id| Detail.create!(salesforce_id: id) } }
 
         before { details }
@@ -112,6 +111,23 @@ describe Restforce::DB::Associations::HasMany do
           expect(database_record.details).to_match_array details
         end
       end
+
+      describe "when the associated records have been cached" do
+        let(:details) { detail_salesforce_ids.map { |id| Detail.new(salesforce_id: id) } }
+        let(:cache) { Restforce::DB::AssociationCache.new }
+        let(:associated) { association.build(database_record, salesforce_record, cache) }
+
+        before do
+          details.each do |detail|
+            cache << detail
+          end
+        end
+
+        it "uses the cached records" do
+          expect(associated).to_be :empty?
+          expect(database_record.details).to_match_array details
+        end
+      end
     end
   end
 end

data/test/lib/restforce/db/associations/has_one_test.rb

@@ -85,6 +85,30 @@ describe Restforce::DB::Associations::HasOne do
         end
       end
 
+      describe "when the associated record has already been persisted" do
+        let(:object) { CustomObject.create!(salesforce_id: object_salesforce_id) }
+
+        before { object }
+
+        it "assigns the existing record" do
+          expect(associated).to_be :empty?
+          expect(database_record.custom_object).to_equal object
+        end
+      end
+
+      describe "when the associated record has been cached" do
+        let(:object) { CustomObject.new(salesforce_id: object_salesforce_id) }
+        let(:cache) { Restforce::DB::AssociationCache.new }
+        let(:associated) { association.build(database_record, salesforce_record, cache) }
+
+        before { cache << object }
+
+        it "uses the cached record" do
+          expect(associated).to_be :empty?
+          expect(database_record.custom_object).to_equal object
+        end
+      end
+
       describe "and a nested association on the associated mapping" do
         let(:nested_mapping) do
           Restforce::DB::Mapping.new(Detail, "CustomObjectDetail__c").tap do |map|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: restforce-db
 version: !ruby/object:Gem::Version
-  version: 1.2.7
+  version: 1.2.8
 platform: ruby
 authors:
 - Andrew Horner
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-04-30 00:00:00.000000000 Z
+date: 2015-05-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -208,6 +208,7 @@ files:
 - lib/generators/templates/script
 - lib/restforce/db.rb
 - lib/restforce/db/accumulator.rb
+- lib/restforce/db/association_cache.rb
 - lib/restforce/db/associations/base.rb
 - lib/restforce/db/associations/belongs_to.rb
 - lib/restforce/db/associations/foreign_key.rb
@@ -245,18 +246,22 @@ files:
 - test/cassettes/Restforce_DB/accessing_Salesforce/uses_the_configured_credentials.yml
 - test/cassettes/Restforce_DB_Associations_BelongsTo/with_an_inverse_mapping/_build/returns_an_associated_record_populated_with_the_Salesforce_attributes.yml
 - test/cassettes/Restforce_DB_Associations_BelongsTo/with_an_inverse_mapping/_build/when_no_salesforce_record_is_found_for_the_association/proceeds_without_constructing_any_records.yml
-- test/cassettes/Restforce_DB_Associations_BelongsTo/with_an_inverse_mapping/_build/when_the_associated_record_has_alrady_been_persisted/assigns_the_existing_record.yml
+- test/cassettes/Restforce_DB_Associations_BelongsTo/with_an_inverse_mapping/_build/when_the_associated_record_has_already_been_persisted/assigns_the_existing_record.yml
+- test/cassettes/Restforce_DB_Associations_BelongsTo/with_an_inverse_mapping/_build/when_the_associated_record_has_been_cached/uses_the_cached_record.yml
 - test/cassettes/Restforce_DB_Associations_BelongsTo/with_an_inverse_mapping/_build/with_an_unrelated_association_mapping/proceeds_without_raising_an_error.yml
 - test/cassettes/Restforce_DB_Associations_BelongsTo/with_an_inverse_mapping/_synced_for_/when_a_matching_associated_record_has_been_synchronized/returns_true.yml
 - test/cassettes/Restforce_DB_Associations_BelongsTo/with_an_inverse_mapping/_synced_for_/when_no_matching_associated_record_has_been_synchronized/returns_false.yml
 - test/cassettes/Restforce_DB_Associations_HasMany/with_an_inverse_mapping/_build/builds_a_number_of_associated_records_from_the_data_in_Salesforce.yml
 - test/cassettes/Restforce_DB_Associations_HasMany/with_an_inverse_mapping/_build/when_no_salesforce_record_is_found_for_the_association/proceeds_without_constructing_any_records.yml
 - test/cassettes/Restforce_DB_Associations_HasMany/with_an_inverse_mapping/_build/when_the_associated_records_have_alrady_been_persisted/constructs_the_association_from_the_existing_records.yml
+- test/cassettes/Restforce_DB_Associations_HasMany/with_an_inverse_mapping/_build/when_the_associated_records_have_been_cached/uses_the_cached_records.yml
 - test/cassettes/Restforce_DB_Associations_HasMany/with_an_inverse_mapping/_synced_for_/when_a_matching_associated_record_has_been_synchronized/returns_true.yml
 - test/cassettes/Restforce_DB_Associations_HasMany/with_an_inverse_mapping/_synced_for_/when_no_matching_associated_record_has_been_synchronized/returns_false.yml
 - test/cassettes/Restforce_DB_Associations_HasOne/with_an_inverse_mapping/_build/and_a_nested_association_on_the_associated_mapping/recursively_builds_all_associations.yml
 - test/cassettes/Restforce_DB_Associations_HasOne/with_an_inverse_mapping/_build/returns_an_associated_record_populated_with_the_Salesforce_attributes.yml
 - test/cassettes/Restforce_DB_Associations_HasOne/with_an_inverse_mapping/_build/when_no_salesforce_record_is_found_for_the_association/proceeds_without_constructing_any_records.yml
+- test/cassettes/Restforce_DB_Associations_HasOne/with_an_inverse_mapping/_build/when_the_associated_record_has_already_been_persisted/assigns_the_existing_record.yml
+- test/cassettes/Restforce_DB_Associations_HasOne/with_an_inverse_mapping/_build/when_the_associated_record_has_been_cached/uses_the_cached_record.yml
 - test/cassettes/Restforce_DB_Associations_HasOne/with_an_inverse_mapping/_synced_for_/when_a_matching_associated_record_has_been_synchronized/returns_true.yml
 - test/cassettes/Restforce_DB_Associations_HasOne/with_an_inverse_mapping/_synced_for_/when_no_matching_associated_record_has_been_synchronized/returns_false.yml
 - test/cassettes/Restforce_DB_Cleaner/_run/given_a_synchronized_Salesforce_record/when_the_record_does_not_meet_the_mapping_conditions/for_a_non-Passive_strategy/drops_the_synchronized_database_record.yml
@@ -288,6 +293,7 @@ files:
 - test/cassettes/Restforce_DB_Synchronizer/_run/given_a_Salesforce_record_with_an_associated_database_record/updates_the_salesforce_record.yml
 - test/cassettes/Restforce_DB_Synchronizer/_run/given_a_Salesforce_record_with_no_associated_database_record/does_nothing_for_this_specific_mapping.yml
 - test/lib/restforce/db/accumulator_test.rb
+- test/lib/restforce/db/association_cache_test.rb
 - test/lib/restforce/db/associations/belongs_to_test.rb
 - test/lib/restforce/db/associations/has_many_test.rb
 - test/lib/restforce/db/associations/has_one_test.rb