MACROMEDIA COLDFUSION 4.5-DEVELOPING WEB, Develop Manual

Page: 304 / 380

278 Developing Web Applications with ColdFusion
On UNIX
Solaris
You can debug custom tags on UNIX using the dbx debugger. You should shut down
ColdFusion using the stop script.
Set the environment variables, including
LD_LIBRARY_PATH
and
CFHOME
as they are set
in the start script. You should then be able to run the cfserver executable under the dbx
debugger and set break points in your CFX code. You may need to set a break point in
main ("stop in main") so dbx loads the symbols for your CFX before you can set
breakpoints in your code.
HP-UX 10.20
You can debug custom tags on UNIX using HP’s DDE debugger. You should shut down
ColdFusion using the stop script.
Set the environment variables, including SHLIB_PATH and CFHOME as they are set in the
start script. You should then be able to run the cfserver executable under the DDE
debugger and set break points in your CFX code. You may need to set a break point in
main ("stop in main") so the debugger loads the symbols for your CFX before you can
set breakpoints in your code.
Before You Begin Developing CFX Tags in Java
Because the methods and syntax are similar, if you are familiar with creating CFXs
using C++ you will be productive creating CFXs in Java almost immediately. Even if you
have never used the C++ based API, you will find that the Java implementation is
extremely easy to learn and work with.
Sample Java CFXs
Before you begin developing a CFX tag in Java, you may want to study sample CFX tags.
The Java source files for the examples can be found in the
examples
subdirectory of the
main installation directory. The example tags are:
•
HelloColdFusion
- Prints a personalized greeting. Demonstrates the minimal
implementation required to create a CFX.
•
ZipBrowser
- Retrieves the contents of a zip archive. Demonstrates generating a
ColdFusion query and returning it to the calling page.
•
ServerDateTime
- Retrieves the date and time from a network server.
Demonstrates attribute validation, using numeric attributes, and setting
variables within the calling page.
•
OutputQuery - Outputs a ColdFusion query in an HTML table. Demonstrates
handling a ColdFusion query as input, throwing exceptions, and generating
dynamic output.