/*
    *  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.trinidad.validator;
  
  import javax.faces.application.FacesMessage;
  import javax.faces.component.UIComponent;
  import javax.faces.context.FacesContext;
  import javax.faces.el.ValueBinding;
  
  import javax.faces.validator.Validator;
  import javax.faces.validator.ValidatorException;
  
  import org.apache.myfaces.trinidad.bean.FacesBean;
  import org.apache.myfaces.trinidad.bean.PropertyKey;
  import org.apache.myfaces.trinidad.util.ComponentUtils;
  import org.apache.myfaces.trinidad.util.IntegerUtils;
  import org.apache.myfaces.trinidad.util.MessageFactory;
  
  /**
   * <p>Implementation for length of <code>java.lang.String</code> values.</p>
   *
   */
  public class LengthValidator extends javax.faces.validator.LengthValidator
  {
    
    public static final String VALIDATOR_ID = "org.apache.myfaces.trinidad.Length";
  
    /**
     * <p>The message identifier of the {@link javax.faces.application.FacesMessage}
     * to be created if the maximum length check fails.  The message format
     * string for this message may optionally include <code>{0}</code>,
     * <code>{1}</code> and <code>{3}</code> placeholders,
     * which will be replaced by user input, component label and configured
     * maximum length.</p>
     */
    public static final String MAXIMUM_MESSAGE_ID =
        "org.apache.myfaces.trinidad.validator.LengthValidator.MAXIMUM";
  
    /**
     * <p>The message identifier of the {@link javax.faces.application.FacesMessage}
     * to be created if the minimum length check fails.  The message format
     * string for this message may optionally include <code>{0}</code>,
     * <code>{1}</code> and <code>{2}</code> placeholders, which will be replaced
     * by user input, component label and configured minimum length.</p>
     */
    public static final String MINIMUM_MESSAGE_ID =
        "org.apache.myfaces.trinidad.validator.LengthValidator.MINIMUM";
  
  
    /**
     * <p>The message identifier of the {@link javax.faces.application.FacesMessage}
     * to be created if the maximum or minimum length check fails, and both
     * the maximum and minimum lengths for this validator have been set.
     * The message format string for this message may optionally include
     * <code>{0}</code>, <code>{1}</code>, <code>{2}</code> and <code>{3}</code>
     * placeholders, which will be replaced by user input, component label,
     * configured minimum length and configured maximum length.</p>
     */
    public static final String NOT_IN_RANGE_MESSAGE_ID =
        "org.apache.myfaces.trinidad.validator.LengthValidator.NOT_IN_RANGE";
  
    /**
     * <p>The message identifier of the {@link javax.faces.application.FacesMessage}
     * to be created if the maximum and minimum lengths are the same,
     * and the length check fails, and both
     * the maximum and minimum values for this validator have been set.
     * The message format string for this message may optionally include
     * <code>{0}</code>, <code>{1}</code>, <code>{2}</code>
     * placeholders, which will be replaced by user input, component label,
     * configured minimum/maximum length.</p>
     */
    public static final String EXACT_MESSAGE_ID =
        "org.apache.myfaces.trinidad.validator.LengthValidator.EXACT";
  
    
    /**
     * Construct a {@link Validator} with no preconfigured limits.
     */
    public LengthValidator()
    {
      super();
    }
  
   /**
    * Construct a {@link Validator} with the specified preconfigured
    * limit.
    *
    * @param maximum Maximum length to allow
    */
   public LengthValidator(int maximum)
   {
     super(maximum);
   }
 
   /**
    * Construct a {@link Validator} with the specified preconfigured
    * limits.
    *
    * @param maximum Maximum length to allow
    * @param minimum Minimum length to allow
    *
    */
   public LengthValidator(int maximum, int minimum)
   {
     super(maximum, minimum);
   }
   
   /**
    * Return the maximum length to be enforced by this {@link
    * Validator} or null if it has not been
    * set.
    */
   @Override
   public int getMaximum()
   {
     Object maxInt = _facesBean.getProperty(_MAXIMUM_KEY);
     if (maxInt == null)
       maxInt = _MAXIMUM_KEY.getDefault();
     return ComponentUtils.resolveInteger(maxInt);
   }
 
   /**
    * Set the maximum length to be enforced by this {@link Validator}.
    *
    * @param maximum The new maximum length
    *
    */
   @Override
   public void setMaximum(int maximum)
   {
     super.setMaximum(maximum);
     _facesBean.setProperty(_MAXIMUM_KEY, Integer.valueOf(maximum));
   }
 
 
   /**
    * Return the minimum length to be enforced by this {@link
    * Validator}, or null if it has not been
    * set.
    */
   @Override
   public int getMinimum()
   {
     Object minInt = _facesBean.getProperty(_MINIMUM_KEY);
     if (minInt == null)
       minInt = _MINIMUM_KEY.getDefault();
     return ComponentUtils.resolveInteger(minInt);
   }
 
   /**
    * Set the minimum length to be enforced by this {@link Validator}.
    *
    * @param minimum The new minimum length
    *
    */
   @Override
   public void setMinimum(int minimum)
   {
     super.setMinimum(minimum);
     _facesBean.setProperty(_MINIMUM_KEY, Integer.valueOf(minimum));
   }
 
   /**
    * <p>Custom error message to be used, for creating detail part of the
    * {@link FacesMessage}, when input length exceeds the maximum length set.</p>
    * Overrides detail message identified by message id {@link #MAXIMUM_MESSAGE_ID}
    * @param maximumMessageDetail Custom error message.
    */
   public void setMessageDetailMaximum(String maximumMessageDetail)
   {
     _facesBean.setProperty(_MAXIMUM_MESSAGE_DETAIL_KEY, maximumMessageDetail);
   }
 
   /**
    *  <p>Return custom detail error message that was set for creating {@link FacesMessage},
    *  for cases where input length exceeds the <code>maximum</code> length set.</p>
    * @return Custom error message.
    * @see #setMessageDetailMaximum(String)
    */
   public String getMessageDetailMaximum()
   {
     Object maxMsgDet = _facesBean.getProperty(_MAXIMUM_MESSAGE_DETAIL_KEY);
     return ComponentUtils.resolveString(maxMsgDet);
   }
 
   /**
    * <p>Custom error message to be used, for creating detail part of the
    * {@link FacesMessage}, when input length is less the set
    * <code>minimum</code> length.</p>
    * Overrides detail message identified by message id {@link #MINIMUM_MESSAGE_ID}
    * @param minimumMessageDetail Custom error message.
    */
   public void setMessageDetailMinimum(String minimumMessageDetail)
   {
     _facesBean.setProperty(_MINIMUM_MESSAGE_DETAIL_KEY, minimumMessageDetail);
   }
 
   /**
    * <p>Return custom detail error message that was set for creating {@link FacesMessage},
    * for cases where, input length is less than the <code>minimum</code> length set.</p>
    * @return Custom error message.
    * @see #setMessageDetailMinimum(String)
    */
   public String getMessageDetailMinimum()
   {
     Object minMsgDet = _facesBean.getProperty(_MINIMUM_MESSAGE_DETAIL_KEY);
     return ComponentUtils.resolveString(minMsgDet);
   }
 
   /**
    * <p>Custom error message to be used, for creating detail part of the
    * {@link FacesMessage}, when input length is not with in the range,
    * when <code>minimum</code> and <code>maximum</code> is set.</p>
    * Overrides detail message identified by message id {@link #NOT_IN_RANGE_MESSAGE_ID}
    * @param notInRangeMessageDetail Custom error message.
    */
   public void setMessageDetailNotInRange(String notInRangeMessageDetail)
   {
     _facesBean.setProperty(_NOT_IN_RANGE_MESSAGE_DETAIL_KEY, notInRangeMessageDetail);
   }
 
   /**
    * <p>Return custom detail error message that was set for creating {@link FacesMessage},
    * for cases where, input length exceeds the <code>maximum</code> length and is
    * less than the <code>minimum</code> length set.</p>
    * @return Custom error message.
    * @see #setMessageDetailNotInRange(String)
    */
   public String getMessageDetailNotInRange()
   {
     Object notInRngMsg = _facesBean.getProperty(_NOT_IN_RANGE_MESSAGE_DETAIL_KEY);
     return ComponentUtils.resolveString(notInRngMsg);
   }
 
 
   /**
    * <p>Custom error message to be used, for creating detail part of the
    * {@link FacesMessage}, 
    * for cases where the maximum and minimum lengths are the same, and
    * the input length does not match.
    * Overrides detail message identified by message id {@link #EXACT_MESSAGE_ID}
    * @param exactMessageDetail Custom error message.
    */
   public void setMessageDetailExact(String exactMessageDetail)
   {
     _facesBean.setProperty(_EXACT_MESSAGE_DETAIL_KEY, exactMessageDetail);
   }
 
   /**
    * <p>Return custom detail error message that was set for creating {@link FacesMessage},
    * for cases where the maximum and minimum lengths are the same, and
    * the input length does not match.</p>
    * @return Custom error message.
    * @see #setMessageDetailExact(String)
    */
   public String getMessageDetailExact()
   {
     Object msg = _facesBean.getProperty(_EXACT_MESSAGE_DETAIL_KEY);
     return ComponentUtils.resolveString(msg);
   }
 
   
   /**
    * <p>Custom hint maximum message.</p>
    * Overrides default hint message
    * @param hintMaximum Custom hint message.
    */
   public void setHintMaximum(String hintMaximum)
   {
     _facesBean.setProperty(_HINT_MAXIMUM_KEY, hintMaximum);
   }
 
   /**
    * <p>Return custom hint maximum message.</p>
    * @return Custom hint message.
    * @see  #setHintMaximum(String)
    */
   public String getHintMaximum()
   {
     Object obj = _facesBean.getProperty(_HINT_MAXIMUM_KEY);
     return ComponentUtils.resolveString(obj);
   }
 
   /**
    * <p>Custom hint minimum message.</p>
    * Overrides default hint message
    * @param hintMinimum Custom hint message.
    */
   public void setHintMinimum(String hintMinimum)
   {
     _facesBean.setProperty(_HINT_MINIMUM_KEY, hintMinimum);
   }
 
   /**
    * <p>Return custom hint minimum message.</p>
    * @return Custom hint message.
    * @see  #setHintMinimum(String)
    */
   public String getHintMinimum()
   {
     Object obj = _facesBean.getProperty(_HINT_MINIMUM_KEY);
     return ComponentUtils.resolveString(obj);
   }
 
   /**
    * <p>Custom hint notInRange message.</p>
    * Overrides default hint message
    * @param hintNotInRange Custom hint message.
    */
   public void setHintNotInRange(String hintNotInRange)
   {
     _facesBean.setProperty(_HINT_NOT_IN_RANGE, hintNotInRange);
   }
 
   /**
    * <p>Return custom hint notInRange message.</p>
    * @return Custom hint message.
    * @see  #setHintNotInRange
    */
   public String getHintNotInRange()
   {
     Object obj = _facesBean.getProperty(_HINT_NOT_IN_RANGE);
     return ComponentUtils.resolveString(obj);
   }
 
 
   /**
    * <p>Custom hint exact message.</p>
    * Overrides default hint message
    * @param hintExact Custom hint message.
    */
   public void setHintExact(String hintExact)
   {
     _facesBean.setProperty(_HINT_EXACT, hintExact);
   }
 
   /**
    * <p>Return custom hint exact message.</p>
    * @return Custom hint message.
    * @see  #setHintExact
    */
   public String getHintExact()
   {
     Object obj = _facesBean.getProperty(_HINT_EXACT);
     return ComponentUtils.resolveString(obj);
   }
   
   @Override
   public void validate(
     FacesContext context,
     UIComponent component,
     Object value
     ) throws ValidatorException
   {
     try
     {
       super.validate(context, component, value);
     }
     catch (ValidatorException ve)
     {
       // We don't really care about the value.  It
       // failed validation in the superclass, so we just
       // care about what sort of message to show
       int min = getMinimum();
       int max = getMaximum();
       
       // FIXME: the default of max should be zero, not MAX_VALUE,
       // at least according to the superclass
       if (max != Integer.MAX_VALUE)
       {
         if (min > 0)
         {
           throw new ValidatorException(
             _getNotInRangeMessage(context, component, value, min, max));
         }
         else
         {
           throw new ValidatorException(
             _getMaximumMessage(context, component, value, max));
         }
       }
       else
       {
         throw new ValidatorException(
           _getMinimumMessage(context, component, value, min));
       }
     }     
   }
 
   //  StateHolder Methods
   @Override
   public Object saveState(FacesContext context)
   {
     return _facesBean.saveState(context);
   }
 
 
   @Override
   public void restoreState(FacesContext context, Object state)
   {
     _facesBean.restoreState(context, state);
   }
 
   /**
    * <p>Set the {@link ValueBinding} used to calculate the value for the
    * specified attribute if any.</p>
    *
    * @param name Name of the attribute for which to set a {@link ValueBinding}
    * @param binding The {@link ValueBinding} to set, or <code>null</code>
    *  to remove any currently set {@link ValueBinding}
    *
    * @exception NullPointerException if <code>name</code>
    *  is <code>null</code>
    * @exception IllegalArgumentException if <code>name</code> is not a valid
    *            attribute of this validator
    */
   public void setValueBinding(String name, ValueBinding binding)
   {
     ValidatorUtils.setValueBinding(_facesBean, name, binding) ;
   }
 
   /**
    * <p>Return the {@link ValueBinding} used to calculate the value for the
    * specified attribute name, if any.</p>
    *
    * @param name Name of the attribute or property for which to retrieve a
    *  {@link ValueBinding}
    *
    * @exception NullPointerException if <code>name</code>
    *  is <code>null</code>
    * @exception IllegalArgumentException if <code>name</code> is not a valid
    * attribute of this validator
    */
   public ValueBinding getValueBinding(String name)
   {
     return ValidatorUtils.getValueBinding(_facesBean, name);
   }
   
   @Override
   public boolean isTransient()
   {
     return (_transientValue);
   }
 
 
   @Override
   public void setTransient(boolean transientValue)
   {
     _transientValue = transientValue;
   }
 
 
   private FacesMessage _getNotInRangeMessage(
       FacesContext context,
       UIComponent component,
       Object value,
       Object min,
       Object max)
   {
     if (min.equals(max))
       return _getExactMessage(context, component, value, min);
 
     Object msg   = _getRawNotInRangeMessageDetail();
     Object label = ValidatorUtils.getComponentLabel(component);
     
     Object[] params = {label, value, min, max};
     
     return MessageFactory.getMessage(context, NOT_IN_RANGE_MESSAGE_ID,
                                      msg, params, component);
   }
 
   
   private Object _getRawNotInRangeMessageDetail()
   {
     return _facesBean.getRawProperty(_NOT_IN_RANGE_MESSAGE_DETAIL_KEY);
   }
 
 
   private FacesMessage _getExactMessage(
       FacesContext context,
       UIComponent component,
       Object value,
       Object minMax)
   {
     Object msg   = _getRawExactMessageDetail();
     Object label = ValidatorUtils.getComponentLabel(component);
     
     Object[] params = {label, value, minMax};
     
     return MessageFactory.getMessage(context, EXACT_MESSAGE_ID,
                                      msg, params, component);
   }
   
 
   private Object _getRawExactMessageDetail()
   {
     return _facesBean.getRawProperty(_EXACT_MESSAGE_DETAIL_KEY);
   }
   
   
   private FacesMessage _getMaximumMessage(
     FacesContext context,
     UIComponent component,
     Object value,
     Object max)
   {
     
     Object msg   = _getRawMaximumMessageDetail();
     Object label = ValidatorUtils.getComponentLabel(component);
     
     Object[] params = {label, value, max};
     
     return MessageFactory.getMessage(context,
                                      MAXIMUM_MESSAGE_ID,
                                      msg,
                                      params,
                                      component);
   }
   
   private Object _getRawMaximumMessageDetail()
   {
     return _facesBean.getRawProperty(_MAXIMUM_MESSAGE_DETAIL_KEY);
   }
   
   private FacesMessage _getMinimumMessage(
     FacesContext context,
     UIComponent component,
     Object value,
     Object min)
   {
     Object msg      = _getRawMinimumMessageDetail();
     Object label    = ValidatorUtils.getComponentLabel(component);
     
     Object[] params = {label, value, min};
     
     return MessageFactory.getMessage(context, MINIMUM_MESSAGE_ID,
                                      msg, params, component);
   }
   
   private Object _getRawMinimumMessageDetail()
   {
     return _facesBean.getRawProperty(_MINIMUM_MESSAGE_DETAIL_KEY);
   }
   
   private static final FacesBean.Type _TYPE = new FacesBean.Type();
   
   // Default is zero, not MIN_VALUE
   private static final PropertyKey _MINIMUM_KEY =
     _TYPE.registerKey("minimum",
                       Integer.class,
                       // Don't rely on autoboxing: there's a method overload
                       Integer.valueOf(0));
 
   // FIXME: the default of the superclass is 0, not MAX_VALUE
   private static final PropertyKey _MAXIMUM_KEY =
     _TYPE.registerKey("maximum", Integer.class,
                       // Don't rely on autoboxing: there's a method overload
                       Integer.valueOf(Integer.MAX_VALUE));
 
   private static final PropertyKey _MAXIMUM_MESSAGE_DETAIL_KEY =
     _TYPE.registerKey("messageDetailMaximum", String.class);
 
   private static final PropertyKey _MINIMUM_MESSAGE_DETAIL_KEY =
     _TYPE.registerKey("messageDetailMinimum", String.class);
 
   private static final PropertyKey _NOT_IN_RANGE_MESSAGE_DETAIL_KEY =
     _TYPE.registerKey("messageDetailNotInRange", String.class);
 
   private static final PropertyKey _EXACT_MESSAGE_DETAIL_KEY =
     _TYPE.registerKey("messageDetailExact", String.class);
 
   private static final PropertyKey  _HINT_MAXIMUM_KEY =
     _TYPE.registerKey("hintMaximum", String.class);
 
   private static final PropertyKey  _HINT_MINIMUM_KEY =
     _TYPE.registerKey("hintMinimum", String.class);
 
   private static final PropertyKey  _HINT_NOT_IN_RANGE =
     _TYPE.registerKey("hintNotInRange", String.class);
 
   private static final PropertyKey  _HINT_EXACT =
     _TYPE.registerKey("hintExact", String.class);
 
   private FacesBean _facesBean = ValidatorUtils.getFacesBean(_TYPE);
 
   private boolean _transientValue = false;
 }