OpenNebula

package org.opennebula.client;

/**

 * OpenNebulaConfigurationException

 *

 * Thrown whenever the configuration  contains errors that prevent the

 * instantiations of a Client instance.

 *

 * This should have been a subclass of Error, since there's no chance

 * you can fix the situation from within the code, you have to stop

 * the JVM, fix the configuration and restart.

 *

 * "An Error is a subclass of Throwable that indicates serious

 * problems that a reasonable application should not try to

 * catch. Most such errors are abnormal conditions. The ThreadDeath

 * error, though a "normal" condition, is also a subclass of Error

 * because most applications should not try to catch it.

 *

 * A method is not required to declare in its throws clause any

 * subclasses of Error that might be thrown during the execution of

 * the method but not caught, since these errors are abnormal

 * conditions that should never occur."

 * 

 * (from Error class documentation)

 *

 * Why RuntimeException ? Because RuntimeExceptions are unchecked (you

 * should not write a catch block for

 * OpenNebulaConfigurationException) and are a subclass of Exception,

 * therefore they do not break previous code, while Error comes from

 * Throwable and that breaks catch(Exception e) blocks in legacy code.

 *

 * Created: Mon Apr 11 18:43:53 2011

 *

 * @author <a href="mailto:saint@eng.it">Gian Uberto Lauri</a>

 * @version $Revision$

 */

public class OpenNebulaConfigurationError extends RuntimeException {

        /**

         * Creates a new instance of <code>OpenNebulaConfigurationError</code> .

         *

         */

        public OpenNebulaConfigurationError(String message) {

                super(message);

        }

}