dynamoid 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. data/Dynamoid.gemspec +5 -3
  2. data/README.markdown +2 -2
  3. data/VERSION +1 -1
  4. data/doc/Dynamoid.html +26 -14
  5. data/doc/Dynamoid/Adapter.html +33 -35
  6. data/doc/Dynamoid/Adapter/AwsSdk.html +177 -153
  7. data/doc/Dynamoid/Adapter/Local.html +144 -57
  8. data/doc/Dynamoid/Associations.html +3 -3
  9. data/doc/Dynamoid/Associations/Association.html +104 -1016
  10. data/doc/Dynamoid/Associations/BelongsTo.html +11 -192
  11. data/doc/Dynamoid/Associations/ClassMethods.html +17 -17
  12. data/doc/Dynamoid/Associations/HasAndBelongsToMany.html +15 -190
  13. data/doc/Dynamoid/Associations/HasMany.html +15 -190
  14. data/doc/Dynamoid/Associations/HasOne.html +11 -192
  15. data/doc/Dynamoid/Associations/ManyAssociation.html +1640 -0
  16. data/doc/Dynamoid/Associations/SingleAssociation.html +598 -0
  17. data/doc/Dynamoid/Components.html +4 -2
  18. data/doc/Dynamoid/Config.html +10 -10
  19. data/doc/Dynamoid/Config/Options.html +1 -1
  20. data/doc/Dynamoid/Criteria.html +1 -1
  21. data/doc/Dynamoid/Criteria/Chain.html +326 -22
  22. data/doc/Dynamoid/Criteria/ClassMethods.html +1 -1
  23. data/doc/Dynamoid/Document.html +181 -27
  24. data/doc/Dynamoid/Document/ClassMethods.html +392 -36
  25. data/doc/Dynamoid/Errors.html +1 -1
  26. data/doc/Dynamoid/Errors/DocumentNotValid.html +1 -1
  27. data/doc/Dynamoid/Errors/Error.html +1 -1
  28. data/doc/Dynamoid/Errors/InvalidField.html +1 -1
  29. data/doc/Dynamoid/Errors/MissingRangeKey.html +1 -1
  30. data/doc/Dynamoid/Fields.html +44 -24
  31. data/doc/Dynamoid/Fields/ClassMethods.html +60 -15
  32. data/doc/Dynamoid/Finders.html +1 -1
  33. data/doc/Dynamoid/Finders/ClassMethods.html +45 -31
  34. data/doc/Dynamoid/Indexes.html +7 -7
  35. data/doc/Dynamoid/Indexes/ClassMethods.html +6 -4
  36. data/doc/Dynamoid/Indexes/Index.html +47 -32
  37. data/doc/Dynamoid/Persistence.html +47 -49
  38. data/doc/Dynamoid/Persistence/ClassMethods.html +149 -47
  39. data/doc/Dynamoid/Validations.html +1 -1
  40. data/doc/_index.html +35 -13
  41. data/doc/class_list.html +1 -1
  42. data/doc/file.LICENSE.html +1 -1
  43. data/doc/file.README.html +37 -4
  44. data/doc/index.html +37 -4
  45. data/doc/method_list.html +320 -136
  46. data/doc/top-level-namespace.html +1 -1
  47. data/lib/dynamoid/adapter.rb +28 -30
  48. data/lib/dynamoid/adapter/aws_sdk.rb +23 -22
  49. data/lib/dynamoid/persistence.rb +33 -27
  50. metadata +6 -4
