1. /* ====================================================================
  2. * The Apache Software License, Version 1.1
  3. *
  4. * Copyright (c) 2002-2003 The Apache Software Foundation. All rights
  5. * reserved.
  6. *
  7. * Redistribution and use in source and binary forms, with or without
  8. * modification, are permitted provided that the following conditions
  9. * are met:
  10. *
  11. * 1. Redistributions of source code must retain the above copyright
  12. * notice, this list of conditions and the following disclaimer.
  13. *
  14. * 2. Redistributions in binary form must reproduce the above copyright
  15. * notice, this list of conditions and the following disclaimer in
  16. * the documentation and/or other materials provided with the
  17. * distribution.
  18. *
  19. * 3. The end-user documentation included with the redistribution, if
  20. * any, must include the following acknowledgement:
  21. * "This product includes software developed by the
  22. * Apache Software Foundation (http://www.apache.org/)."
  23. * Alternately, this acknowledgement may appear in the software itself,
  24. * if and wherever such third-party acknowledgements normally appear.
  25. *
  26. * 4. The names "The Jakarta Project", "Commons", and "Apache Software
  27. * Foundation" must not be used to endorse or promote products derived
  28. * from this software without prior written permission. For written
  29. * permission, please contact apache@apache.org.
  30. *
  31. * 5. Products derived from this software may not be called "Apache"
  32. * nor may "Apache" appear in their names without prior written
  33. * permission of the Apache Software Foundation.
  34. *
  35. * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  36. * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  37. * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  38. * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  39. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  40. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  41. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  42. * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  43. * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  44. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  45. * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  46. * SUCH DAMAGE.
  47. * ====================================================================
  48. *
  49. * This software consists of voluntary contributions made by many
  50. * individuals on behalf of the Apache Software Foundation. For more
  51. * information on the Apache Software Foundation, please see
  52. * <http://www.apache.org/>.
  53. */
  54. package org.apache.commons.lang;
  55. /**
  56. * <p>Thrown when an object is an instance of an unexpected type (a class or interface).</p>
  57. *
  58. * @author Matthew Hawthorne
  59. * @author Gary Gregory
  60. * @since 2.0
  61. * @version $Id: IllegalClassException.java,v 1.5 2003/08/18 02:22:23 bayard Exp $
  62. */
  63. public class IllegalClassException extends IllegalArgumentException {
  64. /**
  65. * <p>Instantiates with the specified types (classes or interfaces).</p>
  66. *
  67. * @param expected the expected type
  68. * @param actual the actual type
  69. */
  70. public IllegalClassException(Class expected, Class actual) {
  71. super(
  72. "Expected: "
  73. + safeGetClassName(expected)
  74. + ", actual: "
  75. + safeGetClassName(actual));
  76. }
  77. /**
  78. * <p>Instantiates with the specified message.</p>
  79. *
  80. * @param message the exception message
  81. */
  82. public IllegalClassException(String message) {
  83. super(message);
  84. }
  85. /**
  86. * <p>Returns the class name or <code>null</code> if the class is
  87. * <code>null</code>.</p>
  88. *
  89. * @param cls a <code>Class</code>
  90. * @return the name of <code>cls</code>, or <code>null</code> if if <code>cls</code> is <code>null</code>.
  91. */
  92. private static final String safeGetClassName(Class cls) {
  93. return cls == null ? null : cls.getName();
  94. }
  95. }