View Javadoc
1   /*
2    * Copyright (c) 1995, 2006, Oracle and/or its affiliates. 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.  Oracle designates this
8    * particular file as subject to the "Classpath" exception as provided
9    * by Oracle 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22   * or visit www.oracle.com if you need additional information or have any
23   * questions.
24   */
25  
26  package org.omg.CORBA;
27  
28  /**
29   * A request or reply from the network is structurally invalid.
30   * This error typically indicates a bug in either the client-side
31   * or server-side run time. For example, if a reply from the server
32   * indicates that the message contains 1000 bytes, but the actual
33   * message is shorter or longer than 1000 bytes, the ORB raises
34   * this exception. <tt>MARSHAL</tt> can also be caused by using
35   * the DII or DSI incorrectly, for example, if the type of the
36   * actual parameters sent does not agree with IDL signature of an
37   * operation.<P>
38   * It contains a minor code, which gives more detailed information about
39   * what caused the exception, and a completion status. It may also contain
40   * a string describing the exception.
41   * <P>
42   * See the section <A href="../../../../technotes/guides/idl/jidlExceptions.html#minorcodemeanings">Minor
43   * Code Meanings</A> to see the minor codes for this exception.
44   *
45   * @since       JDK1.2
46   */
47  
48  public final class MARSHAL extends SystemException {
49      /**
50       * Constructs a <code>MARSHAL</code> exception with a default minor code
51       * of 0, a completion state of CompletionStatus.COMPLETED_NO,
52       * and a null description.
53       */
54      public MARSHAL() {
55          this("");
56      }
57  
58      /**
59       * Constructs a <code>MARSHAL</code> exception with the specified description message,
60       * a minor code of 0, and a completion state of COMPLETED_NO.
61       * @param s the String containing a description of the exception
62       */
63      public MARSHAL(String s) {
64          this(s, 0, CompletionStatus.COMPLETED_NO);
65      }
66  
67      /**
68       * Constructs a <code>MARSHAL</code> exception with the specified
69       * minor code and completion status.
70       * @param minor the minor code
71       * @param completed the completion status
72       */
73      public MARSHAL(int minor, CompletionStatus completed) {
74          this("", minor, completed);
75      }
76  
77      /**
78       * Constructs a <code>MARSHAL</code> exception with the specified description
79       * message, minor code, and completion status.
80       * @param s the String containing a description message
81       * @param minor the minor code
82       * @param completed the completion status
83       */
84      public MARSHAL(String s, int minor, CompletionStatus completed) {
85          super(s, minor, completed);
86      }
87  }