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 Lesser General Public License as published by
008     * the Free Software Foundation, either version 3 of the License.
009     *
010     * Commercial use is permitted to the extent that the code/component(s)
011     * do NOT become part of another Open Source or Commercially developed
012     * licensed development library or toolkit without explicit permission.
013     *
014     * DirectJNgine is distributed in the hope that it will be useful,
015     * but WITHOUT ANY WARRANTY; without even the implied warranty of
016     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
017     * GNU Lesser General Public License for more details.
018     *
019     * You should have received a copy of the GNU Lesser General Public License
020     * along with DirectJNgine.  If not, see <http://www.gnu.org/licenses/>.
021     * 
022     * This software uses the ExtJs library (http://extjs.com), which is 
023     * distributed under the GPL v3 license (see http://extjs.com/license).
024     */
025    
026    package com.softwarementors.extjs.djn;
027    
028    import java.io.UnsupportedEncodingException;
029    import java.util.concurrent.ExecutionException;
030    
031    public class UnexpectedException extends DirectJNgineException {
032      private static final long serialVersionUID = 5820146417838838357L;
033    
034      private UnexpectedException( String message, Throwable cause) {
035        super( message, cause);
036      }
037      
038      public static UnexpectedException forExpectingUTF8UrlEncodingIsAlwaysSupportedByURLEncoder( UnsupportedEncodingException cause ) {
039        assert cause != null;
040        
041        return new UnexpectedException( "Possible DirectJNgine BUG: We assumed that UTF8 encoding is always supported by URLEncoder.", cause);
042      }
043    
044      public static UnexpectedException forExecutionExceptionShouldNotHappenBecauseProcessorHandlesExceptionsAsServerErrorResponses(ExecutionException cause) {
045        assert cause != null;
046        
047        return new UnexpectedException( "Possible DirectJNgine BUG: We assumed that an ExecutionException must never happen because all Java method execution exceptions are caught and handled by the request processor and turned into server error responses -and are never re-thrown.", cause);
048      }
049    
050    }