Java2C_Main

java.lang.Object
- org.vishia.java2C.Java2C_Main

All Implemented Interfaces:

RunRequiredFirstPass_ifc
```
public class Java2C_Main
extends java.lang.Object
implements RunRequiredFirstPass_ifc
```
This class is the main class of translation Java2C. It is used from the command line call-implementation class Java2C.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Java2C_Main.CmdlineArgs` The gotten arguments from the command line are hold in this extra static class.
`static class`	`Java2C_Main.InputFileParseResult` The instance of this class is filled with the result of parsing an input file given with `-if:INPFILE` cmd line calling argument.

Field Summary

Fields
Modifier and Type	Field and Description
`static LocalIdents`	`externalTypes` Contains all types which are searched but not found in the Java2C translation.
`CCodeData`	`localReferenceDummy` A CCodeInfo instance useable as dummy for local variable.
`static Java2C_Main`	`singleton` The singleton instance of this class.
`CRuntimeJavalikeClassData`	`standardClassData` Instance with all `ClassData` and `LocalIdents` for the classes appropriated in the CRuntimeJavalike C runtime environment.
`CCodeData`	`staticReferenceDummy` A CCodeInfo instance useable as dummy for static variable.
`static java.lang.String`	`sVersion` Version, history and license.

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`addInputFilemask(java.lang.String sMask, java.lang.String sCPrefix, java.lang.String sCPostfix)`
`static org.vishia.java2C.ClassData`	`createExternalType(java.lang.String name, java.lang.String pkg)` Creates a external type because no informations are available.
`void`	`execute()` Executes the translation for all files.
`static JavaSrcTreePkg`	`getOrAddRootPkg(java.lang.String sName)` Creates or searches a package which is a root package.
`java.lang.String`	`getPathOutCfiles()`
`java.lang.String`	`getPathOutHeader()`
`java.lang.String`	`getPathOutStcFiles()`
`static LocalIdents`	`getRootLevelIdents()` Gets the FileLevelidents of the root level.
`static JavaSrcTreePkg`	`getRootPkg(java.lang.String sName)` Searches a package which is a root package.
`static void`	`instanciateSingleton(Java2C_Main.CmdlineArgs args, org.vishia.mainCmd.Report report)` The create routine for the singleton.
`org.vishia.java2C.ClassData`	`runRequestedFirstPass(JavaSrcTreeFile javaSrc, java.lang.String sPkgClassName)` Runs the first pass.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - sVersion
```
public static final java.lang.String sVersion
```
    Version, history and license.
    - 2014-09-05 Hartmut bugfix close() from 2014-08-16 is executed before inputs are read on parser error, shift to execution after that.
    - 2014-08-16 Hartmut bugfix missing close() for opened parsed files. The close was executed on end of running the Java command in JVM from operation system. It is possible, but not nice to have, to late.
    - 2008 Hartmut created:
    Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:
    1. You can use this source without any restriction for any desired purpose.
    2. You can redistribute copies of this source to everybody.
    3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
    4. But the LPGL is not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
    5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.
    If you are intent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.
    See Also:
    Constant Field Values
  - externalTypes
```
public static final LocalIdents externalTypes
```
    Contains all types which are searched but not found in the Java2C translation. If a type is necessary but not known, a unknown type is created. It is possible that the type isn't known in the given pool of Java files. Typically it may be a Type which may existent at the C-side because it is manually written. Another problem may be, it is an unregistered standard type.
    
    This types are automatic created and are accessible in all scopes. The reportfile contains the list of all here registered types.
  - standardClassData
```
public CRuntimeJavalikeClassData standardClassData
```
    Instance with all ClassData and LocalIdents for the classes appropriated in the CRuntimeJavalike C runtime environment. All this ClassData are stored in #stdTypes, which is the base of all LocalIdents, therefore this types are accessible in all scopes.
    The content of this class is used directly if ClassData of this standard types are need, the access is done via the singleton.standardClassData.
  - localReferenceDummy
```
public final CCodeData localReferenceDummy
```
    A CCodeInfo instance useable as dummy for local variable. There havn't a reference.
  - staticReferenceDummy
```
public final CCodeData staticReferenceDummy
```
    A CCodeInfo instance useable as dummy for static variable. There havn't a reference.
  - singleton
```
public static Java2C_Main singleton
```
    The singleton instance of this class.
- Method Detail
  - addInputFilemask
```
public boolean addInputFilemask(java.lang.String sMask,
                       java.lang.String sCPrefix,
                       java.lang.String sCPostfix)
