lib/javacomp.h

   1 /* Compile a Java program.
   2    Copyright (C) 2001-2002, 2006, 2009-2021 Free Software Foundation, Inc.
   3    Written by Bruno Haible <haible@clisp.cons.org>, 2001.
   4
   5    This program is free software: you can redistribute it and/or modify
   6    it under the terms of the GNU General Public License as published by
   7    the Free Software Foundation; either version 3 of the License, or
   8    (at your option) any later version.
   9
  10    This program is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13    GNU General Public License for more details.
  14
  15    You should have received a copy of the GNU General Public License
  16    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  17
  18 #ifndef _JAVACOMP_H
  19 #define _JAVACOMP_H
  20
  21 #include <stdbool.h>
  22
  23 /* Compile a Java source file to bytecode.
  24    java_sources is an array of source file names.
  25    classpaths is a list of pathnames to be prepended to the CLASSPATH.
  26
  27    source_version can be:    support for
  28              1.3             inner classes
  29              1.4             assert keyword
  30              1.5             generic classes and methods
  31              1.6             (not supported)
  32              1.7             switch(string)
  33              1.8             lambdas
  34              9               private interface methods
  35             10               type inference for local variables
  36             11               'var' in parameters of lambda expressions
  37    target_version can be:  classfile version:
  38              1.1                 45.3
  39              1.2                 46.0
  40              1.3                 47.0
  41              1.4                 48.0
  42              1.5                 49.0
  43              1.6                 50.0
  44              1.7                 51.0
  45              1.8                 52.0
  46              9                   53.0
  47             10                   54.0
  48             11                   55.0
  49    target_version can also be given as NULL. In this case, the required
  50    target_version is determined from the found JVM (see javaversion.h).
  51    Specifying target_version is useful when building a library (.jar) that is
  52    useful outside the given package. Passing target_version = NULL is useful
  53    when building an application.
  54    It is unreasonable to ask for:
  55      - target_version < 1.4 with source_version >= 1.4, or
  56      - target_version < 1.5 with source_version >= 1.5, or
  57      - target_version < 1.6 with source_version >= 1.6, or
  58      - target_version < 1.7 with source_version >= 1.7, or
  59      - target_version < 1.8 with source_version >= 1.8, or
  60      - target_version < 9 with source_version >= 9, or
  61      - target_version < 10 with source_version >= 10, or
  62      - target_version < 11 with source_version >= 11,
  63    because even Sun's/Oracle's javac doesn't support these combinations.
  64    It is redundant to ask for a target_version > source_version, since the
  65    smaller target_version = source_version will also always work and newer JVMs
  66    support the older target_versions too. Except for the cases
  67      - target_version = 1.4, source_version = 1.3, which allows gcj versions 3.0
  68        to 3.2 to be used,
  69      - target-version = 1.6, source-version = 1.5, which allows gcj versions
  70        >= 4.3 to be used.
  71
  72    directory is the target directory. The .class file for class X.Y.Z is
  73    written at directory/X/Y/Z.class. If directory is NULL, the .class
  74    file is written in the source's directory.
  75    use_minimal_classpath = true means to ignore the user's CLASSPATH and
  76    use a minimal one. This is likely to reduce possible problems if the
  77    user's CLASSPATH contains garbage or a classes.zip file of the wrong
  78    Java version.
  79    If verbose, the command to be executed will be printed.
  80    Return false if OK, true on error.  */
  81 extern bool compile_java_class (const char * const *java_sources,
  82                                 unsigned int java_sources_count,
  83                                 const char * const *classpaths,
  84                                 unsigned int classpaths_count,
  85                                 const char *source_version,
  86                                 const char *target_version,
  87                                 const char *directory,
  88                                 bool optimize, bool debug,
  89                                 bool use_minimal_classpath,
  90                                 bool verbose);
  91
  92 #endif /* _JAVACOMP_H */