EDIT

import org.eclipse.jetty.server.Handler;

import org.eclipse.jetty.server.handler.ContextHandler;

import eu.etaxonomy.cdm.server.instance.SharedAttributes;

        return instanceManager;

        String version = "cdmlib version unreadable";

            Properties versionProperties = new Properties();

            versionProperties.load(versionInStream);

            version = versionProperties.getProperty(CDMLIB_REMOTE_WEBAPP_VERSION, version);

    /**

     * Adds a new WebAppContext to the contexts of the running jetty instance.

     * <ol>

     * <li>Initialize WebAppContext:

     * <ol>

     * <li>set context path</li>

     * <li>set tmp directory</li>

     * <li>bind JndiDataSource</li>

     * <li>set web app context attributes</li>

     * <li>create and setup individual classloader for the instance</li>

     * </ol>

     * </li>

     * <li>

     * finally add the new webappcontext to the contexts of the jetty instance</li>

     * </ol>

     *

     * @param instance

     * @return the instance given as parameter of null in case the instance has

     *         {@link Status.#disabled} or if it is already added.

     * @throws IOException

     */

    public WebAppContext addCdmInstanceContext(CdmInstance instance) throws IOException {

        Configuration conf = instance.getConfiguration();

        if(!instance.isEnabled()){

            logger.info(conf.getInstanceName() + " is disabled, possibly due to JVM memory limitations");

            return null;

        }

        if(getContextFor(conf) != null){

            logger.info(conf.getInstanceName() + " is alreaddy added to the contexts - skipping");

            return null;

        }

        instance.setStatus(Status.initializing);

        logger.info("preparing WebAppContext for '"+ conf.getInstanceName() + "'");

        WebAppContext cdmWebappContext = new WebAppContext();

        cdmWebappContext.setContextPath(constructContextPath(conf));

        cdmWebappContext.setTempDirectory(CDM_WEBAPP_TEMP_FOLDER);

        if(!instance.bindJndiDataSource()){

            // a problem with the datasource occurred skip this webapp

            cdmWebappContext = null;

            logger.error("a problem with the datasource occurred -> skipping /" + conf.getInstanceName());

            instance.setStatus(Status.error);

            return cdmWebappContext;

        }

        cdmWebappContext.setAttribute(SharedAttributes.ATTRIBUTE_DATASOURCE_NAME, conf.getInstanceName());

        cdmWebappContext.setAttribute(SharedAttributes.ATTRIBUTE_JDBC_JNDI_NAME, conf.getJdbcJndiName());

        setWebApp(cdmWebappContext, getCdmRemoteWebAppFile());

        cdmWebappContext.setAttribute(SharedAttributes.ATTRIBUTE_CDM_LOGFILE,

                logPath + File.separator + "cdm-"

                        + conf.getInstanceName() + ".log");

        if( getCdmRemoteWebAppFile().isDirectory() && isRunningFromCdmRemoteWebAppSource()){

            /*

             * when running the webapp from {projectpath} src/main/webapp we

             * must assure that each web application is using it's own

             * classloader thus we tell the WebAppClassLoader where the

             * dependencies of the webapplication can be found. Otherwise

             * the system classloader would load these resources.

             */

            String classPath = System.getProperty("java.class.path");

            logger.info("Running webapp from source folder, thus adding system property 'java.class.path=" + classPath +"'  to WebAppClassLoader");

            WebAppClassLoader classLoader = new WebAppClassLoader(cdmWebappContext);

            classLoader.addClassPath(classPath);

            cdmWebappContext.setClassLoader(classLoader);

        }

        contexts.addHandler(cdmWebappContext);

        instance.setWebAppContext(cdmWebappContext);

        cdmWebappContext.addLifeCycleListener(instance);

        instance.setStatus(Status.stopped);

        return cdmWebappContext;

    }

    /**

     * @param conf

     * @return

     */

    private String constructContextPath(Configuration conf) {

        return "/" + conf.getInstanceName();

    }

    /**

     * Removes the given instance from the contexts. If the instance is running

     * at the time of calling this method it will be stopped first.

     * The JndiDataSource and the webapplicationContext will be released and removed.

     *

     * @param instance the instance to be removed

     *

     * @throws Exception in case stopping the instance fails

     */

    public void removeCdmInstanceContext(CdmInstance instance) throws Exception {

        if(instance.getWebAppContext() != null){

            if(instance.getWebAppContext().isRunning()){

                try {

                    instance.getWebAppContext().stop();

                } catch (Exception e) {

                    instance.getProblems().add("Error while stopping instance: " + e.getMessage());

                    throw e;

                }

            }

            contexts.removeHandler(instance.getWebAppContext());

            instance.releaseWebAppContext();

        } else  {

            // maybe something went wrong before, try to find the potentially lost

            // contexts directly in the server

            ContextHandler handler = getContextFor(instance.getConfiguration());

            if(handler != null){

                contexts.removeHandler(handler);

            }

        }

        instance.unbindJndiDataSource();

    }

    public ContextHandler getContextFor(Configuration conf) {

        return getContextFor(constructContextPath(conf));

    }

    public ContextHandler getContextFor(String contextPath) {

        for( Handler handler : contexts.getHandlers()){

            if(handler instanceof ContextHandler){

                if(((ContextHandler)handler).getContextPath().equals(contextPath)){

                    return (ContextHandler)handler;

                }

            }

        }

        return null;

    }

    public ContextHandlerCollection getContexts() {

        return contexts;

    }

    /**

     * @return a File object pointing to the location of the cdmlib-remote-webapp

     */

    public File getCdmRemoteWebAppFile(){

        if(cdmRemoteWebAppFile == null){

            throw new RuntimeException("Invalid order of action. Server not yet started. The startServer() method must be called first. ");

        }

        return cdmRemoteWebAppFile;

    }

}