001    /*
002     * Copyright © 2008, 2009 Pedro Agulló Soliveres.
003     * 
004     * This file is part of DirectJNgine.
005     *
006     * DirectJNgine is free software: you can redistribute it and/or modify
007     * it under the terms of the GNU General Public License as published by
008     * the Free Software Foundation, either version 3 of the License.
009     *
010     * DirectJNgine is distributed in the hope that it will be useful,
011     * but WITHOUT ANY WARRANTY; without even the implied warranty of
012     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
013     * GNU General Public License for more details.
014     *
015     * You should have received a copy of the GNU General Public License
016     * along with DirectJNgine.  If not, see <http://www.gnu.org/licenses/>.
017     * 
018     * This software uses the ExtJs library (http://extjs.com), which is 
019     * distributed under the GPL v3 license (see http://extjs.com/license).
020     */
021    
022    package com.softwarementors.extjs.djn.servlet;
023    
024    import java.util.List;
025    
026    import com.softwarementors.extjs.djn.DirectJNgineException;
027    import com.softwarementors.extjs.djn.StringUtils;
028    import com.softwarementors.extjs.djn.router.GsonBuilderConfigurator;
029    
030    public class ServletConfigurationException extends DirectJNgineException {
031      private ServletConfigurationException( String message ) {
032        super(message);
033        
034        assert !StringUtils.isEmpty(message);
035      }
036    
037      private ServletConfigurationException( String message, Throwable cause ) {
038        super(message, cause);
039        
040        assert !StringUtils.isEmpty(message);
041        assert cause != null;
042      }
043    
044      public static ServletConfigurationException forMissingRequiredConfigurationParameter(List<String> missingParameters) {
045        assert missingParameters != null;    
046        assert !missingParameters.isEmpty();
047        
048        String parameterNames = StringUtils.concatWithSeparator(missingParameters, ", ");
049        return new ServletConfigurationException( "The following servlet configuration parameters are missing: " + parameterNames + ". Please, check your servlet configuration in web.xml." );
050      }
051    
052      public static ServletConfigurationException forClassNotFound(String className, ClassNotFoundException cause) {
053        assert cause != null;
054        
055        return new ServletConfigurationException( "Unable to find class '" + className + "'", cause );
056      }
057    
058      public static ServletConfigurationException forGsonBuilderConfiguratorMustImplementGsonBuilderConfiguratorInterface(
059          String configuratorClassName) {
060        return new ServletConfigurationException( "The specified gson configurator class, '" + configuratorClassName + "', must implement the '" + GsonBuilderConfigurator.class + "' interface");
061      }
062    
063      public static ServletConfigurationException forParameterMustBeAnIntegerGreaterOrEqualToValue(String parameterName,
064          int result, int minValue) {
065        assert !StringUtils.isEmpty(parameterName);
066        
067        return new ServletConfigurationException( "Parameter, '" + parameterName + "' must be greater than or equal to '" + minValue + "'. It was '" + result + "'.");
068      }
069    
070      public static ServletConfigurationException forParameterMustBeAValidInteger(String parameterName, String resultString) {
071        assert !StringUtils.isEmpty(parameterName);
072        assert !StringUtils.isEmpty(resultString);
073        
074        return new ServletConfigurationException( "Parameter, '" + parameterName + "' must be a valid integer. It was '" +resultString + "'.");
075      }
076    
077      public static ServletConfigurationException forMaxThreadPoolSizeMustBeEqualOrGreaterThanMinThreadPoolSize(
078          int batchRequestsMinThreadsPoolSize, int batchRequestsMaxThreadsPoolSize) {
079        return new ServletConfigurationException( "The maximum batch request pool ('" + DirectJNgineServlet.GlobalParameters.BATCH_REQUESTS_MAX_THREADS_POOOL_SIZE +"') size was " + batchRequestsMaxThreadsPoolSize + 
080            ". It must be greater or equal to the minimum request pool size ('" + DirectJNgineServlet.GlobalParameters.BATCH_REQUESTS_MIN_THREADS_POOOL_SIZE +"'), which was " + batchRequestsMinThreadsPoolSize);
081      }
082    
083    }