Compiling C++ Cfx Tags; Locating Your C++ Library Files On Unix; Implementing C++ Cfx Tags; Debugging C++ Cfx Tags - MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX Develop Manual

Compiling C++ CFX tags

CFX tags built in Windows and on UNIX must be thread-safe. Compile CFX tags for Solaris
with the switch on the Sun compiler.
-mt

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++
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
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:
Build your C++ CFX tag using the debug option.
1
Restart ColdFusion.
2
Start Visual C++ 6.0.
3
Select Build > Start Debug > AttachProcess.
4
Select jrunsvc.exe.
5
Macromedia recommends that you shut down all other Java programs.
Execute any ColdFusion page that calls the CFX tag.
6
Select File > Open to open a file in VisualDev in which to set a breakpoint.
7
Set a breakpoint in the CFX project.
8
The best place is to put it in
the breakpoint.
262 Chapter 12: Building Custom CFXAPI Tags
Chapter 4, "ColdFusion C++ CFX Reference,"
. Next time you execute the page you will hit
ProcessRequest()
.
CCFXRequest class
in CFML