ColdFusion 9.0 Resources

Using the jnbproxy command

You can use the jnbproxy command-line tool as an alternative to the jnbproxyGui program, to generate Java proxies. For more information, see Generating the Java proxy classes.

For example, you can use this command in a batch file to generate multiple proxy JAR files in a single operation.

The jnbproxy command has the following format:

jnbproxy options... classes...

For example:

jnbproxy /al C:\dotNet\netdll\PrimitiveTypes.dll /d C:\dotNet\MyJavajars 
    /host localhost /n PrimitiveTypes /nj /pd j2n /port 6085 /pro b  
    /pp C:\ColdFusion8\lib CSharpDatatypes.PrimitiveTypes

Options

The following table lists the options that you can use. To create proxies on a system that is running ColdFusion, use the /nj option and do not specify the /bp, /java, or /jp options.

Option	Req/Opt	Default	Description
/al assemblylist	Required		Specifies a semicolon-separated series of file paths of .NET assemblies (DLL and EXE files) that contain the required .NET classes.
/bp bcelpath	Optional	Use the CLASSPATH environment variable to locate the file.	Specifies the path to the folder that contains the bcel.jar file. Ignored if you use the /nj option.
/cf	Required		Use the ColdFusion software license. If you do not include this option, your proxies are limited to a 30-day trial period.
/d directory	Optional	The current execution directory.	Specifies the directory in which to write a JAR file with the generated proxies.
/f classfile	Optional		Reads the classes from the specified text file, not the command line. For more information, see the JNBridge documentation.
/h	Optional		Lists the options and usage information. Typing the command `jnbproxy` with no options or arguments results in the same information.
/host hostname	Required		Specifies the host on which the .NET code is located. This option can be a host name or an IP address. Normally, you specify `localhost`.
/java javapath	Optional	Use the first java.exe file found using the system PATH environment variable.	Specifies the path of the directory that contains the java.exe program to use when automatically starting Java. Ignored if you use the `/nj` option.
/jp jnbcorepath	Optional	Use, the CLASSPATH environment variable.	Specifies the path of the folder containing the file jnbcore.jar. Ignored if you use the `/nj` option.
/ls	Optional	Generate and list the proxies.	Lists all classes that are generated in support of the specified classes (see Supporting classes), but don't generate the proxies.
/n name	Optional	Create a file named jnbproxies.jar.	Specifies the name of the JAR file in which to place the proxies. Do not specify the .jar extension; the tool automatically adds it.
/nj	Optional	Start Java automatically.	Does not start Java automatically. If you use this option, Java must be running, and the `/bp`, `/java`, `/jp`, and `/wd` options, if present, are ignored.
/ns	Optional	Generate proxies for all supporting classes.	Generates proxies for the classes specified on the command line (or class file) only, not for any supporting classes.
/pd	Required		Specifies the direction in which the proxies operate. Must be `j2n`.
/port portNum	Required		Specifies the port on which the .NET side listens when generating the proxies. Must be an integer. Normally this value is 6085.
/pro protocol	Required		Specifies the communication mechanism between the .NET and Java sides. The valid values are: `b` TCP/binary `h` (HTTP/SOAP
/wd dir	optional	The system’s default working directory.	Specifies the working directory for the JVM. Ignored if the `/nj` option is present.

Classes

A space-separated sequence of fully qualified .NET class names (for example, CSharpDatatypes.PrimitiveTypes) for which to generate proxies. The proxies for System.Object and System.Type are always generated, even if they are not listed in the class list.