corba/src/share/classes/org/omg/CORBA/portable/RemarshalException.java
author ohair
Tue, 25 May 2010 15:52:11 -0700
changeset 5555 b2b5ed3f0d0d
parent 4 02bb8761fcce
permissions -rw-r--r--
6943119: Rebrand source copyright notices Reviewed-by: darcy
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
4
02bb8761fcce Initial load
duke
parents:
diff changeset
     1
/*
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
     2
 * Copyright (c) 1998, 1999, Oracle and/or its affiliates. All rights reserved.
4
02bb8761fcce Initial load
duke
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
02bb8761fcce Initial load
duke
parents:
diff changeset
     4
 *
02bb8761fcce Initial load
duke
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
02bb8761fcce Initial load
duke
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
4
02bb8761fcce Initial load
duke
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
4
02bb8761fcce Initial load
duke
parents:
diff changeset
    10
 *
02bb8761fcce Initial load
duke
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
02bb8761fcce Initial load
duke
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
02bb8761fcce Initial load
duke
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
02bb8761fcce Initial load
duke
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
02bb8761fcce Initial load
duke
parents:
diff changeset
    15
 * accompanied this code).
02bb8761fcce Initial load
duke
parents:
diff changeset
    16
 *
02bb8761fcce Initial load
duke
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
02bb8761fcce Initial load
duke
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
02bb8761fcce Initial load
duke
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
02bb8761fcce Initial load
duke
parents:
diff changeset
    20
 *
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    23
 * questions.
4
02bb8761fcce Initial load
duke
parents:
diff changeset
    24
 */
02bb8761fcce Initial load
duke
parents:
diff changeset
    25
package org.omg.CORBA.portable;
02bb8761fcce Initial load
duke
parents:
diff changeset
    26
02bb8761fcce Initial load
duke
parents:
diff changeset
    27
/**
02bb8761fcce Initial load
duke
parents:
diff changeset
    28
This class is used for reporting locate forward exceptions and object forward
02bb8761fcce Initial load
duke
parents:
diff changeset
    29
GIOP messages back to the ORB. In this case the ORB must remarshal the request
02bb8761fcce Initial load
duke
parents:
diff changeset
    30
before trying again.
02bb8761fcce Initial load
duke
parents:
diff changeset
    31
Stubs which use the stream-based model shall catch the <code>RemarshalException</code>
02bb8761fcce Initial load
duke
parents:
diff changeset
    32
which is potentially thrown from the <code>_invoke()</code> method of <code>ObjectImpl</code>.
02bb8761fcce Initial load
duke
parents:
diff changeset
    33
Upon catching the exception, the stub shall immediately remarshal the request by calling
02bb8761fcce Initial load
duke
parents:
diff changeset
    34
<code>_request()</code>, marshalling the arguments (if any), and then calling
02bb8761fcce Initial load
duke
parents:
diff changeset
    35
<code>_invoke()</code>. The stub shall repeat this process until <code>_invoke()</code>
02bb8761fcce Initial load
duke
parents:
diff changeset
    36
returns normally or raises some exception other than <code>RemarshalException</code>.
02bb8761fcce Initial load
duke
parents:
diff changeset
    37
*/
02bb8761fcce Initial load
duke
parents:
diff changeset
    38
02bb8761fcce Initial load
duke
parents:
diff changeset
    39
public final class RemarshalException extends Exception {
02bb8761fcce Initial load
duke
parents:
diff changeset
    40
    /**
02bb8761fcce Initial load
duke
parents:
diff changeset
    41
     * Constructs a RemarshalException.
02bb8761fcce Initial load
duke
parents:
diff changeset
    42
     */
02bb8761fcce Initial load
duke
parents:
diff changeset
    43
    public RemarshalException() {
02bb8761fcce Initial load
duke
parents:
diff changeset
    44
        super();
02bb8761fcce Initial load
duke
parents:
diff changeset
    45
    }
02bb8761fcce Initial load
duke
parents:
diff changeset
    46
}