/*
    * Licensed to the Apache Software Foundation (ASF) under one
    * or more contributor license agreements.  See the NOTICE file
    * distributed with this work for additional information
    * regarding copyright ownership.  The ASF licenses this file
    * to you 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.apache.myfaces.webapp;
  
  import java.util.logging.Level;
  import java.util.logging.Logger;
  
  import javax.el.ELContext;
  import javax.el.ExpressionFactory;
  import javax.el.MethodExpression;
  import javax.el.ValueExpression;
  import javax.faces.FacesException;
  import javax.faces.context.ExternalContext;
  import javax.servlet.ServletContext;
  
  /**
   * Initializes MyFaces in a JSP 2.0 (or less) environment.
   * 
   */
  public class Jsp20FacesInitializer extends AbstractFacesInitializer
  {
      /**
       * The logger instance for this class.
       */
      //private static final Log log = LogFactory.getLog(Jsp20FacesInitializer.class);
      private static final Logger log = Logger.getLogger(Jsp20FacesInitializer.class.getName());
  
      /**
       * The ExpressionFactory implementation of the EL-RI.
       */
      private static final String EL_RI_EXPRESSION_FACTORY_IMPL = "com.sun.el.ExpressionFactoryImpl";
  
      /**
       * Jasper's ExpressionFactory implementation.
       */
      private static final String JASPER_EL_EXPRESSION_FACTORY_IMPL = "org.apache.el.ExpressionFactoryImpl";
  
      /**
       * All known ExpressionFactory implementations.
       */
      private static final String[] KNOWN_EXPRESSION_FACTORIES =
              new String[] { EL_RI_EXPRESSION_FACTORY_IMPL, JASPER_EL_EXPRESSION_FACTORY_IMPL };
  
      @Override
      protected void initContainerIntegration(ServletContext servletContext, ExternalContext externalContext)
      {
          if (log.isLoggable(Level.INFO))
          {
              log.info("This application isn't running in a JSP 2.1 container.");
          }
  
          // It's possible to run MyFaces in a JSP 2.0 Container, but the user has to provide
          // the ExpressionFactory implementation to use as there is no JspApplicationContext
          // we could ask for. Having said that, though, the user only has to provide it, if
          // there is no known ExpressionFactory available (i.e. if neither
          // "com.sun.el.ExpressionFactoryImpl" nor "org.apache.el.ExpressionFactoryImpl"
          // are available).
          ExpressionFactory expressionFactory = getUserDefinedExpressionFactory(externalContext);
  
          if (expressionFactory == null)
          {
              if (log.isLoggable(Level.INFO))
              {
                  log.info("Either you haven't specified the ExpressionFactory implementation, or an " 
                          + "error occured while instantiating the implementation you've specified. "
                          + "However, attempting to load a known implementation.");
              }
  
              expressionFactory = findExpressionFactory(KNOWN_EXPRESSION_FACTORIES);
              if (expressionFactory == null)
              { // if we still haven't got a valid implementation
                  if (log.isLoggable(Level.SEVERE))
                  {
                      log.severe("No valid ExpressionFactory implementation is available "
                              + "but that's required as this application isn't running in a JSP 2.1 container.");
                  }
  
                  // use a dummy implementation that reports the error again
                  expressionFactory = new ErrorExpressionFactory();
              }
          }
  
          if (log.isLoggable(Level.FINE))
         {
             log.fine("The following ExpressionFactory implementation will " + "be used: '" + expressionFactory + "'.");
         }
 
         buildConfiguration(servletContext, externalContext, expressionFactory);
     }
 
     /**
      * Attempts to find a valid ExpressionFactory implementation. Each of the given
      * "ExpressionFactory implementation candidates" will be tried to instantiate. If an attempt succeeded, the
      * ExpressionFactory implementation will be returned (i.e. the first valid ExpressionFactory implementation will be
      * returned) and if no attempt succeeds, <code>null</code> will be returned.
      * 
      * @param expressionFactoryClassNames
      *            "ExpresionFactory implementation candidates"
      * 
      * @return the newly created ExpressionFactory implementation, or <code>null</code>, if there is no valid
      *         implementation
      */
     private static ExpressionFactory findExpressionFactory(String[] expressionFactoryClassNames)
     {
         for (String expressionFactoryClassName : expressionFactoryClassNames)
         {
             ExpressionFactory expressionFactory = loadExpressionFactory(expressionFactoryClassName);
             if (expressionFactory != null)
             {
                 return expressionFactory;
             }
         }
 
         return null;
     }
 
     /**
      * Dummy implementation informing the user that there is no valid ExpressionFactory implementation available. This
      * class makes it easier for the user to understand why the application crashes. Otherwise he would have to deal
      * with NullPointerExceptions.
      * 
      */
     private class ErrorExpressionFactory extends ExpressionFactory
     {
 
         @Override
         public Object coerceToType(Object obj, Class<?> targetType)
         {
             throw new FacesException("No valid ExpressionFactory implementation is available "
                     + "but that's required as this application isn't running in a JSP 2.1 container.");
         }
 
         @Override
         public MethodExpression createMethodExpression(ELContext context, String expression,
                                                        Class<?> expectedReturnType, Class<?>[] expectedParamTypes)
         {
             throw new FacesException("No valid ExpressionFactory implementation is available "
                     + "but that's required as this application isn't running in a JSP 2.1 container.");
         }
 
         @Override
         public ValueExpression createValueExpression(Object instance, Class<?> expectedType)
         {
             throw new FacesException("No valid ExpressionFactory implementation is available "
                     + "but that's required as this application isn't running in a JSP 2.1 container.");
         }
 
         @Override
         public ValueExpression createValueExpression(ELContext context, String expression, Class<?> expectedType)
         {
             throw new FacesException("No valid ExpressionFactory implementation is available "
                     + "but that's required as this application isn't running in a JSP 2.1 container.");
         }
 
     }
 
 }