data/doc/Dynamoid/Associations/ManyAssociation.html ADDED
@@ -0,0 +1,1640 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
+ <head>
5
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
6
+ <title>
7
+ Module: Dynamoid::Associations::ManyAssociation
8
+
9
+ &mdash; Documentation by YARD 0.7.5
10
+
11
+ </title>
12
+
13
+ <link rel="stylesheet" href="../../css/style.css" type="text/css" media="screen" charset="utf-8" />
14
+
15
+ <link rel="stylesheet" href="../../css/common.css" type="text/css" media="screen" charset="utf-8" />
16
+
17
+ <script type="text/javascript" charset="utf-8">
18
+ relpath = '../..';
19
+ if (relpath != '') relpath += '/';
20
+ </script>
21
+
22
+ <script type="text/javascript" charset="utf-8" src="../../js/jquery.js"></script>
23
+
24
+ <script type="text/javascript" charset="utf-8" src="../../js/app.js"></script>
25
+
26
+
27
+ </head>
28
+ <body>
29
+ <script type="text/javascript" charset="utf-8">
30
+ if (window.top.frames.main) document.body.className = 'frames';
31
+ </script>
32
+
33
+ <div id="header">
34
+ <div id="menu">
35
+
36
+ <a href="../../_index.html">Index (M)</a> &raquo;
37
+ <span class='title'><span class='object_link'><a href="../../Dynamoid.html" title="Dynamoid (module)">Dynamoid</a></span></span> &raquo; <span class='title'><span class='object_link'><a href="../Associations.html" title="Dynamoid::Associations (module)">Associations</a></span></span>
38
+ &raquo;
39
+ <span class="title">ManyAssociation</span>
40
+
41
+
42
+ <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
43
+ </div>
44
+
45
+ <div id="search">
46
+
47
+ <a id="class_list_link" href="#">Class List</a>
48
+
49
+ <a id="method_list_link" href="#">Method List</a>
50
+
51
+ <a id="file_list_link" href="#">File List</a>
52
+
53
+ </div>
54
+ <div class="clear"></div>
55
+ </div>
56
+
57
+ <iframe id="search_frame"></iframe>
58
+
59
+ <div id="content"><h1>Module: Dynamoid::Associations::ManyAssociation
60
+
61
+
62
+
63
+ </h1>
64
+
65
+ <dl class="box">
66
+
67
+
68
+
69
+
70
+
71
+ <dt class="r1">Includes:</dt>
72
+ <dd class="r1"><span class='object_link'><a href="Association.html" title="Dynamoid::Associations::Association (module)">Association</a></span>, Enumerable</dd>
73
+
74
+
75
+
76
+
77
+ <dt class="r2">Included in:</dt>
78
+ <dd class="r2"><span class='object_link'><a href="HasAndBelongsToMany.html" title="Dynamoid::Associations::HasAndBelongsToMany (class)">HasAndBelongsToMany</a></span>, <span class='object_link'><a href="HasMany.html" title="Dynamoid::Associations::HasMany (class)">HasMany</a></span></dd>
79
+
80
+
81
+
82
+ <dt class="r1 last">Defined in:</dt>
83
+ <dd class="r1 last">lib/dynamoid/associations/many_association.rb</dd>
84
+
85
+ </dl>
86
+ <div class="clear"></div>
87
+
88
+
89
+
90
+
91
+
92
+ <h2>Instance Attribute Summary <small>(<a href="#" class="summary_toggle">collapse</a>)</small></h2>
93
+ <ul class="summary">
94
+
95
+ <li class="public ">
96
+ <span class="summary_signature">
97
+
98
+ <a href="#query-instance_method" title="#query (instance method)">- (Object) <strong>query</strong> </a>
99
+
100
+
101
+
102
+ </span>
103
+
104
+
105
+
106
+
107
+
108
+
109
+
110
+
111
+
112
+
113
+
114
+ <span class="summary_desc"><div class='inline'><p>Returns the value of attribute query.</p>
115
+ </div></span>
116
+
117
+ </li>
118
+
119
+
120
+ </ul>
121
+
122
+
123
+
124
+
125
+
126
+ <h3 class="inherited">Attributes included from <span class='object_link'><a href="Association.html" title="Dynamoid::Associations::Association (module)">Association</a></span></h3>
127
+ <p class="inherited"><span class='object_link'><a href="Association.html#loaded-instance_method" title="Dynamoid::Associations::Association#loaded (method)">#loaded</a></span>, <span class='object_link'><a href="Association.html#name-instance_method" title="Dynamoid::Associations::Association#name (method)">#name</a></span>, <span class='object_link'><a href="Association.html#options-instance_method" title="Dynamoid::Associations::Association#options (method)">#options</a></span>, <span class='object_link'><a href="Association.html#source-instance_method" title="Dynamoid::Associations::Association#source (method)">#source</a></span></p>
128
+
129
+
130
+
131
+ <h2>
132
+ Instance Method Summary
133
+ <small>(<a href="#" class="summary_toggle">collapse</a>)</small>
134
+ </h2>
135
+
136
+ <ul class="summary">
137
+
138
+ <li class="public ">
139
+ <span class="summary_signature">
140
+
141
+ <a href="#%3C%3C-instance_method" title="#&lt;&lt; (instance method)">- (Dynamoid::Document) <strong>&lt;&lt;</strong>(object) </a>
142
+
143
+
144
+
145
+ </span>
146
+
147
+
148
+
149
+
150
+
151
+
152
+
153
+
154
+ <span class="summary_desc"><div class='inline'><p>Add an object or array of objects to an association.</p>
155
+ </div></span>
156
+
157
+ </li>
158
+
159
+
160
+ <li class="public ">
161
+ <span class="summary_signature">
162
+
163
+ <a href="#%3D%3D-instance_method" title="#== (instance method)">- (Boolean) <strong>==</strong>(other) </a>
164
+
165
+
166
+
167
+ </span>
168
+
169
+
170
+
171
+
172
+
173
+
174
+
175
+
176
+ <span class="summary_desc"><div class='inline'><p>Is this array equal to the association's records?.</p>
177
+ </div></span>
178
+
179
+ </li>
180
+
181
+
182
+ <li class="public ">
183
+ <span class="summary_signature">
184
+
185
+ <a href="#create-instance_method" title="#create (instance method)">- (Dynamoid::Document) <strong>create</strong>(attributes = {}) </a>
186
+
187
+
188
+
189
+ </span>
190
+
191
+
192
+
193
+
194
+
195
+
196
+
197
+
198
+ <span class="summary_desc"><div class='inline'><p>Create a new instance of the target class and add it directly to the association.</p>
199
+ </div></span>
200
+
201
+ </li>
202
+
203
+
204
+ <li class="public ">
205
+ <span class="summary_signature">
206
+
207
+ <a href="#create%21-instance_method" title="#create! (instance method)">- (Dynamoid::Document) <strong>create!</strong>(attributes = {}) </a>
208
+
209
+
210
+
211
+ </span>
212
+
213
+
214
+
215
+
216
+
217
+
218
+
219
+
220
+ <span class="summary_desc"><div class='inline'><p>Create a new instance of the target class and add it directly to the association.</p>
221
+ </div></span>
222
+
223
+ </li>
224
+
225
+
226
+ <li class="public ">
227
+ <span class="summary_signature">
228
+
229
+ <a href="#delete-instance_method" title="#delete (instance method)">- (Dynamoid::Document) <strong>delete</strong>(object) </a>
230
+
231
+
232
+
233
+ </span>
234
+
235
+
236
+
237
+
238
+
239
+
240
+
241
+
242
+ <span class="summary_desc"><div class='inline'><p>Deletes an object or array of objects from the association.</p>
243
+ </div></span>
244
+
245
+ </li>
246
+
247
+
248
+ <li class="public ">
249
+ <span class="summary_signature">
250
+
251
+ <a href="#delete_all-instance_method" title="#delete_all (instance method)">- (Object) <strong>delete_all</strong> </a>
252
+
253
+
254
+
255
+ </span>
256
+
257
+
258
+
259
+
260
+
261
+
262
+
263
+
264
+ <span class="summary_desc"><div class='inline'><p>Deletes all members of the association and removes them from the association.</p>
265
+ </div></span>
266
+
267
+ </li>
268
+
269
+
270
+ <li class="public ">
271
+ <span class="summary_signature">
272
+
273
+ <a href="#destroy_all-instance_method" title="#destroy_all (instance method)">- (Object) <strong>destroy_all</strong> </a>
274
+
275
+
276
+
277
+ </span>
278
+
279
+
280
+
281
+
282
+
283
+
284
+
285
+
286
+ <span class="summary_desc"><div class='inline'><p>Destroys all members of the association and removes them from the association.</p>
287
+ </div></span>
288
+
289
+ </li>
290
+
291
+
292
+ <li class="public ">
293
+ <span class="summary_signature">
294
+
295
+ <a href="#each-instance_method" title="#each (instance method)">- (Dynamoid::Document) <strong>each</strong>(&amp;block) </a>
296
+
297
+
298
+
299
+ </span>
300
+
301
+
302
+
303
+
304
+
305
+
306
+
307
+
308
+ <span class="summary_desc"><div class='inline'><p>Create a new instance of the target class and add it directly to the association.</p>
309
+ </div></span>
310
+
311
+ </li>
312
+
313
+
314
+ <li class="public ">
315
+ <span class="summary_signature">
316
+
317
+ <a href="#find_target-instance_method" title="#find_target (instance method)">- (Object) <strong>find_target</strong> </a>
318
+
319
+
320
+
321
+ </span>
322
+
323
+
324
+
325
+
326
+
327
+
328
+
329
+
330
+ <span class="summary_desc"><div class='inline'><p>The records associated to the source.</p>
331
+ </div></span>
332
+
333
+ </li>
334
+
335
+
336
+ <li class="public ">
337
+ <span class="summary_signature">
338
+
339
+ <a href="#include%3F-instance_method" title="#include? (instance method)">- (Boolean) <strong>include?</strong>(object) </a>
340
+
341
+
342
+
343
+ </span>
344
+
345
+
346
+
347
+
348
+
349
+
350
+
351
+
352
+ <span class="summary_desc"><div class='inline'><p>Delegate include? to the records.</p>
353
+ </div></span>
354
+
355
+ </li>
356
+
357
+
358
+ <li class="public ">
359
+ <span class="summary_signature">
360
+
361
+ <a href="#initialize-instance_method" title="#initialize (instance method)">- (ManyAssociation) <strong>initialize</strong>(*args) </a>
362
+
363
+
364
+
365
+ </span>
366
+
367
+
368
+
369
+
370
+
371
+
372
+
373
+
374
+ <span class="summary_desc"><div class='inline'><p>A new instance of ManyAssociation.</p>
375
+ </div></span>
376
+
377
+ </li>
378
+
379
+
380
+ <li class="public ">
381
+ <span class="summary_signature">
382
+
383
+ <a href="#method_missing-instance_method" title="#method_missing (instance method)">- (Object) <strong>method_missing</strong>(method, *args) </a>
384
+
385
+
386
+
387
+ </span>
388
+
389
+
390
+
391
+
392
+
393
+
394
+
395
+
396
+ <span class="summary_desc"><div class='inline'><p>Delegate methods we don't find directly to the records array.</p>
397
+ </div></span>
398
+
399
+ </li>
400
+
401
+
402
+ <li class="public ">
403
+ <span class="summary_signature">
404
+
405
+ <a href="#records-instance_method" title="#records (instance method)">- (Object) <strong>records</strong> </a>
406
+
407
+
408
+
409
+ (also: #all)
410
+
411
+ </span>
412
+
413
+
414
+
415
+
416
+
417
+
418
+
419
+
420
+ <span class="summary_desc"><div class='inline'></div></span>
421
+
422
+ </li>
423
+
424
+
425
+ <li class="public ">
426
+ <span class="summary_signature">
427
+
428
+ <a href="#setter-instance_method" title="#setter (instance method)">- (Dynamoid::Document) <strong>setter</strong>(object) </a>
429
+
430
+
431
+
432
+ </span>
433
+
434
+
435
+
436
+
437
+
438
+
439
+
440
+
441
+ <span class="summary_desc"><div class='inline'><p>Replace an association with object or array of objects.</p>
442
+ </div></span>
443
+
444
+ </li>
445
+
446
+
447
+ <li class="public ">
448
+ <span class="summary_signature">
449
+
450
+ <a href="#where-instance_method" title="#where (instance method)">- (Dynamoid::Association) <strong>where</strong>(args) </a>
451
+
452
+
453
+
454
+ </span>
455
+
456
+
457
+
458
+
459
+
460
+
461
+
462
+
463
+ <span class="summary_desc"><div class='inline'><p>Naive association filtering.</p>
464
+ </div></span>
465
+
466
+ </li>
467
+
468
+
469
+ </ul>
470
+
471
+
472
+
473
+
474
+
475
+
476
+
477
+
478
+
479
+
480
+
481
+ <h3 class="inherited">Methods included from <span class='object_link'><a href="Association.html" title="Dynamoid::Associations::Association (module)">Association</a></span></h3>
482
+ <p class="inherited"><span class='object_link'><a href="Association.html#loaded%3F-instance_method" title="Dynamoid::Associations::Association#loaded? (method)">#loaded?</a></span>, <span class='object_link'><a href="Association.html#reset-instance_method" title="Dynamoid::Associations::Association#reset (method)">#reset</a></span>, <span class='object_link'><a href="Association.html#target-instance_method" title="Dynamoid::Associations::Association#target (method)">#target</a></span></p>
483
+ <div id="method_missing_details" class="method_details_list">
484
+ <h2>Dynamic Method Handling</h2>
485
+ <p class="notice this">
486
+ This class handles dynamic methods through the <tt>method_missing</tt> method
487
+
488
+ </p>
489
+
490
+ <div class="method_details first">
491
+ <p class="signature first" id="method_missing-instance_method">
492
+
493
+ - (<tt>Object</tt>) <strong>method_missing</strong>(method, *args)
494
+
495
+
496
+
497
+ </p><div class="docstring">
498
+ <div class="discussion">
499
+ <p>Delegate methods we don't find directly to the records array.</p>
500
+
501
+
502
+ </div>
503
+ </div>
504
+ <div class="tags">
505
+
506
+ <h3>Since:</h3>
507
+ <ul class="since">
508
+
509
+ <li>
510
+
511
+
512
+
513
+
514
+
515
+ <div class='inline'><p>0.2.0</p>
516
+ </div>
517
+
518
+ </li>
519
+
520
+ </ul>
521
+
522
+ </div><table class="source_code">
523
+ <tr>
524
+ <td>
525
+ <pre class="lines">
526
+
527
+
528
+ 164
529
+ 165
530
+ 166
531
+ 167
532
+ 168
533
+ 169
534
+ 170</pre>
535
+ </td>
536
+ <td>
537
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 164</span>
538
+
539
+ <span class='kw'>def</span> <span class='id identifier rubyid_method_missing'>method_missing</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
540
+ <span class='kw'>if</span> <span class='id identifier rubyid_records'>records</span><span class='period'>.</span><span class='id identifier rubyid_respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='rparen'>)</span>
541
+ <span class='id identifier rubyid_records'>records</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_method'>method</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
542
+ <span class='kw'>else</span>
543
+ <span class='kw'>super</span>
544
+ <span class='kw'>end</span>
545
+ <span class='kw'>end</span></pre>
546
+ </td>
547
+ </tr>
548
+ </table>
549
+ </div>
550
+
551
+ </div>
552
+
553
+ <div id="instance_attr_details" class="attr_details">
554
+ <h2>Instance Attribute Details</h2>
555
+
556
+
557
+ <span id="query=-instance_method"></span>
558
+ <span id="query-instance_method"></span>
559
+ <div class="method_details first">
560
+ <p class="signature first" id="query-instance_method">
561
+
562
+ - (<tt>Object</tt>) <strong>query</strong>
563
+
564
+
565
+
566
+ </p><div class="docstring">
567
+ <div class="discussion">
568
+ <p>Returns the value of attribute query</p>
569
+
570
+
571
+ </div>
572
+ </div>
573
+ <div class="tags">
574
+
575
+
576
+ </div><table class="source_code">
577
+ <tr>
578
+ <td>
579
+ <pre class="lines">
580
+
581
+
582
+ 8
583
+ 9
584
+ 10</pre>
585
+ </td>
586
+ <td>
587
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 8</span>
588
+
589
+ <span class='kw'>def</span> <span class='id identifier rubyid_query'>query</span>
590
+ <span class='ivar'>@query</span>
591
+ <span class='kw'>end</span></pre>
592
+ </td>
593
+ </tr>
594
+ </table>
595
+ </div>
596
+
597
+ </div>
598
+
599
+
600
+ <div id="instance_method_details" class="method_details_list">
601
+ <h2>Instance Method Details</h2>
602
+
603
+
604
+ <div class="method_details first">
605
+ <p class="signature first" id="<<-instance_method">
606
+
607
+ - (<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>) <strong>&lt;&lt;</strong>(object)
608
+
609
+
610
+
611
+ </p><div class="docstring">
612
+ <div class="discussion">
613
+ <p>Add an object or array of objects to an association. This preserves the current records in the association (if any)
614
+ and adds the object to the target association if it is detected to exist.</p>
615
+
616
+
617
+ </div>
618
+ </div>
619
+ <div class="tags">
620
+ <h3>Parameters:</h3>
621
+ <ul class="param">
622
+
623
+ <li>
624
+
625
+ <span class='name'>object</span>
626
+
627
+
628
+ <span class='type'>(<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>)</span>
629
+
630
+
631
+
632
+ &mdash;
633
+ <div class='inline'><p>the object (or array of objects) to add to the association</p>
634
+ </div>
635
+
636
+ </li>
637
+
638
+ </ul>
639
+
640
+ <h3>Returns:</h3>
641
+ <ul class="return">
642
+
643
+ <li>
644
+
645
+
646
+ <span class='type'>(<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>)</span>
647
+
648
+
649
+
650
+ &mdash;
651
+ <div class='inline'><p>the added object</p>
652
+ </div>
653
+
654
+ </li>
655
+
656
+ </ul>
657
+ <h3>Since:</h3>
658
+ <ul class="since">
659
+
660
+ <li>
661
+
662
+
663
+
664
+
665
+
666
+ <div class='inline'><p>0.2.0</p>
667
+ </div>
668
+
669
+ </li>
670
+
671
+ </ul>
672
+
673
+ </div><table class="source_code">
674
+ <tr>
675
+ <td>
676
+ <pre class="lines">
677
+
678
+
679
+ 69
680
+ 70
681
+ 71
682
+ 72
683
+ 73</pre>
684
+ </td>
685
+ <td>
686
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 69</span>
687
+
688
+ <span class='kw'>def</span> <span class='op'>&lt;&lt;</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span>
689
+ <span class='id identifier rubyid_source'>source</span><span class='period'>.</span><span class='id identifier rubyid_update_attribute'>update_attribute</span><span class='lparen'>(</span><span class='id identifier rubyid_source_attribute'>source_attribute</span><span class='comma'>,</span> <span class='id identifier rubyid_source_ids'>source_ids</span><span class='period'>.</span><span class='id identifier rubyid_merge'>merge</span><span class='lparen'>(</span><span class='const'>Array</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_collect'>collect</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='symbol'>:id</span><span class='rparen'>)</span><span class='rparen'>)</span><span class='rparen'>)</span>
690
+ <span class='const'>Array</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='symbol'>:associate_target</span><span class='comma'>,</span> <span class='id identifier rubyid_o'>o</span><span class='rparen'>)</span><span class='rbrace'>}</span> <span class='kw'>if</span> <span class='id identifier rubyid_target_association'>target_association</span>
691
+ <span class='id identifier rubyid_object'>object</span>
692
+ <span class='kw'>end</span></pre>
693
+ </td>
694
+ </tr>
695
+ </table>
696
+ </div>
697
+
698
+ <div class="method_details ">
699
+ <p class="signature " id="==-instance_method">
700
+
701
+ - (<tt>Boolean</tt>) <strong>==</strong>(other)
702
+
703
+
704
+
705
+ </p><div class="docstring">
706
+ <div class="discussion">
707
+ <p>Is this array equal to the association's records?</p>
708
+
709
+
710
+ </div>
711
+ </div>
712
+ <div class="tags">
713
+
714
+ <h3>Returns:</h3>
715
+ <ul class="return">
716
+
717
+ <li>
718
+
719
+
720
+ <span class='type'>(<tt>Boolean</tt>)</span>
721
+
722
+
723
+
724
+ &mdash;
725
+ <div class='inline'><p>true/false</p>
726
+ </div>
727
+
728
+ </li>
729
+
730
+ </ul>
731
+ <h3>Since:</h3>
732
+ <ul class="since">
733
+
734
+ <li>
735
+
736
+
737
+
738
+
739
+
740
+ <div class='inline'><p>0.2.0</p>
741
+ </div>
742
+
743
+ </li>
744
+
745
+ </ul>
746
+
747
+ </div><table class="source_code">
748
+ <tr>
749
+ <td>
750
+ <pre class="lines">
751
+
752
+
753
+ 157
754
+ 158
755
+ 159</pre>
756
+ </td>
757
+ <td>
758
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 157</span>
759
+
760
+ <span class='kw'>def</span> <span class='op'>==</span><span class='lparen'>(</span><span class='id identifier rubyid_other'>other</span><span class='rparen'>)</span>
761
+ <span class='id identifier rubyid_records'>records</span> <span class='op'>==</span> <span class='const'>Array</span><span class='lparen'>(</span><span class='id identifier rubyid_other'>other</span><span class='rparen'>)</span>
762
+ <span class='kw'>end</span></pre>
763
+ </td>
764
+ </tr>
765
+ </table>
766
+ </div>
767
+
768
+ <div class="method_details ">
769
+ <p class="signature " id="create-instance_method">
770
+
771
+ - (<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>) <strong>create</strong>(attributes = {})
772
+
773
+
774
+
775
+ </p><div class="docstring">
776
+ <div class="discussion">
777
+ <p>Create a new instance of the target class and add it directly to the association.</p>
778
+
779
+
780
+ </div>
781
+ </div>
782
+ <div class="tags">
783
+ <h3>Parameters:</h3>
784
+ <ul class="param">
785
+
786
+ <li>
787
+
788
+ <span class='name'>attribute</span>
789
+
790
+
791
+ <span class='type'>(<tt>Hash</tt>)</span>
792
+
793
+
794
+
795
+ &mdash;
796
+ <div class='inline'><p>hash for the new object</p>
797
+ </div>
798
+
799
+ </li>
800
+
801
+ </ul>
802
+
803
+ <h3>Returns:</h3>
804
+ <ul class="return">
805
+
806
+ <li>
807
+
808
+
809
+ <span class='type'>(<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>)</span>
810
+
811
+
812
+
813
+ &mdash;
814
+ <div class='inline'><p>the newly-created object</p>
815
+ </div>
816
+
817
+ </li>
818
+
819
+ </ul>
820
+ <h3>Since:</h3>
821
+ <ul class="since">
822
+
823
+ <li>
824
+
825
+
826
+
827
+
828
+
829
+ <div class='inline'><p>0.2.0</p>
830
+ </div>
831
+
832
+ </li>
833
+
834
+ </ul>
835
+
836
+ </div><table class="source_code">
837
+ <tr>
838
+ <td>
839
+ <pre class="lines">
840
+
841
+
842
+ 107
843
+ 108
844
+ 109</pre>
845
+ </td>
846
+ <td>
847
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 107</span>
848
+
849
+ <span class='kw'>def</span> <span class='id identifier rubyid_create'>create</span><span class='lparen'>(</span><span class='id identifier rubyid_attributes'>attributes</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
850
+ <span class='kw'>self</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_target_class'>target_class</span><span class='period'>.</span><span class='id identifier rubyid_create'>create</span><span class='lparen'>(</span><span class='id identifier rubyid_attributes'>attributes</span><span class='rparen'>)</span>
851
+ <span class='kw'>end</span></pre>
852
+ </td>
853
+ </tr>
854
+ </table>
855
+ </div>
856
+
857
+ <div class="method_details ">
858
+ <p class="signature " id="create!-instance_method">
859
+
860
+ - (<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>) <strong>create!</strong>(attributes = {})
861
+
862
+
863
+
864
+ </p><div class="docstring">
865
+ <div class="discussion">
866
+ <p>Create a new instance of the target class and add it directly to the association. If the create fails an exception will be raised.</p>
867
+
868
+
869
+ </div>
870
+ </div>
871
+ <div class="tags">
872
+ <h3>Parameters:</h3>
873
+ <ul class="param">
874
+
875
+ <li>
876
+
877
+ <span class='name'>attribute</span>
878
+
879
+
880
+ <span class='type'>(<tt>Hash</tt>)</span>
881
+
882
+
883
+
884
+ &mdash;
885
+ <div class='inline'><p>hash for the new object</p>
886
+ </div>
887
+
888
+ </li>
889
+
890
+ </ul>
891
+
892
+ <h3>Returns:</h3>
893
+ <ul class="return">
894
+
895
+ <li>
896
+
897
+
898
+ <span class='type'>(<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>)</span>
899
+
900
+
901
+
902
+ &mdash;
903
+ <div class='inline'><p>the newly-created object</p>
904
+ </div>
905
+
906
+ </li>
907
+
908
+ </ul>
909
+ <h3>Since:</h3>
910
+ <ul class="since">
911
+
912
+ <li>
913
+
914
+
915
+
916
+
917
+
918
+ <div class='inline'><p>0.2.0</p>
919
+ </div>
920
+
921
+ </li>
922
+
923
+ </ul>
924
+
925
+ </div><table class="source_code">
926
+ <tr>
927
+ <td>
928
+ <pre class="lines">
929
+
930
+
931
+ 96
932
+ 97
933
+ 98</pre>
934
+ </td>
935
+ <td>
936
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 96</span>
937
+
938
+ <span class='kw'>def</span> <span class='id identifier rubyid_create!'>create!</span><span class='lparen'>(</span><span class='id identifier rubyid_attributes'>attributes</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
939
+ <span class='kw'>self</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_target_class'>target_class</span><span class='period'>.</span><span class='id identifier rubyid_create!'>create!</span><span class='lparen'>(</span><span class='id identifier rubyid_attributes'>attributes</span><span class='rparen'>)</span>
940
+ <span class='kw'>end</span></pre>
941
+ </td>
942
+ </tr>
943
+ </table>
944
+ </div>
945
+
946
+ <div class="method_details ">
947
+ <p class="signature " id="delete-instance_method">
948
+
949
+ - (<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>) <strong>delete</strong>(object)
950
+
951
+
952
+
953
+ </p><div class="docstring">
954
+ <div class="discussion">
955
+ <p>Deletes an object or array of objects from the association. This removes their records from the association field on the source,
956
+ and attempts to remove the source from the target association if it is detected to exist.</p>
957
+
958
+
959
+ </div>
960
+ </div>
961
+ <div class="tags">
962
+ <h3>Parameters:</h3>
963
+ <ul class="param">
964
+
965
+ <li>
966
+
967
+ <span class='name'>object</span>
968
+
969
+
970
+ <span class='type'>(<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>)</span>
971
+
972
+
973
+
974
+ &mdash;
975
+ <div class='inline'><p>the object (or array of objects) to remove from the association</p>
976
+ </div>
977
+
978
+ </li>
979
+
980
+ </ul>
981
+
982
+ <h3>Returns:</h3>
983
+ <ul class="return">
984
+
985
+ <li>
986
+
987
+
988
+ <span class='type'>(<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>)</span>
989
+
990
+
991
+
992
+ &mdash;
993
+ <div class='inline'><p>the deleted object</p>
994
+ </div>
995
+
996
+ </li>
997
+
998
+ </ul>
999
+ <h3>Since:</h3>
1000
+ <ul class="since">
1001
+
1002
+ <li>
1003
+
1004
+
1005
+
1006
+
1007
+
1008
+ <div class='inline'><p>0.2.0</p>
1009
+ </div>
1010
+
1011
+ </li>
1012
+
1013
+ </ul>
1014
+
1015
+ </div><table class="source_code">
1016
+ <tr>
1017
+ <td>
1018
+ <pre class="lines">
1019
+
1020
+
1021
+ 54
1022
+ 55
1023
+ 56
1024
+ 57
1025
+ 58</pre>
1026
+ </td>
1027
+ <td>
1028
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 54</span>
1029
+
1030
+ <span class='kw'>def</span> <span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span>
1031
+ <span class='id identifier rubyid_source'>source</span><span class='period'>.</span><span class='id identifier rubyid_update_attribute'>update_attribute</span><span class='lparen'>(</span><span class='id identifier rubyid_source_attribute'>source_attribute</span><span class='comma'>,</span> <span class='id identifier rubyid_source_ids'>source_ids</span> <span class='op'>-</span> <span class='const'>Array</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_collect'>collect</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='symbol'>:id</span><span class='rparen'>)</span><span class='rparen'>)</span>
1032
+ <span class='const'>Array</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='symbol'>:disassociate_target</span><span class='comma'>,</span> <span class='id identifier rubyid_o'>o</span><span class='rparen'>)</span><span class='rbrace'>}</span> <span class='kw'>if</span> <span class='id identifier rubyid_target_association'>target_association</span>
1033
+ <span class='id identifier rubyid_object'>object</span>
1034
+ <span class='kw'>end</span></pre>
1035
+ </td>
1036
+ </tr>
1037
+ </table>
1038
+ </div>
1039
+
1040
+ <div class="method_details ">
1041
+ <p class="signature " id="delete_all-instance_method">
1042
+
1043
+ - (<tt>Object</tt>) <strong>delete_all</strong>
1044
+
1045
+
1046
+
1047
+ </p><div class="docstring">
1048
+ <div class="discussion">
1049
+ <p>Deletes all members of the association and removes them from the association.</p>
1050
+
1051
+
1052
+ </div>
1053
+ </div>
1054
+ <div class="tags">
1055
+
1056
+ <h3>Since:</h3>
1057
+ <ul class="since">
1058
+
1059
+ <li>
1060
+
1061
+
1062
+
1063
+
1064
+
1065
+ <div class='inline'><p>0.2.0</p>
1066
+ </div>
1067
+
1068
+ </li>
1069
+
1070
+ </ul>
1071
+
1072
+ </div><table class="source_code">
1073
+ <tr>
1074
+ <td>
1075
+ <pre class="lines">
1076
+
1077
+
1078
+ 134
1079
+ 135
1080
+ 136
1081
+ 137
1082
+ 138</pre>
1083
+ </td>
1084
+ <td>
1085
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 134</span>
1086
+
1087
+ <span class='kw'>def</span> <span class='id identifier rubyid_delete_all'>delete_all</span>
1088
+ <span class='id identifier rubyid_objs'>objs</span> <span class='op'>=</span> <span class='id identifier rubyid_target'>target</span>
1089
+ <span class='id identifier rubyid_source'>source</span><span class='period'>.</span><span class='id identifier rubyid_update_attribute'>update_attribute</span><span class='lparen'>(</span><span class='id identifier rubyid_source_attribute'>source_attribute</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='rparen'>)</span>
1090
+ <span class='id identifier rubyid_objs'>objs</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='symbol'>:delete</span><span class='rparen'>)</span>
1091
+ <span class='kw'>end</span></pre>
1092
+ </td>
1093
+ </tr>
1094
+ </table>
1095
+ </div>
1096
+
1097
+ <div class="method_details ">
1098
+ <p class="signature " id="destroy_all-instance_method">
1099
+
1100
+ - (<tt>Object</tt>) <strong>destroy_all</strong>
1101
+
1102
+
1103
+
1104
+ </p><div class="docstring">
1105
+ <div class="discussion">
1106
+ <p>Destroys all members of the association and removes them from the association.</p>
1107
+
1108
+
1109
+ </div>
1110
+ </div>
1111
+ <div class="tags">
1112
+
1113
+ <h3>Since:</h3>
1114
+ <ul class="since">
1115
+
1116
+ <li>
1117
+
1118
+
1119
+
1120
+
1121
+
1122
+ <div class='inline'><p>0.2.0</p>
1123
+ </div>
1124
+
1125
+ </li>
1126
+
1127
+ </ul>
1128
+
1129
+ </div><table class="source_code">
1130
+ <tr>
1131
+ <td>
1132
+ <pre class="lines">
1133
+
1134
+
1135
+ 125
1136
+ 126
1137
+ 127
1138
+ 128
1139
+ 129</pre>
1140
+ </td>
1141
+ <td>
1142
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 125</span>
1143
+
1144
+ <span class='kw'>def</span> <span class='id identifier rubyid_destroy_all'>destroy_all</span>
1145
+ <span class='id identifier rubyid_objs'>objs</span> <span class='op'>=</span> <span class='id identifier rubyid_target'>target</span>
1146
+ <span class='id identifier rubyid_source'>source</span><span class='period'>.</span><span class='id identifier rubyid_update_attribute'>update_attribute</span><span class='lparen'>(</span><span class='id identifier rubyid_source_attribute'>source_attribute</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='rparen'>)</span>
1147
+ <span class='id identifier rubyid_objs'>objs</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='symbol'>:destroy</span><span class='rparen'>)</span>
1148
+ <span class='kw'>end</span></pre>
1149
+ </td>
1150
+ </tr>
1151
+ </table>
1152
+ </div>
1153
+
1154
+ <div class="method_details ">
1155
+ <p class="signature " id="each-instance_method">
1156
+
1157
+ - (<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>) <strong>each</strong>(&amp;block)
1158
+
1159
+
1160
+
1161
+ </p><div class="docstring">
1162
+ <div class="discussion">
1163
+ <p>Create a new instance of the target class and add it directly to the association. If the create fails an exception will be raised.</p>
1164
+
1165
+
1166
+ </div>
1167
+ </div>
1168
+ <div class="tags">
1169
+ <h3>Parameters:</h3>
1170
+ <ul class="param">
1171
+
1172
+ <li>
1173
+
1174
+ <span class='name'>attribute</span>
1175
+
1176
+
1177
+ <span class='type'>(<tt>Hash</tt>)</span>
1178
+
1179
+
1180
+
1181
+ &mdash;
1182
+ <div class='inline'><p>hash for the new object</p>
1183
+ </div>
1184
+
1185
+ </li>
1186
+
1187
+ </ul>
1188
+
1189
+ <h3>Returns:</h3>
1190
+ <ul class="return">
1191
+
1192
+ <li>
1193
+
1194
+
1195
+ <span class='type'>(<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>)</span>
1196
+
1197
+
1198
+
1199
+ &mdash;
1200
+ <div class='inline'><p>the newly-created object</p>
1201
+ </div>
1202
+
1203
+ </li>
1204
+
1205
+ </ul>
1206
+ <h3>Since:</h3>
1207
+ <ul class="since">
1208
+
1209
+ <li>
1210
+
1211
+
1212
+
1213
+
1214
+
1215
+ <div class='inline'><p>0.2.0</p>
1216
+ </div>
1217
+
1218
+ </li>
1219
+
1220
+ </ul>
1221
+
1222
+ </div><table class="source_code">
1223
+ <tr>
1224
+ <td>
1225
+ <pre class="lines">
1226
+
1227
+
1228
+ 118
1229
+ 119
1230
+ 120</pre>
1231
+ </td>
1232
+ <td>
1233
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 118</span>
1234
+
1235
+ <span class='kw'>def</span> <span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
1236
+ <span class='id identifier rubyid_records'>records</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
1237
+ <span class='kw'>end</span></pre>
1238
+ </td>
1239
+ </tr>
1240
+ </table>
1241
+ </div>
1242
+
1243
+ <div class="method_details ">
1244
+ <p class="signature " id="find_target-instance_method">
1245
+
1246
+ - (<tt>Object</tt>) <strong>find_target</strong>
1247
+
1248
+
1249
+
1250
+ </p><div class="docstring">
1251
+ <div class="discussion">
1252
+ <p>The records associated to the source.</p>
1253
+
1254
+
1255
+ </div>
1256
+ </div>
1257
+ <div class="tags">
1258
+
1259
+ <h3>Returns:</h3>
1260
+ <ul class="return">
1261
+
1262
+ <li>
1263
+
1264
+
1265
+ <span class='type'></span>
1266
+
1267
+
1268
+
1269
+
1270
+ <div class='inline'><p>the association records; depending on which association this is, either a single instance or an array</p>
1271
+ </div>
1272
+
1273
+ </li>
1274
+
1275
+ </ul>
1276
+ <h3>Since:</h3>
1277
+ <ul class="since">
1278
+
1279
+ <li>
1280
+
1281
+
1282
+
1283
+
1284
+
1285
+ <div class='inline'><p>0.2.0</p>
1286
+ </div>
1287
+
1288
+ </li>
1289
+
1290
+ </ul>
1291
+
1292
+ </div><table class="source_code">
1293
+ <tr>
1294
+ <td>
1295
+ <pre class="lines">
1296
+
1297
+
1298
+ 24
1299
+ 25
1300
+ 26</pre>
1301
+ </td>
1302
+ <td>
1303
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 24</span>
1304
+
1305
+ <span class='kw'>def</span> <span class='id identifier rubyid_find_target'>find_target</span>
1306
+ <span class='const'>Array</span><span class='lparen'>(</span><span class='id identifier rubyid_target_class'>target_class</span><span class='period'>.</span><span class='id identifier rubyid_find'>find</span><span class='lparen'>(</span><span class='id identifier rubyid_source_ids'>source_ids</span><span class='period'>.</span><span class='id identifier rubyid_to_a'>to_a</span><span class='rparen'>)</span><span class='rparen'>)</span>
1307
+ <span class='kw'>end</span></pre>
1308
+ </td>
1309
+ </tr>
1310
+ </table>
1311
+ </div>
1312
+
1313
+ <div class="method_details ">
1314
+ <p class="signature " id="include?-instance_method">
1315
+
1316
+ - (<tt>Boolean</tt>) <strong>include?</strong>(object)
1317
+
1318
+
1319
+
1320
+ </p><div class="docstring">
1321
+ <div class="discussion">
1322
+ <p>Delegate include? to the records.</p>
1323
+
1324
+
1325
+ </div>
1326
+ </div>
1327
+ <div class="tags">
1328
+
1329
+ <h3>Returns:</h3>
1330
+ <ul class="return">
1331
+
1332
+ <li>
1333
+
1334
+
1335
+ <span class='type'>(<tt>Boolean</tt>)</span>
1336
+
1337
+
1338
+
1339
+ </li>
1340
+
1341
+ </ul>
1342
+
1343
+ </div><table class="source_code">
1344
+ <tr>
1345
+ <td>
1346
+ <pre class="lines">
1347
+
1348
+
1349
+ 42
1350
+ 43
1351
+ 44</pre>
1352
+ </td>
1353
+ <td>
1354
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 42</span>
1355
+
1356
+ <span class='kw'>def</span> <span class='id identifier rubyid_include?'>include?</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span>
1357
+ <span class='id identifier rubyid_records'>records</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span>
1358
+ <span class='kw'>end</span></pre>
1359
+ </td>
1360
+ </tr>
1361
+ </table>
1362
+ </div>
1363
+
1364
+ <div class="method_details ">
1365
+ <p class="signature " id="initialize-instance_method">
1366
+
1367
+ - (<tt><span class='object_link'><a href="" title="Dynamoid::Associations::ManyAssociation (module)">ManyAssociation</a></span></tt>) <strong>initialize</strong>(*args)
1368
+
1369
+
1370
+
1371
+ </p><div class="docstring">
1372
+ <div class="discussion">
1373
+ <p>A new instance of ManyAssociation</p>
1374
+
1375
+
1376
+ </div>
1377
+ </div>
1378
+ <div class="tags">
1379
+
1380
+
1381
+ </div><table class="source_code">
1382
+ <tr>
1383
+ <td>
1384
+ <pre class="lines">
1385
+
1386
+
1387
+ 10
1388
+ 11
1389
+ 12
1390
+ 13</pre>
1391
+ </td>
1392
+ <td>
1393
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 10</span>
1394
+
1395
+ <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
1396
+ <span class='ivar'>@query</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
1397
+ <span class='kw'>super</span>
1398
+ <span class='kw'>end</span></pre>
1399
+ </td>
1400
+ </tr>
1401
+ </table>
1402
+ </div>
1403
+
1404
+ <div class="method_details ">
1405
+ <p class="signature " id="records-instance_method">
1406
+
1407
+ - (<tt>Object</tt>) <strong>records</strong>
1408
+
1409
+
1410
+
1411
+ <span class="aliases">Also known as:
1412
+ <span class="names"><span id='all-instance_method'>all</span></span>
1413
+ </span>
1414
+
1415
+ </p><table class="source_code">
1416
+ <tr>
1417
+ <td>
1418
+ <pre class="lines">
1419
+
1420
+
1421
+ 28
1422
+ 29
1423
+ 30
1424
+ 31
1425
+ 32
1426
+ 33
1427
+ 34</pre>
1428
+ </td>
1429
+ <td>
1430
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 28</span>
1431
+
1432
+ <span class='kw'>def</span> <span class='id identifier rubyid_records'>records</span>
1433
+ <span class='kw'>if</span> <span class='id identifier rubyid_query'>query</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
1434
+ <span class='id identifier rubyid_target'>target</span>
1435
+ <span class='kw'>else</span>
1436
+ <span class='id identifier rubyid_results_with_query'>results_with_query</span><span class='lparen'>(</span><span class='id identifier rubyid_target'>target</span><span class='rparen'>)</span>
1437
+ <span class='kw'>end</span>
1438
+ <span class='kw'>end</span></pre>
1439
+ </td>
1440
+ </tr>
1441
+ </table>
1442
+ </div>
1443
+
1444
+ <div class="method_details ">
1445
+ <p class="signature " id="setter-instance_method">
1446
+
1447
+ - (<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>) <strong>setter</strong>(object)
1448
+
1449
+
1450
+
1451
+ </p><div class="docstring">
1452
+ <div class="discussion">
1453
+ <p>Replace an association with object or array of objects. This removes all of the existing associated records and replaces them with
1454
+ the passed object(s), and associates the target association if it is detected to exist.</p>
1455
+
1456
+
1457
+ </div>
1458
+ </div>
1459
+ <div class="tags">
1460
+ <h3>Parameters:</h3>
1461
+ <ul class="param">
1462
+
1463
+ <li>
1464
+
1465
+ <span class='name'>object</span>
1466
+
1467
+
1468
+ <span class='type'>(<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>)</span>
1469
+
1470
+
1471
+
1472
+ &mdash;
1473
+ <div class='inline'><p>the object (or array of objects) to add to the association</p>
1474
+ </div>
1475
+
1476
+ </li>
1477
+
1478
+ </ul>
1479
+
1480
+ <h3>Returns:</h3>
1481
+ <ul class="return">
1482
+
1483
+ <li>
1484
+
1485
+
1486
+ <span class='type'>(<tt><span class='object_link'><a href="../Document.html" title="Dynamoid::Document (module)">Dynamoid::Document</a></span></tt>)</span>
1487
+
1488
+
1489
+
1490
+ &mdash;
1491
+ <div class='inline'><p>the added object</p>
1492
+ </div>
1493
+
1494
+ </li>
1495
+
1496
+ </ul>
1497
+ <h3>Since:</h3>
1498
+ <ul class="since">
1499
+
1500
+ <li>
1501
+
1502
+
1503
+
1504
+
1505
+
1506
+ <div class='inline'><p>0.2.0</p>
1507
+ </div>
1508
+
1509
+ </li>
1510
+
1511
+ </ul>
1512
+
1513
+ </div><table class="source_code">
1514
+ <tr>
1515
+ <td>
1516
+ <pre class="lines">
1517
+
1518
+
1519
+ 83
1520
+ 84
1521
+ 85
1522
+ 86
1523
+ 87</pre>
1524
+ </td>
1525
+ <td>
1526
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 83</span>
1527
+
1528
+ <span class='kw'>def</span> <span class='id identifier rubyid_setter'>setter</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span>
1529
+ <span class='id identifier rubyid_target'>target</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span> <span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='id identifier rubyid_o'>o</span><span class='rparen'>)</span><span class='rbrace'>}</span>
1530
+ <span class='kw'>self</span> <span class='op'>&lt;&lt;</span> <span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span>
1531
+ <span class='id identifier rubyid_object'>object</span>
1532
+ <span class='kw'>end</span></pre>
1533
+ </td>
1534
+ </tr>
1535
+ </table>
1536
+ </div>
1537
+
1538
+ <div class="method_details ">
1539
+ <p class="signature " id="where-instance_method">
1540
+
1541
+ - (<tt>Dynamoid::Association</tt>) <strong>where</strong>(args)
1542
+
1543
+
1544
+
1545
+ </p><div class="docstring">
1546
+ <div class="discussion">
1547
+ <p>Naive association filtering.</p>
1548
+
1549
+
1550
+ </div>
1551
+ </div>
1552
+ <div class="tags">
1553
+ <h3>Parameters:</h3>
1554
+ <ul class="param">
1555
+
1556
+ <li>
1557
+
1558
+ <span class='name'>A</span>
1559
+
1560
+
1561
+ <span class='type'>(<tt>Hash</tt>)</span>
1562
+
1563
+
1564
+
1565
+ &mdash;
1566
+ <div class='inline'><p>hash of attributes; each must match every returned object's attribute exactly.</p>
1567
+ </div>
1568
+
1569
+ </li>
1570
+
1571
+ </ul>
1572
+
1573
+ <h3>Returns:</h3>
1574
+ <ul class="return">
1575
+
1576
+ <li>
1577
+
1578
+
1579
+ <span class='type'>(<tt>Dynamoid::Association</tt>)</span>
1580
+
1581
+
1582
+
1583
+ &mdash;
1584
+ <div class='inline'><p>the association this method was called on (for chaining purposes)</p>
1585
+ </div>
1586
+
1587
+ </li>
1588
+
1589
+ </ul>
1590
+ <h3>Since:</h3>
1591
+ <ul class="since">
1592
+
1593
+ <li>
1594
+
1595
+
1596
+
1597
+
1598
+
1599
+ <div class='inline'><p>0.2.0</p>
1600
+ </div>
1601
+
1602
+ </li>
1603
+
1604
+ </ul>
1605
+
1606
+ </div><table class="source_code">
1607
+ <tr>
1608
+ <td>
1609
+ <pre class="lines">
1610
+
1611
+
1612
+ 147
1613
+ 148
1614
+ 149
1615
+ 150</pre>
1616
+ </td>
1617
+ <td>
1618
+ <pre class="code"><span class="info file"># File 'lib/dynamoid/associations/many_association.rb', line 147</span>
1619
+
1620
+ <span class='kw'>def</span> <span class='id identifier rubyid_where'>where</span><span class='lparen'>(</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
1621
+ <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_k'>k</span><span class='comma'>,</span> <span class='id identifier rubyid_v'>v</span><span class='op'>|</span> <span class='id identifier rubyid_query'>query</span><span class='lbracket'>[</span><span class='id identifier rubyid_k'>k</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_v'>v</span><span class='rbrace'>}</span>
1622
+ <span class='kw'>self</span>
1623
+ <span class='kw'>end</span></pre>
1624
+ </td>
1625
+ </tr>
1626
+ </table>
1627
+ </div>
1628
+
1629
+ </div>
1630
+
1631
+ </div>
1632
+
1633
+ <div id="footer">
1634
+ Generated on Thu Apr 26 01:26:26 2012 by
1635
+ <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
1636
+ 0.7.5 (ruby-1.9.3).
1637
+ </div>
1638
+
1639
+ </body>
1640
+ </html>