Package net.sf.saxon.transpile

This package contains classes that support the transpilation of Saxon Java source code to C#, from which the SaxonCS product is built.

Most of the classes in this package implement Java annotations. These are used, for example, to define an alternative C# body for a method, or alternative modifiers required by C#, or to indicate that an enum class can be converted directly to a C# enum. These annotations have no effect on the behaviour of the Java code, but the transpiler interprets them as directives controlling the generation of C# code.

The class CSharp contains static methods which are executable, but the Java implementation of these methods does nothing; the transpiler converts these calls into C# code that fulfils a useful purpose.

Class Summary

Class	Description
CollectionMaker	Provides alternatives to methods such as Collections.emptyList() and Collections.emptyIterator() designed to facilitate transpilation to C#
CSharp	This class contains dummy methods which, if called, have no effect; but calls on these methods are detected by the Java-to-C# converter and affect the C# code that is generated.

Annotation Types Summary

Annotation Type	Description
CSharpDelegate	Annotate a Java class or interface to indicate whether the corresponding C# class should be implemented as a delegate.
CSharpExtendInterface	Annotate a Java interface to reference an additional interface with method definitions that will be present in the C# product.
CSharpInjectMembers	Annotate a Java class or interface with C# code that is to be injected literally into the body of the class or interface when converting to C#.
CSharpInnerClass	This annotation appears on the declaration of a method that creates an instance of an anonymous inner class, and it is used to define what information needs to be passed to the generated C# inner class.
CSharpModifiers	This annotation appears on the declation of a method or field if, for some reason, the automatic generation of the correct modifiers for C# produces incorrect results.
CSharpNullable	Annotate a Java class or interface with C# code that is to be injected literally into the body of the class or interface when converting to C#.
CSharpOmit	Annotate a Java method to indicate that it is to be dropped from the C# generated code (alternative to conditional exclusion using the preprocessor)
CSharpReplaceBody	Annotate a Java method with C# code that is to be injected literally into the body of the method when converting to C#, replacing the Java method body.
CSharpReplaceException	Annotation used by the Java-to-C# transpiler: it causes any exception named in a catch clause within a Java method to be replaced by a different exception in the generated C#
CSharpReplaceMethod	Annotate a Java method, constructor, or field with C# code that is to replace the entire Java method.
CSharpSimpleEnum	Annotate a Java enum to indicate that a simple mapping to a C# enum should be used.
CSharpSuppressWarnings	This annotation appears on the declation of a method or field if, for some reason, the automatic generation of the correct modifiers for C# produces incorrect results.
CSharpTypeBounds	This annotation appears on the declaration of a class using generic type parameters if the C# code needs to have type bounds that cannot be inferred directly from the Java declaration.