Connection Actions And Attributes - MACROMEDIA COLDFUSION 5-DEVELOPING Develop Manual

344
Assigning a
multiple users could access the same connection object at the same time. Creating a
Session variable for a
is available to only one client and does not last past the end of the session.
Example: Caching a connection
<cflock scope="Session" timeout=10>
<cfftp action="Open"
</cflock>
In this example, the connection cache remains available to other pages within the
current session. You must enable Session variables in your application for this
approach to work, and you must lock code that uses Session variables. For
information on locking, see "Locking Code with cflock" on page 233.
Note
Changing a connection's characteristics, such the
might require you to re-establish the connection.

Connection actions and attributes

The following table shows the available
when you use a named (that is, cached) connection. If you do not specify an existing
connection name, you must specify the
Action
Open
Close
ChangeDir
CreateDir
ListDir
RemoveDir
GetFile
PutFile
connection to an Application variable could cause problems, since
cfftp
cfftp
username="anonymous"
password="me@home.com"
server="ftp.eclipse.com"
connection="Session.myconnection">
Attributes
none
none
directory
directory
name
directory
directory
localfile
remotefile
localfile
remotefile
Chapter 18 Interacting with Remote Servers
connection makes more sense, because the connection
actions and the attributes they require
cfftp
username
Action
Rename
Remove
GetCurrentDir
GetCurrentURL
ExistsDir
ExistsFile
Exists
or
retrycount timeout
, , and
password server
Attributes
existing
new
server
item
none
none
directory
remotefile
item
values,
attributes.