Package org.apache.tomcat.util.compat
Class JreCompat
- java.lang.Object
-
- org.apache.tomcat.util.compat.JreCompat
-
public class JreCompat extends Object
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
-
-
Constructor Summary
Constructors Constructor Description JreCompat()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddBootModulePath(Deque<URL> classPathUrlsToProcess)Obtains the URLs for all the JARs on the module path when the JVM starts and adds them to the provided Deque.booleancanAccess(Object base, AccessibleObject accessibleObject)Is the accessibleObject accessible (as a result of appropriate module exports) on the provided instance?voiddisableCachingForJarUrlConnections()Disables caching for JAR URL connections.StringgetApplicationProtocol(SSLEngine sslEngine)Get the application protocol that has been negotiated for connection associated with the given SSLEngine.KeyStore.LoadStoreParametergetDomainLoadStoreParameter(URI uri)static JreCompatgetInstance()StringgetModuleName(Class<?> type)What is the module of the given class?static booleanisAlpnSupported()booleanisExported(Class<?> type)Is the given class in an exported package?booleanisInstanceOfInaccessibleObjectException(Throwable t)Test if the provided exception is an instance of java.lang.reflect.InaccessibleObjectException.static booleanisJre11Available()static booleanisJre8Available()static booleanisJre9Available()booleanjarFileIsMultiRelease(JarFile jarFile)Is this JarFile a multi-release JAR file.JarFilejarFileNewInstance(File f)Creates a new JarFile instance.JarFilejarFileNewInstance(String s)Creates a new JarFile instance.intjarFileRuntimeMajorVersion()voidsetApplicationProtocols(SSLParameters sslParameters, String[] protocols)Set the application protocols the server will accept for ALPNvoidsetUseServerCipherSuitesOrder(SSLParameters engine, boolean useCipherSuitesOrder)
-
-
-
Method Detail
-
getInstance
public static JreCompat getInstance()
-
isJre8Available
public static boolean isJre8Available()
-
isJre11Available
public static boolean isJre11Available()
-
setUseServerCipherSuitesOrder
public void setUseServerCipherSuitesOrder(SSLParameters engine, boolean useCipherSuitesOrder)
-
getDomainLoadStoreParameter
public KeyStore.LoadStoreParameter getDomainLoadStoreParameter(URI uri)
-
isAlpnSupported
public static boolean isAlpnSupported()
-
isJre9Available
public static boolean isJre9Available()
-
isInstanceOfInaccessibleObjectException
public boolean isInstanceOfInaccessibleObjectException(Throwable t)
Test if the provided exception is an instance of java.lang.reflect.InaccessibleObjectException.- Parameters:
t- The exception to test- Returns:
trueif the exception is an instance of InaccessibleObjectException, otherwisefalse
-
setApplicationProtocols
public void setApplicationProtocols(SSLParameters sslParameters, String[] protocols)
Set the application protocols the server will accept for ALPN- Parameters:
sslParameters- The SSL parameters for a connectionprotocols- The application protocols to be allowed for that connection
-
getApplicationProtocol
public String getApplicationProtocol(SSLEngine sslEngine)
Get the application protocol that has been negotiated for connection associated with the given SSLEngine.- Parameters:
sslEngine- The SSLEngine for which to obtain the negotiated protocol- Returns:
- The name of the negotiated protocol
-
disableCachingForJarUrlConnections
public void disableCachingForJarUrlConnections() throws IOExceptionDisables 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
-
addBootModulePath
public void addBootModulePath(Deque<URL> classPathUrlsToProcess)
Obtains the URLs for all the JARs on the module path when the JVM starts and adds them to the provided Deque.- Parameters:
classPathUrlsToProcess- The Deque to which the modules should be added
-
jarFileNewInstance
public final JarFile jarFileNewInstance(String s) throws IOException
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.- Parameters:
s- The JAR file to open- Returns:
- A JarFile instance based on the provided path
- Throws:
IOException- If an I/O error occurs creating the JarFile instance
-
jarFileNewInstance
public JarFile jarFileNewInstance(File f) throws IOException
Creates a new JarFile instance. When running on Java 9 and later, the JarFile will be multi-release JAR aware.- Parameters:
f- The JAR file to open- Returns:
- A JarFile instance based on the provided file
- Throws:
IOException- If an I/O error occurs creating the JarFile instance
-
jarFileIsMultiRelease
public boolean jarFileIsMultiRelease(JarFile jarFile)
Is this JarFile a multi-release JAR file.- Parameters:
jarFile- The JarFile to test- Returns:
trueIf it is a multi-release JAR file and is configured to behave as such.
-
jarFileRuntimeMajorVersion
public int jarFileRuntimeMajorVersion()
-
canAccess
public boolean canAccess(Object base, AccessibleObject accessibleObject)
Is the accessibleObject accessible (as a result of appropriate module exports) on the provided instance?- Parameters:
base- The specific instance to be tested.accessibleObject- The method/field/constructor to be tested.- Returns:
- {code true} if the AccessibleObject can be accessed otherwise {code false}
-
isExported
public boolean isExported(Class<?> type)
Is the given class in an exported package?- Parameters:
type- The class to test- Returns:
- Always
truefor Java 8.trueif the enclosing package is exported for Java 9+
-
-