ColdFusion Developer's Guide

Beta
PART 3: DEVELOPING CFML APPLICATIONS
Chapter 13: Designing and Optimizing a ColdFusion Application .
321
About applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
Elements of a ColdFusion application . . . . . . . . . . . . . . . . . . . . . . . . . .322
Structuring an application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Defining the application and its event handlers in Application.cfc . . 331
Migrating from Application.cfm to Application.cfc. . . . . . . . . . . . . . . .345
Using an Application.cfm page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
Optimizing ColdFusion applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
Chapter 14: Handling Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
About error handling in ColdFusion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Understanding errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .362
Error messages and the standard error format . . . . . . . . . . . . . . . . . . .369
Determining error-handling strategies . . . . . . . . . . . . . . . . . . . . . . . . . .370
Specifying custom error messages with the cferror tag . . . . . . . . . . . 373
Logging errors with the cflog tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
Handling runtime exceptions with ColdFusion tags. . . . . . . . . . . . . . .379
Chapter 15: Using Persistent Data and Locking . . . . . . . . . . . . 399
About persistent scope variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Managing the client state. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Configuring and using client variables . . . . . . . . . . . . . . . . . . . . . . . . . 408
Configuring and using session variables . . . . . . . . . . . . . . . . . . . . . . . . 415
Configuring and using application variables . . . . . . . . . . . . . . . . . . . . . 421
Using server variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .423
Locking code with cflock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
Examples of cflock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .433
Chapter 16: Using ColdFusion Threads . . . . . . . . . . . . . . . . . . . 439
About ColdFusion threads. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
Creating and managing CF threads. . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
Using thread data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
Working with threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .448
Using ColdFusion tools to control thread use . . . . . . . . . . . . . . . . . . . 450
Example: getting multiple RSS feeds . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Chapter 17: Securing Applications . . . . . . . . . . . . . . . . . . . . . . . 453
ColdFusion security features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
6