MACROMEDIA COLDFUSION 5-DEVELOPING Manuel utilisateur

Macromedia® Incorporated

Developing

ColdFusion

Applications

MacroMedia ColdFusion®5

This book, as well as the software described in it, is furnished under license and may

be used or copied only in accordance with the terms of such license. The content of

this manual is furnishedfor informational use only, is subject to change without

notice,andshouldnotbeconstruedasacommitmentbyMacromedia,Incorporated.

Macromedia, Incorporated assumes no responsibility or liability for any errors or

inaccuracies that may appear in this book.

Except as permitted by such license, no part of this publication may be reproduced,

stored in a retrieval system, or transmitted in any form or by any means, electronic,

mechanical, recording, or otherwise, without the prior written permission of

Macromedia, Incorporated.

ColdFusion, HomeSite, and Macromedia are registered trademarks of Macromedia

Incorporation intheUnited States and internationally. Allaire Spectra, the Allaire

Spectralogo, Generator, Macromedia Generation, and JRun are trademarks of

Macromedia, Incorporated. Java is a trademark of Sun Microsystems, Inc. Microsoft,

Windows, Windows NT, Windows 95, Microsoft Access, and FoxPro are registered

trademarksofMicrosoftCorporation.PostScriptisatrademarkofAdobeSystemsInc.

Solaris is a trademark of Sun Microsystems Inc. UNIX is a trademark of The Open

Group. All other company names, brand names, and product names are trademarks

of their respective holder(s).

Part number: ZCF50MDEV

Contents

About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Intended Audience . . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . xvi

New Features . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .xvi

Developer Resources . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . xvii

About ColdFusion Documentation. . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . xviii

Printed and online documentation set . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . xix

Viewing online documentation . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . xix

Printing ColdFusion documentation . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . xix

Getting Answers. . . . . . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . xx

Contacting Macromedia . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . . xx

Chapter 1 Introduction to ColdFusion . . . . . . . . . . . . . . 1

A QuickWeb Overview. . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. 2

Before You Begin . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. 3

HTML . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. 3

Relational database design and management . . . .. . . . . . .. . . . . . .. . . . . .. 3

SQL . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . 3

What is ColdFusion?. . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . .. 4

Editionsof ColdFusion . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. 4

ColdFusion Featuresand Components . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. 5

Aboutthe features . . . . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . 5

About thecomponents .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. 6

How ColdFusion Server Works. . . . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. 8

Chapter 2 Writing Your First ColdFusion Application . 9

The Development Process. . . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 10

Workingwith ColdFusion ApplicationPages . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 10

Aboutapplicaton pages . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . . 10

Creating application pages . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . . 10

Savingapplication pages . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . . 11

Viewing application pages . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . . 11

iv Contents

Workingwith Variables . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . . 13

About variables . . . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 13

Adding more variablesto the application . .. . .. . . . . . .. . . . . .. . . . . . .. . . 15

Development Considerations. . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . 16

Chapter 3 Querying a Database . . . . . . . . . . . . . . . . . . 17

Publishing Dynamic Data . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . 18

Understanding DatabaseBasics . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . . 19

Understanding Data Sources . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . 20

About Open Database Connectivity . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 20

Accessing Data Sources . . . . . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 21

Adding data sources . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 22

Specifying data sourcesdynamically . . . . . . . . .. . . . . . .. . . . . .. . . .. . . . . . 24

Retrieving Data . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . 25

The cfquery tag . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . 25

The cfquery tag syntax . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . . 25

Writing SQL. . . . . . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . 26

Basic SQL syntax elements . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . . 26

SQL notes and considerations . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 27

Building Queries . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . 28

Query notes and considerations . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . . 29

Outputting Query Data . . . . . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 30

Query output notes and considerations . . . . . . . . . . . . .. . . . . .. . . .. . . . . . 31

Getting Information About Query Results. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . . 32

Query properties notes and considerations . . . . . .. . . . . . .. . .. . . . . . .. . . 33

Using Query Results inQueries . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . . 34

Query of query benefits . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 34

Creating queries of queries . . . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 34

Performing a query on a query . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . 35

Chapter 4 Retrieving and Formatting Data . . . . . . . . . 39

Using Forms to Specify the Data toRetrieve. . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . 40

