MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX, Develop Manual, Page: 262 / 860

262 Chapter 12: Building Custom CFXAPI Tags
Compiling C++ CFX tags
CFX tags built in Windows and on UNIX must be thread-safe. Compile CFX tags for Solaris
with the
-mt
switch on the Sun compiler.
Locating your C++ library files on UNIX
On UNIX systems, your C++ library files can be in any directory as long as the directory is
included in LD_LIBRARY_PATH or SHLIB_PATH (HP-UX only).
Implementing C++ CFX tags
CFX tags built in C++ use the tag request object, represented by the C++
CCFXRequest class
.
This object represents a request made from an application page to a custom tag. A pointer to an
instance of a request object is passed to the main procedure of a custom tag. The methods
available from the request object let the custom tag accomplish its work. For information about
the CFX API classes and members, see
Chapter 4, “ColdFusion C++ CFX Reference,” in CFML
Reference .
Debugging C++ CFX tags
After you configure a debugging session, you can run your custom tag from within the debugger,
set breakpoints, single-step, and so on.
Debugging on Windows
You can debug custom tags within the Visual C++ environment.
To debug C++ CFX tags in Windows:
1
Build your C++ CFX tag using the debug option.
2
Restart ColdFusion.
3
Start Visual C++ 6.0.
4
Select Build > Start Debug > AttachProcess .
5
Select jrunsvc.exe.
Macromedia recommends that you shut down all other Java programs.
6
Execute any ColdFusion page that calls the CFX tag.
7
Select File > Open to open a file in VisualDev in which to set a breakpoint.
8
Set a breakpoint in the CFX project.
The best place is to put it in
ProcessRequest()
. Next time you execute the page you will hit
the breakpoint.