Class Catalina

java.lang.Object
org.apache.catalina.startup.Catalina

public class Catalina extends 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 Details

    • sm

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

      public static final String SERVER_XML
      See Also:
    • await

      protected boolean await
      Use await.
    • configFile

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

      protected 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 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 File generatedCodeLocation
      Location of generated sources.
    • generatedCodeLocationParameter

      protected String generatedCodeLocationParameter
      Value of the argument.
    • generatedCodePackage

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

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

    • Catalina

      public Catalina()
  • Method Details

    • setConfigFile

      public void setConfigFile(String file)
    • getConfigFile

      public 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 File getGeneratedCodeLocation()
    • setGeneratedCodeLocation

      public void setGeneratedCodeLocation(File generatedCodeLocation)
    • getGeneratedCodePackage

      public String getGeneratedCodePackage()
    • setGeneratedCodePackage

      public void setGeneratedCodePackage(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(ClassLoader parentClassLoader)
      Set the shared extensions class loader.
      Parameters:
      parentClassLoader - The shared extensions class loader.
    • getParentClassLoader

      public 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(String[] args)
      Process the specified command line arguments.
      Parameters:
      args - Command line arguments to process
      Returns:
      true if we should continue processing
    • configFile

      protected 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(String[] arguments)
    • load

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

      public void load(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)