Table of Contents
Advertisement
DEVELOPING COLDFUSION 9 APPLICATIONS
Using Web Elements and External Objects
2
If the .NET assemblies reside only on the remote system, generate proxy JAR files on that system that represent the
assemblies (see
"Generating the Java proxy
system. If identical .NET assemblies also reside on the local system, you can skip this step.
3
Configure the .NET-side system for remote access (see
Generating the Java proxy classes
The Java proxy generation code requires direct access to the .NET assemblies to generate the proxy classes. Therefore,
if the system that runs your ColdFusion application does not have the assemblies installed, run a tool on the .NET-side
system to create the Java proxies. ColdFusion installs two proxy generation programs, jnbproxyGui.exe and
jnbproxy.exe in the jnbridge directory when you install the .NET services. The jnbproxyGui.exe program is a Windows
user interface application, and the jnbproxy.exe program is a command line application. Both programs have identical
capabilities.
Note: If the system running the ColdFusion application has the assemblies installed, but must access remote versions of
the assemblies (for example, because of configuration differences), you need not manually generate the proxy classes, and
you can skip this step. Instead, specify the paths to the local .exe or .dll files in the
tag (or
function) and specify the remote server in the
CreateObject
access, however.
On a ColdFusion system, the jnbproxyGui and jnbproxy programs are located in the cfroot\jnbridge directory. When
you use the stand-alone installer, the programs are located in the installDir\jnbridge directory.
This document provides the basic information necessary to generate a proxy JAR file using the jnbproxyGui tool.
Additional information is available in the following locations:
• The jnbridge directory includes a jnbproxy.chm Windows Help file with more complete documentation on the
JNBridge technology that powers the ColdFusion .NET feature, including detailed information on both the
jnbproxyGui and jnbproxy programs.
• The jnbridge\docs subdirectory includes additional documentation, including users guide.pdf, a PDF version of the
information in the Help file.
Note: The JNBridge documentation includes information on features that are not supported in ColdFusion. ColdFusion,
for example, does not support access from .NET assemblies to ColdFusion or memory-only communication.
Using the jnbproxyGui tool
You use the jnbproxyGui program to generate a proxy JAR file.
Generate and install a proxy JAR
1
Start JNBProxyGui.exe.
The first time you run the program, it displays the Enter Java Options dialog box. Configure the options, and click OK.
2
You can change the configuration settings at a later time by selecting Project > Java Options.
On a system with ColdFusion: If ColdFusion is currently running on this system, ensure that the Start Java
Automatically option, located on the right side of the JNBProxy Enter Java Options (Project > Java Options) dialog
box is cleared. Leave the default values for the other settings.
When you open an existing project, you could get a Restart Java Side pop-up window with the message "You must
stop and restart the Java side before these changes to the classpath can take effect." You can ignore this message and
click OK to proceed.
When you start the program, the Java Options dialog box could appear. You do not have to change anything; click
OK or Cancel to open the Launch JNBProxy dialog box.
classes" on page 1152). Then copy or move the proxy files to the local
"Configuring the .NET-side
server
Last updated 8/5/2010
system" on page 1154).
attribute of the
assembly
attribute. Configure the remote system for
1152
cfobject
Advertisement
Table of Contents
