1 package org.apache.velocity.exception; 2 3 import org.apache.velocity.util.ExceptionUtils; 4 5 /* 6 * Licensed to the Apache Software Foundation (ASF) under one 7 * or more contributor license agreements. See the NOTICE file 8 * distributed with this work for additional information 9 * regarding copyright ownership. The ASF licenses this file 10 * to you under the Apache License, Version 2.0 (the 11 * "License"); you may not use this file except in compliance 12 * with the License. You may obtain a copy of the License at 13 * 14 * http://www.apache.org/licenses/LICENSE-2.0 15 * 16 * Unless required by applicable law or agreed to in writing, 17 * software distributed under the License is distributed on an 18 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 19 * KIND, either express or implied. See the License for the 20 * specific language governing permissions and limitations 21 * under the License. 22 */ 23 24 /** 25 * Base class for Velocity runtime exceptions thrown to the 26 * application layer. 27 * 28 * @author <a href="mailto:kdowney@amberarcher.com">Kyle F. Downey</a> 29 * @version $Id: VelocityException.java 685685 2008-08-13 21:43:27Z nbubna $ 30 */ 31 public class VelocityException 32 extends RuntimeException 33 { 34 /** 35 * Version Id for serializable 36 */ 37 private static final long serialVersionUID = 1251243065134956045L; 38 39 private final Throwable wrapped; 40 41 /** 42 * @param exceptionMessage The message to register. 43 */ 44 public VelocityException(final String exceptionMessage) 45 { 46 super(exceptionMessage); 47 wrapped = null; 48 } 49 50 /** 51 * @param exceptionMessage The message to register. 52 * @param wrapped A throwable object that caused the Exception. 53 * @since 1.5 54 */ 55 public VelocityException(final String exceptionMessage, final Throwable wrapped) 56 { 57 super(exceptionMessage); 58 this.wrapped = wrapped; 59 ExceptionUtils.setCause(this, wrapped); 60 } 61 62 /** 63 * @param wrapped A throwable object that caused the Exception. 64 * @since 1.5 65 */ 66 public VelocityException(final Throwable wrapped) 67 { 68 super(); 69 this.wrapped = wrapped; 70 ExceptionUtils.setCause(this, wrapped); 71 } 72 73 /** 74 * returns the wrapped Throwable that caused this 75 * MethodInvocationException to be thrown 76 * 77 * @return Throwable thrown by method invocation 78 * @since 1.5 79 */ 80 public Throwable getWrappedThrowable() 81 { 82 return wrapped; 83 } 84 }