gov.llnl.babel.backend.fortran

Class SkelSource

java.lang.Object

gov.llnl.babel.backend.fortran.SkelSource

public class SkelSource
extends java.lang.Object

The purpose of this class is to generate the C skeleton code to support sidl objects implemented in FORTRAN. The skeleton code makes the link between the independent object representation (IOR) and the FORTRAN implementation of a sidl class. The skeleton must map datatypes in C to datatypes in FORTRAN. It must must also provide C functions to populate the static and object entry point vectors for the IOR.

Constructor Summary

Constructors

Constructor and Description
SkelSource(LanguageWriterForC writer, Context context) Create an object to generate the skeleton code in C for a FORTRAN object.

Method Summary

Modifier and Type	Method and Description
static void	borrowRarray(java.lang.String lhs, Type argType, java.lang.String rhs, java.lang.String indexExprBase, java.lang.String prefix, boolean withDecl, Context d_context, LanguageWriter d_writer)
void	doOutArg(Argument arg, java.lang.String lhs) For out and inout parameters, convert the values from the proxy variables into something that the IOR can handle.
static java.util.Collection	extendMethods(Extendable ext, Context d_context) Add the implicit builtin methods to the list of methods.
void	generateCode(Class cls) This method creates a skeleton file for a class.
static void	generateCode(Class cls, LanguageWriterForC writer, Context context) This is a convenience routine to create a skeleton file for a class without having to make an instance of SkelSource.
java.lang.String	getReturnString(Type type) Generate a return string for the specified SIDL type.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SkelSource

public SkelSource(LanguageWriterForC writer,
                  Context context)
           throws java.security.NoSuchAlgorithmException

Create an object to generate the skeleton code in C for a FORTRAN object.

Parameters:

writer - the skeleton code is written to this device.

Throws:

java.security.NoSuchAlgorithmException - problem with the name mangler.

Method Detail

borrowRarray

public static void borrowRarray(java.lang.String lhs,
                                Type argType,
                                java.lang.String rhs,
                                java.lang.String indexExprBase,
                                java.lang.String prefix,
                                boolean withDecl,
                                Context d_context,
                                LanguageWriter d_writer)
                         throws CodeGenerationException

Throws:

CodeGenerationException

doOutArg

public void doOutArg(Argument arg,
                     java.lang.String lhs)
              throws CodeGenerationException

For out and inout parameters, convert the values from the proxy variables into something that the IOR can handle.

Parameters:

argType - the type of the argument.

argName - the original name of the formal argument.

mode - the mode of the argument.

lhs - a left-hand-side expression used to assign the result value

Throws:

CodeGenerationException - a catch all exception to indicate problems in the code generation phase.

getReturnString

public java.lang.String getReturnString(Type type)
                                 throws CodeGenerationException

Generate a return string for the specified SIDL type. Most of the SIDL return strings are listed in the static structures defined at the start of this class. Symbol types and array types require special processing.

Throws:

CodeGenerationException

extendMethods

public static java.util.Collection extendMethods(Extendable ext,
                                                 Context d_context)
                                          throws CodeGenerationException

Add the implicit builtin methods to the list of methods. There are implicit functions for the constructor and destructor.

Parameters:

ext - the extendable object.

Throws:

CodeGenerationException

generateCode

public void generateCode(Class cls)
                  throws CodeGenerationException

This method creates a skeleton file for a class. The skeleton file is a C module that is the glue between the IOR and the implementation of a class written in FORTRAN.

Parameters:

cls - the class to create.

Throws:

CodeGenerationException - a catch all exception to indicate problems in the code generation phase.

generateCode

public static void generateCode(Class cls,
                                LanguageWriterForC writer,
                                Context context)
                         throws CodeGenerationException,
                                java.security.NoSuchAlgorithmException

This is a convenience routine to create a skeleton file for a class without having to make an instance of SkelSource. The skeleton file is a C module that is the glue between the IOR and the implementation of a class written in FORTRAN.

Parameters:

cls - the class for whom a skeleton will be made.

writer - the output device where the skeleton file will be sent.

Throws:

CodeGenerationException - a catch all exception to indicate problems in the code generation phase.

java.security.NoSuchAlgorithmException - problem with the name mangler.