001 /*
002 * GeoAPI - Java interfaces for OGC/ISO standards
003 * http://www.geoapi.org
004 *
005 * Copyright (C) 2004-2012 Open Geospatial Consortium, Inc.
006 * All Rights Reserved. http://www.opengeospatial.org/ogc/legal
007 *
008 * Permission to use, copy, and modify this software and its documentation, with
009 * or without modification, for any purpose and without fee or royalty is hereby
010 * granted, provided that you include the following on ALL copies of the software
011 * and documentation or portions thereof, including modifications, that you make:
012 *
013 * 1. The full text of this NOTICE in a location viewable to users of the
014 * redistributed or derivative work.
015 * 2. Notice of any changes or modifications to the OGC files, including the
016 * date changes were made.
017 *
018 * THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE
019 * NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
020 * TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT
021 * THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY
022 * PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
023 *
024 * COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
025 * CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
026 *
027 * The name and trademarks of copyright holders may NOT be used in advertising or
028 * publicity pertaining to the software without specific, written prior permission.
029 * Title to copyright in this software and any associated documentation will at all
030 * times remain with copyright holders.
031 */
032 package org.opengis.util;
033
034
035 /**
036 * Thrown when a {@linkplain Factory factory} can't create an instance
037 * of the requested object.
038 * <p>
039 * If the failure is caused by an illegal authority code, then the actual exception should
040 * be {@link org.opengis.referencing.NoSuchAuthorityCodeException}. Otherwise, if the failure
041 * is caused by some error in the underlying database (e.g. {@link java.io.IOException} or
042 * {@link java.sql.SQLException}), then the cause shall be specified to the constructor.
043 *
044 * @departure extension
045 * This exception is not part of the OGC specification.
046 *
047 * @author Martin Desruisseaux (IRD)
048 * @version 3.0
049 * @since 1.0
050 *
051 * @see org.opengis.referencing.operation.CoordinateOperationFactory
052 */
053 public class FactoryException extends Exception {
054 /**
055 * Serial number for inter-operability with different versions.
056 */
057 private static final long serialVersionUID = -3414250034883898315L;
058
059 /**
060 * Construct an exception with no detail message.
061 */
062 public FactoryException() {
063 }
064
065 /**
066 * Constructs an exception with the specified detail message.
067 *
068 * @param message The detail message. The detail message is saved
069 * for later retrieval by the {@link #getMessage()} method.
070 */
071 public FactoryException(String message) {
072 super(message);
073 }
074
075 /**
076 * Constructs an exception with the specified cause.
077 *
078 * @param cause The cause for this exception. The cause is saved
079 * for later retrieval by the {@link #getCause()} method.
080 */
081 public FactoryException(Throwable cause) {
082 super(cause);
083 }
084
085 /**
086 * Constructs an exception with the specified detail message and cause.
087 * The cause is the exception thrown in the underlying database
088 * (e.g. {@link java.io.IOException} or {@link java.sql.SQLException}).
089 *
090 * @param message The detail message. The detail message is saved
091 * for later retrieval by the {@link #getMessage()} method.
092 * @param cause The cause for this exception. The cause is saved
093 * for later retrieval by the {@link #getCause()} method.
094 */
095 public FactoryException(String message, Throwable cause) {
096 super(message, cause);
097 }
098 }