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

Wed, 27 Apr 2016 01:21:28 +0800

author
aoqi
date
Wed, 27 Apr 2016 01:21:28 +0800
changeset 0
7ef37b2cdcad
child 748
6845b95cba6b
permissions
-rw-r--r--

Initial load
http://hg.openjdk.java.net/jdk8u/jdk8u/corba/
changeset: 765:f46df0af2ca8
tag: jdk8u25-b17

aoqi@0 1 /*
aoqi@0 2 * Copyright (c) 1998, 1999, Oracle and/or its affiliates. All rights reserved.
aoqi@0 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
aoqi@0 4 *
aoqi@0 5 * This code is free software; you can redistribute it and/or modify it
aoqi@0 6 * under the terms of the GNU General Public License version 2 only, as
aoqi@0 7 * published by the Free Software Foundation. Oracle designates this
aoqi@0 8 * particular file as subject to the "Classpath" exception as provided
aoqi@0 9 * by Oracle in the LICENSE file that accompanied this code.
aoqi@0 10 *
aoqi@0 11 * This code is distributed in the hope that it will be useful, but WITHOUT
aoqi@0 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
aoqi@0 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
aoqi@0 14 * version 2 for more details (a copy is included in the LICENSE file that
aoqi@0 15 * accompanied this code).
aoqi@0 16 *
aoqi@0 17 * You should have received a copy of the GNU General Public License version
aoqi@0 18 * 2 along with this work; if not, write to the Free Software Foundation,
aoqi@0 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
aoqi@0 20 *
aoqi@0 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
aoqi@0 22 * or visit www.oracle.com if you need additional information or have any
aoqi@0 23 * questions.
aoqi@0 24 */
aoqi@0 25
aoqi@0 26 package org.omg.CORBA;
aoqi@0 27
aoqi@0 28 /** Defines the methods used to read primitive data types from input streams
aoqi@0 29 * for unmarshaling custom value types. This interface is used by user
aoqi@0 30 * written custom unmarshaling code for custom value types.
aoqi@0 31 * @see org.omg.CORBA.DataOutputStream
aoqi@0 32 * @see org.omg.CORBA.CustomMarshal
aoqi@0 33 */
aoqi@0 34 public interface DataInputStream extends org.omg.CORBA.portable.ValueBase
aoqi@0 35 {
aoqi@0 36 /** Reads an IDL <code>Any</code> value from the input stream.
aoqi@0 37 * @return the <code>Any</code> read.
aoqi@0 38 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 39 * If an inconsistency is detected, including not having registered
aoqi@0 40 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 41 */
aoqi@0 42 org.omg.CORBA.Any read_any ();
aoqi@0 43
aoqi@0 44 /** Reads an IDL boolean value from the input stream.
aoqi@0 45 * @return the boolean read.
aoqi@0 46 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 47 * If an inconsistency is detected, including not having registered
aoqi@0 48 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 49 */
aoqi@0 50 boolean read_boolean ();
aoqi@0 51
aoqi@0 52 /** Reads an IDL character value from the input stream.
aoqi@0 53 * @return the character read.
aoqi@0 54 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 55 * If an inconsistency is detected, including not having registered
aoqi@0 56 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 57 */
aoqi@0 58 char read_char ();
aoqi@0 59
aoqi@0 60 /** Reads an IDL wide character value from the input stream.
aoqi@0 61 * @return the wide character read.
aoqi@0 62 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 63 * If an inconsistency is detected, including not having registered
aoqi@0 64 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 65 */
aoqi@0 66 char read_wchar ();
aoqi@0 67
aoqi@0 68 /** Reads an IDL octet value from the input stream.
aoqi@0 69 * @return the octet value read.
aoqi@0 70 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 71 * If an inconsistency is detected, including not having registered
aoqi@0 72 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 73 */
aoqi@0 74 byte read_octet ();
aoqi@0 75
aoqi@0 76 /** Reads an IDL short from the input stream.
aoqi@0 77 * @return the short read.
aoqi@0 78 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 79 * If an inconsistency is detected, including not having registered
aoqi@0 80 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 81 */
aoqi@0 82 short read_short ();
aoqi@0 83
aoqi@0 84 /** Reads an IDL unsigned short from the input stream.
aoqi@0 85 * @return the unsigned short read.
aoqi@0 86 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 87 * If an inconsistency is detected, including not having registered
aoqi@0 88 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 89 */
aoqi@0 90 short read_ushort ();
aoqi@0 91
aoqi@0 92 /** Reads an IDL long from the input stream.
aoqi@0 93 * @return the long read.
aoqi@0 94 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 95 * If an inconsistency is detected, including not having registered
aoqi@0 96 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 97 */
aoqi@0 98 int read_long ();
aoqi@0 99
aoqi@0 100 /** Reads an IDL unsigned long from the input stream.
aoqi@0 101 * @return the unsigned long read.
aoqi@0 102 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 103 * If an inconsistency is detected, including not having registered
aoqi@0 104 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 105 */
aoqi@0 106 int read_ulong ();
aoqi@0 107
aoqi@0 108 /** Reads an IDL long long from the input stream.
aoqi@0 109 * @return the long long read.
aoqi@0 110 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 111 * If an inconsistency is detected, including not having registered
aoqi@0 112 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 113 */
aoqi@0 114 long read_longlong ();
aoqi@0 115
aoqi@0 116 /** Reads an unsigned IDL long long from the input stream.
aoqi@0 117 * @return the unsigned long long read.
aoqi@0 118 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 119 * If an inconsistency is detected, including not having registered
aoqi@0 120 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 121 */
aoqi@0 122 long read_ulonglong ();
aoqi@0 123
aoqi@0 124 /** Reads an IDL float from the input stream.
aoqi@0 125 * @return the float read.
aoqi@0 126 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 127 * If an inconsistency is detected, including not having registered
aoqi@0 128 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 129 */
aoqi@0 130 float read_float ();
aoqi@0 131
aoqi@0 132 /** Reads an IDL double from the input stream.
aoqi@0 133 * @return the double read.
aoqi@0 134 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 135 * If an inconsistency is detected, including not having registered
aoqi@0 136 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 137 */
aoqi@0 138 double read_double ();
aoqi@0 139 // read_longdouble not supported by IDL/Java mapping
aoqi@0 140
aoqi@0 141 /** Reads an IDL string from the input stream.
aoqi@0 142 * @return the string read.
aoqi@0 143 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 144 * If an inconsistency is detected, including not having registered
aoqi@0 145 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 146 */
aoqi@0 147 String read_string ();
aoqi@0 148
aoqi@0 149 /** Reads an IDL wide string from the input stream.
aoqi@0 150 * @return the wide string read.
aoqi@0 151 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 152 * If an inconsistency is detected, including not having registered
aoqi@0 153 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 154 */
aoqi@0 155 String read_wstring ();
aoqi@0 156
aoqi@0 157 /** Reads an IDL CORBA::Object from the input stream.
aoqi@0 158 * @return the CORBA::Object read.
aoqi@0 159 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 160 * If an inconsistency is detected, including not having registered
aoqi@0 161 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 162 */
aoqi@0 163 org.omg.CORBA.Object read_Object ();
aoqi@0 164
aoqi@0 165 /** Reads an IDL Abstract interface from the input stream.
aoqi@0 166 * @return the Abstract interface read.
aoqi@0 167 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 168 * If an inconsistency is detected, including not having registered
aoqi@0 169 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 170 */
aoqi@0 171 java.lang.Object read_Abstract ();
aoqi@0 172
aoqi@0 173 /** Reads an IDL value type from the input stream.
aoqi@0 174 * @return the value type read.
aoqi@0 175 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 176 * If an inconsistency is detected, including not having registered
aoqi@0 177 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 178 */
aoqi@0 179 java.io.Serializable read_Value ();
aoqi@0 180
aoqi@0 181 /** Reads an IDL typecode from the input stream.
aoqi@0 182 * @return the typecode read.
aoqi@0 183 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 184 * If an inconsistency is detected, including not having registered
aoqi@0 185 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 186 */
aoqi@0 187 org.omg.CORBA.TypeCode read_TypeCode ();
aoqi@0 188
aoqi@0 189 /** Reads array of IDL Anys from offset for length elements from the
aoqi@0 190 * input stream.
aoqi@0 191 * @param seq The out parameter holder for the array to be read.
aoqi@0 192 * @param offset The index into seq of the first element to read from the
aoqi@0 193 * input stream.
aoqi@0 194 * @param length The number of elements to read from the input stream.
aoqi@0 195 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 196 * If an inconsistency is detected, including not having registered
aoqi@0 197 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 198 */
aoqi@0 199 void read_any_array (org.omg.CORBA.AnySeqHolder seq, int offset, int length);
aoqi@0 200
aoqi@0 201 /** Reads array of IDL booleans from offset for length elements from the
aoqi@0 202 * input stream.
aoqi@0 203 * @param seq The out parameter holder for the array to be read.
aoqi@0 204 * @param offset The index into seq of the first element to read from the
aoqi@0 205 * input stream.
aoqi@0 206 * @param length The number of elements to read from the input stream.
aoqi@0 207 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 208 * If an inconsistency is detected, including not having registered
aoqi@0 209 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 210 */
aoqi@0 211 void read_boolean_array (org.omg.CORBA.BooleanSeqHolder seq, int offset, int length);
aoqi@0 212
aoqi@0 213 /** Reads array of IDL characters from offset for length elements from the
aoqi@0 214 * input stream.
aoqi@0 215 * @param seq The out parameter holder for the array to be read.
aoqi@0 216 * @param offset The index into seq of the first element to read from the
aoqi@0 217 * input stream.
aoqi@0 218 * @param length The number of elements to read from the input stream.
aoqi@0 219 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 220 * If an inconsistency is detected, including not having registered
aoqi@0 221 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 222 */
aoqi@0 223 void read_char_array (org.omg.CORBA.CharSeqHolder seq, int offset, int length);
aoqi@0 224
aoqi@0 225 /** Reads array of IDL wide characters from offset for length elements from the
aoqi@0 226 * input stream.
aoqi@0 227 * @param seq The out parameter holder for the array to be read.
aoqi@0 228 * @param offset The index into seq of the first element to read from the
aoqi@0 229 * input stream.
aoqi@0 230 * @param length The number of elements to read from the input stream.
aoqi@0 231 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 232 * If an inconsistency is detected, including not having registered
aoqi@0 233 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 234 */
aoqi@0 235 void read_wchar_array (org.omg.CORBA.WCharSeqHolder seq, int offset, int length);
aoqi@0 236
aoqi@0 237 /** Reads array of IDL octets from offset for length elements from the
aoqi@0 238 * input stream.
aoqi@0 239 * @param seq The out parameter holder for the array to be read.
aoqi@0 240 * @param offset The index into seq of the first element to read from the
aoqi@0 241 * input stream.
aoqi@0 242 * @param length The number of elements to read from the input stream.
aoqi@0 243 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 244 * If an inconsistency is detected, including not having registered
aoqi@0 245 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 246 */
aoqi@0 247 void read_octet_array (org.omg.CORBA.OctetSeqHolder seq, int offset, int length);
aoqi@0 248
aoqi@0 249 /** Reads array of IDL shorts from offset for length elements from the
aoqi@0 250 * input stream.
aoqi@0 251 * @param seq The out parameter holder for the array to be read.
aoqi@0 252 * @param offset The index into seq of the first element to read from the
aoqi@0 253 * input stream.
aoqi@0 254 * @param length The number of elements to read from the input stream.
aoqi@0 255 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 256 * If an inconsistency is detected, including not having registered
aoqi@0 257 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 258 */
aoqi@0 259 void read_short_array (org.omg.CORBA.ShortSeqHolder seq, int offset, int length);
aoqi@0 260
aoqi@0 261 /** Reads array of IDL unsigned shorts from offset for length elements from the
aoqi@0 262 * input stream.
aoqi@0 263 * @param seq The out parameter holder for the array to be read.
aoqi@0 264 * @param offset The index into seq of the first element to read from the
aoqi@0 265 * input stream.
aoqi@0 266 * @param length The number of elements to read from the input stream.
aoqi@0 267 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 268 * If an inconsistency is detected, including not having registered
aoqi@0 269 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 270 */
aoqi@0 271 void read_ushort_array (org.omg.CORBA.UShortSeqHolder seq, int offset, int length);
aoqi@0 272
aoqi@0 273 /** Reads array of IDL longs from offset for length elements from the
aoqi@0 274 * input stream.
aoqi@0 275 * @param seq The out parameter holder for the array to be read.
aoqi@0 276 * @param offset The index into seq of the first element to read from the
aoqi@0 277 * input stream.
aoqi@0 278 * @param length The number of elements to read from the input stream.
aoqi@0 279 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 280 * If an inconsistency is detected, including not having registered
aoqi@0 281 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 282 */
aoqi@0 283 void read_long_array (org.omg.CORBA.LongSeqHolder seq, int offset, int length);
aoqi@0 284
aoqi@0 285 /** Reads array of IDL unsigned longs from offset for length elements from the
aoqi@0 286 * input stream.
aoqi@0 287 * @param seq The out parameter holder for the array to be read.
aoqi@0 288 * @param offset The index into seq of the first element to read from the
aoqi@0 289 * input stream.
aoqi@0 290 * @param length The number of elements to read from the input stream.
aoqi@0 291 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 292 * If an inconsistency is detected, including not having registered
aoqi@0 293 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 294 */
aoqi@0 295 void read_ulong_array (org.omg.CORBA.ULongSeqHolder seq, int offset, int length);
aoqi@0 296
aoqi@0 297 /** Reads array of IDL unsigned long longs from offset for length elements from the
aoqi@0 298 * input stream.
aoqi@0 299 * @param seq The out parameter holder for the array to be read.
aoqi@0 300 * @param offset The index into seq of the first element to read from the
aoqi@0 301 * input stream.
aoqi@0 302 * @param length The number of elements to read from the input stream.
aoqi@0 303 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 304 * If an inconsistency is detected, including not having registered
aoqi@0 305 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 306 */
aoqi@0 307 void read_ulonglong_array (org.omg.CORBA.ULongLongSeqHolder seq, int offset, int length);
aoqi@0 308
aoqi@0 309 /** Reads array of IDL long longs from offset for length elements from the
aoqi@0 310 * input stream.
aoqi@0 311 * @param seq The out parameter holder for the array to be read.
aoqi@0 312 * @param offset The index into seq of the first element to read from the
aoqi@0 313 * input stream.
aoqi@0 314 * @param length The number of elements to read from the input stream.
aoqi@0 315 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 316 * If an inconsistency is detected, including not having registered
aoqi@0 317 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 318 */
aoqi@0 319 void read_longlong_array (org.omg.CORBA.LongLongSeqHolder seq, int offset, int length);
aoqi@0 320
aoqi@0 321 /** Reads array of IDL floats from offset for length elements from the
aoqi@0 322 * input stream.
aoqi@0 323 * @param seq The out parameter holder for the array to be read.
aoqi@0 324 * @param offset The index into seq of the first element to read from the
aoqi@0 325 * input stream.
aoqi@0 326 * @param length The number of elements to read from the input stream.
aoqi@0 327 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 328 * If an inconsistency is detected, including not having registered
aoqi@0 329 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 330 */
aoqi@0 331 void read_float_array (org.omg.CORBA.FloatSeqHolder seq, int offset, int length);
aoqi@0 332
aoqi@0 333 /** Reads array of IDL doubles from offset for length elements from the
aoqi@0 334 * input stream.
aoqi@0 335 * @param seq The out parameter holder for the array to be read.
aoqi@0 336 * @param offset The index into seq of the first element to read from the
aoqi@0 337 * input stream.
aoqi@0 338 * @param length The number of elements to read from the input stream.
aoqi@0 339 * @throws <code>org.omg.CORBA.MARSHAL</code>
aoqi@0 340 * If an inconsistency is detected, including not having registered
aoqi@0 341 * a streaming policy, then the standard system exception MARSHAL is raised.
aoqi@0 342 */
aoqi@0 343 void read_double_array (org.omg.CORBA.DoubleSeqHolder seq, int offset, int length);
aoqi@0 344 } // interface DataInputStream

mercurial