The Merb way

Cover......Page 1
Contents......Page 8
Foreword......Page 20
Acknowledgments......Page 22
Merb pastie......Page 24
Introduction......Page 28
About the author......Page 32
 1.1 Generating a new application......Page 34
 1.2 The layout of a Merb application......Page 35
  1.2.1 Very flat layout......Page 36
  1.2.2 Flat layout......Page 39
  1.2.3 Standard layout......Page 41
 1.3 Interactive Merb......Page 42
  1.3.1 Console methods......Page 43
  1.3.2 Sandboxing......Page 44
  1.4.1 Init script......Page 45
  1.4.2 Environments......Page 49
  1.4.4 Logging......Page 50
  1.4.5 Database......Page 52
  1.5.1 Extlib......Page 53
  1.5.2 Rack......Page 56
  1.5.4 Plugins......Page 59
  1.6.1 Boot loaders......Page 60
  1.6.2 Server......Page 65
  1.6.5 Dispatcher......Page 66
  1.6.8 Worker......Page 67
 1.7 Conclusion......Page 68
Chapter 2 Routing......Page 70
 2.1 How Merb routing works......Page 71
  2.1.1 Route conditions......Page 72
  2.1.2 Route parameters......Page 75
  2.2.2 The prepare block......Page 76
  2.2.4 Adding routes later on......Page 77
  2.3.1 Listing routes......Page 78
  2.3.2 Trying the router......Page 82
  2.4.1 Literal matching......Page 83
  2.4.2 Symbolic matches......Page 84
  2.4.3 Optional matches......Page 85
  2.4.5 Deferred routes......Page 86
  2.5.1 Using to......Page 87
  2.5.3 Using register......Page 88
  2.5.6 Using other captures......Page 89
  2.6.2 Named routes......Page 90
  2.6.3 Setting prefixes......Page 91
  2.6.4 Fixatable routes......Page 92
  2.7.1 Standard resources routing......Page 93
  2.7.2 Singular resource routing......Page 95
  2.7.3 Using identify......Page 96
 2.8 Conclusion......Page 97
 3.1 From request to controller......Page 98
  3.1.2 How requests get dispatched......Page 99
  3.1.3 The controller's perspective......Page 100
 3.2 The controller classes......Page 101
  3.2.1 The abstract controller......Page 102
  3.2.2 The Merb controller......Page 103
  3.2.3 The application controller......Page 105
  3.2.5 Other controllers......Page 107
  3.3.1 Controller location......Page 108
  3.3.3 Organizing controller methods......Page 109
 3.4 Filters......Page 112
  3.4.1 Before filters......Page 113
  3.4.2 After filters......Page 114
  3.4.3 Filter options......Page 115
  3.4.4 Skipping filters......Page 116
  3.5.1 A redirect caveat......Page 117
  3.5.2 Redirects after POST requests......Page 118
  3.5.3 Redirecting in before filters......Page 119
  3.6.2 Controller exceptions......Page 120
  3.6.3 The exceptions controller......Page 121
  3.7.1 How templates are compiled......Page 122
  3.7.3 Template......Page 124
  3.7.4 Formats......Page 125
  3.7.6 Layout......Page 127
  3.7.7 display......Page 128
  3.7.9 render_deferred......Page 129
 3.9 Sending and streaming......Page 130
  3.9.2 Streaming files......Page 131
 3.10 Conclusion......Page 132
 4.1 ERB......Page 134
  4.1.2 Removing whitespace......Page 135
  4.1.4 Merb's block-aware enhancer......Page 136
  4.2.1 Tags......Page 138
  4.2.3 IDs and classes......Page 139
  4.2.6 Outputting lines......Page 140
  4.2.9 Preserving whitespace......Page 141
 4.3 Merb view templates......Page 142
 4.4 Partials......Page 144
 4.5 Conclusion......Page 145
 5.1 Configuration......Page 146
 5.2 Model classes......Page 148
 5.3 Properties......Page 151
  5.3.1 Database storage......Page 153
  5.3.2 Defining properties......Page 160
 5.4 Associations......Page 165
  5.4.1 Belongs to......Page 166
  5.4.2 Has......Page 168
  5.4.3 Has through......Page 171
  5.5.1 Creating records......Page 173
  5.5.2 Retrieving records......Page 175
  5.5.3 Updating records......Page 185
 5.6 Hooks......Page 187
  5.7.1 Extra property types......Page 188
  5.7.2 Timestamps......Page 189
  5.7.3 Aggregates......Page 191
  5.7.4 Validations......Page 195
 5.8 Conclusion......Page 198
 6.1 Truncate helper......Page 200
  6.2.1 Two digits......Page 201
  6.2.3 Currency strings......Page 202
  6.3.1 Formats......Page 204
  6.3.2 Ordinals......Page 206
  6.3.3 Time DSL......Page 207
  6.3.4 Relative time......Page 208
 6.4 Cycle helper......Page 209
 6.5 Tag helpers......Page 210
  6.6.1 Builders......Page 212
  6.6.2 Helpers......Page 220
 6.7 Conclusion......Page 225
  7.1.1 Generating slices......Page 226
  7.1.2 Running slices......Page 229
  7.1.3 Building slices......Page 232
  7.1.4 Slice controllers......Page 233
 7.2 Slice usage......Page 234
 7.3 Conclusion......Page 236
 8.1 How sessions work......Page 238
 8.2 Configuration......Page 239
  8.3.1 Session containers......Page 240
  8.3.2 Session store containers......Page 241
  8.3.3 Session storage mechanisms......Page 244
 8.4 Request access......Page 252
 8.6 Conclusion......Page 253
 9.1 Auth core......Page 254
  9.1.1 Authentication......Page 256
  9.1.2 Strategy......Page 260
  9.1.3 Sessions......Page 264
  9.1.4 Errors......Page 265
  9.1.5 Responses......Page 266
  9.1.6 Helpers......Page 267
  9.1.7 Router helper......Page 268
  9.1.9 Callbacks......Page 269
 9.2 Auth more......Page 270
  9.2.1 Strategies......Page 271
  9.2.2 Models......Page 275
 9.3 Auth password slices......Page 278
  9.3.1 Lib file......Page 279
  9.3.2 Controller......Page 280
  9.3.3 Views......Page 282
 9.4 Conclusion......Page 284
  10.1.1 SMTP......Page 286
  10.1.4 Custom delivery methods......Page 287
 10.2 Using mailers directly......Page 288
 10.3 Mail controllers......Page 290
  10.3.1 Invoking actions......Page 291
  10.3.2 Parameters......Page 292
  10.3.3 Attaching files......Page 293
 10.5 Generation......Page 294
 10.6 Conclusion......Page 295
 11.1 Parts controllers......Page 296
 11.2 Invoking actions......Page 299
 11.4 Conclusion......Page 300
  12.1.1 Fundamental stores......Page 302
  12.1.2 Strategy stores......Page 303
  12.2.1 Writing......Page 304
  12.2.2 Reading......Page 305
  12.2.4 Deleting......Page 306
  12.3.1 Action caching......Page 307
  12.3.2 Eager caching......Page 308
  12.3.4 Partial caching......Page 310
 12.4 Conclusion......Page 311
 13.1 Rake tasks......Page 312
 13.2 Spec files......Page 315
 13.3 Model specs......Page 316
 13.4 Request specs......Page 318
 13.5 Request helper......Page 322
 13.6 Request matchers......Page 323
 13.7 RSpec extensions......Page 325
 13.8 Miscellaneous extensions......Page 327
 13.9 Conclusion......Page 328
Afterword......Page 330
 A......Page 332
 B......Page 335
 C......Page 336
 D......Page 342
 E......Page 343
 F......Page 345
 H......Page 346
 I......Page 348
 K......Page 349
 M......Page 350
 N......Page 352
 P......Page 353
 R......Page 355
 S......Page 359
 T......Page 362
 V......Page 364
 X......Page 365
 Y......Page 366