/*
* JBoss, Home of Professional Open Source
* Copyright 2010, Red Hat Middleware LLC, and individual contributors
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
* http://www.apache.org/licenses/LICENSE-2.0
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.jboss.arquillian.container.tomcat.embedded_6;
import java.io.File;
import java.io.IOException;
import java.net.InetAddress;
import java.net.URL;
import java.net.UnknownHostException;
import java.util.ArrayList;
import java.util.List;
import java.util.logging.Logger;
import org.apache.catalina.Container;
import org.apache.catalina.Engine;
import org.apache.catalina.Host;
import org.apache.catalina.connector.Connector;
import org.apache.catalina.core.StandardContext;
import org.apache.catalina.core.StandardHost;
import org.apache.catalina.startup.Embedded;
import org.apache.catalina.startup.ExpandWar;
import org.jboss.arquillian.protocol.servlet_3.ServletMethodExecutor;
import org.jboss.arquillian.spi.Configuration;
import org.jboss.arquillian.spi.ContainerMethodExecutor;
import org.jboss.arquillian.spi.Context;
import org.jboss.arquillian.spi.DeployableContainer;
import org.jboss.arquillian.spi.DeploymentException;
import org.jboss.arquillian.spi.LifecycleException;
import org.jboss.modcluster.catalina.ModClusterListener;
import org.jboss.shrinkwrap.api.Archive;
import org.jboss.shrinkwrap.tomcat_6.api.ShrinkWrapStandardContext;
/**
*
Arquillian {@link DeployableContainer} implementation for an
* Embedded Tomcat server; responsible for both lifecycle and deployment
* operations.
*
* Please note that the context path set for the webapp must begin with
* a forward slash. Otherwise, certain path operations within Tomcat
* will behave inconsistently. Though it goes without saying, the host
* name (bindAddress) cannot have a trailing slash for the same
* reason.
*
* @author Jean Deruelle
* @author Dan Allen
* @version $Revision: $
*/
public class TomcatContainer implements DeployableContainer
{
private static final Logger log = Logger.getLogger(TomcatContainer.class.getName());
private static final String ENV_VAR = "${env.";
private static final String HTTP_PROTOCOL = "http";
private static final String TMPDIR_SYS_PROP = "java.io.tmpdir";
/**
* Tomcat embedded
*/
private Embedded embedded;
/**
* Engine contained within Tomcat embedded
*/
private Engine engine;
/**
* Host contained in the tomcat engine
*/
private Host standardHost;
/**
* Tomcat container configuration
*/
private TomcatConfiguration configuration;
private String serverName;
private String bindAddress;
private int bindPort;
private boolean wasStarted;
private final List failedUndeployments = new ArrayList();
public void setup(Context context, Configuration configuration)
{
this.configuration = configuration.getContainerConfig(TomcatConfiguration.class);
bindAddress = this.configuration.getBindAddress();
bindPort = this.configuration.getBindHttpPort();
serverName = this.configuration.getServerName();
}
public void start(Context context) throws LifecycleException
{
try
{
startTomcatEmbedded();
}
catch (Exception e)
{
throw new LifecycleException("Bad shit happened", e);
}
}
public void stop(Context context) throws LifecycleException
{
try
{
removeFailedUnDeployments();
}
catch (Exception e)
{
throw new LifecycleException("Could not clean up", e);
}
if (wasStarted)
{
try
{
stopTomcatEmbedded();
}
catch (org.apache.catalina.LifecycleException e)
{
throw new LifecycleException("An unexpected error occurred", e);
}
}
}
public ContainerMethodExecutor deploy(Context context, final Archive> archive) throws DeploymentException
{
if (archive == null)
{
throw new IllegalArgumentException("Archive must be specified");
}
if (embedded == null)
{
throw new IllegalStateException("Embedded container is not running");
}
try
{
StandardContext standardContext = archive.as(ShrinkWrapStandardContext.class);
standardContext.addLifecycleListener(new EmbeddedContextConfig());
standardContext.setUnpackWAR(configuration.isUnpackArchive());
if (standardContext.getUnpackWAR())
{
deleteUnpackedWAR(standardContext);
}
standardHost.addChild(standardContext);
context.add(StandardContext.class, standardContext);
}
catch (Exception e)
{
throw new DeploymentException("Failed to deploy " + archive.getName(), e);
}
try
{
return new ServletMethodExecutor(
new URL(
HTTP_PROTOCOL,
bindAddress,
bindPort,
"/"));
}
catch (Exception e)
{
throw new RuntimeException("Could not create ContainerMethodExecutor", e);
}
}
public void undeploy(Context context, Archive> archive) throws DeploymentException
{
StandardContext standardContext = context.get(StandardContext.class);
if (standardContext != null)
{
standardHost.removeChild(standardContext);
if (standardContext.getUnpackWAR())
{
deleteUnpackedWAR(standardContext);
}
}
}
private void undeploy(String name) throws DeploymentException
{
Container child = standardHost.findChild(name);
if (child != null)
{
standardHost.removeChild(child);
}
}
private void removeFailedUnDeployments() throws IOException
{
List remainingDeployments = new ArrayList();
for (String name : failedUndeployments)
{
try
{
undeploy(name);
}
catch (Exception e)
{
IOException ioe = new IOException();
ioe.initCause(e);
throw ioe;
}
}
if (remainingDeployments.size() > 0)
{
log.severe("Failed to undeploy these artifacts: " + remainingDeployments);
}
failedUndeployments.clear();
}
protected void startTomcatEmbedded() throws UnknownHostException, org.apache.catalina.LifecycleException
{
// creating the tomcat embedded == service tag in server.xml
embedded = new Embedded();
embedded.setName(serverName);
// TODO this needs to be a lot more robust
String tomcatHome = configuration.getTomcatHome();
File tomcatHomeFile = null;
if (tomcatHome != null)
{
if (tomcatHome.startsWith(ENV_VAR))
{
String sysVar = tomcatHome.substring(ENV_VAR.length(), tomcatHome.length() - 1);
tomcatHome = System.getProperty(sysVar);
if (tomcatHome != null && tomcatHome.length() > 0 && new File(tomcatHome).isAbsolute())
{
tomcatHomeFile = new File(tomcatHome);
log.info("Using tomcat home from environment variable: " + tomcatHome);
}
}
else
{
tomcatHomeFile = new File(tomcatHome);
}
}
if (tomcatHomeFile == null)
{
tomcatHomeFile = new File(System.getProperty(TMPDIR_SYS_PROP), "tomcat-embedded-6");
}
tomcatHomeFile.mkdirs();
embedded.setCatalinaBase(tomcatHomeFile.getAbsolutePath());
embedded.setCatalinaHome(tomcatHomeFile.getAbsolutePath());
// creates the engine, i.e., element in server.xml
engine = embedded.createEngine();
engine.setName(serverName);
engine.setDefaultHost(bindAddress);
engine.setService(embedded);
embedded.setContainer(engine);
embedded.addEngine(engine);
// creates the host, i.e., element in server.xml
File appBaseFile = new File(tomcatHomeFile, configuration.getAppBase());
appBaseFile.mkdirs();
standardHost = embedded.createHost(bindAddress, appBaseFile.getAbsolutePath());
if (configuration.getTomcatWorkDir() != null)
{
((StandardHost) standardHost).setWorkDir(configuration.getTomcatWorkDir());
}
((StandardHost) standardHost).setUnpackWARs(configuration.isUnpackArchive());
engine.addChild(standardHost);
// creates an http connector, i.e., element in server.xml
Connector connector = embedded.createConnector(InetAddress.getByName(bindAddress), bindPort, false);
embedded.addConnector(connector);
connector.setContainer(engine);
embedded.addLifecycleListener(createModClusterListener("224.0.1.105", 23364, false, null, true, false, true, null));
// starts embedded tomcat
embedded.init();
embedded.start();
wasStarted = true;
}
/* Create the listener
* groupa: multi address to receive from httpd.
* groupp: port to receive from httpd.
* ssl: use ssl.
* domain: domain to send to httpd (to fail over in the domain).
* stickySession: use stickySession.
* stickySessionRemove: remove the sessionid if we are sticky and need to failover.
* stickySessionForce: return an error if we have to failover to another node.
* advertiseSecurityKey: Key for the digest logic.
*/
private ModClusterListener createModClusterListener(String groupa, int groupp, boolean ssl, String domain,
boolean stickySession, boolean stickySessionRemove,
boolean stickySessionForce, String advertiseSecurityKey) {
ModClusterListener listener = new ModClusterListener();
listener.setAdvertiseGroupAddress(groupa);
listener.setAdvertisePort(groupp);
listener.setSsl(ssl);
listener.setLoadBalancingGroup(domain);
listener.setStickySession(stickySession);
listener.setStickySessionRemove(stickySessionRemove);
listener.setStickySessionForce(stickySessionForce);
listener.setNodeTimeout(20000);
listener.setProxyList("localhost:6666");
if (advertiseSecurityKey != null)
listener.setAdvertiseSecurityKey(advertiseSecurityKey);
return listener;
}
protected void stopTomcatEmbedded() throws LifecycleException, org.apache.catalina.LifecycleException
{
embedded.stop();
}
/**
* Make sure an the unpacked WAR is not left behind
* you would think Tomcat would cleanup an unpacked WAR, but it doesn't
*/
protected void deleteUnpackedWAR(StandardContext standardContext)
{
File unpackDir = new File(standardHost.getAppBase(), standardContext.getPath().substring(1));
if (unpackDir.exists())
{
ExpandWar.deleteDir(unpackDir);
}
}
}