author | alanb |
Tue, 03 May 2016 09:09:57 +0100 | |
changeset 37779 | 7c84df693837 |
parent 36511 | 9d0388c6b336 |
child 39050 | 9de41b79ec7e |
permissions | -rw-r--r-- |
36511 | 1 |
/* |
2 |
* Copyright (c) 2013, 2016, 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 |
package java.lang.module; |
|
27 |
||
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
28 |
import java.io.PrintStream; |
36511 | 29 |
import java.lang.module.ModuleDescriptor.Requires.Modifier; |
30 |
import java.util.ArrayDeque; |
|
31 |
import java.util.ArrayList; |
|
32 |
import java.util.Collection; |
|
33 |
import java.util.Deque; |
|
34 |
import java.util.HashMap; |
|
35 |
import java.util.HashSet; |
|
36 |
import java.util.LinkedHashSet; |
|
37 |
import java.util.List; |
|
38 |
import java.util.Map; |
|
39 |
import java.util.Map.Entry; |
|
40 |
import java.util.Objects; |
|
41 |
import java.util.Optional; |
|
42 |
import java.util.Set; |
|
43 |
import java.util.StringJoiner; |
|
44 |
import java.util.stream.Collectors; |
|
45 |
||
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
46 |
import jdk.internal.module.ModuleHashes; |
36511 | 47 |
|
48 |
/** |
|
49 |
* The resolver used by {@link Configuration#resolveRequires} and |
|
50 |
* {@link Configuration#resolveRequiresAndUses}. |
|
51 |
*/ |
|
52 |
||
53 |
final class Resolver { |
|
54 |
||
55 |
private final ModuleFinder beforeFinder; |
|
56 |
private final Configuration parent; |
|
57 |
private final ModuleFinder afterFinder; |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
58 |
private final PrintStream traceOutput; |
36511 | 59 |
|
60 |
// maps module name to module reference |
|
61 |
private final Map<String, ModuleReference> nameToReference = new HashMap<>(); |
|
62 |
||
63 |
||
64 |
Resolver(ModuleFinder beforeFinder, |
|
65 |
Configuration parent, |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
66 |
ModuleFinder afterFinder, |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
67 |
PrintStream traceOutput) { |
36511 | 68 |
this.beforeFinder = beforeFinder; |
69 |
this.parent = parent; |
|
70 |
this.afterFinder = afterFinder; |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
71 |
this.traceOutput = traceOutput; |
36511 | 72 |
} |
73 |
||
74 |
||
75 |
/** |
|
76 |
* Resolves the given named modules. |
|
77 |
* |
|
78 |
* @throws ResolutionException |
|
79 |
*/ |
|
80 |
Resolver resolveRequires(Collection<String> roots) { |
|
81 |
||
82 |
// create the visit stack to get us started |
|
83 |
Deque<ModuleDescriptor> q = new ArrayDeque<>(); |
|
84 |
for (String root : roots) { |
|
85 |
||
86 |
// find root module |
|
87 |
ModuleReference mref = findWithBeforeFinder(root); |
|
88 |
if (mref == null) { |
|
89 |
if (parent.findModule(root).isPresent()) { |
|
90 |
// in parent, nothing to do |
|
91 |
continue; |
|
92 |
} |
|
93 |
mref = findWithAfterFinder(root); |
|
94 |
if (mref == null) { |
|
95 |
fail("Module %s not found", root); |
|
96 |
} |
|
97 |
} |
|
98 |
||
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
99 |
if (isTracing()) { |
36511 | 100 |
trace("Root module %s located", root); |
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
101 |
mref.location().ifPresent(uri -> trace(" (%s)", uri)); |
36511 | 102 |
} |
103 |
||
104 |
assert mref.descriptor().name().equals(root); |
|
105 |
nameToReference.put(root, mref); |
|
106 |
q.push(mref.descriptor()); |
|
107 |
} |
|
108 |
||
109 |
resolve(q); |
|
110 |
||
111 |
return this; |
|
112 |
} |
|
113 |
||
114 |
/** |
|
115 |
* Resolve all modules in the given queue. On completion the queue will be |
|
116 |
* empty and any resolved modules will be added to {@code nameToReference}. |
|
117 |
* |
|
118 |
* @return The set of module resolved by this invocation of resolve |
|
119 |
*/ |
|
120 |
private Set<ModuleDescriptor> resolve(Deque<ModuleDescriptor> q) { |
|
121 |
Set<ModuleDescriptor> resolved = new HashSet<>(); |
|
122 |
||
123 |
while (!q.isEmpty()) { |
|
124 |
ModuleDescriptor descriptor = q.poll(); |
|
125 |
assert nameToReference.containsKey(descriptor.name()); |
|
126 |
||
127 |
// process dependences |
|
128 |
for (ModuleDescriptor.Requires requires : descriptor.requires()) { |
|
129 |
String dn = requires.name(); |
|
130 |
||
131 |
// find dependence |
|
132 |
ModuleReference mref = findWithBeforeFinder(dn); |
|
133 |
if (mref == null) { |
|
134 |
if (parent.findModule(dn).isPresent()) |
|
135 |
continue; |
|
136 |
||
137 |
mref = findWithAfterFinder(dn); |
|
138 |
if (mref == null) { |
|
139 |
fail("Module %s not found, required by %s", |
|
140 |
dn, descriptor.name()); |
|
141 |
} |
|
142 |
} |
|
143 |
||
144 |
if (!nameToReference.containsKey(dn)) { |
|
145 |
nameToReference.put(dn, mref); |
|
146 |
q.offer(mref.descriptor()); |
|
147 |
resolved.add(mref.descriptor()); |
|
148 |
||
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
149 |
if (isTracing()) { |
36511 | 150 |
trace("Module %s located, required by %s", |
151 |
dn, descriptor.name()); |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
152 |
mref.location().ifPresent(uri -> trace(" (%s)", uri)); |
36511 | 153 |
} |
154 |
} |
|
155 |
||
156 |
} |
|
157 |
||
158 |
resolved.add(descriptor); |
|
159 |
} |
|
160 |
||
161 |
return resolved; |
|
162 |
} |
|
163 |
||
164 |
/** |
|
165 |
* Augments the set of resolved modules with modules induced by the |
|
166 |
* service-use relation. |
|
167 |
*/ |
|
168 |
Resolver resolveUses() { |
|
169 |
||
170 |
// Scan the finders for all available service provider modules. As |
|
171 |
// java.base uses services then then module finders will be scanned |
|
172 |
// anyway. |
|
173 |
Map<String, Set<ModuleReference>> availableProviders = new HashMap<>(); |
|
174 |
for (ModuleReference mref : findAll()) { |
|
175 |
ModuleDescriptor descriptor = mref.descriptor(); |
|
176 |
if (!descriptor.provides().isEmpty()) { |
|
177 |
||
178 |
for (String sn : descriptor.provides().keySet()) { |
|
179 |
// computeIfAbsent |
|
180 |
Set<ModuleReference> providers = availableProviders.get(sn); |
|
181 |
if (providers == null) { |
|
182 |
providers = new HashSet<>(); |
|
183 |
availableProviders.put(sn, providers); |
|
184 |
} |
|
185 |
providers.add(mref); |
|
186 |
} |
|
187 |
||
188 |
} |
|
189 |
} |
|
190 |
||
191 |
// create the visit stack |
|
192 |
Deque<ModuleDescriptor> q = new ArrayDeque<>(); |
|
193 |
||
194 |
// the initial set of modules that may use services |
|
195 |
Set<ModuleDescriptor> candidateConsumers = new HashSet<>(); |
|
196 |
Configuration p = parent; |
|
197 |
while (p != null) { |
|
198 |
candidateConsumers.addAll(p.descriptors()); |
|
199 |
p = p.parent().orElse(null); |
|
200 |
} |
|
201 |
for (ModuleReference mref : nameToReference.values()) { |
|
202 |
candidateConsumers.add(mref.descriptor()); |
|
203 |
} |
|
204 |
||
205 |
||
206 |
// Where there is a consumer of a service then resolve all modules |
|
207 |
// that provide an implementation of that service |
|
208 |
do { |
|
209 |
for (ModuleDescriptor descriptor : candidateConsumers) { |
|
210 |
if (!descriptor.uses().isEmpty()) { |
|
211 |
for (String service : descriptor.uses()) { |
|
212 |
Set<ModuleReference> mrefs = availableProviders.get(service); |
|
213 |
if (mrefs != null) { |
|
214 |
for (ModuleReference mref : mrefs) { |
|
215 |
ModuleDescriptor provider = mref.descriptor(); |
|
216 |
if (!provider.equals(descriptor)) { |
|
217 |
||
218 |
trace("Module %s provides %s, used by %s", |
|
219 |
provider.name(), service, descriptor.name()); |
|
220 |
||
221 |
String pn = provider.name(); |
|
222 |
if (!nameToReference.containsKey(pn)) { |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
223 |
if (isTracing()) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
224 |
mref.location() |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
225 |
.ifPresent(uri -> trace(" (%s)", uri)); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
226 |
} |
36511 | 227 |
nameToReference.put(pn, mref); |
228 |
q.push(provider); |
|
229 |
} |
|
230 |
} |
|
231 |
} |
|
232 |
} |
|
233 |
} |
|
234 |
} |
|
235 |
} |
|
236 |
||
237 |
candidateConsumers = resolve(q); |
|
238 |
||
239 |
} while (!candidateConsumers.isEmpty()); |
|
240 |
||
241 |
return this; |
|
242 |
} |
|
243 |
||
244 |
||
245 |
/** |
|
246 |
* Execute post-resolution checks and returns the module graph of resolved |
|
247 |
* modules as {@code Map}. The resolved modules will be in the given |
|
248 |
* configuration. |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
249 |
* |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
250 |
* @param check {@true} to execute the post resolution checks |
36511 | 251 |
*/ |
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
252 |
Map<ResolvedModule, Set<ResolvedModule>> finish(Configuration cf, |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
253 |
boolean check) |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
254 |
{ |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
255 |
if (isTracing()) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
256 |
trace("Result:"); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
257 |
Set<String> names = nameToReference.keySet(); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
258 |
names.stream().sorted().forEach(name -> trace(" %s", name)); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
259 |
} |
36511 | 260 |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
261 |
if (check) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
262 |
detectCycles(); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
263 |
checkPlatformConstraints(); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
264 |
checkHashes(); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
265 |
} |
36511 | 266 |
|
267 |
Map<ResolvedModule, Set<ResolvedModule>> graph = makeGraph(cf); |
|
268 |
||
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
269 |
if (check) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
270 |
checkExportSuppliers(graph); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
271 |
} |
36511 | 272 |
|
273 |
return graph; |
|
274 |
} |
|
275 |
||
276 |
/** |
|
277 |
* Checks the given module graph for cycles. |
|
278 |
* |
|
279 |
* For now the implementation is a simple depth first search on the |
|
280 |
* dependency graph. We'll replace this later, maybe with Tarjan. |
|
281 |
*/ |
|
282 |
private void detectCycles() { |
|
283 |
visited = new HashSet<>(); |
|
284 |
visitPath = new LinkedHashSet<>(); // preserve insertion order |
|
285 |
for (ModuleReference mref : nameToReference.values()) { |
|
286 |
visit(mref.descriptor()); |
|
287 |
} |
|
288 |
visited.clear(); |
|
289 |
} |
|
290 |
||
291 |
// the modules that were visited |
|
292 |
private Set<ModuleDescriptor> visited; |
|
293 |
||
294 |
// the modules in the current visit path |
|
295 |
private Set<ModuleDescriptor> visitPath; |
|
296 |
||
297 |
private void visit(ModuleDescriptor descriptor) { |
|
298 |
if (!visited.contains(descriptor)) { |
|
299 |
boolean added = visitPath.add(descriptor); |
|
300 |
if (!added) { |
|
301 |
throw new ResolutionException("Cycle detected: " + |
|
302 |
cycleAsString(descriptor)); |
|
303 |
} |
|
304 |
for (ModuleDescriptor.Requires requires : descriptor.requires()) { |
|
305 |
String dn = requires.name(); |
|
306 |
||
307 |
ModuleReference mref = nameToReference.get(dn); |
|
308 |
if (mref != null) { |
|
309 |
ModuleDescriptor other = mref.descriptor(); |
|
310 |
if (other != descriptor) { |
|
311 |
// dependency is in this configuration |
|
312 |
visit(other); |
|
313 |
} |
|
314 |
} |
|
315 |
} |
|
316 |
visitPath.remove(descriptor); |
|
317 |
visited.add(descriptor); |
|
318 |
} |
|
319 |
} |
|
320 |
||
321 |
/** |
|
322 |
* Returns a String with a list of the modules in a detected cycle. |
|
323 |
*/ |
|
324 |
private String cycleAsString(ModuleDescriptor descriptor) { |
|
325 |
List<ModuleDescriptor> list = new ArrayList<>(visitPath); |
|
326 |
list.add(descriptor); |
|
327 |
int index = list.indexOf(descriptor); |
|
328 |
return list.stream() |
|
329 |
.skip(index) |
|
330 |
.map(ModuleDescriptor::name) |
|
331 |
.collect(Collectors.joining(" -> ")); |
|
332 |
} |
|
333 |
||
334 |
||
335 |
/** |
|
336 |
* If there are platform specific modules then check that the OS name, |
|
337 |
* architecture and version match. |
|
338 |
* |
|
339 |
* @apiNote This method does not currently check if the OS matches |
|
340 |
* platform specific modules in parent configurations. |
|
341 |
*/ |
|
342 |
private void checkPlatformConstraints() { |
|
343 |
||
344 |
// first module encountered that is platform specific |
|
345 |
String savedModuleName = null; |
|
346 |
String savedOsName = null; |
|
347 |
String savedOsArch = null; |
|
348 |
String savedOsVersion = null; |
|
349 |
||
350 |
for (ModuleReference mref : nameToReference.values()) { |
|
351 |
ModuleDescriptor descriptor = mref.descriptor(); |
|
352 |
||
353 |
String osName = descriptor.osName().orElse(null); |
|
354 |
String osArch = descriptor.osArch().orElse(null); |
|
355 |
String osVersion = descriptor.osVersion().orElse(null); |
|
356 |
||
357 |
if (osName != null || osArch != null || osVersion != null) { |
|
358 |
||
359 |
if (savedModuleName == null) { |
|
360 |
||
361 |
savedModuleName = descriptor.name(); |
|
362 |
savedOsName = osName; |
|
363 |
savedOsArch = osArch; |
|
364 |
savedOsVersion = osVersion; |
|
365 |
||
366 |
} else { |
|
367 |
||
368 |
boolean matches = platformMatches(osName, savedOsName) |
|
369 |
&& platformMatches(osArch, savedOsArch) |
|
370 |
&& platformMatches(osVersion, savedOsVersion); |
|
371 |
||
372 |
if (!matches) { |
|
373 |
String s1 = platformAsString(savedOsName, |
|
374 |
savedOsArch, |
|
375 |
savedOsVersion); |
|
376 |
||
377 |
String s2 = platformAsString(osName, osArch, osVersion); |
|
378 |
fail("Mismatching constraints on target platform: " |
|
379 |
+ savedModuleName + ": " + s1 |
|
380 |
+ ", " + descriptor.name() + ": " + s2); |
|
381 |
} |
|
382 |
||
383 |
} |
|
384 |
||
385 |
} |
|
386 |
} |
|
387 |
||
388 |
} |
|
389 |
||
390 |
/** |
|
391 |
* Returns true if the s1 and s2 are equal or one of them is null. |
|
392 |
*/ |
|
393 |
private boolean platformMatches(String s1, String s2) { |
|
394 |
if (s1 == null || s2 == null) |
|
395 |
return true; |
|
396 |
else |
|
397 |
return Objects.equals(s1, s2); |
|
398 |
} |
|
399 |
||
400 |
/** |
|
401 |
* Return a string that encodes the OS name/arch/version. |
|
402 |
*/ |
|
403 |
private String platformAsString(String osName, |
|
404 |
String osArch, |
|
405 |
String osVersion) { |
|
406 |
||
407 |
return new StringJoiner("-") |
|
408 |
.add(Objects.toString(osName, "*")) |
|
409 |
.add(Objects.toString(osArch, "*")) |
|
410 |
.add(Objects.toString(osVersion, "*")) |
|
411 |
.toString(); |
|
412 |
||
413 |
} |
|
414 |
||
415 |
/** |
|
416 |
* Checks the hashes in the module descriptor to ensure that they match |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
417 |
* any recorded hashes. |
36511 | 418 |
*/ |
419 |
private void checkHashes() { |
|
420 |
for (ModuleReference mref : nameToReference.values()) { |
|
421 |
ModuleDescriptor descriptor = mref.descriptor(); |
|
422 |
||
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
423 |
// get map of module hashes |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
424 |
Optional<ModuleHashes> ohashes = descriptor.hashes(); |
36511 | 425 |
if (!ohashes.isPresent()) |
426 |
continue; |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
427 |
ModuleHashes hashes = ohashes.get(); |
36511 | 428 |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
429 |
String algorithm = hashes.algorithm(); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
430 |
for (String dn : hashes.names()) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
431 |
ModuleReference other = nameToReference.get(dn); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
432 |
if (other == null) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
433 |
other = parent.findModule(dn) |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
434 |
.map(ResolvedModule::reference) |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
435 |
.orElse(null); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
436 |
} |
36511 | 437 |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
438 |
// skip checking the hash if the module has been patched |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
439 |
if (other != null && !other.isPatched()) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
440 |
String recordedHash = hashes.hashFor(dn); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
441 |
String actualHash = other.computeHash(algorithm); |
36511 | 442 |
if (actualHash == null) |
443 |
fail("Unable to compute the hash of module %s", dn); |
|
444 |
if (!recordedHash.equals(actualHash)) { |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
445 |
fail("Hash of %s (%s) differs to expected hash (%s)" + |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
446 |
" recorded in %s", dn, actualHash, recordedHash, |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
447 |
descriptor.name()); |
36511 | 448 |
} |
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
449 |
} |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
450 |
} |
36511 | 451 |
|
452 |
} |
|
453 |
} |
|
454 |
||
455 |
||
456 |
/** |
|
457 |
* Computes and sets the readability graph for the modules in the given |
|
458 |
* Resolution object. |
|
459 |
* |
|
460 |
* The readability graph is created by propagating "requires" through the |
|
461 |
* "public requires" edges of the module dependence graph. So if the module |
|
462 |
* dependence graph has m1 requires m2 && m2 requires public m3 then the |
|
463 |
* resulting readability graph will contain m1 reads m2, m1 |
|
464 |
* reads m3, and m2 reads m3. |
|
465 |
* |
|
466 |
* TODO: Use a more efficient algorithm, maybe cache the requires public |
|
467 |
* in parent configurations. |
|
468 |
*/ |
|
469 |
private Map<ResolvedModule, Set<ResolvedModule>> makeGraph(Configuration cf) { |
|
470 |
||
471 |
// the "reads" graph starts as a module dependence graph and |
|
472 |
// is iteratively updated to be the readability graph |
|
473 |
Map<ResolvedModule, Set<ResolvedModule>> g1 = new HashMap<>(); |
|
474 |
||
475 |
// the "requires public" graph, contains requires public edges only |
|
476 |
Map<ResolvedModule, Set<ResolvedModule>> g2 = new HashMap<>(); |
|
477 |
||
478 |
||
479 |
// need "requires public" from the modules in parent configurations as |
|
480 |
// there may be selected modules that have a dependency on modules in |
|
481 |
// the parent configuration. |
|
482 |
||
483 |
Configuration p = parent; |
|
484 |
while (p != null) { |
|
485 |
for (ModuleDescriptor descriptor : p.descriptors()) { |
|
486 |
ResolvedModule x = p.findModule(descriptor.name()).orElse(null); |
|
487 |
if (x == null) |
|
488 |
throw new InternalError(); |
|
489 |
for (ModuleDescriptor.Requires requires : descriptor.requires()) { |
|
490 |
if (requires.modifiers().contains(Modifier.PUBLIC)) { |
|
491 |
String dn = requires.name(); |
|
492 |
ResolvedModule y = p.findModule(dn).orElse(null); |
|
493 |
if (y == null) |
|
494 |
throw new InternalError(dn + " not found"); |
|
495 |
g2.computeIfAbsent(x, k -> new HashSet<>()).add(y); |
|
496 |
} |
|
497 |
} |
|
498 |
} |
|
499 |
||
500 |
p = p.parent().orElse(null); |
|
501 |
} |
|
502 |
||
503 |
// populate g1 and g2 with the dependences from the selected modules |
|
504 |
for (ModuleReference mref : nameToReference.values()) { |
|
505 |
ModuleDescriptor descriptor = mref.descriptor(); |
|
506 |
ResolvedModule x = new ResolvedModule(cf, mref); |
|
507 |
||
508 |
Set<ResolvedModule> reads = new HashSet<>(); |
|
509 |
g1.put(x, reads); |
|
510 |
||
511 |
Set<ResolvedModule> requiresPublic = new HashSet<>(); |
|
512 |
g2.put(x, requiresPublic); |
|
513 |
||
514 |
for (ModuleDescriptor.Requires requires : descriptor.requires()) { |
|
515 |
String dn = requires.name(); |
|
516 |
||
517 |
ResolvedModule y; |
|
518 |
ModuleReference other = nameToReference.get(dn); |
|
519 |
if (other != null) { |
|
520 |
y = new ResolvedModule(cf, other); // cache? |
|
521 |
} else { |
|
522 |
y = parent.findModule(dn).orElse(null); |
|
523 |
if (y == null) |
|
524 |
throw new InternalError("unable to find " + dn); |
|
525 |
} |
|
526 |
||
527 |
// m requires other => m reads other |
|
528 |
reads.add(y); |
|
529 |
||
530 |
// m requires public other |
|
531 |
if (requires.modifiers().contains(Modifier.PUBLIC)) { |
|
532 |
requiresPublic.add(y); |
|
533 |
} |
|
534 |
||
535 |
} |
|
536 |
||
537 |
// automatic modules reads all selected modules and all modules |
|
538 |
// in parent configurations |
|
539 |
if (descriptor.isAutomatic()) { |
|
540 |
String name = descriptor.name(); |
|
541 |
||
542 |
// reads all selected modules |
|
543 |
// requires public` all selected automatic modules |
|
544 |
for (ModuleReference mref2 : nameToReference.values()) { |
|
545 |
ModuleDescriptor descriptor2 = mref2.descriptor(); |
|
546 |
if (!name.equals(descriptor2.name())) { |
|
547 |
ResolvedModule m = new ResolvedModule(cf, mref2); |
|
548 |
reads.add(m); |
|
549 |
if (descriptor2.isAutomatic()) |
|
550 |
requiresPublic.add(m); |
|
551 |
} |
|
552 |
} |
|
553 |
||
554 |
// reads all modules in parent configurations |
|
555 |
// `requires public` all automatic modules in parent configurations |
|
556 |
p = parent; |
|
557 |
while (p != null) { |
|
558 |
for (ResolvedModule m : p.modules()) { |
|
559 |
reads.add(m); |
|
560 |
if (m.reference().descriptor().isAutomatic()) |
|
561 |
requiresPublic.add(m); |
|
562 |
} |
|
563 |
p = p.parent().orElse(null); |
|
564 |
} |
|
565 |
||
566 |
} |
|
567 |
||
568 |
} |
|
569 |
||
570 |
// Iteratively update g1 until there are no more requires public to propagate |
|
571 |
boolean changed; |
|
572 |
Map<ResolvedModule, Set<ResolvedModule>> changes = new HashMap<>(); |
|
573 |
do { |
|
574 |
changed = false; |
|
575 |
for (Entry<ResolvedModule, Set<ResolvedModule>> entry : g1.entrySet()) { |
|
576 |
||
577 |
ResolvedModule m1 = entry.getKey(); |
|
578 |
Set<ResolvedModule> m1Reads = entry.getValue(); |
|
579 |
||
580 |
for (ResolvedModule m2 : m1Reads) { |
|
581 |
Set<ResolvedModule> m2RequiresPublic = g2.get(m2); |
|
582 |
if (m2RequiresPublic != null) { |
|
583 |
for (ResolvedModule m3 : m2RequiresPublic) { |
|
584 |
if (!m1Reads.contains(m3)) { |
|
585 |
||
586 |
// computeIfAbsent |
|
587 |
Set<ResolvedModule> s = changes.get(m1); |
|
588 |
if (s == null) { |
|
589 |
s = new HashSet<>(); |
|
590 |
changes.put(m1, s); |
|
591 |
} |
|
592 |
s.add(m3); |
|
593 |
changed = true; |
|
594 |
||
595 |
} |
|
596 |
} |
|
597 |
} |
|
598 |
} |
|
599 |
} |
|
600 |
||
601 |
if (changed) { |
|
602 |
for (Map.Entry<ResolvedModule, Set<ResolvedModule>> e : |
|
603 |
changes.entrySet()) { |
|
604 |
ResolvedModule m = e.getKey(); |
|
605 |
g1.get(m).addAll(e.getValue()); |
|
606 |
} |
|
607 |
changes.clear(); |
|
608 |
} |
|
609 |
||
610 |
} while (changed); |
|
611 |
||
612 |
||
613 |
return g1; |
|
614 |
} |
|
615 |
||
616 |
||
617 |
/** |
|
618 |
* Checks the readability graph to ensure that no two modules export the |
|
619 |
* same package to a module. This includes the case where module M has |
|
620 |
* a local package P and M reads another module that exports P to M. |
|
621 |
* Also checks the uses/provides of module M to ensure that it reads a |
|
622 |
* module that exports the package of the service type to M. |
|
623 |
*/ |
|
624 |
private void checkExportSuppliers(Map<ResolvedModule, Set<ResolvedModule>> graph) { |
|
625 |
||
626 |
for (Map.Entry<ResolvedModule, Set<ResolvedModule>> e : graph.entrySet()) { |
|
627 |
ModuleDescriptor descriptor1 = e.getKey().descriptor(); |
|
628 |
||
629 |
// the map of packages that are local or exported to descriptor1 |
|
630 |
Map<String, ModuleDescriptor> packageToExporter = new HashMap<>(); |
|
631 |
||
632 |
// local packages |
|
633 |
Set<String> packages = descriptor1.packages(); |
|
634 |
for (String pn : packages) { |
|
635 |
packageToExporter.put(pn, descriptor1); |
|
636 |
} |
|
637 |
||
638 |
// descriptor1 reads descriptor2 |
|
639 |
Set<ResolvedModule> reads = e.getValue(); |
|
640 |
for (ResolvedModule endpoint : reads) { |
|
641 |
ModuleDescriptor descriptor2 = endpoint.descriptor(); |
|
642 |
||
643 |
for (ModuleDescriptor.Exports export : descriptor2.exports()) { |
|
644 |
||
645 |
if (export.isQualified()) { |
|
646 |
if (!export.targets().contains(descriptor1.name())) |
|
647 |
continue; |
|
648 |
} |
|
649 |
||
650 |
// source is exported to descriptor2 |
|
651 |
String source = export.source(); |
|
652 |
ModuleDescriptor other |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
653 |
= packageToExporter.put(source, descriptor2); |
36511 | 654 |
|
655 |
if (other != null && other != descriptor2) { |
|
656 |
// package might be local to descriptor1 |
|
657 |
if (other == descriptor1) { |
|
658 |
fail("Module %s contains package %s" |
|
659 |
+ ", module %s exports package %s to %s", |
|
660 |
descriptor1.name(), |
|
661 |
source, |
|
662 |
descriptor2.name(), |
|
663 |
source, |
|
664 |
descriptor1.name()); |
|
665 |
} else { |
|
666 |
fail("Modules %s and %s export package %s to module %s", |
|
667 |
descriptor2.name(), |
|
668 |
other.name(), |
|
669 |
source, |
|
670 |
descriptor1.name()); |
|
671 |
} |
|
672 |
||
673 |
} |
|
674 |
} |
|
675 |
} |
|
676 |
||
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
677 |
// uses/provides checks not applicable to automatic modules |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
678 |
if (!descriptor1.isAutomatic()) { |
36511 | 679 |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
680 |
// uses S |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
681 |
for (String service : descriptor1.uses()) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
682 |
String pn = packageName(service); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
683 |
if (!packageToExporter.containsKey(pn)) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
684 |
fail("Module %s does not read a module that exports %s", |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
685 |
descriptor1.name(), pn); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
686 |
} |
36511 | 687 |
} |
688 |
||
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
689 |
// provides S |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
690 |
for (Map.Entry<String, ModuleDescriptor.Provides> entry : |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
691 |
descriptor1.provides().entrySet()) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
692 |
String service = entry.getKey(); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
693 |
ModuleDescriptor.Provides provides = entry.getValue(); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
694 |
|
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
695 |
String pn = packageName(service); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
696 |
if (!packageToExporter.containsKey(pn)) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
697 |
fail("Module %s does not read a module that exports %s", |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
698 |
descriptor1.name(), pn); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
699 |
} |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
700 |
|
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
701 |
for (String provider : provides.providers()) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
702 |
if (!packages.contains(packageName(provider))) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
703 |
fail("Provider %s not in module %s", |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
704 |
provider, descriptor1.name()); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
705 |
} |
36511 | 706 |
} |
707 |
} |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
708 |
|
36511 | 709 |
} |
710 |
||
711 |
} |
|
712 |
||
713 |
} |
|
714 |
||
715 |
||
716 |
/** |
|
717 |
* Invokes the beforeFinder to find method to find the given module. |
|
718 |
*/ |
|
719 |
private ModuleReference findWithBeforeFinder(String mn) { |
|
720 |
try { |
|
721 |
return beforeFinder.find(mn).orElse(null); |
|
722 |
} catch (FindException e) { |
|
723 |
// unwrap |
|
724 |
throw new ResolutionException(e.getMessage(), e.getCause()); |
|
725 |
} |
|
726 |
} |
|
727 |
||
728 |
/** |
|
729 |
* Invokes the afterFinder to find method to find the given module. |
|
730 |
*/ |
|
731 |
private ModuleReference findWithAfterFinder(String mn) { |
|
732 |
try { |
|
733 |
return afterFinder.find(mn).orElse(null); |
|
734 |
} catch (FindException e) { |
|
735 |
// unwrap |
|
736 |
throw new ResolutionException(e.getMessage(), e.getCause()); |
|
737 |
} |
|
738 |
} |
|
739 |
||
740 |
/** |
|
741 |
* Returns the set of all modules that are observable with the before |
|
742 |
* and after ModuleFinders. |
|
743 |
*/ |
|
744 |
private Set<ModuleReference> findAll() { |
|
745 |
try { |
|
746 |
||
747 |
Set<ModuleReference> beforeModules = beforeFinder.findAll(); |
|
748 |
Set<ModuleReference> afterModules = afterFinder.findAll(); |
|
749 |
||
750 |
if (afterModules.isEmpty()) |
|
751 |
return beforeModules; |
|
752 |
||
753 |
if (beforeModules.isEmpty() && parent == Configuration.empty()) |
|
754 |
return afterModules; |
|
755 |
||
756 |
Set<ModuleReference> result = new HashSet<>(beforeModules); |
|
757 |
for (ModuleReference mref : afterModules) { |
|
758 |
String name = mref.descriptor().name(); |
|
759 |
if (!beforeFinder.find(name).isPresent() |
|
760 |
&& !parent.findModule(name).isPresent()) |
|
761 |
result.add(mref); |
|
762 |
} |
|
763 |
||
764 |
return result; |
|
765 |
||
766 |
} catch (FindException e) { |
|
767 |
// unwrap |
|
768 |
throw new ResolutionException(e.getMessage(), e.getCause()); |
|
769 |
} |
|
770 |
} |
|
771 |
||
772 |
/** |
|
773 |
* Returns the package name |
|
774 |
*/ |
|
775 |
private static String packageName(String cn) { |
|
776 |
int index = cn.lastIndexOf("."); |
|
777 |
return (index == -1) ? "" : cn.substring(0, index); |
|
778 |
} |
|
779 |
||
780 |
/** |
|
781 |
* Throw ResolutionException with the given format string and arguments |
|
782 |
*/ |
|
783 |
private static void fail(String fmt, Object ... args) { |
|
784 |
String msg = String.format(fmt, args); |
|
785 |
throw new ResolutionException(msg); |
|
786 |
} |
|
787 |
||
788 |
/** |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
789 |
* Tracing support |
36511 | 790 |
*/ |
791 |
||
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
792 |
private boolean isTracing() { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
793 |
return traceOutput != null; |
36511 | 794 |
} |
795 |
||
796 |
private void trace(String fmt, Object ... args) { |
|
37779
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
797 |
if (traceOutput != null) { |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
798 |
traceOutput.format("[Resolver] " + fmt, args); |
7c84df693837
8154956: Module system implementation refresh (4/2016)
alanb
parents:
36511
diff
changeset
|
799 |
traceOutput.println(); |
36511 | 800 |
} |
801 |
} |
|
802 |
||
803 |
} |