1 /*
2 * Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Sun designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Sun in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22 * CA 95054 USA or visit www.sun.com if you need additional information or
23 * have any questions.
24 */
25
26 package java.util;
27
28 import java.io.NotSerializableException;
29 import java.io.IOException;
30
31 /**
32 * Thrown to indicate that an operation could not complete because
33 * the input did not conform to the appropriate XML document type
34 * for a collection of properties, as per the {@link Properties}
35 * specification.<p>
36 *
37 * Note, that although InvalidPropertiesFormatException inherits Serializable
38 * interface from Exception, it is not intended to be Serializable. Appropriate
39 * serialization methods are implemented to throw NotSerializableException.
40 *
41 * @see Properties
42 * @since 1.5
43 * @serial exclude
44 */
45
46 public class InvalidPropertiesFormatException extends IOException {
47 /**
48 * Constructs an InvalidPropertiesFormatException with the specified
49 * cause.
50 *
51 * @param cause the cause (which is saved for later retrieval by the
52 * {@link Throwable#getCause()} method).
53 */
54 public InvalidPropertiesFormatException(Throwable cause) {
55 super(cause==null ? null : cause.toString());
56 this.initCause(cause);
57 }
58
59 /**
60 * Constructs an InvalidPropertiesFormatException with the specified
61 * detail message.
62 *
63 * @param message the detail message. The detail message is saved for
64 * later retrieval by the {@link Throwable#getMessage()} method.
65 */
66 public InvalidPropertiesFormatException(String message) {
67 super(message);
68 }
69
70 /**
71 * Throws NotSerializableException, since InvalidPropertiesFormatException
72 * objects are not intended to be serializable.
73 */
74 private void writeObject(java.io.ObjectOutputStream out)
75 throws NotSerializableException
76 {
77 throw new NotSerializableException("Not serializable.");
78 }
79
80 /**
81 * Throws NotSerializableException, since InvalidPropertiesFormatException
82 * objects are not intended to be serializable.
83 */
84 private void readObject(java.io.ObjectInputStream in)
85 throws NotSerializableException
86 {
87 throw new NotSerializableException("Not serializable.");
88 }
89
90 }