1 /* 2 * ==================================================================== 3 * Licensed to the Apache Software Foundation (ASF) under one 4 * or more contributor license agreements. See the NOTICE file 5 * distributed with this work for additional information 6 * regarding copyright ownership. The ASF licenses this file 7 * to you under the Apache License, Version 2.0 (the 8 * "License"); you may not use this file except in compliance 9 * with the License. You may obtain a copy of the License at 10 * 11 * http://www.apache.org/licenses/LICENSE-2.0 12 * 13 * Unless required by applicable law or agreed to in writing, 14 * software distributed under the License is distributed on an 15 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16 * KIND, either express or implied. See the License for the 17 * specific language governing permissions and limitations 18 * under the License. 19 * ==================================================================== 20 * 21 * This software consists of voluntary contributions made by many 22 * individuals on behalf of the Apache Software Foundation. For more 23 * information on the Apache Software Foundation, please see 24 * <http://www.apache.org/>. 25 * 26 */ 27 28 package org.apache.http; 29 30 /** 31 * Signals that an HTTP exception has occurred. 32 * 33 * @since 4.0 34 */ 35 public class HttpException extends Exception { 36 37 private static final int FIRST_VALID_CHAR = 32; 38 private static final long serialVersionUID = -5437299376222011036L; 39 40 /** 41 * Converts characters < 32 to hex. 42 * 43 * @param message 44 * the source string. 45 * @return a converted string. 46 */ 47 static String clean(final String message) { 48 final char[] chars = message.toCharArray(); 49 int i; 50 // First check to see if need to allocate a new StringBuilder 51 for (i = 0; i < chars.length; i++) { 52 if (chars[i] < FIRST_VALID_CHAR) { 53 break; 54 } 55 } 56 if (i == chars.length) { 57 return message; 58 } 59 final StringBuilder builder = new StringBuilder(chars.length * 2); 60 for (i = 0; i < chars.length; i++) { 61 final char ch = chars[i]; 62 if (ch < FIRST_VALID_CHAR) { 63 builder.append("[0x"); 64 final String hexString = Integer.toHexString(i); 65 if (hexString.length() == 1) { 66 builder.append("0"); 67 } 68 builder.append(hexString); 69 builder.append("]"); 70 } else { 71 builder.append(ch); 72 } 73 } 74 return builder.toString(); 75 } 76 77 /** 78 * Creates a new HttpException with a {@code null} detail message. 79 */ 80 public HttpException() { 81 super(); 82 } 83 84 /** 85 * Creates a new HttpException with the specified detail message. 86 * 87 * @param message 88 * the exception detail message 89 */ 90 public HttpException(final String message) { 91 super(clean(message)); 92 } 93 94 /** 95 * Creates a new HttpException with the specified detail message and cause. 96 * 97 * @param message 98 * the exception detail message 99 * @param cause 100 * the {@code Throwable} that caused this exception, or 101 * {@code null} if the cause is unavailable, unknown, or not a 102 * {@code Throwable} 103 */ 104 public HttpException(final String message, final Throwable cause) { 105 super(clean(message)); 106 initCause(cause); 107 } 108 109 }