Class Catalina


  • public class Catalina
    extends java.lang.Object
    Startup/Shutdown shell program for Catalina. The following command line options are recognized:
    • -config {pathname} - Set the pathname of the configuration file to be processed. If a relative path is specified, it will be interpreted as relative to the directory pathname specified by the "catalina.base" system property. [conf/server.xml]
    • -help - Display usage information.
    • -nonaming - Disable naming support.
    • configtest - Try to test the config
    • start - Start an instance of Catalina.
    • stop - Stop the currently running instance of Catalina.
    Author:
    Craig R. McClanahan, Remy Maucherat
    • Field Detail

      • sm

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

        protected boolean await
        Use await.
      • configFile

        protected java.lang.String configFile
        Pathname to the server configuration file.
      • parentClassLoader

        protected java.lang.ClassLoader parentClassLoader
        The shared extensions class loader for this server.
      • server

        protected Server server
        The server component we are starting or stopping.
      • useShutdownHook

        protected boolean useShutdownHook
        Use shutdown hook flag.
      • shutdownHook

        protected java.lang.Thread shutdownHook
        Shutdown hook.
      • useNaming

        protected boolean useNaming
        Is naming enabled ?
      • loaded

        protected boolean loaded
        Prevent duplicate loads.
      • throwOnInitFailure

        protected boolean throwOnInitFailure
        Rethrow exceptions on init failure.
      • generateCode

        protected boolean generateCode
        Generate Tomcat embedded code from configuration files.
      • generatedCodeLocation

        protected java.io.File generatedCodeLocation
        Location of generated sources.
      • generatedCodeLocationParameter

        protected java.lang.String generatedCodeLocationParameter
        Value of the argument.
      • generatedCodePackage

        protected java.lang.String generatedCodePackage
        Top package name for generated source.
      • useGeneratedCode

        protected boolean useGeneratedCode
        Use generated code as a replacement for configuration files.
    • Constructor Detail

      • Catalina

        public Catalina()
    • Method Detail

      • setConfigFile

        public void setConfigFile​(java.lang.String file)
      • getConfigFile

        public java.lang.String getConfigFile()
      • setUseShutdownHook

        public void setUseShutdownHook​(boolean useShutdownHook)
      • getUseShutdownHook

        public boolean getUseShutdownHook()
      • getGenerateCode

        public boolean getGenerateCode()
      • setGenerateCode

        public void setGenerateCode​(boolean generateCode)
      • getUseGeneratedCode

        public boolean getUseGeneratedCode()
      • setUseGeneratedCode

        public void setUseGeneratedCode​(boolean useGeneratedCode)
      • getGeneratedCodeLocation

        public java.io.File getGeneratedCodeLocation()
      • setGeneratedCodeLocation

        public void setGeneratedCodeLocation​(java.io.File generatedCodeLocation)
      • getGeneratedCodePackage

        public java.lang.String getGeneratedCodePackage()
      • setGeneratedCodePackage

        public void setGeneratedCodePackage​(java.lang.String generatedCodePackage)
      • getThrowOnInitFailure

        public boolean getThrowOnInitFailure()
        Returns:
        true if an exception should be thrown if an error occurs during server init
      • setThrowOnInitFailure

        public void setThrowOnInitFailure​(boolean throwOnInitFailure)
        Set the behavior regarding errors that could occur during server init.
        Parameters:
        throwOnInitFailure - the new flag value
      • setParentClassLoader

        public void setParentClassLoader​(java.lang.ClassLoader parentClassLoader)
        Set the shared extensions class loader.
        Parameters:
        parentClassLoader - The shared extensions class loader.
      • getParentClassLoader

        public java.lang.ClassLoader getParentClassLoader()
      • setServer

        public void setServer​(Server server)
      • getServer

        public Server getServer()
      • isUseNaming

        public boolean isUseNaming()
        Returns:
        true if naming is enabled.
      • setUseNaming

        public void setUseNaming​(boolean useNaming)
        Enables or disables naming support.
        Parameters:
        useNaming - The new use naming value
      • setAwait

        public void setAwait​(boolean b)
      • isAwait

        public boolean isAwait()
      • arguments

        protected boolean arguments​(java.lang.String[] args)
        Process the specified command line arguments.
        Parameters:
        args - Command line arguments to process
        Returns:
        true if we should continue processing
      • configFile

        protected java.io.File configFile()
        Return a File object representing our configuration file.
        Returns:
        the main configuration file
      • createStartDigester

        protected Digester createStartDigester()
        Create and configure the Digester we will be using for startup.
        Returns:
        the main digester to parse server.xml
      • createStopDigester

        protected Digester createStopDigester()
        Create and configure the Digester we will be using for shutdown.
        Returns:
        the digester to process the stop operation
      • parseServerXml

        protected void parseServerXml​(boolean start)
      • stopServer

        public void stopServer()
      • stopServer

        public void stopServer​(java.lang.String[] arguments)
      • load

        public void load()
        Start a new server instance.
      • load

        public void load​(java.lang.String[] args)
      • start

        public void start()
        Start a new server instance.
      • stop

        public void stop()
        Stop an existing server instance.
      • await

        public void await()
        Await and shutdown.
      • usage

        protected void usage()
        Print usage information for this application.
      • initStreams

        protected void initStreams()
      • initNaming

        protected void initNaming()
      • setSecurityProtection

        protected void setSecurityProtection()
        Set the security package access/protection.
      • generateLoader

        protected void generateLoader()
      • generateClassHeader

        protected void generateClassHeader​(Digester digester,
                                           boolean start)
      • generateClassFooter

        protected void generateClassFooter​(Digester digester)