src/share/classes/org/omg/CORBA/PrincipalHolder.java

Sat, 07 Jun 2014 10:09:30 +0100

author
coffeys
date
Sat, 07 Jun 2014 10:09:30 +0100
changeset 660
009fc3f785a9
parent 158
91006f157c46
child 748
6845b95cba6b
permissions
-rw-r--r--

8042789: org.omg.CORBA.ORBSingletonClass loading no longer uses context class loader
Reviewed-by: alanb, lancea

     1 /*
     2  * Copyright (c) 1996, 2004, 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  */
    26 package org.omg.CORBA;
    28 import org.omg.CORBA.portable.Streamable;
    29 import org.omg.CORBA.portable.InputStream;
    30 import org.omg.CORBA.portable.OutputStream;
    33 /**
    34  * The Holder for <tt>Principal</tt>.  For more information on
    35  * Holder files, see <a href="doc-files/generatedfiles.html#holder">
    36  * "Generated Files: Holder Files"</a>.<P>
    37  * A container class for values of type <code>Principal</code>
    38  * that is used to store "out" and "inout" parameters in IDL methods.
    39  * If an IDL method signature has an IDL <code>Principal</code> as an "out"
    40  * or "inout" parameter, the programmer must pass an instance of
    41  * <code>PrincipalHolder</code> as the corresponding
    42  * parameter in the method invocation; for "inout" parameters, the programmer
    43  * must also fill the "in" value to be sent to the server.
    44  * Before the method invocation returns, the ORB will fill in the
    45  * value corresponding to the "out" value returned from the server.
    46  * <P>
    47  * If <code>myPrincipalHolder</code> is an instance of <code>PrincipalHolder</code>,
    48  * the value stored in its <code>value</code> field can be accessed with
    49  * <code>myPrincipalHolder.value</code>.
    50  *
    51  * @since       JDK1.2
    52  * @deprecated Deprecated by CORBA 2.2.
    53  */
    54 @Deprecated
    55 public final class PrincipalHolder implements Streamable {
    56     /**
    57      * The <code>Principal</code> value held by this <code>PrincipalHolder</code>
    58      * object.
    59      */
    60     public Principal value;
    62     /**
    63      * Constructs a new <code>PrincipalHolder</code> object with its
    64      * <code>value</code> field initialized to <code>null</code>.
    65      */
    66     public PrincipalHolder() {
    67     }
    69     /**
    70      * Constructs a new <code>PrincipalHolder</code> object with its
    71      * <code>value</code> field initialized to the given
    72      * <code>Principal</code> object.
    73      * @param initial the <code>Principal</code> with which to initialize
    74      *                the <code>value</code> field of the newly-created
    75      *                <code>PrincipalHolder</code> object
    76      */
    77     public PrincipalHolder(Principal initial) {
    78         value = initial;
    79     }
    81     public void _read(InputStream input) {
    82         value = input.read_Principal();
    83     }
    85     public void _write(OutputStream output) {
    86         output.write_Principal(value);
    87     }
    89     public org.omg.CORBA.TypeCode _type() {
    90         return ORB.init().get_primitive_tc(TCKind.tk_Principal);
    91     }
    93 }

mercurial