Flexible Rails: Flex 3 on Rails 2

Flexible Rails......Page 1
brief contents......Page 8
foreword......Page 18
preface......Page 20
contents......Page 10
Getting started......Page 34
1. Why are we here? Where are we going?......Page 36
1.1.2 Overview of Rails 2......Page 38
1.1.3 Overview of using Flex 3 and Rails 2 together......Page 40
1.2 Flash 9? Are you kidding me?......Page 41
1.3 History......Page 42
1.4 A preview of the book......Page 45
1.5 Summary......Page 46
2. Hello World......Page 47
2.1.1 Installing Ruby......Page 49
2.1.2 Installing Rails......Page 50
2.1.4 Installing Flex......Page 51
2.1.5 Installing a text editor or IDE (SDK users only)......Page 54
2.1.6 Creating the Rails project......Page 55
2.1.7 How to read the rest of this iteration......Page 57
2.2.1 Creating the Flex project......Page 58
2.2.2 “Hello World” from Flex......Page 59
2.2.3 “Hello World” from Rails......Page 61
2.2.4 “Hello World” from Flex and Rails......Page 64
2.3.1 Creating the Aptana RadRails project......Page 65
2.3.2 “Hello World” from Flex......Page 67
2.3.3 “Hello World” from Rails......Page 71
2.3.4 “Hello World” from Flex and Rails......Page 74
2.4.2 “Hello World” from Flex......Page 76
2.4.3 “Hello World” from Rails......Page 79
2.4.4 “Hello World” from Flex and Rails......Page 82
2.5 Summary......Page 84
3. Getting started......Page 85
3.1 If you’re starting here......Page 86
3.2 Freezing the Rails version......Page 88
3.3 Disabling browser navigation integration......Page 89
3.4 Adding login functionality to Rails......Page 90
3.4.1 Installing and running restful_authentication......Page 91
3.4.2 Editing and running the CreateUsers migration, and checking the result......Page 92
3.4.3 Adding RESTful routes......Page 95
3.4.4 Modifying the includes and before_filter as instructed by the comments......Page 96
3.4.5 Testing account creation from HTML......Page 100
3.5.1 “Hello World,” this time with meaning!......Page 102
3.5.2 Binding? What the…?......Page 104
3.5.3 This MXML looks strange......Page 105
3.5.4 Flex 3 documentation? Where?......Page 106
3.5.5 Stubbing out an account-creation and login UI in Flex......Page 107
3.5.6 Making account create and login functional......Page 113
3.6 Adding data to the test fixtures......Page 128
3.7 Checking the tests......Page 131
3.8 Configuring Flex Builder to run and debug pomodo......Page 132
3.9 Summary......Page 134
Building the application......Page 136
4. Creating the main Flex UI......Page 138
4.2 Design......Page 139
4.3 Code......Page 141
4.4 Summary......Page 150
5. Expanding the Rails code, RESTfully......Page 151
5.1.1 Disclaimer: doing REST wrong......Page 152
5.1.2 What is REST?......Page 153
5.1.3 Why use a RESTful approach?......Page 155
5.2 Calling the user by name......Page 156
5.2.1 Adding a primitive debug console to Flex......Page 157
5.2.2 The case of the missing first name......Page 161
5.2.3 Fixing to_xml temporarily......Page 163
5.2.4 Fixing to_xml permanently......Page 165
5.3.1 Creating the Task, Project, and Location resources......Page 168
5.3.2 Adding the associations to the model......Page 170
5.3.3 A tour of the TasksController......Page 175
5.3.4 Understanding how routing works to set the requested format......Page 179
5.3.5 Making the UsersController and SessionsController RESTful......Page 182
5.3.6 Editing and running the migrations......Page 186
5.3.7 Ad hoc testing with the HTML views......Page 190
5.4 Security......Page 194
5.4.2 Requiring login......Page 195
5.4.3 Access control......Page 198
5.5 Expanding our fixtures and keeping our tests passing......Page 211
5.6 Summary......Page 218
6. Flex on Rails......Page 219
6.2 Listing tasks in Flex......Page 220
6.2.1 Should we use to_xml with :include?......Page 225
6.3 Creating tasks in Flex......Page 228
6.4 Creating and listing projects and locations in Flex......Page 233
6.5.1 Refactoring the list data location......Page 241
6.5.2 Making the projects and locations show up......Page 247
6.5.3 Using a ComboBox prompt......Page 250
6.5.4 Adding a None object to the ComboBox dataProvider......Page 252
6.5.5 Saving the project and location choices......Page 255
6.6 About that None project and location......Page 258
6.7.1 Adding update_xml and destroy_xml methods to the Rails controllers......Page 261
6.7.2 Getting ComboBox itemRenderers to work in the TasksListBox......Page 264
6.7.3 Adding Delete buttons......Page 276
6.7.4 Adding Completed CheckBoxes to the TasksListBox......Page 278
6.7.5 Editing the task name and notes in the TasksListBox......Page 281
6.7.6 Adding Delete buttons and Completed check boxes to the ProjectsListBox and LocationsListBox......Page 284
6.10 Exercises for the reader......Page 292
7. Validation......Page 294
7.1 Revisiting the HTML account signup screen......Page 295
7.2 Rails and Flex validation-should you stay DRY?......Page 299
7.3 Understanding Rails validation, and building custom XML for errors......Page 300
7.4 A Quick look at validation in Flex 3......Page 307
7.5 Integrating Rails validation with Flex 3 validation......Page 309
7.6 Flex validators revisited......Page 317
7.8 Summary......Page 323
7.9 Exercises for the reader......Page 324
Refactoring......Page 326
8. Refactoring to Cairngorm......Page 328
8.1 Background and setup......Page 329
8.1.1 Cairngorm history......Page 330
8.1.2 Do you need to use Cairngorm?......Page 331
8.1.4 Importing the Cairngorm sources into Flex Builder......Page 332
8.1.5 Getting and running the ModifiedCairngormStore......Page 333
8.1.6 Adding Cairngorm to pomodo......Page 335
8.1.7 Creating the standard directories......Page 336
8.2 Cairngorm event sequence overview......Page 337
8.3 Creating com.pomodo.model.PomodoModelLocator......Page 338
8.4.1 EventNames.as......Page 342
8.4.2 PomodoController.as......Page 343
8.5.1 CairngormUtils.as......Page 345
8.5.2 ServiceUtils.as......Page 346
8.6.1 CreateTaskCommand.as......Page 348
8.6.2 CreateProjectCommand.as......Page 349
8.6.4 CreateSessionCommand.as......Page 351
8.6.5 CreateUserCommand.as......Page 353
8.6.6 UpdateTaskCommand.as......Page 354
8.6.7 UpdateProjectCommand.as......Page 355
8.6.8 UpdateLocationCommand.as......Page 357
8.6.9 DestroyTaskCommand.as......Page 358
8.6.10 DestroyProjectCommand.as......Page 359
8.6.11 DestroyLocationCommand.as......Page 360
8.6.12 ListTasksCommand.as......Page 361
8.6.13 ListProjectsCommand.as......Page 362
8.6.14 ListLocationsCommand.as......Page 363
8.7.1 TaskDelegate.as......Page 364
8.7.2 ProjectDelegate.as......Page 365
8.7.3 LocationDelegate.as......Page 367
8.7.4 UserDelegate.as......Page 368
8.8 Deleting the com.pomodo.events package......Page 369
8.9.1 TaskCreateBox.mxml......Page 370
8.9.2 ProjectCreateBox.mxml......Page 372
8.9.3 LocationCreateBox.mxml......Page 373
8.9.4 TasksListBox.mxml......Page 375
8.9.5 ProjectsListBox.mxml......Page 380
8.9.6 LocationsListBox.mxml......Page 383
8.9.7 AccountCreateBox.mxml......Page 385
8.9.8 LoginBox.mxml......Page 387
8.9.9 MainBox.mxml......Page 388
8.9.10 SplashBox.mxml......Page 391
8.10 Modifying Pomodo.mxml......Page 392
8.11 Running pomodo......Page 394
8.12 HTTPService Gotchas......Page 395
8.14 Exercise for the reader......Page 401
9. Holding state on the client properly......Page 402
9.1 Refactoring, samurai coder style......Page 403
9.2.1 Task.as......Page 404
9.2.2 Project.as......Page 407
9.2.3 Location.as......Page 409
9.2.4 User.as......Page 411
9.3 Modifying the PomodoModelLocator......Page 413
9.4 Modifying ServiceUtils......Page 418
9.5 Modifying the business delegates......Page 419
9.5.1 TaskDelegate.as......Page 420
9.5.2 ProjectDelegate.as......Page 421
9.5.3 LocationDelegate.as......Page 423
9.5.5 UserDelegate.as......Page 424
9.6.1 CreateSessionCommand.as......Page 425
9.6.2 CreateUserCommand.as......Page 426
9.6.3 DestroyTaskCommand.as......Page 427
9.6.4 ListLocationsCommand.as......Page 428
9.6.6 ListTasksCommand.as......Page 429
9.6.8 UpdateProjectCommand.as......Page 430
9.6.9 UpdateTaskCommand.as......Page 431
9.7.1 MainBox.mxml......Page 432
9.7.2 TaskCreateBox.mxml......Page 433
9.7.3 ProjectCreateBox.mxml......Page 434
9.7.5 AccountCreateBox.mxml......Page 435
9.7.6 TasksListBox.mxml......Page 437
9.7.7 ProjectsListBox......Page 445
9.7.8 LocationsListBox.mxml......Page 448
9.8 Summary......Page 450
Finishing up......Page 452
10. Finishing the application......Page 454
10.1 Notely......Page 455
10.2 Better security with attr_accessible......Page 469
10.3 GTD semantics, including the Next Action concept and :dependent......Page 472
10.4 Filtering tasks......Page 480
10.5 The CommandShell......Page 486
10.6 Logging out......Page 487
10.7 Marketing!......Page 490
10.8 Deleting users......Page 493
10.9 Exercises for the Reader......Page 500
11. Refactoring to RubyAMF......Page 501
11.1 Warning: biased author......Page 502
11.2 Hello RubyAMF......Page 504
11.3 Refactoring to RubyAMF, fast-forwarded......Page 509
11.3.1 Modifying rubyamf_config.rb......Page 510
11.3.2 Modifying the Rails controllers......Page 514
11.3.3 Creating Services.mxml and modifying Pomodo.mxml......Page 525
11.3.4 Creating the value objects......Page 527
11.3.5 Modifying the model objects to produce value objects......Page 529
11.3.6 Modifying the business delegates......Page 533
11.3.7 Modifying the PomodoModelLocator......Page 538
11.3.8 Modifying the commands......Page 541
11.4 Summary......Page 544
12. Rails on AIR (Adobe Integrated Runtime)......Page 545
12.1.2 Creating the new project......Page 546
12.1.3 Getting it running......Page 550
12.2 Refactoring event triggering......Page 556
12.3 Online/Offline support......Page 561
12.6 Conclusion......Page 570
appendix A: How to use Subversion with Flex + Rails......Page 572
appendix B: Handwaving at omitted topics......Page 576
Multiple-file upload with Flash, Flex, AIR, and Rails or Merb......Page 577
WebORB......Page 579
A......Page 580
C......Page 581
F......Page 582
H......Page 583
L......Page 584
N......Page 585
P......Page 586
R......Page 587
T......Page 588
U......Page 589
Z......Page 590