Compiler options

This chapter describes the options you can use with the VisiBroker for .NET compilers.

Options are processed in order from left to right, giving the last value precedence. All the options in the list are enabled by default.

Options are preceded by a hyphen (-). For some of the options you can use the inverse of the default value by either using -[no_] or removing the hyphen. For example, to display a “warning” if a #pragma is not recognized, the default value is:

warn_unrecognized_pragmas

To turn off the default, type the following command:

-no_warn_unrecognized_pragmas

idl2cs[j]

The idl2cs tool compiles an IDL source file and creates a directory structure containing the C# mappings for the IDL declarations. The idl2cs and idl2csj tools are identical except that idl2csj will run in a Java-only environment (allowing the compiler to be run on platforms without .NET, including Unix and older Windows machines), while idl2cs will run in a C#-only (.NET Framework) environment.

One IDL file maps to one C# file. The default output filename for Foo.idl is Foo.cs. The output file can be specified using the -o option. Typically IDL file names must end with the .idl extension.

Syntax

idl2cs [options] {source_file}

Example

idl2cs -no_Object_method Example.idl

Option	Description
-D, -define foo[=bar]	Defines a preprocessor macro foo, optionally with a value bar. You can use this option more than once.
-I, -include <dir>	Specifies the full or relative path to the directory for #include files. Used in searching for include files. You can use this option more than once.
-P, -no_line_directives	Suppresses the generation of line number information in the generated code. The default is off.
-H, -list_includes	Prints the full paths of included files on the standard error output. The default is off.
-C, -retain_comments	Retains comments from IDL file in the preprocessor output. The default is off.
-U, -undefine foo	Undefines a preprocessor macro foo.
-[no_]idl_strict	Specifies strict adherence to OMG standard interpretation of idl source. The default is off.
-[no_]builtin (TypeCode|Principal)	Creates builtin type ::TypeCode or ::Principal. The default is on.
-[no_]warn_unrecognized_pragmas	Displays a warning that appears if a #pragma is not recognized. The default is on.
-[no_]back_compat_mapping	Use mapping that is compatible with VisiBroker 3.x. The default is off.
-[no_]preprocess	Preprocesses the input file before parsing. The default is on.
-[no_]preprocess_only	Stops parsing the input file after preprocessing. The default is off.
-[no_]warn_all	Turns all warnings on or off simultaneously. The default is off.
-[no_]case_sensitive	Treat identifiers in a case-sensitive manner. The default is on.
-[no_]comments	Suppresses the generation of comments in the code. The default is on.
-gen_included_files	Generates code for #included files. The default is off.
-list_files	Lists files written during code generation. The default is off.
-root_dir <path>	Specifies the directory in which the generated files reside.
-[no_]servant	Generates servant (server-side) code. The default is on.
-[no_]tie	Generates Tie classes. The default is on.
-[no_]warn_missing_define	Warns if any forward declared interfaces were not defined. The default is on.
-[no_]strict_reverse_mapping	Use strict Java reverse mapping. The default is off.
-o <file>	Specifies the name of the output file, or “-” for stdout.
-[no_]bind	Generates the bind() code. The default is off.
-idl2namespace <IDL name> <ns>	Overrides default namespace for a given IDL container type.
-[no_]Object_method	Generates all methods on Object. The default is on.
-namespace <ns>	Specifies the root namespace for generated code.
-map_keyword <kwd> <replacement>	Specifies the keyword to avoid and designates its replacement.
-[no_]mixed_caps	Converts methods to MixedCaps and members to mixedCaps. The default is on.
-[no_]examples	Generates sample implementations. The default is off.
-hint_file <file_uri>	Specifies a hint file URI for custom type mappings. Only available to idl2csj.
-[no_]remoting_proxy	Generates a Proxy class for use with .NET Remoting. The default is on.
-h, -help, -usage, -?	Prints option help information.
-version	Displays the VisiBroker for .NET software version number.
file1 [file2] ...	Designates one or more files to process, or “-” for stdin.

java2cs

This command generates C# code from a Java class. java2cs translates a remote interface defined in Java RMI into corresponding C#. It will translate remote interfaces, EJB interfaces, and value classes into C#. Note that java2cs will also translate types referred to directly or indirectly by the input types.

You can use more than one Java class name (in Java byte code) as input. If you enter more than one class name, make sure you include spaces in between the class names. Use fully scoped class names. You can also provide an EJB JAR or EAR or any library JAR as input.

Note

The java2cs compiler does not support overloaded methods on CORBA interfaces.

If you use a class that extends org.omg.CORBA.IDLEntity in some Java remote interface definition, it must have the following:

