/*
* Copyright (c) 1998-2011 Caucho Technology -- all rights reserved
*
* This file is part of Resin(R) Open Source
*
* Each copy or derived work must preserve the copyright notice and this
* notice unmodified.
*
* Resin Open Source is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* Resin Open Source is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
* of NON-INFRINGEMENT. See the GNU General Public License for more
* details.
*
* You should have received a copy of the GNU General Public License
* along with Resin Open Source; if not, write to the
*
* Free Software Foundation, Inc.
* 59 Temple Place, Suite 330
* Boston, MA 02111-1307 USA
*
* @author Scott Ferguson
*/
package com.caucho.resin;
import java.util.HashMap;
import java.util.Map;
import com.caucho.config.ConfigException;
import com.caucho.config.program.ContainerProgram;
import com.caucho.config.program.PropertyValueProgram;
import com.caucho.server.dispatch.ServletConfigImpl;
import com.caucho.util.L10N;
/**
* Embeddable version of a servlet
*
* <code><pre>
* ResinEmbed resin = new ResinEmbed();
*
* WebAppEmbed webApp = new WebAppEmbed("/foo", "/var/www/foo");
*
* ServletEmbed myServlet = new ServletEmbed("my-servlet", "qa.MyServlet");
* webApp.addServlet(myServlet);
*
* resin.addWebApp(webApp);
* </pre></code>
*/
public class ServletEmbed
{
private static final L10N L = new L10N(ServletEmbed.class);
private String _servletName;
private String _servletClass;
private int _loadOnStartup = -1;
private boolean _isAsyncSupported;
private HashMap<String,String> _initParamMap = new HashMap<String,String>();
private ContainerProgram _init = new ContainerProgram();
private ServletProtocolEmbed _protocol;
/**
* Creates a new embedded servlet
*/
public ServletEmbed()
{
}
/**
* Creates a new embedded servlet
*
* @param servletClass the servlet-class
*/
public ServletEmbed(String servletClass)
{
setServletClass(servletClass);
}
/**
* Creates a new embedded servlet
*
* @param servletClass the servlet-class
* @param servletName the servlet-name
*/
public ServletEmbed(String servletClass, String servletName)
{
setServletClass(servletClass);
setServletName(servletName);
}
/**
* The servlet-name
*/
public void setServletName(String servletName)
{
_servletName = servletName;
}
/**
* The servlet-name
*/
public String getServletName()
{
return _servletName;
}
/**
* The servlet-class
*/
public void setServletClass(String servletClass)
{
_servletClass = servletClass;
}
/**
* The servlet-class
*/
public String getServletClass()
{
return _servletClass;
}
/**
* Sets the load-on-startup parameter.
*/
public void setLoadOnStartup(int loadOnStartup)
{
_loadOnStartup = loadOnStartup;
}
/**
* Sets true if the servlet can use async/comet
*/
public void setAsyncSupported(boolean isSupported)
{
_isAsyncSupported = isSupported;
}
/**
* Sets an init-param.
*/
public void setInitParam(String name, String value)
{
_initParamMap.put(name, value);
}
/**
* Adds an init/ioc property.
*/
public void addProperty(String name, Object value)
{
_init.addProgram(new PropertyValueProgram(name, value));
}
/**
* Sets the remoting protocol
*/
public void setProtocol(ServletProtocolEmbed protocol)
{
_protocol = protocol;
}
protected void configure(ServletConfigImpl servletConfig)
{
try {
if (_servletClass == null)
throw new ConfigException(L.l("servlet-class is required for ServletEmbed."));
servletConfig.setServletClass(_servletClass);
if (_servletName != null)
servletConfig.setServletName(_servletName);
else
servletConfig.setServletName(_servletClass);
for (Map.Entry<String,String> entry : _initParamMap.entrySet()) {
servletConfig.setInitParam(entry.getKey(), entry.getValue());
}
servletConfig.setInit(_init);
if (_loadOnStartup >= 0)
servletConfig.setLoadOnStartup(_loadOnStartup);
if (_protocol != null) {
servletConfig.setProtocol(_protocol.createProtocol());
}
servletConfig.setAsyncSupported(_isAsyncSupported);
servletConfig.init();
} catch (Exception e) {
throw ConfigException.create(e);
}
}
}