/FileExtraction/Java_unseen/dlitz_resin/modules/resin/src/com/caucho/resin/ServletEmbed.java
/*
 * 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);
    }
  }
}
