annotate jvmci/jdk.vm.ci.services/src/jdk/vm/ci/services/Services.java @ 23692:93be30973b26

don't crash if Services is used but -XX:-EnableJVMCI - just return null
author Doug Simon <doug.simon@oracle.com>
date Thu, 16 Jun 2016 18:23:03 +0200
parents f84a5ac3be22
children a8378ff1936d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
1 /*
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
2 * Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
4 *
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
7 * published by the Free Software Foundation.
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
8 *
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
9 * This code is distributed in the hope that it will be useful, but WITHOUT
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
12 * version 2 for more details (a copy is included in the LICENSE file that
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
13 * accompanied this code).
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
14 *
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
15 * You should have received a copy of the GNU General Public License version
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
16 * 2 along with this work; if not, write to the Free Software Foundation,
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
18 *
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
20 * or visit www.oracle.com if you need additional information or have any
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
21 * questions.
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
22 */
22761
f2206f5bb62e removed @ServiceProvider mechanism (GRAAL-1380)
Doug Simon <doug.simon@oracle.com>
parents: 22672
diff changeset
23 package jdk.vm.ci.services;
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
24
23408
f84a5ac3be22 make JVMCI JDK immutable and sharable among different JVMCI clients
Doug Simon <doug.simon@oracle.com>
parents: 23380
diff changeset
25 import java.util.ArrayList;
22569
ec96f33a101d updated imports to be explicit and added checkstyle rule to forbid * imports
Doug Simon <doug.simon@oracle.com>
parents: 22430
diff changeset
26 import java.util.Collections;
ec96f33a101d updated imports to be explicit and added checkstyle rule to forbid * imports
Doug Simon <doug.simon@oracle.com>
parents: 22430
diff changeset
27 import java.util.Formatter;
ec96f33a101d updated imports to be explicit and added checkstyle rule to forbid * imports
Doug Simon <doug.simon@oracle.com>
parents: 22430
diff changeset
28 import java.util.List;
23408
f84a5ac3be22 make JVMCI JDK immutable and sharable among different JVMCI clients
Doug Simon <doug.simon@oracle.com>
parents: 23380
diff changeset
29 import java.util.ServiceLoader;
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
30
22569
ec96f33a101d updated imports to be explicit and added checkstyle rule to forbid * imports
Doug Simon <doug.simon@oracle.com>
parents: 22430
diff changeset
31 import sun.reflect.Reflection;
21607
71b338926f2e moved JVMCI classes into their own distributions (JBS:GRAAL-53)
Doug Simon <doug.simon@oracle.com>
parents: 21604
diff changeset
32
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
33 /**
21937
3a292e8b9e51 replaced Service marker interface with non-standard META-INF directory names to differentiate JVMCI providers from standard service providers
Doug Simon <doug.simon@oracle.com>
parents: 21895
diff changeset
34 * An mechanism for accessing service providers via JVMCI. These providers are loaded via a JVMCI
3a292e8b9e51 replaced Service marker interface with non-standard META-INF directory names to differentiate JVMCI providers from standard service providers
Doug Simon <doug.simon@oracle.com>
parents: 21895
diff changeset
35 * class loader that is hidden from application code. Hence the {@link SecurityManager} checks in
3a292e8b9e51 replaced Service marker interface with non-standard META-INF directory names to differentiate JVMCI providers from standard service providers
Doug Simon <doug.simon@oracle.com>
parents: 21895
diff changeset
36 * {@link #load(Class)} and {@link #loadSingle(Class, boolean)}.
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
37 */
21941
ef76ce87cc13 Services cannot be sub-classes or instantiated
Doug Simon <doug.simon@oracle.com>
parents: 21937
diff changeset
38 public final class Services {
ef76ce87cc13 Services cannot be sub-classes or instantiated
Doug Simon <doug.simon@oracle.com>
parents: 21937
diff changeset
39
ef76ce87cc13 Services cannot be sub-classes or instantiated
Doug Simon <doug.simon@oracle.com>
parents: 21937
diff changeset
40 private Services() {
ef76ce87cc13 Services cannot be sub-classes or instantiated
Doug Simon <doug.simon@oracle.com>
parents: 21937
diff changeset
41 }
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
42
23692
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
43 private static boolean jvmciEnabled = true;
21675
2e8c01def9a5 moved [AMD64|SPARC]HotSpotJVMCIBackendFactory into JVMCI namespace (JBS:GRAAL-53)
Doug Simon <doug.simon@oracle.com>
parents: 21662
diff changeset
44
21887
543f150e7fa0 com.oracle.jvmci.service.Service is now a marker for service implementations available via JVMCI; removed Truffle -> JVMCI dependency
Doug Simon <doug.simon@oracle.com>
parents: 21799
diff changeset
45 private static final ClassValue<List<?>> cache = new ClassValue<List<?>>() {
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
46 @Override
21887
543f150e7fa0 com.oracle.jvmci.service.Service is now a marker for service implementations available via JVMCI; removed Truffle -> JVMCI dependency
Doug Simon <doug.simon@oracle.com>
parents: 21799
diff changeset
47 protected List<?> computeValue(Class<?> type) {
23692
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
48 List<Object> impls = new ArrayList<>();
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
49 if (jvmciEnabled) {
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
50 try {
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
51 for (Object impl : ServiceLoader.load(type, getJVMCIClassLoader())) {
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
52 impls.add(impl);
21799
10f28849c1ec improve error message when JVMCI services are not found
Doug Simon <doug.simon@oracle.com>
parents: 21798
diff changeset
53 }
23692
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
54 } catch (InternalError e) {
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
55 if (e.getMessage().equals("JVMCI is not enabled")) {
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
56 jvmciEnabled = false;
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
57 } else {
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
58 throw e;
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
59 }
21675
2e8c01def9a5 moved [AMD64|SPARC]HotSpotJVMCIBackendFactory into JVMCI namespace (JBS:GRAAL-53)
Doug Simon <doug.simon@oracle.com>
parents: 21662
diff changeset
60 }
2e8c01def9a5 moved [AMD64|SPARC]HotSpotJVMCIBackendFactory into JVMCI namespace (JBS:GRAAL-53)
Doug Simon <doug.simon@oracle.com>
parents: 21662
diff changeset
61 }
23692
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
62 return impls;
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
63 }
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
64 };
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
65
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
66 /**
23369
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
67 * Performs any required security checks and dynamic reconfiguration to allow the module of a
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
68 * given class to access the classes in the JVMCI module.
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
69 *
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
70 * Note: This API exists to provide backwards compatibility for JVMCI clients compiled against a
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
71 * JDK release earlier than 9.
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
72 *
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
73 * @param requestor a class requesting access to the JVMCI module for its module
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
74 * @throws SecurityException if a security manager is present and it denies
23380
cd8fd4cced6c added JVMCIPermission (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23369
diff changeset
75 * {@link JVMCIPermission}
23369
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
76 */
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
77 public static void exportJVMCITo(Class<?> requestor) {
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
78 // There are no modules in JVMCI-8.
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
79 }
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
80
5aa3b3a72e35 jdk.vm.ci needs to securely export services (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23359
diff changeset
81 /**
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
82 * Gets an {@link Iterable} of the JVMCI providers available for a given service.
21636
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
83 *
23297
4b58c92e939b remove redundant modifiers
Manuel Rigger <rigger.manuel@gmail.com>
parents: 22761
diff changeset
84 * @throws SecurityException if a security manager is present and it denies <tt>
23359
9779df770504 align the permission checked by Services with jvmci-9
Doug Simon <doug.simon@oracle.com>
parents: 23297
diff changeset
85 * {@link RuntimePermission}("jvmci")</tt>
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
86 */
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
87 @SuppressWarnings("unchecked")
21887
543f150e7fa0 com.oracle.jvmci.service.Service is now a marker for service implementations available via JVMCI; removed Truffle -> JVMCI dependency
Doug Simon <doug.simon@oracle.com>
parents: 21799
diff changeset
88 public static <S> Iterable<S> load(Class<S> service) {
21636
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
89 SecurityManager sm = System.getSecurityManager();
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
90 if (sm != null) {
23380
cd8fd4cced6c added JVMCIPermission (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23369
diff changeset
91 sm.checkPermission(new JVMCIPermission());
21636
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
92 }
21760
55058b8000ea updated javadoc to document that JVMCI services are disjoint from the standard service loading mechanism and tightened generic type constraint such that Services and @ServiceProcessor can only be used with classes implementing Service
Doug Simon <doug.simon@oracle.com>
parents: 21675
diff changeset
93 try {
55058b8000ea updated javadoc to document that JVMCI services are disjoint from the standard service loading mechanism and tightened generic type constraint such that Services and @ServiceProcessor can only be used with classes implementing Service
Doug Simon <doug.simon@oracle.com>
parents: 21675
diff changeset
94 return (Iterable<S>) cache.get(service);
55058b8000ea updated javadoc to document that JVMCI services are disjoint from the standard service loading mechanism and tightened generic type constraint such that Services and @ServiceProcessor can only be used with classes implementing Service
Doug Simon <doug.simon@oracle.com>
parents: 21675
diff changeset
95 } catch (UnsatisfiedLinkError e) {
55058b8000ea updated javadoc to document that JVMCI services are disjoint from the standard service loading mechanism and tightened generic type constraint such that Services and @ServiceProcessor can only be used with classes implementing Service
Doug Simon <doug.simon@oracle.com>
parents: 21675
diff changeset
96 return Collections.emptyList();
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
97 }
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
98 }
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
99
21614
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
100 /**
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
101 * Gets the JVMCI provider for a given service for which at most one provider must be available.
21614
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
102 *
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
103 * @param service the service whose provider is being requested
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
104 * @param required specifies if an {@link InternalError} should be thrown if no provider of
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
105 * {@code service} is available
23297
4b58c92e939b remove redundant modifiers
Manuel Rigger <rigger.manuel@gmail.com>
parents: 22761
diff changeset
106 * @throws SecurityException if a security manager is present and it denies <tt>
23359
9779df770504 align the permission checked by Services with jvmci-9
Doug Simon <doug.simon@oracle.com>
parents: 23297
diff changeset
107 * {@link RuntimePermission}("jvmci")</tt>
21614
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
108 */
21887
543f150e7fa0 com.oracle.jvmci.service.Service is now a marker for service implementations available via JVMCI; removed Truffle -> JVMCI dependency
Doug Simon <doug.simon@oracle.com>
parents: 21799
diff changeset
109 @SuppressWarnings({"unchecked"})
543f150e7fa0 com.oracle.jvmci.service.Service is now a marker for service implementations available via JVMCI; removed Truffle -> JVMCI dependency
Doug Simon <doug.simon@oracle.com>
parents: 21799
diff changeset
110 public static <S> S loadSingle(Class<S> service, boolean required) {
21636
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
111 SecurityManager sm = System.getSecurityManager();
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
112 if (sm != null) {
23380
cd8fd4cced6c added JVMCIPermission (JDK-8155023)
Doug Simon <doug.simon@oracle.com>
parents: 23369
diff changeset
113 sm.checkPermission(new JVMCIPermission());
21636
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
114 }
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
115 Iterable<S> providers;
21760
55058b8000ea updated javadoc to document that JVMCI services are disjoint from the standard service loading mechanism and tightened generic type constraint such that Services and @ServiceProcessor can only be used with classes implementing Service
Doug Simon <doug.simon@oracle.com>
parents: 21675
diff changeset
116 try {
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
117 providers = (Iterable<S>) cache.get(service);
21760
55058b8000ea updated javadoc to document that JVMCI services are disjoint from the standard service loading mechanism and tightened generic type constraint such that Services and @ServiceProcessor can only be used with classes implementing Service
Doug Simon <doug.simon@oracle.com>
parents: 21675
diff changeset
118 } catch (UnsatisfiedLinkError e) {
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
119 providers = Collections.emptyList();
21614
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
120 }
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
121
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
122 S singleProvider = null;
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
123 for (S provider : providers) {
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
124 if (singleProvider != null) {
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
125 throw new InternalError(String.format("Multiple %s providers found: %s, %s", service.getName(), singleProvider.getClass().getName(), provider.getClass().getName()));
21614
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
126 }
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
127 singleProvider = provider;
21614
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
128 }
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
129 if (singleProvider == null && required) {
21614
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
130 String javaHome = System.getProperty("java.home");
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
131 String vmName = System.getProperty("java.vm.name");
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
132 Formatter errorMessage = new Formatter();
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
133 errorMessage.format("The VM does not expose required service %s.%n", service.getName());
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
134 errorMessage.format("Currently used Java home directory is %s.%n", javaHome);
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
135 errorMessage.format("Currently used VM configuration is: %s", vmName);
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
136 throw new UnsupportedOperationException(errorMessage.toString());
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
137 }
21895
763db13bd6f4 reworded Service documentation to be interms of "providers" instead of "implementations" to better match documentation for the standard ServiceLoader mechanism
Doug Simon <doug.simon@oracle.com>
parents: 21887
diff changeset
138 return singleProvider;
21614
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
139 }
2f92172fa320 Truffle and NFI implementations are now accessed via JVMCI services instead of being hard coded in the VM (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21607
diff changeset
140
21636
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
141 static {
23408
f84a5ac3be22 make JVMCI JDK immutable and sharable among different JVMCI clients
Doug Simon <doug.simon@oracle.com>
parents: 23380
diff changeset
142 Reflection.registerMethodsToFilter(Services.class, "getJVMCIClassLoader");
21636
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
143 Reflection.registerFieldsToFilter(Services.class, "cache");
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
144 }
6d9c8d0d0f7c added SecurityManager checks and field/method reflection hiding (JBS:GRAAL-51)
Doug Simon <doug.simon@oracle.com>
parents: 21633
diff changeset
145
23692
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
146 /**
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
147 * Gets the JVMCI class loader.
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
148 *
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
149 * @throws InternalError with the {@linkplain Throwable#getMessage() message}
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
150 * {@code "JVMCI is not enabled"} iff JVMCI is not enabled
93be30973b26 don't crash if Services is used but -XX:-EnableJVMCI - just return null
Doug Simon <doug.simon@oracle.com>
parents: 23408
diff changeset
151 */
23408
f84a5ac3be22 make JVMCI JDK immutable and sharable among different JVMCI clients
Doug Simon <doug.simon@oracle.com>
parents: 23380
diff changeset
152 private static native ClassLoader getJVMCIClassLoader();
15916
6aa352b260f4 removed use of ServiceLoader in runtime initialization
Doug Simon <doug.simon@oracle.com>
parents:
diff changeset
153 }