emul/compact/src/main/java/java/util/ServiceConfigurationError.java
author Jaroslav Tulach <jaroslav.tulach@apidesign.org>
Wed, 23 Jan 2013 22:32:27 +0100
branchjdk7-b147
changeset 557 5be31d9fa455
permissions -rw-r--r--
Basic classes needed to support ServiceLoader
jaroslav@557
     1
/*
jaroslav@557
     2
 * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved.
jaroslav@557
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
jaroslav@557
     4
 *
jaroslav@557
     5
 * This code is free software; you can redistribute it and/or modify it
jaroslav@557
     6
 * under the terms of the GNU General Public License version 2 only, as
jaroslav@557
     7
 * published by the Free Software Foundation.  Oracle designates this
jaroslav@557
     8
 * particular file as subject to the "Classpath" exception as provided
jaroslav@557
     9
 * by Oracle in the LICENSE file that accompanied this code.
jaroslav@557
    10
 *
jaroslav@557
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
jaroslav@557
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
jaroslav@557
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
jaroslav@557
    14
 * version 2 for more details (a copy is included in the LICENSE file that
jaroslav@557
    15
 * accompanied this code).
jaroslav@557
    16
 *
jaroslav@557
    17
 * You should have received a copy of the GNU General Public License version
jaroslav@557
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
jaroslav@557
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
jaroslav@557
    20
 *
jaroslav@557
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
jaroslav@557
    22
 * or visit www.oracle.com if you need additional information or have any
jaroslav@557
    23
 * questions.
jaroslav@557
    24
 */
jaroslav@557
    25
jaroslav@557
    26
package java.util;
jaroslav@557
    27
jaroslav@557
    28
jaroslav@557
    29
/**
jaroslav@557
    30
 * Error thrown when something goes wrong while loading a service provider.
jaroslav@557
    31
 *
jaroslav@557
    32
 * <p> This error will be thrown in the following situations:
jaroslav@557
    33
 *
jaroslav@557
    34
 * <ul>
jaroslav@557
    35
 *
jaroslav@557
    36
 *   <li> The format of a provider-configuration file violates the <a
jaroslav@557
    37
 *   href="ServiceLoader.html#format">specification</a>; </li>
jaroslav@557
    38
 *
jaroslav@557
    39
 *   <li> An {@link java.io.IOException IOException} occurs while reading a
jaroslav@557
    40
 *   provider-configuration file; </li>
jaroslav@557
    41
 *
jaroslav@557
    42
 *   <li> A concrete provider class named in a provider-configuration file
jaroslav@557
    43
 *   cannot be found; </li>
jaroslav@557
    44
 *
jaroslav@557
    45
 *   <li> A concrete provider class is not a subclass of the service class;
jaroslav@557
    46
 *   </li>
jaroslav@557
    47
 *
jaroslav@557
    48
 *   <li> A concrete provider class cannot be instantiated; or
jaroslav@557
    49
 *
jaroslav@557
    50
 *   <li> Some other kind of error occurs. </li>
jaroslav@557
    51
 *
jaroslav@557
    52
 * </ul>
jaroslav@557
    53
 *
jaroslav@557
    54
 *
jaroslav@557
    55
 * @author Mark Reinhold
jaroslav@557
    56
 * @since 1.6
jaroslav@557
    57
 */
jaroslav@557
    58
jaroslav@557
    59
public class ServiceConfigurationError
jaroslav@557
    60
    extends Error
jaroslav@557
    61
{
jaroslav@557
    62
jaroslav@557
    63
    private static final long serialVersionUID = 74132770414881L;
jaroslav@557
    64
jaroslav@557
    65
    /**
jaroslav@557
    66
     * Constructs a new instance with the specified message.
jaroslav@557
    67
     *
jaroslav@557
    68
     * @param  msg  The message, or <tt>null</tt> if there is no message
jaroslav@557
    69
     *
jaroslav@557
    70
     */
jaroslav@557
    71
    public ServiceConfigurationError(String msg) {
jaroslav@557
    72
        super(msg);
jaroslav@557
    73
    }
jaroslav@557
    74
jaroslav@557
    75
    /**
jaroslav@557
    76
     * Constructs a new instance with the specified message and cause.
jaroslav@557
    77
     *
jaroslav@557
    78
     * @param  msg  The message, or <tt>null</tt> if there is no message
jaroslav@557
    79
     *
jaroslav@557
    80
     * @param  cause  The cause, or <tt>null</tt> if the cause is nonexistent
jaroslav@557
    81
     *                or unknown
jaroslav@557
    82
     */
jaroslav@557
    83
    public ServiceConfigurationError(String msg, Throwable cause) {
jaroslav@557
    84
        super(msg, cause);
jaroslav@557
    85
    }
jaroslav@557
    86
jaroslav@557
    87
}