JreCompat.java
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.tomcat.util.compat;
import java.io.File;
import java.io.IOException;
import java.lang.reflect.AccessibleObject;
import java.lang.reflect.Field;
import java.net.URI;
import java.net.URL;
import java.net.URLConnection;
import java.security.KeyStore.LoadStoreParameter;
import java.util.Deque;
import java.util.jar.JarFile;
import javax.net.ssl.SSLEngine;
import javax.net.ssl.SSLParameters;
import org.apache.tomcat.util.res.StringManager;
/**
* This is the base implementation class for JRE compatibility and provides an
* implementation based on Java 7. Sub-classes may extend this class and provide
* alternative implementations for later JRE versions
*/
public class JreCompat {
private static final int RUNTIME_MAJOR_VERSION = 7;
private static final JreCompat instance;
private static final boolean jre8Available;
private static final boolean jre9Available;
private static final boolean jre11Available;
private static final boolean jre16Available;
private static final boolean jre19Available;
private static final boolean jre21Available;
private static final StringManager sm = StringManager.getManager(JreCompat.class);
static {
// This is Tomcat 8 with a minimum Java version of Java 7.
// Look for the highest supported JVM first
if (Jre21Compat.isSupported()) {
instance = new Jre21Compat();
jre21Available = true;
jre19Available = true;
jre16Available = true;
jre9Available = true;
jre8Available = true;
} else if (Jre19Compat.isSupported()) {
instance = new Jre19Compat();
jre21Available = false;
jre19Available = true;
jre16Available = true;
jre9Available = true;
jre8Available = true;
} else if (Jre16Compat.isSupported()) {
instance = new Jre16Compat();
jre21Available = false;
jre19Available = false;
jre16Available = true;
jre9Available = true;
jre8Available = true;
} else if (Jre9Compat.isSupported()) {
instance = new Jre9Compat();
jre21Available = false;
jre19Available = false;
jre16Available = false;
jre9Available = true;
jre8Available = true;
} else if (Jre8Compat.isSupported()) {
instance = new Jre8Compat();
jre21Available = false;
jre19Available = false;
jre16Available = false;
jre9Available = false;
jre8Available = true;
} else {
instance = new JreCompat();
jre21Available = false;
jre19Available = false;
jre16Available = false;
jre9Available = false;
jre8Available = false;
}
jre11Available = instance.jarFileRuntimeMajorVersion() >= 11;
}
public static JreCompat getInstance() {
return instance;
}
public static boolean isAlpnSupported() {
return isJre9Available() || (isJre8Available() && Jre8Compat.isAlpnSupported());
}
public static boolean isJre8Available() {
return jre8Available;
}
public static boolean isJre9Available() {
return jre9Available;
}
public static boolean isJre11Available() {
return jre11Available;
}
public static boolean isJre16Available() {
return jre16Available;
}
public static boolean isJre19Available() {
return jre19Available;
}
public static boolean isJre21Available() {
return jre21Available;
}
// Java 7 implementation of Java 8 methods
@SuppressWarnings("unused")
public void setUseServerCipherSuitesOrder(SSLParameters engine, boolean useCipherSuitesOrder) {
throw new UnsupportedOperationException(sm.getString("jreCompat.noServerCipherSuiteOrder"));
}
@SuppressWarnings("unused")
public LoadStoreParameter getDomainLoadStoreParameter(URI uri) {
throw new UnsupportedOperationException(sm.getString("jreCompat.noDomainLoadStoreParameter"));
}
// Java 7 implementation of Java 9 methods
/**
* Test if the provided exception is an instance of
* java.lang.reflect.InaccessibleObjectException.
*
* @param t The exception to test
*
* @return {@code true} if the exception is an instance of
* InaccessibleObjectException, otherwise {@code false}
*/
public boolean isInstanceOfInaccessibleObjectException(Throwable t) {
// Exception does not exist prior to Java 9
return false;
}
/**
* Set the application protocols the server will accept for ALPN
*
* @param sslParameters The SSL parameters for a connection
* @param protocols The application protocols to be allowed for that
* connection
*/
public void setApplicationProtocols(SSLParameters sslParameters, String[] protocols) {
throw new UnsupportedOperationException(sm.getString("jreCompat.noApplicationProtocols"));
}
/**
* Get the application protocol that has been negotiated for connection
* associated with the given SSLEngine.
*
* @param sslEngine The SSLEngine for which to obtain the negotiated
* protocol
*
* @return The name of the negotiated protocol
*/
public String getApplicationProtocol(SSLEngine sslEngine) {
throw new UnsupportedOperationException(sm.getString("jreCompat.noApplicationProtocol"));
}
/**
* Disables caching for JAR URL connections. For Java 8 and earlier, this also disables
* caching for ALL URL connections.
*
* @throws IOException If a dummy JAR URLConnection can not be created
*/
public void disableCachingForJarUrlConnections() throws IOException {
// Doesn't matter that this JAR doesn't exist - just as
// long as the URL is well-formed
URL url = new URL("jar:file://dummy.jar!/");
URLConnection uConn = url.openConnection();
uConn.setDefaultUseCaches(false);
}
/**
* Obtains the URLs for all the JARs on the module path when the JVM starts
* and adds them to the provided Deque.
*
* @param classPathUrlsToProcess The Deque to which the modules should be
* added
*/
public void addBootModulePath(Deque<URL> classPathUrlsToProcess) {
// NO-OP for Java 7. There is no module path.
}
/**
* Creates a new JarFile instance. When running on Java 9 and later, the
* JarFile will be multi-release JAR aware. While this isn't strictly
* required to be in this package, it is provided as a convenience method.
*
* @param s The JAR file to open
*
* @return A JarFile instance based on the provided path
*
* @throws IOException If an I/O error occurs creating the JarFile instance
*/
public final JarFile jarFileNewInstance(String s) throws IOException {
return jarFileNewInstance(new File(s));
}
/**
* Creates a new JarFile instance. When running on Java 9 and later, the
* JarFile will be multi-release JAR aware.
*
* @param f The JAR file to open
*
* @return A JarFile instance based on the provided file
*
* @throws IOException If an I/O error occurs creating the JarFile instance
*/
public JarFile jarFileNewInstance(File f) throws IOException {
return new JarFile(f);
}
/**
* Is this JarFile a multi-release JAR file.
*
* @param jarFile The JarFile to test
*
* @return {@code true} If it is a multi-release JAR file and is configured
* to behave as such.
*/
public boolean jarFileIsMultiRelease(JarFile jarFile) {
// Java 8 doesn't support multi-release so default to false
return false;
}
public int jarFileRuntimeMajorVersion() {
return RUNTIME_MAJOR_VERSION;
}
/**
* Is the accessibleObject accessible (as a result of appropriate module
* exports) on the provided instance?
*
* @param base The specific instance to be tested.
* @param accessibleObject The method/field/constructor to be tested.
*
* @return {code true} if the AccessibleObject can be accessed otherwise
* {code false}
*/
public boolean canAccess(Object base, AccessibleObject accessibleObject) {
// Java 8 doesn't support modules so default to true
return true;
}
/**
* Is the given class in an exported package?
*
* @param type The class to test
*
* @return Always {@code true} for Java 8. {@code true} if the enclosing
* package is exported for Java 9+
*/
public boolean isExported(Class<?> type) {
return true;
}
/**
* What is the module of the given class?
*
* @param type The class to test
*
* @return Always {@code true} for Java 8. {@code true} if the enclosing
* package is exported for Java 9+
*/
public String getModuleName(Class<?> type) {
return "NO_MODULE_JAVA_8";
}
// Java 7 implementations of Java 19 methods
/**
* Obtains the executor, if any, used to create the provided thread.
*
* @param thread The thread to examine
*
* @return The executor, if any, that created the provided thread
*
* @throws NoSuchFieldException
* If a field used via reflection to obtain the executor cannot
* be found
* @throws SecurityException
* If a security exception occurs while trying to identify the
* executor
* @throws IllegalArgumentException
* If the instance object does not match the class of the field
* when obtaining a field value via reflection
* @throws IllegalAccessException
* If a field is not accessible due to access restrictions
*/
public Object getExecutor(Thread thread)
throws NoSuchFieldException, SecurityException, IllegalArgumentException, IllegalAccessException {
Object result = null;
// Runnable wrapped by Thread
// "target" in Sun/Oracle JDK
// "runnable" in IBM JDK
// "action" in Apache Harmony
Object target = null;
for (String fieldName : new String[] { "target", "runnable", "action" }) {
try {
Field targetField = thread.getClass().getDeclaredField(fieldName);
targetField.setAccessible(true);
target = targetField.get(thread);
break;
} catch (NoSuchFieldException nfe) {
continue;
}
}
// "java.util.concurrent" code is in public domain,
// so all implementations are similar including our
// internal fork.
if (target != null && target.getClass().getCanonicalName() != null &&
(target.getClass().getCanonicalName().equals(
"org.apache.tomcat.util.threads.ThreadPoolExecutor.Worker") ||
target.getClass().getCanonicalName().equals(
"java.util.concurrent.ThreadPoolExecutor.Worker"))) {
Field executorField = target.getClass().getDeclaredField("this$0");
executorField.setAccessible(true);
result = executorField.get(target);
}
return result;
}
// Java 7 implementations of Java 21 methods
/**
* Create a thread builder for virtual threads using the given name to name the threads.
*
* @param name The base name for the threads
*
* @return The thread buidler for virtual threads
*/
public Object createVirtualThreadBuilder(String name) {
throw new UnsupportedOperationException(sm.getString("jreCompat.noVirtualThreads"));
}
/**
* Create a thread with the given thread builder and use it to execute the given runnable.
*
* @param threadBuilder The thread builder to use to create a thread
* @param command The command to run
*/
public void threadBuilderStart(Object threadBuilder, Runnable command) {
throw new UnsupportedOperationException(sm.getString("jreCompat.noVirtualThreads"));
}
}