StoreConfig (Apache Tomcat 10.1.54 API Documentation)
Description: declaration: package: org.apache.catalina.storeconfig, class: StoreConfig

# Class StoreConfig

java.lang.Object
org.apache.catalina.storeconfig.StoreConfig

All Implemented Interfaces:
  `IStoreConfig`

public class StoreConfig extends Object implements IStoreConfig
Store Server/Service/Host/Context at file or PrintWriter. Default server.xml is at $catalina.base/conf/server.xml

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `protected static final StringManager`
  `sm`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `StoreConfig()`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `StoreRegistry`
  `getRegistry()`
  Get Configuration Registry
  `Server`
  `getServer()`
  Get associated server
  `String`
  `getServerFilename()`
  Get server.xml location
  `void`
  `setRegistry(StoreRegistry aRegistry)`
  Set Configuration Registry
  `void`
  `setServer(Server aServer)`
  Set associated server
  `void`
  `setServerFilename(String string)`
  Set new server.xml location.
  `void`
  `store(PrintWriter aWriter, int indent, Context aContext)`
  Store the specified Context properties.
  `void`
  `store(PrintWriter aWriter, int indent, Host aHost)`
  Store the specified Host properties.
  `void`
  `store(PrintWriter writer, int indent, Server aServer)`
  Store the specified Server properties.
  `void`
  `store(PrintWriter aWriter, int indent, Service aService)`
  Store the specified Service properties.
  `boolean`
  `store(Context aContext)`
  Store the specified Context properties.
  `boolean`
  `store(Server aServer)`
  Write the configuration information for this entire `Server` out to the server.xml configuration file.
  `void`
  `storeConfig()`
  Store the current StoreFactory Server.
  `void`
  `storeContext(String aContextName, boolean backup, boolean externalAllowed)`
  Store a Context from ObjectName.
  `void`
  `storeServer(String aServerName, boolean backup, boolean externalAllowed)`
  Store Server from Object Name (Catalina:type=Server).

  ### Methods inherited from class Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Field Details

  - ### sm

    protected static final StringManager sm

- ## Constructor Details

  - ### StoreConfig

    public StoreConfig()

- ## Method Details

  - ### getServerFilename

    public String getServerFilename()
    Get server.xml location
    Returns:
      The server file name

  - ### setServerFilename

    public void setServerFilename(String string)
    Set new server.xml location.
    Parameters:
      `string` - The server.xml location

  - ### getRegistry

    public StoreRegistry getRegistry()
    Description copied from interface: `IStoreConfig`
    Get Configuration Registry
    Specified by:
      `getRegistry` in interface `IStoreConfig`
    Returns:
      aRegistry that handle the store operations

  - ### setServer

    public void setServer(Server aServer)
    Description copied from interface: `IStoreConfig`
    Set associated server
    Specified by:
      `setServer` in interface `IStoreConfig`
    Parameters:
      `aServer` - the associated server

  - ### getServer

    public Server getServer()
    Description copied from interface: `IStoreConfig`
    Get associated server
    Specified by:
      `getServer` in interface `IStoreConfig`
    Returns:
      aServer the associated server

  - ### setRegistry

    public void setRegistry(StoreRegistry aRegistry)
    Description copied from interface: `IStoreConfig`
    Set Configuration Registry
    Specified by:
      `setRegistry` in interface `IStoreConfig`
    Parameters:
      `aRegistry` - aregistry that handle the store operations

  - ### storeConfig

    public void storeConfig()
    Description copied from interface: `IStoreConfig`
    Store the current StoreFactory Server.
    Specified by:
      `storeConfig` in interface `IStoreConfig`

  - ### storeServer

    public void storeServer(String aServerName, boolean backup, boolean externalAllowed) throws MalformedObjectNameException
    Store Server from Object Name (Catalina:type=Server).
    Parameters:
      `aServerName` - Server ObjectName
      `backup` - `true` to backup existing configuration files before rewriting them
      `externalAllowed` - `true` to allow saving webapp configuration for webapps that are not inside the host's app directory
    Throws:
      `MalformedObjectNameException` - Bad MBean name

  - ### storeContext

    public void storeContext(String aContextName, boolean backup, boolean externalAllowed) throws MalformedObjectNameException
    Store a Context from ObjectName.
    Parameters:
      `aContextName` - MBean ObjectName
      `backup` - `true` to backup existing configuration files before rewriting them
      `externalAllowed` - `true` to allow saving webapp configuration for webapps that are not inside the host's app directory
    Throws:
      `MalformedObjectNameException` - Bad MBean name

  - ### store

    public boolean store(Server aServer)
    Description copied from interface: `IStoreConfig`
    Write the configuration information for this entire `Server` out to the server.xml configuration file.
    Specified by:
      `store` in interface `IStoreConfig`
    Parameters:
      `aServer` - Server instance
    Returns:
      `true` if the store operation was successful

  - ### store

    public boolean store(Context aContext)
    Description copied from interface: `IStoreConfig`
    Store the specified Context properties.
    Specified by:
      `store` in interface `IStoreConfig`
    Parameters:
      `aContext` - Object to be stored
    Returns:
      `true` if the store operation was successful

  - ### store

    public void store(PrintWriter aWriter, int indent, Context aContext) throws Exception
    Description copied from interface: `IStoreConfig`
    Store the specified Context properties.
    Specified by:
      `store` in interface `IStoreConfig`
    Parameters:
      `aWriter` - PrintWriter to which we are storing
      `indent` - Number of spaces to indent this element
      `aContext` - Object to be stored
    Throws:
      `Exception` - Store error occurred

  - ### store

    public void store(PrintWriter aWriter, int indent, Host aHost) throws Exception
    Description copied from interface: `IStoreConfig`
    Store the specified Host properties.
    Specified by:
      `store` in interface `IStoreConfig`
    Parameters:
      `aWriter` - PrintWriter to which we are storing
      `indent` - Number of spaces to indent this element
      `aHost` - Object to be stored
    Throws:
      `Exception` - Store error occurred

  - ### store

    public void store(PrintWriter aWriter, int indent, Service aService) throws Exception
    Description copied from interface: `IStoreConfig`
    Store the specified Service properties.
    Specified by:
      `store` in interface `IStoreConfig`
    Parameters:
      `aWriter` - PrintWriter to which we are storing
      `indent` - Number of spaces to indent this element
      `aService` - Object to be stored
    Throws:
      `Exception` - Store error occurred

  - ### store

    public void store(PrintWriter writer, int indent, Server aServer) throws Exception
    Description copied from interface: `IStoreConfig`
    Store the specified Server properties.
    Specified by:
      `store` in interface `IStoreConfig`
    Parameters:
      `writer` - PrintWriter to which we are storing
      `indent` - Number of spaces to indent this element
      `aServer` - Object to be stored
    Throws:
      `Exception` - Store error occurred