gov.llnl.babel.backend.fortran

Class GenerateServer

java.lang.Object

gov.llnl.babel.backend.fortran.GenerateServer

All Implemented Interfaces:

CodeGenerator, ContextAware

public class GenerateServer
extends java.lang.Object
implements CodeGenerator

This class implements the CodeGenerator interface for the FORTRAN server side code generator. This generator creates C source code to provide the glue between IOR and an object implemented in FORTRAN. This will also generate an implementation file in FORTRAN for the developer to fill in with the appropriate behavior.

Constructor Summary

Constructors

Constructor and Description
GenerateServer() Create a new instance.

Method Summary

Methods

Modifier and Type	Method and Description
void	generateCode(java.util.Set symbols) Given a set of symbol ids, this method will generate FORTRAN skeletons (written in C) for all classes in the set.
java.util.Set	getLanguages() Return the set of language names that this generator supports.
java.lang.String	getName() Return the canonical name of this generator.
java.lang.String	getType() Return the type of generator.
boolean	getUserSymbolsOnly() Return true if and only if this code factory should only operate on symbols outside the sidl namespace (i.e., exclude symbols from the sidl runtime library).
void	setContext(Context context) Routine to notify extensions of the context.
void	setName(java.lang.String name) Set the name of the generator.

Methods inherited from class java.lang.Object

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

Constructor Detail

GenerateServer

public GenerateServer()

Create a new instance.

Method Detail

generateCode

public void generateCode(java.util.Set symbols)
                  throws CodeGenerationException

Given a set of symbol ids, this method will generate FORTRAN skeletons (written in C) for all classes in the set. This will also generate a FORTRAN source file with templates for each of the required methods. The end user who is implementing the sidl object is expected to fill in the FORTRAN template.

Specified by:

generateCode in interface CodeGenerator

Parameters:

symbols - the set of symbol names for which code will be generated as needed. Each object in the set should be a SymbolID.

Throws:

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

getType

public java.lang.String getType()

Description copied from interface: CodeGenerator

Return the type of generator. Currently, there are three types of generator "stub", "skel" and "ior". "xml" might be added someday.

Specified by:

getType in interface CodeGenerator

getUserSymbolsOnly

public boolean getUserSymbolsOnly()

Description copied from interface: CodeGenerator

Return true if and only if this code factory should only operate on symbols outside the sidl namespace (i.e., exclude symbols from the sidl runtime library). This is typically true for C and Python where the stubs for the sidl runtime library are pregenerated. Generally, this should be true for anything other than a stub. Implementors do not need to worry about the special case of generating the sidl runtime library itself.

Specified by:

getUserSymbolsOnly in interface CodeGenerator

getLanguages

public java.util.Set getLanguages()

Description copied from interface: CodeGenerator

Return the set of language names that this generator supports. Normally, there is one one name per generator. However, the C++ generator can be referred to as cxx or c++, so it has two in its set. The names should be lower case. Some examples are "c", "ior", "c++", etc.

Specified by:

getLanguages in interface CodeGenerator

Returns:

a Set of strings. Each string is a language name that this generator supports.

setName

public void setName(java.lang.String name)
             throws CodeGenerationException

Description copied from interface: CodeGenerator

Set the name of the generator. This sets the name of the generator as it appeared on the command line. This method should be called at least once before CodeGenerator.getName() is called.

Specified by:

setName in interface CodeGenerator

Parameters:

name - this should be the name that the end user designated for the generator.

Throws:

CodeGenerationException

getName

public java.lang.String getName()

Description copied from interface: CodeGenerator

Return the canonical name of this generator. This exists for cases where a backend may have more than one name. CodeGenerator.setName(String) should be called at least once before this method is called.

Specified by:

getName in interface CodeGenerator

Returns:

the return value should always be a string in the set returned by CodeGenerator.getLanguages(). It may not be equal to the name given in CodeGenerator.setName(String).

setContext

public void setContext(Context context)

Description copied from interface: ContextAware

Routine to notify extensions of the context.

Specified by:

setContext in interface ContextAware