•	an IDL file that contains the IDL definition for that type because the org.omg.CORBA.IDLEntity interface is a signature interface that marks all IDL data types mapped to Java.

•	all related (supporting) classes according to the CORBA 2.4 IDL2Java Specification from the Object Management Group (OMG).

If you use a class that extends org.omg.CORBA.IDLEntity in some Java remote interface definition, use the -import <IDL files> directive in the java2cs tool's command line.

For more information, refer to the CORBA 2.4 IDL2Java Specification located at http://www.omg.org.

Syntax

java2cs [options] {input_class_name}

Example

java2cs -no_tie Account Client Server

Use java2cs if you have existing Java byte code that you wish to adapt to use distributed objects or if you do not want to write IDL. By using java2cs, you can generate the necessary container classes, client stubs, and server skeletons from Java byte code.

Option	Description
-D, define foo[=bar]	Defines a preprocessor macro foo, optionally with a value bar.
-I, -include <dir>	Specifies the full or relative path to the directory for #include files. Used in searching for include files.
-P, -no_line_directives	Suppresses the generation of line number information in the generated code. The default is off.
-H, -list_includes	Prints the full paths of included files on the standard error output. The default is off.
-C, -retain_comments	Retains comments from Java file when the C# code is generated. Otherwise, the comments will not appear in the C# code. The default is off.
-U, -undefine foo	Undefines a preprocessor macro foo.
-[no_]idl_strict	Specifies strict adherence to OMG standard interpretation of IDL source. The default is off.
-[no_]builtin (Typecode|Principal)	Creates builtin type ::TypeCode or ::Principal. The default is on.
-[no_]warn_unrecognized_pragmas	Displays a warning that appears if a #pragma is not recognized. The default is on.
-[no_]back_compat_mapping	Uses mapping that is compatible with VisiBroker 3.x. The default is off.
-[no_]preprocess	Preprocesses the input file before parsing. The default is on.
-[no_]preprocess_only	Stops parsing the input file after preprocessing. The default is off.
-[no_]warn_all	Turns all warnings on or off simultaneously. The default is off.
-[no_]idlentity_array_mapping	Maps array of IDLEntity to boxedIDL in boxedRMI. The default is off.
-exported <pkg>	Specifies an exported package.
-[no_]export_all	Exports all packages. The default is off.
-import <IDL file name>	Loads extra IDL definitions.
-imported <pkg> <IDL file name>	Specifies the name of an imported package.
-gen_hints <file-name>	Produces a template hint file. The default is off.
-show_ignored	Prints out all warnings about unloadable classes. The default is off.
-list_classes	Prints out classes which are compiled. The default is off.
-[no_]ignore <class>|<package>	Ignores a class (or all classes in a package) and all classes that depend on it.
-[no_]case_sensitive	Treats identifiers in a case-sensitive manner. The default is on.
-[no_]comments	Places comments in generated code. The default is on.
-gen_included_files	Generates code for #included files. The default is off.
-list_files	Lists files written during code generation. The default is off.
-root_dir <path>	Specifies the directory in which the generated files reside.
-[no_]servant	Generates servant (server-side) code. The default is on.
-[no_]tie	Generates tie classes. The default is on.
-[no_]warn_missing_define	Warns if any forward declared names were never defined. The default is on.
-[no_]strict_reverse_mapping	Uses strict Java reverse mapping. The default is off.
-o <file>	Specifies the name of the output file, or “-” for stdout.
-[no_]bind	Generates the bind() code. The default is off.
-idl2namespace <IDL name> <ns>	Overrides default namespace for a given IDL container type.
-[no_]Object_method	Generates all methods defined in java.lang.Object methods, such as string and equals. The default is on.
-namespace <ns>	Specifies the root namespace for generated code.
-map_keyword <kwd> <replacement>	Specifies the keyword to avoid and designates its replacement.
-[no_]mixed_caps	Converts methods to MixedCaps and members to mixedCaps. The default is on.
-[no_]examples	Generates sample implementations. The default is off.
-hint_file <file-uri>	Specifies a hint file URI for custom type mappings.
-[no_]remoting_proxy	Generates a Proxy class for use with .NET Remoting. The default is on.
-h, -help, -usage, -?	Prints option help information.
-version	Displays the VisiBroker for .NET software version number.
[file.jar] [file.ear] ...	Optional list of J2EE archives (JAR or EAR) to process.
[class1] [class2] ...	Optional list of Java classes to process. Note that is no target Java classes are specified, they will be determined automatically from the specified J2EE archive.