1 /* Compile a Java program.
2 Copyright (C) 2001-2002, 2006, 2009-2023 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 */