form tag syntax . . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . . 40

Form controls . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . 41

Form notes and considerations . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . 44

Workingwith Action Pages . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . 45

Processing form variables on action pages . . . . . . .. . . . . . .. . .. . . . . . .. . . 45

Dynamically generating SQL statements . . . . . . . .. . . .. . . . . .. . . . . . .. . . 45

Creating action pages . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 46

Testing for a variable’s existence . . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . 47

Form variable notes and considerations . . . . . . . . .. . . .. . . . . .. . . . . . .. . . 48

Workingwith Queries and Data. . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . . 49

DevelopingWebApplicationswithColdFusionDRAFT 5/9/01 Path/Filename/Author

Using HTMLtables to display query results . . . . . .. . . .. . . . . .. . . . . . .. . . 49

Formattingindividual data items . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 50

Performing pattern matching . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . 51

Filtering data based on multiple conditions . . . . . . . . . . . . .. . .. . . . . . .. . . 51

Creating table joins . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 52

Buildingflexible search interfaces . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . . 52

Returning Results to the User. . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . 55

If there are no query results . . . . . . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . 55

Returning results incrementally . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . . 56

Chapter 5 Graphing Data . . . . . . . . . . . . . . . . . . . . . . . . 59

Creating a Graph . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 60

Graph types . . . . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . 60

Creating a basic graph . . . . . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . . 61

Graphing Data . . . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 62

Graphing a query . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . . 62

Graphing individual data points . . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 65

Combining a query and data points . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . 66

Controlling Graph Appearance . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 67

Common graph characteristics .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . . 67

Settingbar and horizontalbar chart characteristics . . .. . . . . .. . . . . . .. . . 68

Settingpie chart characteristics . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . 71

Settingline and area graph characteristics . . . .. . . . . . .. . . . . .. . . . . . .. . . 74

Linking Dynamically from Graphs . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . . 77

Chapter 6 Making Variables Dynamic . . . . . . . . . . . . . 81

Dynamically Populating List Boxes. . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 82

Creating Dynamic Check Boxes and Multiple-Selection List Boxes. . . . . . . . . . . 84

Check boxes . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 84

Multipleselection lists . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . . 86

Ensuring that Variables Exist . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . . 88

Using cfparam to test for variables and set default values . . . . . . .. . .. . . 88

Requiring users to enter valuesin form fields . . . . . . . .. . . . . .. . . . . . .. . . 89

Validating Data Types. . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . 90

Using cfparam to validate the data type . . . . . .. . . . . . .. . .. . . . . . .. . . . . . 90

Validating form field data types . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . . 91

Checkingquery parameters with cfqueryparam . . . . . .. . . . . .. . . . . . .. . . 94

Dynamic SQL. . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . . 96

Implementing dynamic SQL . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . 96

Chapter 7 Updating Your Database . . . . . . . . . . . . . . 101

Inserting Data . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 102

Creating anHTML insert form . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 102

vi Contents

Data entry form notes andconsiderations .. . . . . .. . . . . . .. . .. . . . . . .. . 103

Creating anaction page toinsert data . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 103

Updating Data .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 106

Creating anupdate form . . . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 106

Creating anaction page toupdate data . . . . . . . . . .. . . . . . .. . . . . . .. . . . . 109

Deleting Data . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 112

Deleting a single record . . . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 112

Deleting multiple records . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 113

Chapter 8 Handling Complex Data

with Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

About Arrays. . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 116

Basic Array Techniques . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 118

Creating anarray . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 118

Adding elements to anarray . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 119

Referencing elements in dynamic arrays . . . . . . . . . . . .. . . . . .. . . .. . . . . 119

Populating Arrays with Data. . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 121

Populating anarray with ArraySet . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 121

Populating anarray with cfloop . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 121

Using nested loops for 2D and 3D arrays . . . . . . . .. . . . . . .. . . . . . .. . . . . 122

Populating an arrayfrom a query . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 123

Array Functions . . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 124

About Structures . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 125

Structurenotation . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 126

Creating and Using Structures . . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 127

Creating structures . . . . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 127

Adding data elements to structures . . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 127

Updating valuesin structures . . . . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 128

Getting information about structures . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 129

Copying structures . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 130

