001 /*
002 * jDTAUS - DTAUS fileformat.
003 * Copyright (c) 2005 Christian Schulte <cs@schulte.it>
004 *
005 * This library is free software; you can redistribute it and/or
006 * modify it under the terms of the GNU Lesser General Public
007 * License as published by the Free Software Foundation; either
008 * version 2.1 of the License, or any later version.
009 *
010 * This library is distributed in the hope that it will be useful,
011 * but WITHOUT ANY WARRANTY; without even the implied warranty of
012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
013 * Lesser General Public License for more details.
014 *
015 * You should have received a copy of the GNU Lesser General Public
016 * License along with this library; if not, write to the Free Software
017 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
018 *
019 */
020 package org.jdtaus.core.container;
021
022 import java.util.Locale;
023
024 /**
025 * Gets thrown when creating an instance of an implementation fails.
026 *
027 * @author <a href="mailto:cs@schulte.it">Christian Schulte</a>
028 * @version $Id: InstantiationException.java 1914 2007-03-01 02:20:44Z schulte2005 $
029 */
030 public class InstantiationException extends IllegalStateException
031 {
032
033 //--Constructors------------------------------------------------------------
034
035 /**
036 * Creates a new {@code InstantiationException} instance.
037 *
038 * @param identifier the identifier of the implementation for which creating
039 * an instance failed.
040 * @param cause the cause of the exception.
041 */
042 public InstantiationException(final String identifier,
043 final Throwable cause)
044 {
045
046 super(InstantiationExceptionBundle.getInstantiationMessage(
047 Locale.getDefault()).format(new Object[] { identifier }));
048
049 this.initCause(cause);
050 this.identifier = identifier;
051 }
052
053 //------------------------------------------------------------Constructors--
054 //--InstantiationException--------------------------------------------------
055
056 /**
057 * The identifier of the implementation for which creating an instance
058 * failed.
059 * @serial
060 */
061 private String identifier;
062
063 /**
064 * Gets the identifier of the implementation for which creating an instance
065 * failed.
066 *
067 * @return the identifier of the implementation for which creating an
068 * instance failed or {@code null}.
069 */
070 public String getIdentifier()
071 {
072 return this.identifier;
073 }
074
075 //--------------------------------------------------InstantiationException--
076
077 }