/**

/**

 * Minimal tomcat starter for embedding/unit tests.

 * Minimal tomcat starter for embedding/unit tests.

 *

 *

 * Tomcat supports multiple styles of configuration and

 * Tomcat supports multiple styles of configuration and

 * startup - the most common and stable is server.xml-based,

 * startup - the most common and stable is server.xml-based,

 * implemented in org.apache.catalina.startup.Bootstrap.

 * implemented in org.apache.catalina.startup.Bootstrap.

 *

 *

 * This class is for use in apps that embed tomcat.

 * This class is for use in apps that embed tomcat.

 * Requirements:

 * Requirements:

 *

 *

 *

 *

 *

 *

 * There are a variety of 'add' methods to configure servlets and webapps. These

 * There are a variety of 'add' methods to configure servlets and webapps. These

 * methods, by default, create a simple in-memory security realm and apply it.

 * methods, by default, create a simple in-memory security realm and apply it.

 * If you need more complex security processing, you can define a subclass of

 * If you need more complex security processing, you can define a subclass of

 * this class.

 * this class.

 *

 *

 * This class provides a set of convenience methods for configuring webapp

 * This class provides a set of convenience methods for configuring webapp

 * contexts, all overloads of the method <code>addWebapp</code>. These methods

 * contexts, all overloads of the method <code>addWebapp</code>. These methods

 * create a webapp context, configure it, and then add it to a {@link Host}.

 * create a webapp context, configure it, and then add it to a {@link Host}.

 * listener that adds the standard DefaultServlet, JSP processing, and welcome

 * listener that adds the standard DefaultServlet, JSP processing, and welcome

 * files.

 * files.

 *

 *

 * In complex cases, you may prefer to use the ordinary Tomcat API to create

 * In complex cases, you may prefer to use the ordinary Tomcat API to create

 * webapp contexts; for example, you might need to install a custom Loader

 * webapp contexts; for example, you might need to install a custom Loader

 * before the call to {@link Host#addChild(Container)}. To replicate the basic

 * before the call to {@link Host#addChild(Container)}. To replicate the basic

 * methods of this class: {@link #noDefaultWebXmlPath()} and

 * methods of this class: {@link #noDefaultWebXmlPath()} and

 * {@link #getDefaultWebXmlListener()}.

 * {@link #getDefaultWebXmlListener()}.

 *

 *

 * {@link #getDefaultWebXmlListener()} returns a {@link LifecycleListener} that

 * {@link #getDefaultWebXmlListener()} returns a {@link LifecycleListener} that

 * adds the standard DefaultServlet, JSP processing, and welcome files. If you

 * adds the standard DefaultServlet, JSP processing, and welcome files. If you

 * add this listener, you must prevent Tomcat from applying any standard global

 * add this listener, you must prevent Tomcat from applying any standard global

 * web.xml with ...

 * web.xml with ...

 *

 *

 * {@link #noDefaultWebXmlPath()} returns a dummy pathname to configure to

 * {@link #noDefaultWebXmlPath()} returns a dummy pathname to configure to

 * prevent {@link ContextConfig} from trying to apply a global web.xml file.

 * prevent {@link ContextConfig} from trying to apply a global web.xml file.

 *

 *

 * This class provides a main() and few simple CLI arguments,

 * This class provides a main() and few simple CLI arguments,

 * see setters for doc. It can be used for simple tests and

 * see setters for doc. It can be used for simple tests and

 * demo.

 * demo.

     * Tomcat needs a directory for temp files. This should be the

     * Tomcat needs a directory for temp files. This should be the

     * first method called.

     * first method called.

     *

     *

     * By default, if this method is not called, we use:

     * By default, if this method is not called, we use:

     * (/tmp doesn't seem a good choice for security).

     * (/tmp doesn't seem a good choice for security).

     *

     *

     * TODO: disable work dir if not needed ( no jsp, etc ).

     * TODO: disable work dir if not needed ( no jsp, etc ).

     *

     *

     * @param basedir The Tomcat base folder on which all others

     * @param basedir The Tomcat base folder on which all others

     * programmatically, there will still be no scanning for

     * programmatically, there will still be no scanning for

     * {@link javax.servlet.annotation.HandlesTypes} matches.

     * {@link javax.servlet.annotation.HandlesTypes} matches.

     *

     *

     * API calls equivalent with web.xml:

     * API calls equivalent with web.xml:

     *

     *

     *  ctx.addParameter("name", "value");

     *  ctx.addParameter("name", "value");

     *

     *

     *

     *

     *

     *

     *

     *

     * Note: If you reload the Context, all your configuration will be lost. If

     * Note: If you reload the Context, all your configuration will be lost. If

     * you need reload support, consider using a LifecycleListener to provide

     * you need reload support, consider using a LifecycleListener to provide

     * your configuration.

     * your configuration.

     *

     *

     * TODO: add the rest

     * TODO: add the rest

     *

     *

     * @param contextPath The context mapping to use, "" for root context.

     * @param contextPath The context mapping to use, "" for root context.

    /**

    /**

     * Equivalent to <servlet><servlet-name><servlet-class>.

     * Equivalent to <servlet><servlet-name><servlet-class>.

     *

     *

     * In general it is better/faster to use the method that takes a

     * In general it is better/faster to use the method that takes a

     * Servlet as param - this one can be used if the servlet is not

     * Servlet as param - this one can be used if the servlet is not

     * commonly used, and want to avoid loading all deps.

     * commonly used, and want to avoid loading all deps.

     * ( for example: jsp servlet )

     * ( for example: jsp servlet )

     *

     *

     * You can customize the returned servlet, ex:

     * You can customize the returned servlet, ex:

     *    wrapper.addInitParameter("name", "value");

     *    wrapper.addInitParameter("name", "value");

     *

     *

     * @param contextPath   Context to add Servlet to

     * @param contextPath   Context to add Servlet to

     * @param servletName   Servlet name (used in mappings)

     * @param servletName   Servlet name (used in mappings)

     * Get the default http connector. You can set more

     * Get the default http connector. You can set more

     * parameters - the port is already initialized.

     * parameters - the port is already initialized.

     *

     *

     * Alternatively, you can construct a Connector and set any params,

     * Alternatively, you can construct a Connector and set any params,

     * then call addConnector(Connector)

     * then call addConnector(Connector)

     *

     *

    /**

    /**

     * Fix startup sequence - required if you don't use web.xml.

     * Fix startup sequence - required if you don't use web.xml.

     *

     *

     * The start() method in context will set 'configured' to false - and

     * The start() method in context will set 'configured' to false - and

     * expects a listener to set it back to true.

     * expects a listener to set it back to true.

     */

     */