lib/javacomp.h

   1 /* Compile a Java program.
   2    Copyright (C) 2001-2002, 2006, 2009-2013 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 <http://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 yet supported)
  32    target_version can be:  classfile version:
  33              1.1                 45.3
  34              1.2                 46.0
  35              1.3                 47.0
  36              1.4                 48.0
  37              1.5                 49.0
  38              1.6                 50.0
  39    target_version can also be given as NULL. In this case, the required
  40    target_version is determined from the found JVM (see javaversion.h).
  41    Specifying target_version is useful when building a library (.jar) that is
  42    useful outside the given package. Passing target_version = NULL is useful
  43    when building an application.
  44    It is unreasonable to ask for:
  45      - target_version < 1.4 with source_version >= 1.4, or
  46      - target_version < 1.5 with source_version >= 1.5, or
  47      - target_version < 1.6 with source_version >= 1.6,
  48    because even Sun's javac doesn't support these combinations.
  49    It is redundant to ask for a target_version > source_version, since the
  50    smaller target_version = source_version will also always work and newer JVMs
  51    support the older target_versions too. Except for the case
  52    target_version = 1.4, source_version = 1.3, which allows gcj versions 3.0
  53    to 3.2 to be used.
  54
  55    directory is the target directory. The .class file for class X.Y.Z is
  56    written at directory/X/Y/Z.class. If directory is NULL, the .class
  57    file is written in the source's directory.
  58    use_minimal_classpath = true means to ignore the user's CLASSPATH and
  59    use a minimal one. This is likely to reduce possible problems if the
  60    user's CLASSPATH contains garbage or a classes.zip file of the wrong
  61    Java version.
  62    If verbose, the command to be executed will be printed.
  63    Return false if OK, true on error.  */
  64 extern bool compile_java_class (const char * const *java_sources,
  65                                 unsigned int java_sources_count,
  66                                 const char * const *classpaths,
  67                                 unsigned int classpaths_count,
  68                                 const char *source_version,
  69                                 const char *target_version,
  70                                 const char *directory,
  71                                 bool optimize, bool debug,
  72                                 bool use_minimal_classpath,
  73                                 bool verbose);
  74
  75 #endif /* _JAVACOMP_H */