Deleting structures . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 130

Structureexample . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 130

Looping throughstructures . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . 132

Structure Functions . . . . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 133

Chapter 9 Building Dynamic Forms . . . . . . . . . . . . . . 135

Creating Forms withthe cfform Tag . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 136

Using HTMLand cfform . . . . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 136

cfform controls . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 137

Preservinginput data with preservedata . . . . . . . . .. . . .. . . . . .. . . . . . .. . 137

Browser considerations .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 138

Input Validation with cfform Controls . . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 139

Validating with regular expressions . . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 140

DevelopingWebApplicationswithColdFusionDRAFT 5/9/01 Path/Filename/Author

vii

Input Validationwith JavaScript . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 144

Handling failed validation . . . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 144

Example: validating an e-mail address . . . . . . . . . . . . . .. . . . . .. . . . . . .. . 144

Building TreeControls withcftree. . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 147

Grouping output from a query .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 148

cftree form variables . . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 149

Input validation . . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 149

Structuring TreeControls . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 150

Image names ina cftree . . . . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 151

Embedding URLsin a cftree . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . 152

Specifying the tree itemin the URL . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 153

Creating Data Grids with cfgrid . . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 153

Populating a gridfrom a query .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 154

Creating anUpdateable Grid . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 155

Navigating and entering data ina grid .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 155

Controlling cell contents . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 156

How user edits are returned . . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 156

Editingdata in cfgrid . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 157

Updating the database with cfgridupdate . . . . .. . .. . . . . . .. . . . . . .. . . . . 159

Updating the database with cfquery . . . . . . . . .. . . . . . .. . . . . .. . . .. . . . . 160

Building Slider Bar Controls . . . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 164

Building Text Entry Boxes . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 165

Building Drop-Down List Boxes. . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 166

Embedding Java Applets . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 167

Registering a Javaapplet . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 167

Using cfapplet to embedan applet . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 169

Handling form variables from an applet . . . . . . . . .. . . . . . .. . . . . . .. . .. . 169

Chapter 10 Reusing Code . . . . . . . . . . . . . . . . . . . . . . 171

Ways to Reuse Code . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 172

Reusing Common Codewithcfinclude . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 172

Using Custom Tags . . . . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 173

Using existing custom tags . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 174

Creating custom CFML tags . . . . . . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 174

Variable scopes andspecial variables . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . 174

Using tagattributes . . . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 175

Passing values to andfrom custom tags . . . . . . . . . . . . .. . . . . .. . . .. . . . . 176

Passing custom tag attributes via CFML structures . . .. . . . . .. . . .. . . . . 177

Customtag example . . . . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 178

Nesting Custom Tags . . . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 180

Passing Data Between Nested CustomTags . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 181

What data is accessible? . . . . . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 181

viii Contents

Where is data accessible? . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 181

High-level data exchange . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 181

Executing Custom Tags . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . 185

Tag instance data . . . . . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 185

Modes ofexecution . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 185

Specifying execution modes . . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . 185

Terminating tag execution .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 186

Access togenerated content . . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 187

Installing Custom Tags. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . 187

Local tags . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 187

Shared tags . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 187

Managing CustomTags . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 188

Resolving filename conflicts . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 188

Securing custom tags . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 188

Encoding custom tags . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 189

Chapter 11 Preventing and Handling Errors . . . . . . . 191

Debug Settings in theColdFusion Administrator . . . . . .. . . . . . .. . . . . . .. . . . . 192

Generating debug information for an individual page . . . .. . . . . . .. . . . . 192

Generating debug information for an individual query . . . . . . . . . . . . .. . 192

Error messages . . . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 192

CFML Code Validation. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 194

Runtime validation . . . . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 194

The CFML syntax checker . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 194

Troubleshooting Common Problems . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 195

ODBC datasource configuration . . . . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . 195

HTTP/URL . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 195

CFML syntax errors . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 195

Error Handling in ColdFusion . . . . . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . 197

Understanding ColdFusion errors . . . . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . 197

Generating Custom Error Messageswith cferror . . . . . . . . . .. . .. . . . . . .. . . . . 199

Creating anerror applicationpage . . . . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . 200

LoggingErrors . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 202

Handling Exceptionsin ColdFusion . . . . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 204

