src/share/classes/org/omg/CORBA_2_3/portable/InputStream.java

Tue, 12 Nov 2013 18:04:13 +0000

author
msheppar
date
Tue, 12 Nov 2013 18:04:13 +0000
changeset 561
b083590cb088
parent 158
91006f157c46
child 748
6845b95cba6b
child 935
89c95715f192
permissions
-rw-r--r--

8025767: Enhance IIOP Streams
Summary: modify org.omg.CORBA_2_3.portable.InputStream inheritance structure.
Reviewed-by: alanb, coffeys, skoivu

duke@1 1 /*
msheppar@561 2 * Copyright (c) 1998, 2013, Oracle and/or its affiliates. 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
ohair@158 7 * published by the Free Software Foundation. Oracle designates this
duke@1 8 * particular file as subject to the "Classpath" exception as provided
ohair@158 9 * by Oracle 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 *
ohair@158 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@158 22 * or visit www.oracle.com if you need additional information or have any
ohair@158 23 * questions.
duke@1 24 */
duke@1 25 /*
duke@1 26 * Licensed Materials - Property of IBM
duke@1 27 * RMI-IIOP v1.0
duke@1 28 * Copyright IBM Corp. 1998 1999 All Rights Reserved
duke@1 29 *
duke@1 30 */
duke@1 31
duke@1 32 package org.omg.CORBA_2_3.portable;
duke@1 33
msheppar@561 34 import java.io.SerializablePermission;
msheppar@561 35 import java.security.AccessController;
msheppar@561 36 import java.security.PrivilegedAction;
msheppar@561 37
duke@1 38 /**
duke@1 39 * InputStream provides for the reading of all of the mapped IDL types
duke@1 40 * from the stream. It extends org.omg.CORBA.portable.InputStream. This
duke@1 41 * class defines new methods that were added for CORBA 2.3.
duke@1 42 *
duke@1 43 * @see org.omg.CORBA.portable.InputStream
duke@1 44 * @author OMG
duke@1 45 * @since JDK1.2
duke@1 46 */
duke@1 47
duke@1 48 public abstract class InputStream extends org.omg.CORBA.portable.InputStream {
duke@1 49
msheppar@561 50
msheppar@561 51 private static final String ALLOW_SUBCLASS_PROP = "jdk.corba.allowInputStreamSubclass";
msheppar@561 52
msheppar@561 53 private static final boolean allowSubclass = AccessController.doPrivileged(
msheppar@561 54 new PrivilegedAction<Boolean>() {
msheppar@561 55 @Override
msheppar@561 56 public Boolean run() {
msheppar@561 57 String prop = System.getProperty(ALLOW_SUBCLASS_PROP);
msheppar@561 58 return prop == null ? false :
msheppar@561 59 (prop.equalsIgnoreCase("false") ? false : true);
msheppar@561 60 }
msheppar@561 61 });
msheppar@561 62
msheppar@561 63 private static Void checkPermission() {
msheppar@561 64 SecurityManager sm = System.getSecurityManager();
msheppar@561 65 if (sm != null) {
msheppar@561 66 if (!allowSubclass)
msheppar@561 67 sm.checkPermission(new
msheppar@561 68 SerializablePermission("enableSubclassImplementation"));
msheppar@561 69 }
msheppar@561 70 return null;
msheppar@561 71 }
msheppar@561 72
msheppar@561 73 private InputStream(Void ignore) { }
msheppar@561 74
msheppar@561 75 /**
msheppar@561 76 * Create a new instance of this class.
msheppar@561 77 *
msheppar@561 78 * throw SecurityException if SecurityManager is installed and
msheppar@561 79 * enableSubclassImplementation SerializablePermission
msheppar@561 80 * is not granted or jdk.corba.allowOutputStreamSubclass system
msheppar@561 81 * property is either not set or is set to 'false'
msheppar@561 82 */
msheppar@561 83 public InputStream() {
msheppar@561 84 this(checkPermission());
msheppar@561 85 }
msheppar@561 86
duke@1 87 /**
duke@1 88 * Unmarshalls a value type from the input stream.
duke@1 89 * @return the value type unmarshalled from the input stream
duke@1 90 */
duke@1 91 public java.io.Serializable read_value() {
duke@1 92 throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1 93 }
duke@1 94
duke@1 95 /**
duke@1 96 * Unmarshalls a value type from the input stream.
duke@1 97 * @param clz is the declared type of the value to be unmarshalled
duke@1 98 * @return the value unmarshalled from the input stream
duke@1 99 */
duke@1 100 public java.io.Serializable read_value(java.lang.Class clz) {
duke@1 101 throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1 102 }
duke@1 103
duke@1 104 /**
duke@1 105 * Unmarshalls a value type from the input stream.
duke@1 106 * @param factory is the instance fo the helper to be used for
duke@1 107 * unmarshalling the value type
duke@1 108 * @return the value unmarshalled from the input stream
duke@1 109 */
duke@1 110 public java.io.Serializable read_value(org.omg.CORBA.portable.BoxedValueHelper factory) {
duke@1 111 throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1 112 }
duke@1 113
duke@1 114 /**
duke@1 115 * Unmarshalls a value type from the input stream.
duke@1 116 * @param rep_id identifies the type of the value to be unmarshalled
duke@1 117 * @return value type unmarshalled from the input stream
duke@1 118 */
duke@1 119 public java.io.Serializable read_value(java.lang.String rep_id) {
duke@1 120 throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1 121 }
duke@1 122
duke@1 123 /**
duke@1 124 * Unmarshalls a value type from the input stream.
duke@1 125 * @param value is an uninitialized value which is added to the orb's
duke@1 126 * indirection table before calling Streamable._read() or
duke@1 127 * CustomMarshal.unmarshal() to unmarshal the value.
duke@1 128 * @return value type unmarshalled from the input stream
duke@1 129 */
duke@1 130 public java.io.Serializable read_value(java.io.Serializable value) {
duke@1 131 throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1 132 }
duke@1 133
duke@1 134 /**
duke@1 135 * Unmarshal the value object or a suitable stub object.
duke@1 136 * @return ORB runtime returns the value object or a suitable stub object.
duke@1 137 */
duke@1 138 public java.lang.Object read_abstract_interface() {
duke@1 139 throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1 140 }
duke@1 141
duke@1 142 /**
duke@1 143 * Unmarshal the class object or the stub class corresponding to the passed type.
duke@1 144 * @param clz is the Class object for the stub class which corresponds to
duke@1 145 * the type that is statically expected.
duke@1 146 * @return ORB runtime returns the value object or a suitable stub object.
duke@1 147 */
duke@1 148 public java.lang.Object read_abstract_interface(java.lang.Class clz) {
duke@1 149 throw new org.omg.CORBA.NO_IMPLEMENT();
duke@1 150 }
duke@1 151
duke@1 152 }

mercurial