1 #
2 # Copyright (c) 2014, 2025, Oracle and/or its affiliates. All rights reserved.
3 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 #
5 # This code is free software; you can redistribute it and/or modify it
6 # under the terms of the GNU General Public License version 2 only, as
7 # published by the Free Software Foundation. Oracle designates this
8 # particular file as subject to the "Classpath" exception as provided
9 # by Oracle in the LICENSE file that accompanied this code.
10 #
11 # This code is distributed in the hope that it will be useful, but WITHOUT
12 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 # version 2 for more details (a copy is included in the LICENSE file that
15 # accompanied this code).
16 #
17 # You should have received a copy of the GNU General Public License version
18 # 2 along with this work; if not, write to the Free Software Foundation,
19 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 #
21 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 # or visit www.oracle.com if you need additional information or have any
23 # questions.
24 #
25
26 include MakeFileStart.gmk
27
28 ################################################################################
29
30 include JavaCompilation.gmk
31 include Modules.gmk
32
33 include CopyFiles.gmk
34
35 ################################################################################
36 # If this is an imported module that has prebuilt classes, only compile
37 # module-info.java.
38 ifneq ($(IMPORT_MODULES_CLASSES), )
39 IMPORT_MODULE_DIR := $(IMPORT_MODULES_CLASSES)/$(MODULE)
40 ifneq ($(wildcard $(IMPORT_MODULE_DIR)), )
41 $(MODULE)_INCLUDE_FILES := module-info.java
42 endif
43 else
44 IMPORT_MODULE_DIR :=
45 endif
46
47 ################################################################################
48 # Setup the compilation for the module
49 #
50 MODULE_SRC_DIRS := $(call FindModuleSrcDirs, $(MODULE))
51
52 # The JDK_USER_DEFINED_FILTER is a poor man's incremental build: by specifying
53 # JDK_FILTER at the make command line, only a subset of the JDK java files will
54 # be recompiled. If multiple paths are separated by comma, convert that into a
55 # space separated list.
56 JDK_USER_DEFINED_FILTER := $(strip $(subst $(COMMA),$(SPACE), $(JDK_FILTER)))
57 ifeq ($(JDK_FILTER), )
58 FAIL_NO_SRC := true
59 else
60 # When using JDK_FILTER, most module java compilations will end up finding
61 # no source files. Don't let that fail the build.
62 FAIL_NO_SRC := false
63 endif
64
65 # Get the complete module source path.
66 MODULESOURCEPATH := $(call GetModuleSrcPath)
67
68 # Add imported modules to the modulepath
69 MODULEPATH := $(call PathList, $(IMPORT_MODULES_CLASSES))
70
71 ################################################################################
72 # Copy zh_HK properties files from zh_TW (needed by some modules)
73
74 $(JDK_OUTPUTDIR)/modules/%_zh_HK.properties: $(JDK_OUTPUTDIR)/modules/%_zh_TW.properties
75 $(install-file)
76
77 CreateHkTargets = \
78 $(call FilterExcludedTranslations, \
79 $(patsubst $(TOPDIR)/src/%, $(JDK_OUTPUTDIR)/modules/%, \
80 $(subst /share/classes,, \
81 $(subst _zh_TW,_zh_HK, $(filter %_zh_TW.properties, $1)) \
82 ) \
83 ), \
84 .properties \
85 )
86
87 ################################################################################
88 # Include module specific build settings
89
90 THIS_SNIPPET := $(call GetModuleSnippetName, Java)
91
92 ifneq ($(wildcard $(THIS_SNIPPET)), )
93 include MakeSnippetStart.gmk
94
95 include $(THIS_SNIPPET)
96
97 include MakeSnippetEnd.gmk
98 endif
99
100 ################################################################################
101 # Setup the main compilation
102
103 COMPILATION_OUTPUTDIR := $(if $($(MODULE)_BIN), $($(MODULE)_BIN), $(JDK_OUTPUTDIR)/modules)
104
105 $(eval $(call SetupJavaCompilation, $(MODULE), \
106 SMALL_JAVA := false, \
107 MODULE := $(MODULE), \
108 SRC := $(wildcard $(MODULE_SRC_DIRS)), \
109 INCLUDES := $(JDK_USER_DEFINED_FILTER), \
110 FAIL_NO_SRC := $(FAIL_NO_SRC), \
111 BIN := $(COMPILATION_OUTPUTDIR), \
112 HEADERS := $(SUPPORT_OUTPUTDIR)/headers, \
113 CREATE_API_DIGEST := true, \
114 CLEAN := $(CLEAN), \
115 CLEAN_FILES := $(CLEAN_FILES), \
116 COPY := $(COPY), \
117 DISABLED_WARNINGS := $(DISABLED_WARNINGS_java), \
118 EXCLUDES := $(EXCLUDES), \
119 EXCLUDE_FILES := $(EXCLUDE_FILES), \
120 EXCLUDE_PATTERNS := -files, \
121 KEEP_ALL_TRANSLATIONS := $(KEEP_ALL_TRANSLATIONS), \
122 TARGET_RELEASE := $(TARGET_RELEASE), \
123 JAVAC_FLAGS := \
124 $(DOCLINT) \
125 $(JAVAC_FLAGS) \
126 --module-source-path $(MODULESOURCEPATH) \
127 --module-path $(MODULEPATH) \
128 --system none, \
129 ))
130
131 TARGETS += $($(MODULE))
132
133 ################################################################################
134 # Setup compilation for value classes in the module
135 # TBD: When $(DOCLINT) was included there was an NPE in JavacTypes.getOverriddenMethods
136
137 # Directory and file name suffix for jar file containing value classes
138 VALUECLASSES_STR := valueclasses
139
140 ifneq ($(COMPILER), bootjdk)
141 MODULE_VALUECLASS_SRC_DIRS := $(call FindModuleValueClassSrcDirs, $(MODULE))
142 MODULE_VALUECLASS_SOURCEPATH := $(call GetModuleValueClassSrcPath)
143
144 # Temporarily compile valueclasses into a separate directory with the form:
145 # <tempdir>/<module>/<classpath>
146 # and then copy the class files into:
147 # <outdir>/<module>/META-INF/preview/<classpath>
148 # We cannot compile directly into the desired directory because it's the
149 # compiler which creates the original '<module>/<classpath>/...' hierarchy.
150 VALUECLASS_OUTPUTDIR := $(SUPPORT_OUTPUTDIR)/$(VALUECLASSES_STR)
151 PREVIEW_OUTPUTDIR := $(COMPILATION_OUTPUTDIR)/$(MODULE)/META-INF/preview
152
153 ifneq ($(MODULE_VALUECLASS_SRC_DIRS),)
154 $(eval $(call SetupJavaCompilation, $(MODULE)-$(VALUECLASSES_STR), \
155 SMALL_JAVA := false, \
156 MODULE := $(MODULE), \
157 SRC := $(wildcard $(MODULE_VALUECLASS_SRC_DIRS)), \
158 INCLUDES := $(JDK_USER_DEFINED_FILTER), \
159 FAIL_NO_SRC := $(FAIL_NO_SRC), \
160 BIN := $(VALUECLASS_OUTPUTDIR)/, \
161 JAR := $(JDK_OUTPUTDIR)/lib/$(VALUECLASSES_STR)/$(MODULE)-$(VALUECLASSES_STR).jar, \
162 HEADERS := $(SUPPORT_OUTPUTDIR)/headers, \
163 DISABLED_WARNINGS := $(DISABLED_WARNINGS_java) preview, \
164 EXCLUDES := $(EXCLUDES), \
165 EXCLUDE_FILES := $(EXCLUDE_FILES) \
166 KEEP_ALL_TRANSLATIONS := $(KEEP_ALL_TRANSLATIONS), \
167 DEPENDS := $($(MODULE)), \
168 JAVAC_FLAGS := \
169 $(JAVAC_FLAGS) \
170 --module-source-path $(MODULE_VALUECLASS_SOURCEPATH) \
171 --module-path $(JDK_OUTPUTDIR)/modules \
172 --system none \
173 --enable-preview -source $(JDK_SOURCE_TARGET_VERSION), \
174 ))
175
176 TARGETS += $($(MODULE)-$(VALUECLASSES_STR))
177
178 # Restructure the value class hierarchy from "<module>/<classpath>/..."
179 # to "<module>/META-INF/preview/<classpath>/..."
180 # When module patching is removed, this could probably be a move rather than a copy.
181
182 # FIXME: The marker file should probably go in modules root dir.
183 # FIXME: Copying value classes should not also copy marker files.
184 $(PREVIEW_OUTPUTDIR)/_the.copy_valueclasses.marker: $($(MODULE)-$(VALUECLASSES_STR))
185 $(call MakeTargetDir)
186 $(CP) -R $(VALUECLASS_OUTPUTDIR)/$(MODULE)/. $(@D)/
187 $(TOUCH) $@
188
189 TARGETS += $(PREVIEW_OUTPUTDIR)/_the.copy_valueclasses.marker
190
191 $(eval $(call SetupCopyFiles, $(MODULE)-copy-valueclass-jar, \
192 FILES := $(JDK_OUTPUTDIR)/lib/$(VALUECLASSES_STR)/$(MODULE)-$(VALUECLASSES_STR).jar, \
193 DEST := $(SUPPORT_OUTPUTDIR)/modules_libs/$(MODULE)/$(VALUECLASSES_STR), \
194 ))
195
196 TARGETS += $($(MODULE)-copy-valueclass-jar)
197 endif
198 endif
199
200 # Declare dependencies between java compilations of different modules.
201 # Since the other modules are declared in different invocations of this file,
202 # use the macro to find the correct target file to depend on.
203 # Only the javac compilation actually depends on other modules so limit
204 # dependency declaration to that by using the *_MODFILELIST variable.
205 $($(MODULE)_MODFILELIST): $(foreach d, $(call FindDepsForModule, $(MODULE)), \
206 $(call SetupJavaCompilationApiTarget, $d, \
207 $(if $($d_BIN), $($d_BIN), $(JDK_OUTPUTDIR)/modules/$d)))
208
209 ################################################################################
210 # If this is an imported module, copy the pre built classes and resources into
211 # the modules output dir
212
213 ifneq ($(wildcard $(IMPORT_MODULE_DIR)), )
214 $(JDK_OUTPUTDIR)/modules/$(MODULE)/_imported.marker: \
215 $(call FindFiles, $(IMPORT_MODULE_DIR))
216 $(call MakeDir, $(@D))
217 # Do not delete marker and build meta data files
218 $(RM) -r $(filter-out $(@D)/_%, $(wildcard $(@D)/*))
219 $(CP) -R $(IMPORT_MODULE_DIR)/* $(@D)/
220 $(TOUCH) $@
221
222 TARGETS += $(JDK_OUTPUTDIR)/modules/$(MODULE)/_imported.marker
223
224 # Add this dependency to avoid a race between compiling module-info.java and
225 # importing the classes.
226 $($(MODULE)_COMPILE_TARGET): $(JDK_OUTPUTDIR)/modules/$(MODULE)/_imported.marker
227 endif
228
229 ################################################################################
230
231 include MakeFileEnd.gmk