Types of recoverable exceptions supported . . . . . . . . . .. . . . . .. . . . . . .. . 205

Exception information incfcatch . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 206

Exception handlingstrategies . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 208

Exception handlingexample . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 208

CustomExceptionTypes . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 210

Chapter 12 Using the Application Framework . . . . . 213

Understanding the Web Application Framework. . . .. . . . . . .. . . . . .. . . .. . . . . 214

Application-level settings and functions . . . . . . . . .. . . . . . .. . .. . . . . . .. . 214

DevelopingWebApplicationswithColdFusionDRAFT 5/9/01 Path/Filename/Author

Client, Session, Application, and Server scopevariables . . . . . . . . .. . . . . 214

Custom error handling .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . 215

Web server security integration . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 215

Mapping an ApplicationFramework . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 216

Processing Application.cfm and OnRequestEnd.cfm . . . . . . . .. . . .. . . . . 216

Defining the directorystructure . . . . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . 217

Creating the Application.cfm File . . . . . . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 219

Namingthe application . . . . . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 219

Settingapplication default variables and constants . . . . . .. . . . . . .. . . . . 219

Managing the Client State. . . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 221

AboutClient and Sessionvariables .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 221

About client cookies . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 222

Managing client state ina clustered environment . . . . . . . . . .. . . . . . .. . 222

Managing client state without cookies . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 222

Configuring and Using Client Variables. . . . . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . 223

Settingup Clientvariable options . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 223

Using Client variables . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 224

Using Session Variables . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 228

EnablingSession variables . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 228

What is a session? . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 228

Storingsession data inSession variables . . . . .. . . . . . .. . . . . .. . . . . . .. . 229

Standard Session variables . . . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 229

Getting a list of Session variables . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 230

Using Application Variables . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . 230

Storingapplication data in Application variables . . . . . . . . . . .. . . .. . . . . 230

Applicationvariable timeouts . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 231

Tips for using Application variables . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 231

Getting a list of Application variables . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 231

Using Server Variables . . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 232

Locking Code withcflock. . . . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 233

Using cflock .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 233

How cflock works . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 233

Using administrative lock management . . . . . .. . .. . . . . . .. . . . . . .. . . . . 236

Nesting locks and avoiding deadlocks . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . 237

Examples of cflock. . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 238

Chapter 13 Extending ColdFusion Pages with CFML

Scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

About CFScript. . . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 244

CFScriptexample . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 244

Supported statements . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . .. . . . . . .. . 244

The CFScript Language . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 245

Comments . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 245

xContents

Variables . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . 245

Expressions . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 245

Statements . . . . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 245

Reserved words . . . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 248

Differences from JavaScript . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 248

Interaction of CFScript withCFML. . . . . . . . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 249

Defining and Using Custom Functions . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . . . . 250

Defining functions . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 250

Calling functions . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 251

Using arguments and variables . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 251

Identifying custom functions . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 253

Examples ofcustom functons . . . . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 253

Using customfunctions effectively . . . . . . . . . . . . .. . . .. . . . . .. . . . . . .. . 254

Chapter 14 Using Regular Expressions in Functions . . . .

259

About Regular Expressions . . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 260

Basic Regular Expression Rules . . . . . . . . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . 261

Character classes . . . . . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . .. . 261

Multicharacter Regular Expressions . . . . . . . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 263

Limiting input string size . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 264

Anchoring a regular expressionto a string .. . . . . .. . . . . . .. . . . . . .. . . . . 264

Using Backreferences. . . . .. . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 265

Using backreferencesin replacement strings . . . .. . . . . . .. . . . . . .. . .. . 265

Returning Matched Subexpressions . . . . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 266

Regular Expression Examples. . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 267

Regular expressionsin CFML . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 267

Chapter 15 Indexing and Searching Data . . . . . . . . . 269

Searching a ColdFusionWeb Site.. . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 270

Advantagesof using Verity . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . . . . . .. . . . . 270

Supported File Types . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . .. . . . . . .. . 271

Support for International Languages . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 272

Creating a Searchable Data Source . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 273

Creating a Collection . . . . . . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 273

Populating and indexing a collection . . . . . .. . .. . . . . . .. . . . . .. . . . . . .. . 276

