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

Mon, 20 Apr 2009 00:12:19 -0700

author
tbell
date
Mon, 20 Apr 2009 00:12:19 -0700
changeset 68
4906dae0c5fa
parent 1
55540e827aef
child 158
91006f157c46
permissions
-rw-r--r--

6372405: Server thread hangs when fragments don't complete because of connection abort
5104239: Java: thread deadlock
6191561: JCK15: api/org_omg/PortableInterceptor/ClientRequestInfo/index.html#RIMethods sometime hang
6486322: org.omg.CORBA.ORB.init() thread safety issue
6420980: Security issue with the com.sun.corba.se.impl.orbutil.ORBUtility class
6465377: NullPointerException for RMI ORB in 1.5.0_08
6553303: Corba application fails w/ org.omg.CORBA.COMM_FAILURE: vmcid: SUN minor code: 203 completed: No
6438259: Wrong repository ID generated by IDLJ
Reviewed-by: darcy

duke@1 1 /*
duke@1 2 * Copyright 1995-2001 Sun Microsystems, Inc. All Rights Reserved.
duke@1 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@1 4 *
duke@1 5 * This code is free software; you can redistribute it and/or modify it
duke@1 6 * under the terms of the GNU General Public License version 2 only, as
duke@1 7 * published by the Free Software Foundation. Sun designates this
duke@1 8 * particular file as subject to the "Classpath" exception as provided
duke@1 9 * by Sun in the LICENSE file that accompanied this code.
duke@1 10 *
duke@1 11 * This code is distributed in the hope that it will be useful, but WITHOUT
duke@1 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@1 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@1 14 * version 2 for more details (a copy is included in the LICENSE file that
duke@1 15 * accompanied this code).
duke@1 16 *
duke@1 17 * You should have received a copy of the GNU General Public License version
duke@1 18 * 2 along with this work; if not, write to the Free Software Foundation,
duke@1 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@1 20 *
duke@1 21 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
duke@1 22 * CA 95054 USA or visit www.sun.com if you need additional information or
duke@1 23 * have any questions.
duke@1 24 */
duke@1 25
duke@1 26
duke@1 27 package org.omg.CORBA;
duke@1 28
duke@1 29 import org.omg.CORBA.portable.Streamable;
duke@1 30 import org.omg.CORBA.portable.InputStream;
duke@1 31 import org.omg.CORBA.portable.OutputStream;
duke@1 32
duke@1 33 /**
duke@1 34 * The Holder for <tt>Char</tt>. For more information on
duke@1 35 * Holder files, see <a href="doc-files/generatedfiles.html#holder">
duke@1 36 * "Generated Files: Holder Files"</a>.<P>
duke@1 37 * A Holder class for a <code>char</code>
duke@1 38 * that is used to store "out" and "inout" parameters in IDL methods.
duke@1 39 * If an IDL method signature has an IDL <code>char</code> as an "out"
duke@1 40 * or "inout" parameter, the programmer must pass an instance of
duke@1 41 * <code>CharHolder</code> as the corresponding
duke@1 42 * parameter in the method invocation; for "inout" parameters, the programmer
duke@1 43 * must also fill the "in" value to be sent to the server.
duke@1 44 * Before the method invocation returns, the ORB will fill in the
duke@1 45 * value corresponding to the "out" value returned from the server.
duke@1 46 * <P>
duke@1 47 * If <code>myCharHolder</code> is an instance of <code>CharHolder</code>,
duke@1 48 * the value stored in its <code>value</code> field can be accessed with
duke@1 49 * <code>myCharHolder.value</code>.
duke@1 50 *
duke@1 51 * @since JDK1.2
duke@1 52 */
duke@1 53 public final class CharHolder implements Streamable {
duke@1 54
duke@1 55 /**
duke@1 56 * The <code>char</code> value held by this <code>CharHolder</code>
duke@1 57 * object.
duke@1 58 */
duke@1 59 public char value;
duke@1 60
duke@1 61 /**
duke@1 62 * Constructs a new <code>CharHolder</code> object with its
duke@1 63 * <code>value</code> field initialized to <code>0</code>.
duke@1 64 */
duke@1 65 public CharHolder() {
duke@1 66 }
duke@1 67
duke@1 68 /**
duke@1 69 * Constructs a new <code>CharHolder</code> object for the given
duke@1 70 * <code>char</code>.
duke@1 71 * @param initial the <code>char</code> with which to initialize
duke@1 72 * the <code>value</code> field of the new
duke@1 73 * <code>CharHolder</code> object
duke@1 74 */
duke@1 75 public CharHolder(char initial) {
duke@1 76 value = initial;
duke@1 77 }
duke@1 78
duke@1 79 /**
duke@1 80 * Reads from <code>input</code> and initalizes the value in
duke@1 81 * this <code>CharHolder</code> object
duke@1 82 * with the unmarshalled data.
duke@1 83 *
duke@1 84 * @param input the InputStream containing CDR formatted data from the wire
duke@1 85 */
duke@1 86 public void _read(InputStream input) {
duke@1 87 value = input.read_char();
duke@1 88 }
duke@1 89
duke@1 90 /**
duke@1 91 * Marshals to <code>output</code> the value in
duke@1 92 * this <code>CharHolder</code> object.
duke@1 93 *
duke@1 94 * @param output the OutputStream which will contain the CDR formatted data
duke@1 95 */
duke@1 96 public void _write(OutputStream output) {
duke@1 97 output.write_char(value);
duke@1 98 }
duke@1 99
duke@1 100 /**
duke@1 101 * Returns the <code>TypeCode</code> object corresponding
duke@1 102 * to the value held in
duke@1 103 * this <code>CharHolder</code> object.
duke@1 104 *
duke@1 105 * @return the TypeCode of the value held in
duke@1 106 * this <code>CharHolder</code> object
duke@1 107 */
duke@1 108 public org.omg.CORBA.TypeCode _type() {
duke@1 109 return ORB.init().get_primitive_tc(TCKind.tk_char);
duke@1 110 }
duke@1 111 }

mercurial