1 /* 2 * Licensed to the Apache Software Foundation (ASF) under one or more 3 * contributor license agreements. See the NOTICE file distributed with 4 * this work for additional information regarding copyright ownership. 5 * The ASF licenses this file to You under the Apache License, Version 2.0 6 * (the "License"); you may not use this file except in compliance with 7 * the License. You may obtain a copy of the License at 8 * 9 * http://www.apache.org/licenses/LICENSE-2.0 10 * 11 * Unless required by applicable law or agreed to in writing, software 12 * distributed under the License is distributed on an "AS IS" BASIS, 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 */ 17 18 19 package org.apache.commons.beanutils; 20 21 22 /** 23 * <p>A <strong>ConversionException</strong> indicates that a call to 24 * <code>Converter.convert()</code> has failed to complete successfully. 25 * 26 * @since 1.3 27 * @version $Id$ 28 */ 29 30 public class ConversionException extends RuntimeException { 31 32 33 // ----------------------------------------------------------- Constructors 34 35 36 /** 37 * Construct a new exception with the specified message. 38 * 39 * @param message The message describing this exception 40 */ 41 public ConversionException(final String message) { 42 43 super(message); 44 45 } 46 47 48 /** 49 * Construct a new exception with the specified message and root cause. 50 * 51 * @param message The message describing this exception 52 * @param cause The root cause of this exception 53 */ 54 public ConversionException(final String message, final Throwable cause) { 55 56 super(message); 57 this.cause = cause; 58 59 } 60 61 62 /** 63 * Construct a new exception with the specified root cause. 64 * 65 * @param cause The root cause of this exception 66 */ 67 public ConversionException(final Throwable cause) { 68 69 super(cause.getMessage()); 70 this.cause = cause; 71 72 } 73 74 75 // ------------------------------------------------------------- Properties 76 77 78 /** 79 * The root cause of this <code>ConversionException</code>, compatible with 80 * JDK 1.4's extensions to <code>java.lang.Throwable</code>. 81 */ 82 protected Throwable cause = null; 83 84 /** 85 * Return the root cause of this conversion exception. 86 * @return the root cause of this conversion exception 87 */ 88 @Override 89 public Throwable getCause() { 90 return (this.cause); 91 } 92 93 94 }