Selecting anindexing method . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 277

Buildinga search interface . . . . . . . .. . .. . . . . . .. . . . . . .. . . . . .. . . . . . .. . 279

Indexing Query Results . . . . . .. . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . . . . . .. . . . . 282

Indexing database query results . . . . . . . . . .. . . . . .. . . . . . .. . . . . . .. . .. . 282

Indexing cfldapquery results . . .. . . . . .. . . . . . .. . . . . . .. . . . . .. . . .. . . . . 283

Indexingcfpop query results . . . . . . . . .. . . . . . .. . .. . . . . . .. . . . . . .. . . . . 284

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels MACROMEDIA Logiciel

MACROMEDIA

MACROMEDIA FLASH 8-EXTENDING FLASH Manuel utilisateur

MACROMEDIA

MACROMEDIA BREEZE Guide de référence rapide

MACROMEDIA

MACROMEDIA FLEX-CREATING ADVANCED COMPONENTS Manuel utilisateur

MACROMEDIA

MACROMEDIA COLDFUSION MX 7.0.2-USING COLDFUSION MX WITH FLEX... Instructions de montage

MACROMEDIA

MACROMEDIA FLASH MX 2004-FLASH JAVASCRIPT DICTIONARY Manuel utilisateur

MACROMEDIA

MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX Manuel utilisateur

MACROMEDIA

MACROMEDIA FLASH 8-DEVELOPING FLASH LITE 2.X Manuel utilisateur

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-DEVELOPING MEDIA Manuel utilisateur

MACROMEDIA

MACROMEDIA BREEZE-SECURITY Manuel utilisateur

MACROMEDIA

MACROMEDIA FREEHAND MX 11 Instructions de montage

MACROMEDIA

MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Manuel de service

MACROMEDIA

MACROMEDIA COLDFUSION 5-CFML Manuel utilisateur

MACROMEDIA

MACROMEDIA FLASH 8-FLASH Instructions de fonctionnement

MACROMEDIA

MACROMEDIA COLDFUSION 5-ADVANCED ADMINISTRATION Manuel utilisateur

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-DEVELOPING WEB Manuel utilisateur

MACROMEDIA

MACROMEDIA COLFUSION MX 7-CFML Manuel de service

MACROMEDIA

MACROMEDIA FLASH COMMUNICATION SERVER MX-SERVER-SIDE COMMUNICATION ACTIONSCRIPT... Manuel utilisateur

MACROMEDIA

MACROMEDIA FLASH MX 2004 - FLASH LITE AUTHORING GUIDELINES FOR THE I-MODE... Mode d’emploi

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Instructions de montage

MACROMEDIA

MACROMEDIA BREEZE-USING THE MACROMEDIA BREEZE MANAGER Instructions de montage

MACROMEDIA

MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER Manuel utilisateur

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-SERVER MANAGEMENT ACTIONSCRIPT... Manuel de service

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-ADMINISTRING COLDFUSION... Manuel utilisateur

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Instructions de montage

Manuels Logiciel populaires d'autres marques

COMPRO

COMPRO COMPROFM Manuel utilisateur

Muratec

Muratec OFFICEBRIDGE ONLINE Manuel utilisateur

Oracle

Oracle Contact Center Anywhere 8.1 Manuel utilisateur

Adobe

Adobe 65007312 - Photoshop Lightroom Manuel

Avaya

Avaya NULL One-X for RIM Blackberry Manuel utilisateur

HP ProLiant BL420c Manuel utilisateur

PS Audio

PS Audio PowerPlay Manuel du propriétaire

Brady

Brady LOCKOUT PRO 3.0 Manuel de service

Avaya

Avaya Interaction Center Manuel utilisateur

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Manuel

Novell

Novell GROUPWISE 8 - INTERNET AGENT Manuel utilisateur

Oracle

Oracle Application 9i Manuel utilisateur

Acer

Acer RDM Manuel utilisateur

Canon

Canon Vixia HF21 Manuel utilisateur

Canon

Canon ZR950 Manuel utilisateur

Samsung

Samsung Auto Backup Manuel utilisateur

Polycom

Polycom Vortex EF2201 Instructions d'installation et d'utilisation

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Manuel utilisateur