1 #
  2 # Copyright (c) 2014, 2026, 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   ifneq ($(MODULE_VALUECLASS_SRC_DIRS),)
144     # Temporarily compile valueclasses into a separate directory, and then copy
145     # into the correct "META-INF/preview" path location.
146     # We cannot compile directly into the desired directory because it's the
147     # compiler which creates the original '<module>/<classpath>/...' hierarchy.
148     TEMP_OUTPUTDIR := $(SUPPORT_OUTPUTDIR)/$(VALUECLASSES_STR)
149 
150     $(eval $(call SetupJavaCompilation, $(MODULE)-$(VALUECLASSES_STR), \
151         SMALL_JAVA := false, \
152         MODULE := $(MODULE), \
153         SRC := $(wildcard $(MODULE_VALUECLASS_SRC_DIRS)), \
154         INCLUDES := $(JDK_USER_DEFINED_FILTER), \
155         FAIL_NO_SRC := $(FAIL_NO_SRC), \
156         BIN := $(TEMP_OUTPUTDIR)/, \
157         HEADERS := $(SUPPORT_OUTPUTDIR)/headers, \
158         DISABLED_WARNINGS := $(DISABLED_WARNINGS_java) preview, \
159         EXCLUDES := $(EXCLUDES), \
160         EXCLUDE_FILES := $(EXCLUDE_FILES) \
161         KEEP_ALL_TRANSLATIONS := $(KEEP_ALL_TRANSLATIONS), \
162         DEPENDS := $($(MODULE)), \
163         JAVAC_FLAGS := \
164             $(JAVAC_FLAGS) \
165             --module-source-path $(MODULE_VALUECLASS_SOURCEPATH) \
166             --module-path $(JDK_OUTPUTDIR)/modules \
167             --system none \
168             --enable-preview -source $(JDK_SOURCE_TARGET_VERSION), \
169     ))
170 
171     # Don't add '$($(MODULE)-$(VALUECLASSES_STR))' to TARGETS (it's transient).
172     # The 'valueclasses' target below depends on it, and that's the non-transient
173     # result we care about.
174 
175     # Copy compiled output from "$TEMP_OUTPUTDIR/$MODULE/<classpath>/..."
176     # to "$COMPILATION_OUTPUTDIR/$MODULE/META-INF/preview/<classpath>/...".
177     MOD_SRC := $(TEMP_OUTPUTDIR)/$(MODULE)
178     MOD_DST := $(COMPILATION_OUTPUTDIR)/$(MODULE)
179 
180     # NOTE: We cannot use '$(CP) -R $(MOD_SRC)/*/ ...' to select sub-directories (it
181     # does not work on MacOS/BSD). Use 'filter-out' to explicitly exclude marker files.
182     $(MOD_DST)/_the.$(MODULE).valueclasses: $($(MODULE)-$(VALUECLASSES_STR))
183 		$(RM) -r $(@D)/META-INF/preview
184 		$(MKDIR) -p $(@D)/META-INF/preview
185 		$(CP) -R $(filter-out $(MOD_SRC)/_%, $(wildcard $(MOD_SRC)/*)) $(@D)/META-INF/preview
186 		$(TOUCH) $@
187 
188     TARGETS += $(MOD_DST)/_the.$(MODULE).valueclasses
189   endif
190 endif
191 
192 # Declare dependencies between java compilations of different modules.
193 # Since the other modules are declared in different invocations of this file,
194 # use the macro to find the correct target file to depend on.
195 # Only the javac compilation actually depends on other modules so limit
196 # dependency declaration to that by using the *_MODFILELIST variable.
197 $($(MODULE)_MODFILELIST): $(foreach d, $(call FindDepsForModule, $(MODULE)), \
198     $(call SetupJavaCompilationApiTarget, $d, \
199         $(if $($d_BIN), $($d_BIN), $(JDK_OUTPUTDIR)/modules/$d)))
200 
201 ################################################################################
202 # If this is an imported module, copy the pre built classes and resources into
203 # the modules output dir
204 
205 ifneq ($(wildcard $(IMPORT_MODULE_DIR)), )
206   $(JDK_OUTPUTDIR)/modules/$(MODULE)/_imported.marker: \
207       $(call FindFiles, $(IMPORT_MODULE_DIR))
208 	$(call MakeDir, $(@D))
209         # Do not delete marker and build meta data files
210 	$(RM) -r $(filter-out $(@D)/_%, $(wildcard $(@D)/*))
211 	$(CP) -R $(IMPORT_MODULE_DIR)/* $(@D)/
212 	$(TOUCH) $@
213 
214   TARGETS += $(JDK_OUTPUTDIR)/modules/$(MODULE)/_imported.marker
215 
216   # Add this dependency to avoid a race between compiling module-info.java and
217   # importing the classes.
218   $($(MODULE)_COMPILE_TARGET): $(JDK_OUTPUTDIR)/modules/$(MODULE)/_imported.marker
219 endif
220 
221 ################################################################################
222 
223 include MakeFileEnd.gmk
--- EOF ---