```
  - instanciateSingleton
```
public static void instanciateSingleton(Java2C_Main.CmdlineArgs args,
                        org.vishia.mainCmd.Report report)
```
    The create routine for the singleton.
  - execute
```
public void execute()
             throws java.text.ParseException,
                    java.io.FileNotFoundException,
                    java.lang.IllegalArgumentException,
                    java.io.IOException,
                    java.lang.IllegalAccessException,
                    java.lang.InstantiationException
```
    Executes the translation for all files.
    
    Throws:
    
    java.text.ParseException
    
    java.lang.InstantiationException
    
    java.lang.IllegalAccessException
    
    java.io.IOException
    
    java.lang.IllegalArgumentException
    
    java.io.FileNotFoundException
  - getPathOutCfiles
```
public java.lang.String getPathOutCfiles()
```
  - getPathOutHeader
```
public java.lang.String getPathOutHeader()
```
  - getPathOutStcFiles
```
public java.lang.String getPathOutStcFiles()
```
  - createExternalType
```
public static final org.vishia.java2C.ClassData createExternalType(java.lang.String name,
                                             java.lang.String pkg)
```
    Creates a external type because no informations are available.
    
    Parameters:
    name -
    pkg -
    
    Returns:
    the created type. It is put also in the global userTypes:
  - getOrAddRootPkg
```
public static final JavaSrcTreePkg getOrAddRootPkg(java.lang.String sName)
```
    Creates or searches a package which is a root package. Inside the returned package, the method JavaSrcTreePkg#getOrAddPkg(String, String) can be invoked to get or add a sub package or the method {@link JavaSrcTreePkg#setFileJava(String, File, String, String, String, String, String, String, boolean) can be invoked.
    
    Parameters:
    sName - The name of the root package
    
    Returns:
    The root package management instance.
  - getRootPkg
```
public static final JavaSrcTreePkg getRootPkg(java.lang.String sName)
```
    Searches a package which is a root package.
    
    Parameters:
    sName - The name of the root package
    
    Returns:
    The root package management instance.
  - getRootLevelIdents
```
public static final LocalIdents getRootLevelIdents()
```
    Gets the FileLevelidents of the root level. It are such as the packages "org" or "java".
    
    Returns:
    The fileLevelIdents for the root level.
  - runRequestedFirstPass
```
public org.vishia.java2C.ClassData runRequestedFirstPass(JavaSrcTreeFile javaSrc,
                                                java.lang.String sPkgClassName)
                                                  throws java.io.FileNotFoundException,
                                                         java.lang.IllegalArgumentException,
                                                         java.io.IOException,
                                                         java.lang.IllegalAccessException,
                                                         java.lang.InstantiationException,
                                                         java.text.ParseException
```
    Runs the first pass. Searches the file and build the ClassData parsing and converting the file. This method is called if an unknown type is used yet.
    
    Specified by:
    
    runRequestedFirstPass in interface RunRequiredFirstPass_ifc
    
    Parameters:
    sClassName - The name of the type in Java. The filename should be the same. The file is searched in any package given as input parameter calling java2C.
    
    Returns:
    null if no file found. Otherwise the built ClassData. This ClassData are registered in the list Java2C_Main#userTypes.
    
    Throws:
    
    java.text.ParseException
    
    java.io.FileNotFoundException
    
    java.lang.IllegalArgumentException
    
    java.io.IOException
    
    java.lang.IllegalAccessException
    
    java.lang.InstantiationException
    See Also:
    org.vishia.java2C.RunRequiredFirstPass_ifc#runRequestedFirstPass(java.lang.String)

Class Java2C_Main

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

sVersion

externalTypes

standardClassData

localReferenceDummy

staticReferenceDummy

singleton

Method Detail

addInputFilemask

instanciateSingleton

execute

getPathOutCfiles

getPathOutHeader

getPathOutStcFiles

createExternalType

getOrAddRootPkg

getRootPkg

getRootLevelIdents

runRequestedFirstPass