Package org.apache.catalina.core

Class AprLifecycleListener

  • All Implemented Interfaces:
    LifecycleListener
    public class AprLifecycleListener
extends java.lang.Object
implements LifecycleListener
    Implementation of LifecycleListener that will init and destroy APR.

    This listener must only be nested within Server elements.

    Only one instance of the APR/Native library may be loaded per JVM. Loading multiple instances will trigger a JVM crash - typically when the Connectors are destroyed. This listener utilises reference counting to ensure that only one instance of the APR/Native library is loaded at any one time.

    If multiple listener configurations are found, only the first one initialised will be used.

    Since:
    4.1

    • Field Detail

      • sm

        protected static final StringManager sm
        The string manager for this package.

      • TCN_RECOMMENDED_MAJOR

        protected static final int TCN_RECOMMENDED_MAJOR
        See Also:
        Constant Field Values

      • TCN_RECOMMENDED_MINOR

        protected static final int TCN_RECOMMENDED_MINOR
        See Also:
        Constant Field Values

      • SSLEngine

        protected static java.lang.String SSLEngine

      • FIPSMode

        protected static java.lang.String FIPSMode

      • SSLRandomSeed

        protected static java.lang.String SSLRandomSeed

      • sslInitialized

        protected static boolean sslInitialized

      • fipsModeActive

        protected static boolean fipsModeActive

    • Constructor Detail

      • AprLifecycleListener

        public AprLifecycleListener()

    • Method Detail

      • isAprAvailable

        public static boolean isAprAvailable()

      • getInstalledTcnVersion

        public static java.lang.String getInstalledTcnVersion()
        Get the installed Tomcat Native version string, if available.
        Returns:
        the version string, or null if APR is not available

      • getInstalledAprVersion

        public static java.lang.String getInstalledAprVersion()
        Get the installed APR version string, if available.
        Returns:
        the APR version string, or null if APR is not available

      • getInstalledOpenSslVersion

        public static java.lang.String getInstalledOpenSslVersion()
        Get the installed OpenSSL version string (via APR), if available.
        Returns:
        the OpenSSL version string, or null if not available

      • getTcnVersionWarning

        public static java.lang.String getTcnVersionWarning()
        Get a warning message if the installed Tomcat Native version is older than recommended. This performs the same version check used during Tomcat startup.
        Returns:
        a warning message if the installed version is outdated, or null if the version is acceptable or APR is not available

      • lifecycleEvent

        public void lifecycleEvent​(LifecycleEvent event)
        Primary entry point for startup and shutdown events.
        Specified by:
        lifecycleEvent in interface LifecycleListener
        Parameters:
        event - The event that has occurred

      • getSSLEngine

        public java.lang.String getSSLEngine()

      • setSSLEngine

        public void setSSLEngine​(java.lang.String SSLEngine)

      • getSSLRandomSeed

        public java.lang.String getSSLRandomSeed()

      • setSSLRandomSeed

        public void setSSLRandomSeed​(java.lang.String SSLRandomSeed)

      • getFIPSMode

        public java.lang.String getFIPSMode()

      • setFIPSMode

        public void setFIPSMode​(java.lang.String FIPSMode)

      • isFIPSModeActive

        public boolean isFIPSModeActive()

      • setUseOpenSSL

        public void setUseOpenSSL​(boolean useOpenSSL)

      • getUseOpenSSL

        public static boolean getUseOpenSSL()

      • isInstanceCreated

        public static boolean isInstanceCreated()