lib/javacomp.h

   1 /* Compile a Java program.
   2    Copyright (C) 2001-2002, 2006, 2009-2024 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 /* Compile a Java source file to bytecode.
  22    java_sources is an array of source file names.
  23    classpaths is a list of pathnames to be prepended to the CLASSPATH.
  24
  25    source_version can be:    support for
  26              1.6             assert keyword (1.4), generic classes and methods (1.5)
  27              1.7             switch(string)
  28              1.8             lambdas
  29              9               private interface methods
  30             10               type inference for local variables
  31             11               'var' in parameters of lambda expressions
  32             ...
  33    If source-version 1.3 or 1.4 or 1.5 is requested, it gets mapped to 1.6, for
  34    backward compatibility. (Currently the minimum Java and javac version we need
  35    to support is Java 1.6, since that's the default Java version on Solaris 10.)
  36
  37    target_version can be:  classfile version:
  38              1.6                 50.0
  39              1.7                 51.0
  40              1.8                 52.0
  41              9                   53.0
  42             10                   54.0
  43             11                   55.0
  44             ...                  ...
  45    If a target-version below 1.6 is requested, it gets mapped to 1.6, for
  46    backward compatibility. (Currently the minimum Java and javac version we need
  47    to support is Java 1.6, since that's the default Java version on Solaris 10.)
  48    target_version can also be given as NULL. In this case, the required
  49    target_version is determined from the found JVM (see javaversion.h).
  50    Specifying target_version is useful when building a library (.jar) that is
  51    useful outside the given package. Passing target_version = NULL is useful
  52    when building an application.
  53    It is unreasonable to ask for a target-version < source-version, such as
  54      - target_version < 1.4 with source_version >= 1.4, or
  55      - target_version < 1.5 with source_version >= 1.5, or
  56      - target_version < 1.6 with source_version >= 1.6, or
  57      - target_version < 1.7 with source_version >= 1.7, or
  58      - target_version < 1.8 with source_version >= 1.8, or
  59      - target_version < 9 with source_version >= 9, or
  60      - target_version < 10 with source_version >= 10, or
  61      - target_version < 11 with source_version >= 11, or
  62      - ...
  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.
  67
  68    directory is the target directory. The .class file for class X.Y.Z is
  69    written at directory/X/Y/Z.class. If directory is NULL, the .class
  70    file is written in the source's directory.
  71    use_minimal_classpath = true means to ignore the user's CLASSPATH and
  72    use a minimal one. This is likely to reduce possible problems if the
  73    user's CLASSPATH contains garbage or a classes.zip file of the wrong
  74    Java version.
  75    If verbose, the command to be executed will be printed.
  76    Return false if OK, true on error.  */
  77 extern bool compile_java_class (const char * const *java_sources,
  78                                 unsigned int java_sources_count,
  79                                 const char * const *classpaths,
  80                                 unsigned int classpaths_count,
  81                                 const char *source_version,
  82                                 const char *target_version,
  83                                 const char *directory,
  84                                 bool optimize, bool debug,
  85                                 bool use_minimal_classpath,
  86                                 bool verbose);
  87
  88 #endif /* _JAVACOMP_H */