1 /*
2 * Copyright 1996-1998 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.rmi;
27
28 /**
29 * An <code>UnmarshalException</code> can be thrown while unmarshalling the
30 * parameters or results of a remote method call if any of the following
31 * conditions occur:
32 * <ul>
33 * <li> if an exception occurs while unmarshalling the call header
34 * <li> if the protocol for the return value is invalid
35 * <li> if a <code>java.io.IOException</code> occurs unmarshalling
36 * parameters (on the server side) or the return value (on the client side).
37 * <li> if a <code>java.lang.ClassNotFoundException</code> occurs during
38 * unmarshalling parameters or return values
39 * <li> if no skeleton can be loaded on the server-side; note that skeletons
40 * are required in the 1.1 stub protocol, but not in the 1.2 stub protocol.
41 * <li> if the method hash is invalid (i.e., missing method).
42 * <li> if there is a failure to create a remote reference object for
43 * a remote object's stub when it is unmarshalled.
44 * </ul>
45 *
46 * @author Ann Wollrath
47 * @since JDK1.1
48 */
49 public class UnmarshalException extends RemoteException {
50
51 /* indicate compatibility with JDK 1.1.x version of class */
52 private static final long serialVersionUID = 594380845140740218L;
53
54 /**
55 * Constructs an <code>UnmarshalException</code> with the specified
56 * detail message.
57 *
58 * @param s the detail message
59 * @since JDK1.1
60 */
61 public UnmarshalException(String s) {
62 super(s);
63 }
64
65 /**
66 * Constructs an <code>UnmarshalException</code> with the specified
67 * detail message and nested exception.
68 *
69 * @param s the detail message
70 * @param ex the nested exception
71 * @since JDK1.1
72 */
73 public UnmarshalException(String s, Exception ex) {
74 super(s, ex);
75 }
76 }