# HG changeset patch
# User amurillo
# Date 1442944914 25200
# Node ID d7c393b4e0d3d3e2651a04e7e2c611cde30fabea
# Parent 3851193a8c607ea07e7acd5e708b5580a344bdb0# Parent 79d34d4b9627c662c440e87ef61041dec08e1ff8
Merge
diff -r 3851193a8c60 -r d7c393b4e0d3 .hgtags
--- a/.hgtags Thu Sep 17 09:19:40 2015 -0700
+++ b/.hgtags Tue Sep 22 11:01:54 2015 -0700
@@ -324,3 +324,4 @@
3966bd3b8167419aa05c6718a4af1cf54b1e3c58 jdk9-b79
3c9f5bd909ae7187f24622ee4b69f8a5756a9271 jdk9-b80
2050b3a0aadcb0e024bf798197421d58e54ec8bf jdk9-b81
+6521875cb63e1d0121b30af56ebbc36db078c4c6 jdk9-b82
diff -r 3851193a8c60 -r d7c393b4e0d3 .hgtags-top-repo
--- a/.hgtags-top-repo Thu Sep 17 09:19:40 2015 -0700
+++ b/.hgtags-top-repo Tue Sep 22 11:01:54 2015 -0700
@@ -324,3 +324,4 @@
ba08a9f79b9849716bae1f39f71333d47f604012 jdk9-b79
f7c5ae2933c0b8510a420d1713a955e4ffc7ad0b jdk9-b80
b8afcf91331d78626a583ec1b63164468d6f4181 jdk9-b81
+42b56d1f418523ecb61a49d7493302c80c8009cc jdk9-b82
diff -r 3851193a8c60 -r d7c393b4e0d3 common/autoconf/generated-configure.sh
--- a/common/autoconf/generated-configure.sh Thu Sep 17 09:19:40 2015 -0700
+++ b/common/autoconf/generated-configure.sh Tue Sep 22 11:01:54 2015 -0700
@@ -841,7 +841,6 @@
JDK_MAJOR_VERSION
USER_RELEASE_SUFFIX
COMPRESS_JARS
-RMICONNECTOR_IIOP
UNLIMITED_CRYPTO
CACERTS_FILE
TEST_IN_BUILD
@@ -1060,7 +1059,6 @@
enable_hotspot_test_in_build
with_cacerts_file
enable_unlimited_crypto
-enable_rmiconnector_iiop
with_milestone
with_update_version
with_user_release_suffix
@@ -1848,9 +1846,6 @@
run the Queens test after Hotspot build [disabled]
--enable-unlimited-crypto
Enable unlimited crypto policy [disabled]
- --enable-rmiconnector-iiop
- enable the JMX RMIConnector iiop transport
- [disabled]
--disable-warnings-as-errors
do not consider native warnings to be an error
[enabled]
@@ -3951,7 +3946,7 @@
#
-# Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2011, 2015, Oracle and/or its affiliates. All rights reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
@@ -20100,22 +20095,6 @@
###############################################################################
#
- # --enable-rmiconnector-iiop
- #
- # Check whether --enable-rmiconnector-iiop was given.
-if test "${enable_rmiconnector_iiop+set}" = set; then :
- enableval=$enable_rmiconnector_iiop;
-fi
-
- if test "x$enable_rmiconnector_iiop" = "xyes"; then
- RMICONNECTOR_IIOP=true
- else
- RMICONNECTOR_IIOP=false
- fi
-
-
- ###############################################################################
- #
# Compress jars
#
COMPRESS_JARS=false
diff -r 3851193a8c60 -r d7c393b4e0d3 common/autoconf/jdk-options.m4
--- a/common/autoconf/jdk-options.m4 Thu Sep 17 09:19:40 2015 -0700
+++ b/common/autoconf/jdk-options.m4 Tue Sep 22 11:01:54 2015 -0700
@@ -1,5 +1,5 @@
#
-# Copyright (c) 2011, 2014, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2011, 2015, Oracle and/or its affiliates. All rights reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
@@ -455,19 +455,6 @@
###############################################################################
#
- # --enable-rmiconnector-iiop
- #
- AC_ARG_ENABLE(rmiconnector-iiop, [AS_HELP_STRING([--enable-rmiconnector-iiop],
- [enable the JMX RMIConnector iiop transport @<:@disabled@:>@])])
- if test "x$enable_rmiconnector_iiop" = "xyes"; then
- RMICONNECTOR_IIOP=true
- else
- RMICONNECTOR_IIOP=false
- fi
- AC_SUBST(RMICONNECTOR_IIOP)
-
- ###############################################################################
- #
# Compress jars
#
COMPRESS_JARS=false
diff -r 3851193a8c60 -r d7c393b4e0d3 common/autoconf/spec.gmk.in
--- a/common/autoconf/spec.gmk.in Thu Sep 17 09:19:40 2015 -0700
+++ b/common/autoconf/spec.gmk.in Tue Sep 22 11:01:54 2015 -0700
@@ -262,9 +262,6 @@
# Enable unlimited crypto policy
UNLIMITED_CRYPTO=@UNLIMITED_CRYPTO@
-# Enable RMIConnector IIOP transport
-RMICONNECTOR_IIOP=@RMICONNECTOR_IIOP@
-
GCOV_ENABLED=@GCOV_ENABLED@
# Necessary additional compiler flags to compile X11
diff -r 3851193a8c60 -r d7c393b4e0d3 common/bin/blessed-modifier-order.sh
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/common/bin/blessed-modifier-order.sh Tue Sep 22 11:01:54 2015 -0700
@@ -0,0 +1,60 @@
+#!/bin/bash
+#
+# Copyright 2015 Google, Inc. All Rights Reserved.
+# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+#
+# This code is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License version 2 only, as
+# published by the Free Software Foundation.
+#
+# This code is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+# version 2 for more details (a copy is included in the LICENSE file that
+# accompanied this code).
+#
+# You should have received a copy of the GNU General Public License version
+# 2 along with this work; if not, write to the Free Software Foundation,
+# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+# Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+# or visit www.oracle.com if you need additional information or have any
+# questions.
+
+usage() {
+ (
+ echo "$0 DIR ..."
+ echo "Modifies in place all the java source files found"
+ echo "in the given directories so that all java language modifiers"
+ echo "are in the canonical order given by Modifier#toString()."
+ echo "Tries to get it right even within javadoc comments,"
+ echo "and even if the list of modifiers spans 2 lines."
+ echo
+ echo "See:"
+ echo "https://docs.oracle.com/javase/8/docs/api/java/lang/reflect/Modifier.html#toString-int-"
+ echo
+ echo "Example:"
+ echo "$0 jdk/src/java.base jdk/test/java/{util,io,lang}"
+ ) >&2
+ exit 1
+}
+
+set -eu
+declare -ar dirs=("$@")
+[[ "${#dirs[@]}" > 0 ]] || usage
+for dir in "${dirs[@]}"; do [[ -d "$dir" ]] || usage; done
+
+declare -ar modifiers=(
+ public protected private
+ abstract static final transient
+ volatile synchronized native strictfp
+)
+declare -r SAVE_IFS="$IFS"
+for ((i = 3; i < "${#modifiers[@]}"; i++)); do
+ IFS='|'; x="${modifiers[*]:0:i}" y="${modifiers[*]:i}"; IFS="$SAVE_IFS"
+ if [[ -n "$x" && -n "$y" ]]; then
+ find "${dirs[@]}" -name '*.java' -type f -print0 | \
+ xargs -0 perl -0777 -p -i -e \
+ "do {} while s/^([A-Za-z@* ]*)\b($y)(\s|(?:\s|\n\s+\*)*\s)($x)\b/\1\4\3\2/mg"
+ fi
+done
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/.hgtags
--- a/corba/.hgtags Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/.hgtags Tue Sep 22 11:01:54 2015 -0700
@@ -324,3 +324,4 @@
4ab250b8fac66ef8cd15ee78c40f0c651c96e16a jdk9-b79
821a0373ef2d1642a9824facb938b901ad010413 jdk9-b80
45c35b7f5b40d5af0085e4a7b3a4d6e3e0347c35 jdk9-b81
+c20d8ebddaa6fb09cc81d3edf3d1d05f4232700a jdk9-b82
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ByteBuffer.java
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ByteBuffer.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ByteBuffer.java Tue Sep 22 11:01:54 2015 -0700
@@ -37,9 +37,9 @@
protected byte elementData[];
/**
- * The number of valid components in this ByteBuffer object.
- * Components elementData[0] through
- * elementData[elementCount-1] are the actual items.
+ * The number of valid components in this {@code ByteBuffer} object.
+ * Components {@code elementData[0]} through
+ * {@code elementData[elementCount-1]} are the actual items.
*
* @serial
*/
@@ -88,7 +88,7 @@
/**
* Constructs an empty ByteBuffer so that its internal data array
- * has size 10 and its standard capacity increment is
+ * has size {@code 10} and its standard capacity increment is
* zero.
*/
public ByteBuffer() {
@@ -99,7 +99,7 @@
* Trims the capacity of this ByteBuffer to be the ByteBuffer's current
* size. If the capacity of this cector is larger than its current
* size, then the capacity is changed to equal the size by replacing
- * its internal data array, kept in the field elementData,
+ * its internal data array, kept in the field {@code elementData},
* with a smaller one. An application can use this operation to
* minimize the storage of a ByteBuffer.
*/
@@ -138,7 +138,7 @@
* Returns the current capacity of this ByteBuffer.
*
* @return the current capacity (the length of its internal
- * data arary, kept in the field elementData
+ * data arary, kept in the field {@code elementData}
* of this ByteBuffer.
*/
public int capacity() {
@@ -157,9 +157,9 @@
/**
* Tests if this ByteBuffer has no components.
*
- * @return true
if and only if this ByteBuffer has
+ * @return {@code true} if and only if this ByteBuffer has
* no components, that is, its size is zero;
- * false
otherwise.
+ * {@code false} otherwise.
*/
public boolean isEmpty() {
return elementCount == 0;
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/com/sun/corba/se/impl/javax/rmi/CORBA/Util.java
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/javax/rmi/CORBA/Util.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/javax/rmi/CORBA/Util.java Tue Sep 22 11:01:54 2015 -0700
@@ -438,11 +438,11 @@
}
/**
- * Writes a java.lang.Object as a CORBA Object. If obj
is
+ * Writes a java.lang.Object as a CORBA Object. If {@code obj} is
* an exported RMI-IIOP server object, the tie is found
- * and wired to obj
, then written to out.write_Object(org.omg.CORBA.Object)
.
- * If obj
is a CORBA Object, it is written to
- * out.write_Object(org.omg.CORBA.Object)
.
+ * and wired to {@code obj}, then written to {@code out.write_Object(org.omg.CORBA.Object)}.
+ * If {@code obj} is a CORBA Object, it is written to
+ * {@code out.write_Object(org.omg.CORBA.Object)}.
* @param out the stream in which to write the object.
* @param obj the object to write.
*/
@@ -457,10 +457,10 @@
/**
* Writes a java.lang.Object as either a value or a CORBA Object.
- * If obj
is a value object or a stub object, it is written to
- * out.write_abstract_interface(java.lang.Object)
. If obj
is an exported
- * RMI-IIOP server object, the tie is found and wired to obj
,
- * then written to out.write_abstract_interface(java.lang.Object)
.
+ * If {@code obj} is a value object or a stub object, it is written to
+ * {@code out.write_abstract_interface(java.lang.Object)}. If {@code obj} is an exported
+ * RMI-IIOP server object, the tie is found and wired to {@code obj},
+ * then written to {@code out.write_abstract_interface(java.lang.Object)}.
* @param out the stream in which to write the object.
* @param obj the object to write.
*/
@@ -595,7 +595,7 @@
* the class might be found. May be null.
* @param loader a class whose ClassLoader may be used to
* load the class if all other methods fail.
- * @return the Class
object representing the loaded class.
+ * @return the {@code Class} object representing the loaded class.
* @exception ClassNotFoundException if class cannot be loaded.
*/
public Class loadClass( String className, String remoteCodebase,
@@ -605,20 +605,20 @@
}
/**
- * The isLocal method has the same semantics as the
+ * The {@code isLocal} method has the same semantics as the
* ObjectImpl._is_local method, except that it can throw a RemoteException.
* (no it doesn't but the spec says it should.)
*
- * The _is_local() method is provided so that stubs may determine
+ * The {@code _is_local()} method is provided so that stubs may determine
* if a particular object is implemented by a local servant and hence local
* invocation APIs may be used.
*
* @param stub the stub to test.
*
- * @return The _is_local() method returns true if
+ * @return The {@code _is_local()} method returns true if
* the servant incarnating the object is located in the same process as
- * the stub and they both share the same ORB instance. The _is_local()
- * method returns false otherwise. The default behavior of _is_local() is
+ * the stub and they both share the same ORB instance. The {@code _is_local()}
+ * method returns false otherwise. The default behavior of {@code _is_local()} is
* to return false.
*
* @throws RemoteException The Java to IDL specification does to
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/com/sun/corba/se/impl/presentation/rmi/JNDIStateFactoryImpl.java
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/presentation/rmi/JNDIStateFactoryImpl.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/presentation/rmi/JNDIStateFactoryImpl.java Tue Sep 22 11:01:54 2015 -0700
@@ -93,7 +93,7 @@
* @param name Ignored
* @param ctx The non-null CNCtx whose ORB to use.
* @param env Ignored
- * @return The CORBA object for orig or null.
+ * @return The CORBA object for {@code orig} or null.
* @exception ConfigurationException If the CORBA object cannot be obtained
* due to configuration problems
* @exception NamingException If some other problem prevented a CORBA
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/connection/ORBSocketFactory.java
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/connection/ORBSocketFactory.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/connection/ORBSocketFactory.java Tue Sep 22 11:01:54 2015 -0700
@@ -165,7 +165,7 @@
* If number is 0 then use an emphemeral port for the listener of
* the associated type.
* - * If number is greater then 0 use that port number.
+ * If number is greater than 0 use that port number.
*
* An ORB creates a listener socket for each type
* specified by the user by calling
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/javax/rmi/CORBA/Util.java
--- a/corba/src/java.corba/share/classes/javax/rmi/CORBA/Util.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/javax/rmi/CORBA/Util.java Tue Sep 22 11:01:54 2015 -0700
@@ -108,12 +108,12 @@
}
/**
- * Writes a java.lang.Object as a CORBA Object. If obj
is
+ * Writes a java.lang.Object as a CORBA Object. If {@code obj} is
* an exported RMI-IIOP server object, the tie is found
- * and wired to obj
, then written to
-out.write_Object(org.omg.CORBA.Object)
.
- * If obj
is a CORBA Object, it is written to
- * out.write_Object(org.omg.CORBA.Object)
.
+ * and wired to {@code obj}, then written to
+ * {@code out.write_Object(org.omg.CORBA.Object)}.
+ * If {@code obj} is a CORBA Object, it is written to
+ * {@code out.write_Object(org.omg.CORBA.Object)}.
* @param out the stream in which to write the object.
* @param obj the object to write.
*/
@@ -128,12 +128,11 @@
/**
* Writes a java.lang.Object as either a value or a CORBA Object.
- * If obj
is a value object or a stub object, it is written to
- * out.write_abstract_interface(java.lang.Object)
. If obj
-is
-an exported
- * RMI-IIOP server object, the tie is found and wired to obj
,
- * then written to out.write_abstract_interface(java.lang.Object)
.
+ * If {@code obj} is a value object or a stub object, it is written to
+ * {@code out.write_abstract_interface(java.lang.Object)}.
+ * If {@code obj} is an exported
+ * RMI-IIOP server object, the tie is found and wired to {@code obj},
+ * then written to {@code out.write_abstract_interface(java.lang.Object)}.
* @param out the stream in which to write the object.
* @param obj the object to write.
*/
@@ -161,8 +160,8 @@
}
/**
- * Removes the associated tie from an internal table and calls {@link
-Tie#deactivate}
+ * Removes the associated tie from an internal table
+ * and calls {@link Tie#deactivate}
* to deactivate the object.
* @param target the object to unexport.
*/
@@ -219,27 +218,27 @@
*
The spec for this method is the "Java to IDL language * mapping", ptc/00-01-06. *
In Java SE Platform, this method works as follows: - *
Class
object representing the loaded class.
+ * @return the {@code Class} object representing the loaded class.
* @exception ClassNotFoundException if class cannot be loaded.
*/
public static Class loadClass(String className,
@@ -254,24 +253,24 @@
/**
- * The isLocal method has the same semantics as the
- * ObjectImpl._is_local
- * method, except that it can throw a RemoteException.
+ * The {@code isLocal} method has the same semantics as the
+ * {@code ObjectImpl._is_local}
+ * method, except that it can throw a {@code RemoteException}.
*
- * The _is_local() method is provided so that stubs may determine if a
+ * The {@code _is_local()} method is provided so that stubs may determine if a
* particular object is implemented by a local servant and hence local
* invocation APIs may be used.
*
* @param stub the stub to test.
*
- * @return The _is_local() method returns true if
+ * @return The {@code _is_local()} method returns true if
* the servant incarnating the object is located in the same process as
- * the stub and they both share the same ORB instance. The _is_local()
- * method returns false otherwise. The default behavior of _is_local() is
+ * the stub and they both share the same ORB instance. The {@code _is_local()}
+ * method returns false otherwise. The default behavior of {@code _is_local()} is
* to return false.
*
* @throws RemoteException The Java to IDL specification does not
- * specify the conditions that cause a RemoteException to be thrown.
+ * specify the conditions that cause a {@code RemoteException} to be thrown.
*/
public static boolean isLocal(Stub stub) throws RemoteException {
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/AnyHolder.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/AnyHolder.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/AnyHolder.java Tue Sep 22 11:01:54 2015 -0700
@@ -30,52 +30,52 @@
import org.omg.CORBA.portable.OutputStream;
/**
- * The Holder for Any. For more information on
+ * The Holder for {@code Any}. For more information on
* Holder files, see
* "Generated Files: Holder Files".
- * A Holder class for Any
objects
+ * A Holder class for {@code Any} objects
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL any
as an "out"
+ * If an IDL method signature has an IDL {@code any} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * AnyHolder
as the corresponding
+ * {@code AnyHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myAnyHolder
is an instance of AnyHolder
,
- * the value stored in its value
field can be accessed with
- * myAnyHolder.value
.
+ * If {@code myAnyHolder} is an instance of {@code AnyHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myAnyHolder.value}.
*
* @since JDK1.2
*/
public final class AnyHolder implements Streamable {
/**
- * The Any
value held by this AnyHolder
object.
+ * The {@code Any} value held by this {@code AnyHolder} object.
*/
public Any value;
/**
- * Constructs a new AnyHolder
object with its
- * value
field initialized to null
.
+ * Constructs a new {@code AnyHolder} object with its
+ * {@code value} field initialized to {@code null}.
*/
public AnyHolder() {
}
/**
- * Constructs a new AnyHolder
object for the given
- * Any
object.
- * @param initial the Any
object with which to initialize
- * the value
field of the new
- * AnyHolder
object
+ * Constructs a new {@code AnyHolder} object for the given
+ * {@code Any} object.
+ * @param initial the {@code Any} object with which to initialize
+ * the {@code value} field of the new
+ * {@code AnyHolder} object
*/
public AnyHolder(Any initial) {
value = initial;
}
/**
- * Reads from input
and initalizes the value in the Holder
+ * Reads from {@code input} and initalizes the value in the Holder
* with the unmarshalled data.
*
* @param input the InputStream containing CDR formatted data from the wire.
@@ -85,8 +85,8 @@
}
/**
- * Marshals to output
the value in
- * this AnyHolder
object.
+ * Marshals to {@code output} the value in
+ * this {@code AnyHolder} object.
*
* @param output the OutputStream which will contain the CDR formatted data.
*/
@@ -95,11 +95,11 @@
}
/**
- * Returns the TypeCode
object corresponding to the value
- * held in this AnyHolder
object.
+ * Returns the {@code TypeCode} object corresponding to the value
+ * held in this {@code AnyHolder} object.
*
* @return the TypeCode of the value held in
- * this AnyHolder
object
+ * this {@code AnyHolder} object
*/
public TypeCode _type() {
return ORB.init().get_primitive_tc(TCKind.tk_any);
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/AnySeqHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/AnySeqHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/AnySeqHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,26 +26,26 @@
/**
-* The Helper for AnySeq. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-* org/omg/CORBA/AnySeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -*
+ * org/omg/CORBA/AnySeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + *
-* org/omg/CORBA/AnySeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code AnySeq}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/AnySeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class AnySeqHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY.java Tue Sep 22 11:01:54 2015 -0700 @@ -25,8 +25,8 @@ package org.omg.CORBA; /** - * A PolicyErrorCode which would be filled in - * the PolicyError exception. + * A {@code PolicyErrorCode} which would be filled in + * the {@code PolicyError} exception. * * @author rip-dev */ diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY_TYPE.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY_TYPE.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY_TYPE.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,8 +26,8 @@ package org.omg.CORBA; /** - * A PolicyErrorCode which would be filled in - * the PolicyError exception. + * A {@code PolicyErrorCode} which would be filled in + * the {@code PolicyError} exception. * * @author rip-dev */ diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/BAD_TYPECODE.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/BAD_TYPECODE.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/BAD_TYPECODE.java Tue Sep 22 11:01:54 2015 -0700 @@ -27,7 +27,7 @@ /** * Exception thrown when the ORB has encountered a malformed type code - * (for example, a type code with an invalid TCKind value).
+ * (for example, a type code with an invalid {@code TCKind} value).
* It contains a minor code, which gives more detailed information about
* what caused the exception, and a completion status. It may also contain
* a string describing the exception.
@@ -40,7 +40,7 @@
public final class BAD_TYPECODE extends SystemException {
/**
- * Constructs a BAD_TYPECODE
exception with a default
+ * Constructs a {@code BAD_TYPECODE} exception with a default
* minor code of 0 and a completion state of COMPLETED_NO.
*/
public BAD_TYPECODE() {
@@ -48,7 +48,7 @@
}
/**
- * Constructs a BAD_TYPECODE
exception with the specified detail,
+ * Constructs a {@code BAD_TYPECODE} exception with the specified detail,
* a minor code of 0, and a completion state of COMPLETED_NO.
*
* @param s the String containing a detail message
@@ -58,10 +58,10 @@
}
/**
- * Constructs a BAD_TYPECODE
exception with the specified
+ * Constructs a {@code BAD_TYPECODE} exception with the specified
* minor code and completion status.
* @param minor the minor code
- * @param completed an instance of CompletionStatus
indicating
+ * @param completed an instance of {@code CompletionStatus} indicating
* the completion status
*/
public BAD_TYPECODE(int minor, CompletionStatus completed) {
@@ -69,12 +69,12 @@
}
/**
- * Constructs a BAD_TYPECODE
exception with the specified detail
+ * Constructs a {@code BAD_TYPECODE} exception with the specified detail
* message, minor code, and completion status.
* A detail message is a String that describes this particular exception.
* @param s the String containing a detail message
* @param minor the minor code
- * @param completed an instance of CompletionStatus
indicating
+ * @param completed an instance of {@code CompletionStatus} indicating
* the completion status
*/
public BAD_TYPECODE(String s, int minor, CompletionStatus completed) {
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/BooleanHolder.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/BooleanHolder.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/BooleanHolder.java Tue Sep 22 11:01:54 2015 -0700
@@ -30,56 +30,56 @@
/**
- * The Holder for Boolean. For more information on
+ * The Holder for {@code Boolean}. For more information on
* Holder files, see
* "Generated Files: Holder Files".
- * A Holder class for a boolean
+ * A Holder class for a {@code boolean}
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL boolean
as an "out"
+ * If an IDL method signature has an IDL {@code boolean} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * BooleanHolder
as the corresponding
+ * {@code BooleanHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myBooleanHolder
is an instance of BooleanHolder
,
- * the value stored in its value
field can be accessed with
- * myBooleanHolder.value
.
+ * If {@code myBooleanHolder} is an instance of {@code BooleanHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myBooleanHolder.value}.
*
* @since JDK1.2
*/
public final class BooleanHolder implements Streamable {
/**
- * The boolean
value held by this BooleanHolder
+ * The {@code boolean} value held by this {@code BooleanHolder}
* object.
*/
public boolean value;
/**
- * Constructs a new BooleanHolder
object with its
- * value
field initialized to false
.
+ * Constructs a new {@code BooleanHolder} object with its
+ * {@code value} field initialized to {@code false}.
*/
public BooleanHolder() {
}
/**
- * Constructs a new BooleanHolder
object with its
- * value
field initialized with the given boolean
.
- * @param initial the boolean
with which to initialize
- * the value
field of the newly-created
- * BooleanHolder
object
+ * Constructs a new {@code BooleanHolder} object with its
+ * {@code value} field initialized with the given {@code boolean}.
+ * @param initial the {@code boolean} with which to initialize
+ * the {@code value} field of the newly-created
+ * {@code BooleanHolder} object
*/
public BooleanHolder(boolean initial) {
value = initial;
}
/**
- * Reads unmarshalled data from input
and assigns it to this
- * BooleanHolder
object's value
field.
+ * Reads unmarshalled data from {@code input} and assigns it to this
+ * {@code BooleanHolder} object's {@code value} field.
*
- * @param input the InputStream
object containing
+ * @param input the {@code InputStream} object containing
* CDR formatted data from the wire
*/
public void _read(InputStream input) {
@@ -87,8 +87,8 @@
}
/**
- * Marshals the value in this BooleanHolder
object's
- * value
field to the output stream output
.
+ * Marshals the value in this {@code BooleanHolder} object's
+ * {@code value} field to the output stream {@code output}.
*
* @param output the OutputStream which will contain the CDR formatted data
*/
@@ -97,11 +97,11 @@
}
/**
- * Retrieves the TypeCode
object that corresponds to the
- * value held in this BooleanHolder
object.
+ * Retrieves the {@code TypeCode} object that corresponds to the
+ * value held in this {@code BooleanHolder} object.
*
- * @return the TypeCode
for the value held
- * in this BooleanHolder
object
+ * @return the {@code TypeCode} for the value held
+ * in this {@code BooleanHolder} object
*/
public TypeCode _type() {
return ORB.init().get_primitive_tc(TCKind.tk_boolean);
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/BooleanSeqHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/BooleanSeqHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/BooleanSeqHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,26 +26,26 @@
/**
-* The Helper for BooleanSeq. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-* org/omg/CORBA/BooleanSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -*
+ * org/omg/CORBA/BooleanSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + *
-* org/omg/CORBA/BooleanSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code BooleanSeq}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/BooleanSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class BooleanSeqHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ByteHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ByteHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ByteHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -31,54 +31,54 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for Byte. For more information on + * The Holder for {@code Byte}. For more information on * Holder files, see * "Generated Files: Holder Files".
- * A Holder class for a byte
+ * A Holder class for a {@code byte}
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL octet
as an "out"
+ * If an IDL method signature has an IDL {@code octet} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * ByteHolder
as the corresponding
+ * {@code ByteHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myByteHolder
is an instance of ByteHolder
,
- * the value stored in its value
field can be accessed with
- * myByteHolder.value
.
+ * If {@code myByteHolder} is an instance of {@code ByteHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myByteHolder.value}.
*
* @since JDK1.2
*/
public final class ByteHolder implements Streamable {
/**
- * The byte
value held by this ByteHolder
+ * The {@code byte} value held by this {@code ByteHolder}
* object.
*/
public byte value;
/**
- * Constructs a new ByteHolder
object with its
- * value
field initialized to 0.
+ * Constructs a new {@code ByteHolder} object with its
+ * {@code value} field initialized to 0.
*/
public ByteHolder() {
}
/**
- * Constructs a new ByteHolder
object for the given
- * byte
.
- * @param initial the byte
with which to initialize
- * the value
field of the new
- * ByteHolder
object
+ * Constructs a new {@code ByteHolder} object for the given
+ * {@code byte}.
+ * @param initial the {@code byte} with which to initialize
+ * the {@code value} field of the new
+ * {@code ByteHolder} object
*/
public ByteHolder(byte initial) {
value = initial;
}
/**
- * Reads from input
and initalizes the value in
- * this ByteHolder
object
+ * Reads from {@code input} and initalizes the value in
+ * this {@code ByteHolder} object
* with the unmarshalled data.
*
* @param input the InputStream containing CDR formatted data from the wire.
@@ -88,8 +88,8 @@
}
/**
- * Marshals to output
the value in
- * this ByteHolder
object.
+ * Marshals to {@code output} the value in
+ * this {@code ByteHolder} object.
*
* @param output the OutputStream which will contain the CDR formatted data.
*/
@@ -99,10 +99,10 @@
/**
* Returns the TypeCode corresponding to the value held in
- * this ByteHolder
object.
+ * this {@code ByteHolder} object.
*
- * @return the TypeCode of the value held in
- * this ByteHolder
object
+ * @return the TypeCode of the value held in
+ * this {@code ByteHolder} object
*/
public org.omg.CORBA.TypeCode _type() {
return ORB.init().get_primitive_tc(TCKind.tk_octet);
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/CharHolder.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/CharHolder.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/CharHolder.java Tue Sep 22 11:01:54 2015 -0700
@@ -31,54 +31,54 @@
import org.omg.CORBA.portable.OutputStream;
/**
- * The Holder for Char. For more information on
+ * The Holder for {@code Char}. For more information on
* Holder files, see
* "Generated Files: Holder Files".
- * A Holder class for a char
+ * A Holder class for a {@code char}
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL char
as an "out"
+ * If an IDL method signature has an IDL {@code char} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * CharHolder
as the corresponding
+ * {@code CharHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myCharHolder
is an instance of CharHolder
,
- * the value stored in its value
field can be accessed with
- * myCharHolder.value
.
+ * If {@code myCharHolder} is an instance of {@code CharHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myCharHolder.value}.
*
* @since JDK1.2
*/
public final class CharHolder implements Streamable {
/**
- * The char
value held by this CharHolder
+ * The {@code char} value held by this {@code CharHolder}
* object.
*/
public char value;
/**
- * Constructs a new CharHolder
object with its
- * value
field initialized to 0
.
+ * Constructs a new {@code CharHolder} object with its
+ * {@code value} field initialized to {@code 0}.
*/
public CharHolder() {
}
/**
- * Constructs a new CharHolder
object for the given
- * char
.
- * @param initial the char
with which to initialize
- * the value
field of the new
- * CharHolder
object
+ * Constructs a new {@code CharHolder} object for the given
+ * {@code char}.
+ * @param initial the {@code char} with which to initialize
+ * the {@code value} field of the new
+ * {@code CharHolder} object
*/
public CharHolder(char initial) {
value = initial;
}
/**
- * Reads from input
and initalizes the value in
- * this CharHolder
object
+ * Reads from {@code input} and initalizes the value in
+ * this {@code CharHolder} object
* with the unmarshalled data.
*
* @param input the InputStream containing CDR formatted data from the wire
@@ -88,8 +88,8 @@
}
/**
- * Marshals to output
the value in
- * this CharHolder
object.
+ * Marshals to {@code output} the value in
+ * this {@code CharHolder} object.
*
* @param output the OutputStream which will contain the CDR formatted data
*/
@@ -98,12 +98,12 @@
}
/**
- * Returns the TypeCode
object corresponding
+ * Returns the {@code TypeCode} object corresponding
* to the value held in
- * this CharHolder
object.
+ * this {@code CharHolder} object.
*
* @return the TypeCode of the value held in
- * this CharHolder
object
+ * this {@code CharHolder} object
*/
public org.omg.CORBA.TypeCode _type() {
return ORB.init().get_primitive_tc(TCKind.tk_char);
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/CharSeqHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/CharSeqHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/CharSeqHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,26 +26,26 @@
/**
-* The Helper for CharSeq. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-* org/omg/CORBA/CharSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -*
+ * org/omg/CORBA/CharSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + *
-* org/omg/CORBA/CharSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code CharSeq}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/CharSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class CharSeqHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/CompletionStatusHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/CompletionStatusHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/CompletionStatusHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,13 +26,13 @@ /** -* The Helper for CompletionStatus. For more information on -* Helper files, see -* "Generated Files: Helper Files".
-* org/omg/CORBA/CompletionStatusHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* 03 June 1999 11:52:03 o'clock GMT+00:00 -*/ + * The Helper for {@code CompletionStatus}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/CompletionStatusHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * 03 June 1999 11:52:03 o'clock GMT+00:00 + */ abstract public class CompletionStatusHelper { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/Current.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/Current.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/Current.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,16 +26,16 @@ /** -* Interfaces derived from the Current interface enable ORB and CORBA +* Interfaces derived from the {@code Current} interface enable ORB and CORBA * services to provide access to information (context) associated with * the thread of execution in which they are running. This information * is accessed in a structured manner using interfaces derived from the -* Current interface defined in the CORBA module. +* {@code Current} interface defined in the CORBA module. * *
Each ORB or CORBA service that needs its own context derives an -* interface from the CORBA module's Current. Users of the -* service can obtain an instance of the appropriate Current -* interface by invoking ORB::resolve_initial_references.
+* interface from the CORBA module's {@code Current}. Users of the +* service can obtain an instance of the appropriate {@code Current} +* interface by invoking {@code ORB::resolve_initial_references}.
* * org/omg/CORBA/Current.java * Generated by the IDL-to-Java compiler (portable), version "3.0" diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/CurrentHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/CurrentHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/CurrentHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,14 +26,14 @@ /** -* The Helper for Current. For more information on -* Helper files, see -* "Generated Files: Helper Files".
-* org/omg/CORBA/CurrentHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT -*/ + * The Helper for {@code Current}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/CurrentHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT + */ abstract public class CurrentHelper { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/CurrentHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/CurrentHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/CurrentHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -25,14 +25,14 @@ package org.omg.CORBA; /** -* The Holder for Current. For more information on -* Holder files, see -* "Generated Files: Holder Files".
-* org/omg/CORBA/CurrentHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT -*/ + * The Holder for {@code Current}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/CurrentHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT + */ public final class CurrentHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/CurrentOperations.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/CurrentOperations.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/CurrentOperations.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,15 +26,15 @@ /** -* The interface for Current. For more information on -* Operations interfaces, see -* "Generated Files". -* -* org/omg/CORBA/CurrentOperations.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT. -*/ + * The interface for {@code Current}. For more information on + * Operations interfaces, see + * "Generated Files". + * + * org/omg/CORBA/CurrentOperations.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT. + */ public interface CurrentOperations { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/CustomMarshal.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/CustomMarshal.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/CustomMarshal.java Tue Sep 22 11:01:54 2015 -0700 @@ -34,7 +34,7 @@ * as a custom value type's implicit base class, although the custom * valuetype does not actually inherit it in IDL. The implementer * of a custom value type shall provide an implementation of the - * CustomMarshal operations. The manner in which this is done is + * {@code CustomMarshal} operations. The manner in which this is done is * specified in the IDL to Java langauge mapping. Each custom * marshaled value type shall have its own implementation. * @see DataInputStream diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/DefinitionKindHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/DefinitionKindHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/DefinitionKindHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,14 +26,14 @@ /** -* The Helper for DefinitionKind. For more information on -* Helper files, see -* "Generated Files: Helper Files".
-* org/omg/CORBA/DefinitionKindHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ir.idl -* 03 June 1999 11:33:43 o'clock GMT+00:00 -*/ + * The Helper for {@code DefinitionKind}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/DefinitionKindHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ir.idl + * 03 June 1999 11:33:43 o'clock GMT+00:00 + */ abstract public class DefinitionKindHelper { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/DomainManager.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/DomainManager.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/DomainManager.java Tue Sep 22 11:01:54 2015 -0700 @@ -25,11 +25,12 @@ package org.omg.CORBA; -/** Provides mechanisms for establishing and navigating relationships to +/** + * Provides mechanisms for establishing and navigating relationships to * superior and subordinate domains, as well as for creating and accessing - * policies. The DomainManager has associated with it the policy - * objects for a - * particular domain. The domain manager also records the membership of + * policies. The {@code DomainManager} has associated with it the policy + * objects for a particular domain. + * The domain manager also records the membership of * the domain and provides the means to add and remove members. The domain * manager is itself a member of a domain, possibly the domain it manages. * The domain manager provides mechanisms for establishing and navigating diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/DomainManagerOperations.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/DomainManagerOperations.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/DomainManagerOperations.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,9 +26,9 @@ package org.omg.CORBA; /** - * Provides the DomainManager with the means to access policies. + * Provides the {@code DomainManager} with the means to access policies. *
- * The DomainManager has associated with it the policy objects for a + * The {@code DomainManager} has associated with it the policy objects for a * particular domain. The domain manager also records the membership of * the domain and provides the means to add and remove members. The domain * manager is itself a member of a domain, possibly the domain it manages. @@ -39,11 +39,12 @@ public interface DomainManagerOperations { - /** This returns the policy of the specified type for objects in + /** + * This returns the policy of the specified type for objects in * this domain. The types of policies available are domain specific. * See the CORBA specification for a list of standard ORB policies. * - *@param policy_type Type of policy to request + * @param policy_type Type of policy to request */ public org.omg.CORBA.Policy get_domain_policy(int policy_type); } diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/DoubleHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/DoubleHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/DoubleHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -30,47 +30,47 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for Double. For more information on + * The Holder for {@code Double}. For more information on * Holder files, see * "Generated Files: Holder Files".
- * A Holder class for a double
+ * A Holder class for a {@code double}
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL double
as an "out"
+ * If an IDL method signature has an IDL {@code double} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * DoubleHolder
as the corresponding
+ * {@code DoubleHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myDoubleHolder
is an instance of DoubleHolder
,
- * the value stored in its value
field can be accessed with
- * myDoubleHolder.value
.
+ * If {@code myDoubleHolder} is an instance of {@code DoubleHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myDoubleHolder.value}.
*
* @since JDK1.2
*/
public final class DoubleHolder implements Streamable {
/**
- * The double
value held by this DoubleHolder
+ * The {@code double} value held by this {@code DoubleHolder}
* object.
*/
public double value;
/**
- * Constructs a new DoubleHolder
object with its
- * value
field initialized to 0.0.
+ * Constructs a new {@code DoubleHolder} object with its
+ * {@code value} field initialized to 0.0.
*/
public DoubleHolder() {
}
/**
- * Constructs a new DoubleHolder
object for the given
- * double
.
- * @param initial the double
with which to initialize
- * the value
field of the new
- * DoubleHolder
object
+ * Constructs a new {@code DoubleHolder} object for the given
+ * {@code double}.
+ * @param initial the {@code double} with which to initialize
+ * the {@code value} field of the new
+ * {@code DoubleHolder} object
*/
public DoubleHolder(double initial) {
value = initial;
@@ -80,7 +80,7 @@
* Read a double value from the input stream and store it in the
* value member.
*
- * @param input the InputStream
to read from.
+ * @param input the {@code InputStream} to read from.
*/
public void _read(InputStream input) {
value = input.read_double();
@@ -88,18 +88,18 @@
/**
* Write the double value stored in this holder to an
- * OutputStream
.
+ * {@code OutputStream}.
*
- * @param output the OutputStream
to write into.
+ * @param output the {@code OutputStream} to write into.
*/
public void _write(OutputStream output) {
output.write_double(value);
}
/**
- * Return the TypeCode
of this holder object.
+ * Return the {@code TypeCode} of this holder object.
*
- * @return the TypeCode
object.
+ * @return the {@code TypeCode} object.
*/
public org.omg.CORBA.TypeCode _type() {
return ORB.init().get_primitive_tc(TCKind.tk_double);
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/DoubleSeqHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/DoubleSeqHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/DoubleSeqHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,26 +26,26 @@
/**
-* The Helper for DoubleSeq. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-* org/omg/CORBA/DoubleSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:37 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -*
+ * org/omg/CORBA/DoubleSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:37 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + *
-* org/omg/CORBA/DoubleSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:37 o'clock GMT+00:00 -*/ + * The Holder for {@code DoubleSeq}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/DoubleSeqHolder.java
+ * Generated by the IDL-to-Java compiler (portable), version "3.0"
+ * from streams.idl
+ * 13 May 1999 22:41:37 o'clock GMT+00:00
+ */
public final class DoubleSeqHolder implements org.omg.CORBA.portable.Streamable
{
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/DynAny.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/DynAny.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/DynAny.java Tue Sep 22 11:01:54 2015 -0700
@@ -27,367 +27,368 @@
package org.omg.CORBA;
-/** Enables org.omg.CORBA.Any values to be dynamically
+/**
+ * Enables {@code org.omg.CORBA.Any} values to be dynamically
* interpreted (traversed) and
- * constructed. A DynAny object is associated with a data value
- * which may correspond to a copy of the value inserted into an Any.
- * The DynAny APIs enable traversal of the data value associated with an
- * Any at runtime and extraction of the primitive constituents of the
- * data value.
+ * constructed. A {@code DynAny} object is associated with a data value
+ * which may correspond to a copy of the value inserted into an {@code Any}.
+ * The {@code DynAny} APIs enable traversal of the data value associated with an
+ * Any at runtime and extraction of the primitive constituents of the
+ * data value.
* @deprecated Use the new DynAny instead
*/
@Deprecated
public interface DynAny extends org.omg.CORBA.Object
{
/**
- * Returns the TypeCode
of the object inserted into
- * this DynAny
.
+ * Returns the {@code TypeCode} of the object inserted into
+ * this {@code DynAny}.
*
- * @return the TypeCode
object.
+ * @return the {@code TypeCode} object.
*/
public org.omg.CORBA.TypeCode type() ;
/**
* Copy the contents from one Dynamic Any into another.
*
- * @param dyn_any the DynAny
object whose contents
- * are assigned to this DynAny
.
+ * @param dyn_any the {@code DynAny} object whose contents
+ * are assigned to this {@code DynAny}.
* @throws org.omg.CORBA.DynAnyPackage.Invalid if the source
- * DynAny
is invalid
+ * {@code DynAny} is invalid
*/
public void assign(org.omg.CORBA.DynAny dyn_any)
throws org.omg.CORBA.DynAnyPackage.Invalid;
/**
- * Make a DynAny
object from an Any
+ * Make a {@code DynAny} object from an {@code Any}
* object.
*
- * @param value the Any
object.
+ * @param value the {@code Any} object.
* @throws org.omg.CORBA.DynAnyPackage.Invalid if the source
- * Any
object is empty or bad
+ * {@code Any} object is empty or bad
*/
public void from_any(org.omg.CORBA.Any value)
throws org.omg.CORBA.DynAnyPackage.Invalid;
/**
- * Convert a DynAny
object to an Any
+ * Convert a {@code DynAny} object to an {@code Any}
* object.
*
- * @return the Any
object.
+ * @return the {@code Any} object.
* @throws org.omg.CORBA.DynAnyPackage.Invalid if this
- * DynAny
is empty or bad.
+ * {@code DynAny} is empty or bad.
* created or does not contain a meaningful value
*/
public org.omg.CORBA.Any to_any()
throws org.omg.CORBA.DynAnyPackage.Invalid;
/**
- * Destroys this DynAny
object and frees any resources
+ * Destroys this {@code DynAny} object and frees any resources
* used to represent the data value associated with it. This method
- * also destroys all DynAny
objects obtained from it.
+ * also destroys all {@code DynAny} objects obtained from it.
*
- * Destruction of DynAny
objects should be handled with
+ * Destruction of {@code DynAny} objects should be handled with
* care, taking into account issues dealing with the representation of
- * data values associated with DynAny
objects. A programmer
- * who wants to destroy a DynAny
object but still be able
+ * data values associated with {@code DynAny} objects. A programmer
+ * who wants to destroy a {@code DynAny} object but still be able
* to manipulate some component of the data value associated with it,
- * should first create a DynAny
object for the component
- * and then make a copy of the created DynAny
object.
+ * should first create a {@code DynAny} object for the component
+ * and then make a copy of the created {@code DynAny} object.
*/
public void destroy() ;
/**
- * Clones this DynAny
object.
+ * Clones this {@code DynAny} object.
*
- * @return a copy of this DynAny
object
+ * @return a copy of this {@code DynAny} object
*/
public org.omg.CORBA.DynAny copy() ;
/**
- * Inserts the given boolean
as the value for this
- * DynAny
object.
+ * Inserts the given {@code boolean} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the boolean
to insert into this
- * DynAny
object
+ * @param value the {@code boolean} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_boolean(boolean value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given byte
as the value for this
- * DynAny
object.
+ * Inserts the given {@code byte} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the byte
to insert into this
- * DynAny
object
+ * @param value the {@code byte} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_octet(byte value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given char
as the value for this
- * DynAny
object.
+ * Inserts the given {@code char} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the char
to insert into this
- * DynAny
object
+ * @param value the {@code char} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_char(char value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given short
as the value for this
- * DynAny
object.
+ * Inserts the given {@code short} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the short
to insert into this
- * DynAny
object
+ * @param value the {@code short} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_short(short value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given short
as the value for this
- * DynAny
object.
+ * Inserts the given {@code short} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the short
to insert into this
- * DynAny
object
+ * @param value the {@code short} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_ushort(short value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given int
as the value for this
- * DynAny
object.
+ * Inserts the given {@code int} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the int
to insert into this
- * DynAny
object
+ * @param value the {@code int} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_long(int value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given int
as the value for this
- * DynAny
object.
+ * Inserts the given {@code int} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the int
to insert into this
- * DynAny
object
+ * @param value the {@code int} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_ulong(int value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given float
as the value for this
- * DynAny
object.
+ * Inserts the given {@code float} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the float
to insert into this
- * DynAny
object
+ * @param value the {@code float} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_float(float value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given double
as the value for this
- * DynAny
object.
+ * Inserts the given {@code double} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the double
to insert into this
- * DynAny
object
+ * @param value the {@code double} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_double(double value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given String
object as the value for this
- * DynAny
object.
+ * Inserts the given {@code String} object as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the String
to insert into this
- * DynAny
object
+ * @param value the {@code String} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_string(String value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given org.omg.CORBA.Object
as the value for this
- * DynAny
object.
+ * Inserts the given {@code org.omg.CORBA.Object} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the org.omg.CORBA.Object
to insert into this
- * DynAny
object
+ * @param value the {@code org.omg.CORBA.Object} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_reference(org.omg.CORBA.Object value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given org.omg.CORBA.TypeCode
as the value for this
- * DynAny
object.
+ * Inserts the given {@code org.omg.CORBA.TypeCode} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the org.omg.CORBA.TypeCode
to insert into this
- * DynAny
object
+ * @param value the {@code org.omg.CORBA.TypeCode} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_typecode(org.omg.CORBA.TypeCode value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given long
as the value for this
- * DynAny
object.
+ * Inserts the given {@code long} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the long
to insert into this
- * DynAny
object
+ * @param value the {@code long} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_longlong(long value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given long
as the value for this
- * DynAny
object.
+ * Inserts the given {@code long} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the long
to insert into this
- * DynAny
object
+ * @param value the {@code long} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_ulonglong(long value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given char
as the value for this
- * DynAny
object.
+ * Inserts the given {@code char} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the char
to insert into this
- * DynAny
object
+ * @param value the {@code char} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_wchar(char value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given String
as the value for this
- * DynAny
object.
+ * Inserts the given {@code String} as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the String
to insert into this
- * DynAny
object
+ * @param value the {@code String} to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_wstring(String value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Inserts the given org.omg.CORBA.Any
object as the value for this
- * DynAny
object.
+ * Inserts the given {@code org.omg.CORBA.Any} object as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the org.omg.CORBA.Any
object to insert into this
- * DynAny
object
+ * @param value the {@code org.omg.CORBA.Any} object to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_any(org.omg.CORBA.Any value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
@@ -395,32 +396,32 @@
// orbos 98-01-18: Objects By Value -- begin
/**
- * Inserts the given java.io.Serializable
object as the value for this
- * DynAny
object.
+ * Inserts the given {@code java.io.Serializable} object as the value for this
+ * {@code DynAny} object.
*
- *
If this method is called on a constructed DynAny
+ *
If this method is called on a constructed {@code DynAny}
* object, it initializes the next component of the constructed data
- * value associated with this DynAny
object.
+ * value associated with this {@code DynAny} object.
*
- * @param value the java.io.Serializable
object to insert into this
- * DynAny
object
+ * @param value the {@code java.io.Serializable} object to insert into this
+ * {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.InvalidValue
* if the value inserted is not consistent with the type
- * of the accessed component in this DynAny
object
+ * of the accessed component in this {@code DynAny} object
*/
public void insert_val(java.io.Serializable value)
throws org.omg.CORBA.DynAnyPackage.InvalidValue;
/**
- * Retrieves the java.io.Serializable
object contained
- * in this DynAny
object.
+ * Retrieves the {@code java.io.Serializable} object contained
+ * in this {@code DynAny} object.
*
- * @return the java.io.Serializable
object that is the
- * value for this DynAny
object
+ * @return the {@code java.io.Serializable} object that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a java.io.Serializable
object
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code java.io.Serializable} object
*/
public java.io.Serializable get_val()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
@@ -428,284 +429,284 @@
// orbos 98-01-18: Objects By Value -- end
/**
- * Retrieves the boolean
contained
- * in this DynAny
object.
+ * Retrieves the {@code boolean} contained
+ * in this {@code DynAny} object.
*
- * @return the boolean
that is the
- * value for this DynAny
object
+ * @return the {@code boolean} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a boolean
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code boolean}
*/
public boolean get_boolean()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the byte
contained
- * in this DynAny
object.
+ * Retrieves the {@code byte} contained
+ * in this {@code DynAny} object.
*
- * @return the byte
that is the
- * value for this DynAny
object
+ * @return the {@code byte} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a byte
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code byte}
*/
public byte get_octet()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the char
contained
- * in this DynAny
object.
+ * Retrieves the {@code char} contained
+ * in this {@code DynAny} object.
*
- * @return the char
that is the
- * value for this DynAny
object
+ * @return the {@code char} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a char
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code char}
*/
public char get_char()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the short
contained
- * in this DynAny
object.
+ * Retrieves the {@code short} contained
+ * in this {@code DynAny} object.
*
- * @return the short
that is the
- * value for this DynAny
object
+ * @return the {@code short} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a short
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code short}
*/
public short get_short()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the short
contained
- * in this DynAny
object.
+ * Retrieves the {@code short} contained
+ * in this {@code DynAny} object.
*
- * @return the short
that is the
- * value for this DynAny
object
+ * @return the {@code short} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a short
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code short}
*/
public short get_ushort()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the int
contained
- * in this DynAny
object.
+ * Retrieves the {@code int} contained
+ * in this {@code DynAny} object.
*
- * @return the int
that is the
- * value for this DynAny
object
+ * @return the {@code int} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a int
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code int}
*/
public int get_long()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the int
contained
- * in this DynAny
object.
+ * Retrieves the {@code int} contained
+ * in this {@code DynAny} object.
*
- * @return the int
that is the
- * value for this DynAny
object
+ * @return the {@code int} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a int
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code int}
*/
public int get_ulong()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the float
contained
- * in this DynAny
object.
+ * Retrieves the {@code float} contained
+ * in this {@code DynAny} object.
*
- * @return the float
that is the
- * value for this DynAny
object
+ * @return the {@code float} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a float
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code float}
*/
public float get_float()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the double
contained
- * in this DynAny
object.
+ * Retrieves the {@code double} contained
+ * in this {@code DynAny} object.
*
- * @return the double
that is the
- * value for this DynAny
object
+ * @return the {@code double} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a double
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code double}
*/
public double get_double()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the String
contained
- * in this DynAny
object.
+ * Retrieves the {@code String} contained
+ * in this {@code DynAny} object.
*
- * @return the String
that is the
- * value for this DynAny
object
+ * @return the {@code String} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a String
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code String}
*/
public String get_string()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the org.omg.CORBA.Other
contained
- * in this DynAny
object.
+ * Retrieves the {@code org.omg.CORBA.Other} contained
+ * in this {@code DynAny} object.
*
- * @return the org.omg.CORBA.Other
that is the
- * value for this DynAny
object
+ * @return the {@code org.omg.CORBA.Other} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for an org.omg.CORBA.Other
+ * {@code DynAny} object is not equivalent to
+ * the type code for an {@code org.omg.CORBA.Other}
*/
public org.omg.CORBA.Object get_reference()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the org.omg.CORBA.TypeCode
contained
- * in this DynAny
object.
+ * Retrieves the {@code org.omg.CORBA.TypeCode} contained
+ * in this {@code DynAny} object.
*
- * @return the org.omg.CORBA.TypeCode
that is the
- * value for this DynAny
object
+ * @return the {@code org.omg.CORBA.TypeCode} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a org.omg.CORBA.TypeCode
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code org.omg.CORBA.TypeCode}
*/
public org.omg.CORBA.TypeCode get_typecode()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the long
contained
- * in this DynAny
object.
+ * Retrieves the {@code long} contained
+ * in this {@code DynAny} object.
*
- * @return the long
that is the
- * value for this DynAny
object
+ * @return the {@code long} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a long
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code long}
*/
public long get_longlong()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the long
contained
- * in this DynAny
object.
+ * Retrieves the {@code long} contained
+ * in this {@code DynAny} object.
*
- * @return the long
that is the
- * value for this DynAny
object
+ * @return the {@code long} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a long
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code long}
*/
public long get_ulonglong()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the char
contained
- * in this DynAny
object.
+ * Retrieves the {@code char} contained
+ * in this {@code DynAny} object.
*
- * @return the char
that is the
- * value for this DynAny
object
+ * @return the {@code char} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a char
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code char}
*/
public char get_wchar()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the String
contained
- * in this DynAny
object.
+ * Retrieves the {@code String} contained
+ * in this {@code DynAny} object.
*
- * @return the String
that is the
- * value for this DynAny
object
+ * @return the {@code String} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for a String
+ * {@code DynAny} object is not equivalent to
+ * the type code for a {@code String}
*/
public String get_wstring()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Retrieves the org.omg.CORBA.Any
contained
- * in this DynAny
object.
+ * Retrieves the {@code org.omg.CORBA.Any} contained
+ * in this {@code DynAny} object.
*
- * @return the org.omg.CORBA.Any
that is the
- * value for this DynAny
object
+ * @return the {@code org.omg.CORBA.Any} that is the
+ * value for this {@code DynAny} object
* @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
* if the type code of the accessed component in this
- * DynAny
object is not equivalent to
- * the type code for an org.omg.CORBA.Any
+ * {@code DynAny} object is not equivalent to
+ * the type code for an {@code org.omg.CORBA.Any}
*/
public org.omg.CORBA.Any get_any()
throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
/**
- * Returns a DynAny
object reference that can
+ * Returns a {@code DynAny} object reference that can
* be used to get/set the value of the component currently accessed.
- * The appropriate insert
method
- * can be called on the resulting DynAny
object
+ * The appropriate {@code insert} method
+ * can be called on the resulting {@code DynAny} object
* to initialize the component.
- * The appropriate get
method
- * can be called on the resulting DynAny
object
+ * The appropriate {@code get} method
+ * can be called on the resulting {@code DynAny} object
* to extract the value of the component.
*
- * @return a DynAny
object reference that can be
+ * @return a {@code DynAny} object reference that can be
* used to retrieve or set the value of the component currently
* accessed
*/
public org.omg.CORBA.DynAny current_component() ;
/**
- * Moves to the next component of this DynAny
object.
+ * Moves to the next component of this {@code DynAny} object.
* This method is used for iterating through the components of
* a constructed type, effectively moving a pointer from one
* component to the next. The pointer starts out on the first
- * component when a DynAny
object is created.
+ * component when a {@code DynAny} object is created.
*
- * @return true
if the pointer points to a component;
- * false
if there are no more components or this
- * DynAny
is associated with a basic type rather than
+ * @return {@code true} if the pointer points to a component;
+ * {@code false} if there are no more components or this
+ * {@code DynAny} is associated with a basic type rather than
* a constructed type
*/
public boolean next() ;
@@ -714,12 +715,12 @@
* Moves the internal pointer to the given index. Logically, this method
* sets a new offset for this pointer.
*
- * @param index an int
indicating the position to which
+ * @param index an {@code int} indicating the position to which
* the pointer should move. The first position is 0.
- * @return true
if the pointer points to a component;
- * false
if there is no component at the designated
- * index. If this DynAny
object is associated with a
- * basic type, this method returns false
for any index
+ * @return {@code true} if the pointer points to a component;
+ * {@code false} if there is no component at the designated
+ * index. If this {@code DynAny} object is associated with a
+ * basic type, this method returns {@code false} for any index
* other than 0.
*/
public boolean seek(int index) ;
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/DynArray.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/DynArray.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/DynArray.java Tue Sep 22 11:01:54 2015 -0700
@@ -27,8 +27,9 @@
package org.omg.CORBA;
-/** Represents a DynAny object associated
- * with an array.
+/**
+ * Represents a {@code DynAny} object associated with an array.
+ *
* @deprecated Use the new DynArray instead
*/
@Deprecated
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/DynEnum.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/DynEnum.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/DynEnum.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,8 +26,9 @@
package org.omg.CORBA;
-/** Represents a DynAny object associated
- * with an IDL enum.
+/**
+ * Represents a {@code DynAny} object associated with an IDL enum.
+ *
* @deprecated Use the new DynEnum instead
*/
@Deprecated
@@ -35,14 +36,14 @@
{
/**
* Return the value of the IDL enum stored in this
- * DynEnum
as a string.
+ * {@code DynEnum} as a string.
*
* @return the stringified value.
*/
public String value_as_string();
/**
- * Set a particular enum in this DynEnum
.
+ * Set a particular enum in this {@code DynEnum}.
*
* @param arg the string corresponding to the value.
*/
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/FieldNameHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/FieldNameHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/FieldNameHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,13 +26,13 @@
/**
-* The Helper for FieldName. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-* org/omg/CORBA/FieldNameHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* 03 June 1999 11:52:03 o'clock GMT+00:00 -*/ + * The Helper for {@code FieldName}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/FieldNameHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * 03 June 1999 11:52:03 o'clock GMT+00:00 + */ abstract public class FieldNameHelper { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/FixedHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/FixedHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/FixedHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -31,7 +31,7 @@ /** - * The Holder for Fixed. For more information on + * The Holder for {@code Fixed}. For more information on * Holder files, see * "Generated Files: Holder Files".
* FixedHolder is a container class for values of IDL type "fixed",
@@ -69,7 +69,7 @@
* Read a fixed point value from the input stream and store it in
* the value member.
*
- * @param input the InputStream
to read from.
+ * @param input the {@code InputStream} to read from.
*/
public void _read(InputStream input) {
value = input.read_fixed();
@@ -77,9 +77,9 @@
/**
* Write the fixed point value stored in this holder to an
- * OutputStream
.
+ * {@code OutputStream}.
*
- * @param output the OutputStream
to write into.
+ * @param output the {@code OutputStream} to write into.
*/
public void _write(OutputStream output) {
output.write_fixed(value);
@@ -87,9 +87,9 @@
/**
- * Return the TypeCode
of this holder object.
+ * Return the {@code TypeCode} of this holder object.
*
- * @return the TypeCode
object.
+ * @return the {@code TypeCode} object.
*/
public org.omg.CORBA.TypeCode _type() {
return ORB.init().get_primitive_tc(TCKind.tk_fixed);
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/FloatHolder.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/FloatHolder.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/FloatHolder.java Tue Sep 22 11:01:54 2015 -0700
@@ -31,45 +31,45 @@
/**
- * The Holder for Float. For more information on
+ * The Holder for {@code Float}. For more information on
* Holder files, see
* "Generated Files: Holder Files".
- * A Holder class for a float
+ * A Holder class for a {@code float}
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL float
as an "out"
+ * If an IDL method signature has an IDL {@code float} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * FloatHolder
as the corresponding
+ * {@code FloatHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myFloatHolder
is an instance of FloatHolder
,
- * the value stored in its value
field can be accessed with
- * myFloatHolder.value
.
+ * If {@code myFloatHolder} is an instance of {@code FloatHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myFloatHolder.value}.
*
* @since JDK1.2
*/
public final class FloatHolder implements Streamable {
/**
- * The float
value held by this FloatHolder
+ * The {@code float} value held by this {@code FloatHolder}
* object.
*/
public float value;
/**
- * Constructs a new FloatHolder
object with its
- * value
field initialized to 0.0.
+ * Constructs a new {@code FloatHolder} object with its
+ * {@code value} field initialized to 0.0.
*/
public FloatHolder() {
}
/**
- * Constructs a new FloatHolder
object for the given
- * float
.
- * @param initial the float
with which to initialize
- * the value
field of the new
- * FloatHolder
object
+ * Constructs a new {@code FloatHolder} object for the given
+ * {@code float}.
+ * @param initial the {@code float} with which to initialize
+ * the {@code value} field of the new
+ * {@code FloatHolder} object
*/
public FloatHolder(float initial) {
value = initial;
@@ -79,7 +79,7 @@
* Read a float from an input stream and initialize the value
* member with the float value.
*
- * @param input the InputStream
to read from.
+ * @param input the {@code InputStream} to read from.
*/
public void _read(InputStream input) {
value = input.read_float();
@@ -88,16 +88,16 @@
/**
* Write the float value into an output stream.
*
- * @param output the OutputStream
to write into.
+ * @param output the {@code OutputStream} to write into.
*/
public void _write(OutputStream output) {
output.write_float(value);
}
/**
- * Return the TypeCode
of this Streamable.
+ * Return the {@code TypeCode} of this Streamable.
*
- * @return the TypeCode
object.
+ * @return the {@code TypeCode} object.
*/
public org.omg.CORBA.TypeCode _type() {
return ORB.init().get_primitive_tc(TCKind.tk_float);
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/FloatSeqHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/FloatSeqHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/FloatSeqHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,26 +26,26 @@
/**
-* The Helper for FloatSeq. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-* org/omg/CORBA/FloatSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:37 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -*
+ * org/omg/CORBA/FloatSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:37 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + *
-* org/omg/CORBA/FloatSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:37 o'clock GMT+00:00 -*/ + * The Holder for {@code FloatSeq}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/FloatSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:37 o'clock GMT+00:00 + */ public final class FloatSeqHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/IDLTypeHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/IDLTypeHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/IDLTypeHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,14 +26,14 @@ /** -* The Helper for IDLType. For more information on -* Helper files, see -* "Generated Files: Helper Files".
-* org/omg/CORBA/IDLTypeHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ir.idl -* 03 June 1999 11:33:44 o'clock GMT+00:00 -*/ + * The Helper for {@code IDLType}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/IDLTypeHelper.java
+ * Generated by the IDL-to-Java compiler (portable), version "3.0"
+ * from ir.idl
+ * 03 June 1999 11:33:44 o'clock GMT+00:00
+ */
abstract public class IDLTypeHelper
{
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/IDLTypeOperations.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/IDLTypeOperations.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/IDLTypeOperations.java Tue Sep 22 11:01:54 2015 -0700
@@ -25,10 +25,10 @@
package org.omg.CORBA;
/**
-* The interface for IDLType. For more information on
-* Operations interfaces, see
-* "Generated Files: Operations files".
-*/
+ * The interface for {@code IDLType}. For more information on
+ * Operations interfaces, see
+ * "Generated Files: Operations files".
+ */
/*
tempout/org/omg/CORBA/IDLTypeOperations.java
@@ -51,8 +51,8 @@
{
/**
* The type attribute describes the type defined by an object
- * derived from IDLType
.
- * @return the TypeCode
defined by this object.
+ * derived from {@code IDLType}.
+ * @return the {@code TypeCode} defined by this object.
*/
org.omg.CORBA.TypeCode type ();
} // interface IDLTypeOperations
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/INV_OBJREF.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/INV_OBJREF.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/INV_OBJREF.java Tue Sep 22 11:01:54 2015 -0700
@@ -32,7 +32,7 @@
* exception is raised by ORB::string_to_object if the passed
* string does not decode correctly. An ORB may choose to detect
* calls via nil references (but is not obliged to do detect them).
- * INV_OBJREF is used to indicate this.
+ * {@code INV_OBJREF} is used to indicate this.
* It contains a minor code, which gives more detailed information about
* what caused the exception, and a completion status. It may also contain
* a string describing the exception.
@@ -47,7 +47,7 @@
public final class INV_OBJREF extends SystemException {
/**
- * Constructs an INV_OBJREF
exception with a default
+ * Constructs an {@code INV_OBJREF} exception with a default
* minor code of 0 and a completion state of COMPLETED_NO.
*/
public INV_OBJREF() {
@@ -55,7 +55,7 @@
}
/**
- * Constructs an INV_OBJREF
exception with the specified detail
+ * Constructs an {@code INV_OBJREF} exception with the specified detail
* message, a minor code of 0, and a completion state of COMPLETED_NO.
* @param s the String containing a detail message
*/
@@ -64,10 +64,10 @@
}
/**
- * Constructs an INV_OBJREF
exception with the specified
+ * Constructs an {@code INV_OBJREF} exception with the specified
* minor code and completion status.
* @param minor the minor code
- * @param completed a CompletionStatus
instance indicating
+ * @param completed a {@code CompletionStatus} instance indicating
* the completion status
*/
public INV_OBJREF(int minor, CompletionStatus completed) {
@@ -75,12 +75,12 @@
}
/**
- * Constructs an INV_OBJREF
exception with the specified detail
+ * Constructs an {@code INV_OBJREF} exception with the specified detail
* message, minor code, and completion status.
* A detail message is a String that describes this particular exception.
* @param s the String containing a detail message
* @param minor the minor code
- * @param completed a CompletionStatus
instance indicating
+ * @param completed a {@code CompletionStatus} instance indicating
* the completion status
*/
public INV_OBJREF(String s, int minor, CompletionStatus completed) {
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/INV_POLICY.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/INV_POLICY.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/INV_POLICY.java Tue Sep 22 11:01:54 2015 -0700
@@ -28,7 +28,7 @@
/**
* Standard exception thrown
* when an invocation cannot be made because of an incompatibility between
- * Policy overrides that apply to the particular invocation.
+ * {@code Policy} overrides that apply to the particular invocation.
* It contains a minor code, which gives more detailed information about
* what caused the exception, and a completion status. It may also contain
* a string describing the exception.
@@ -39,7 +39,7 @@
public final class INV_POLICY extends SystemException {
/**
- * Constructs a INV_POLICY
exception with a default minor code
+ * Constructs a {@code INV_POLICY} exception with a default minor code
* of 0, a completion state of CompletionStatus.COMPLETED_NO,
* and a null description.
*/
@@ -48,7 +48,7 @@
}
/**
- * Constructs a INV_POLICY
exception with the
+ * Constructs a {@code INV_POLICY} exception with the
* specified description message,
* a minor code of 0, and a completion state of COMPLETED_NO.
* @param s the String containing a detail message
@@ -58,7 +58,7 @@
}
/**
- * Constructs a INV_POLICY
exception with the specified
+ * Constructs a {@code INV_POLICY} exception with the specified
* minor code and completion status.
* @param minor the minor code
* @param completed the completion status
@@ -68,7 +68,7 @@
}
/**
- * Constructs a INV_POLICY
exception with the
+ * Constructs a {@code INV_POLICY} exception with the
* specified description message, minor code, and completion status.
* @param s the String containing a description message
* @param minor the minor code
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/IRObjectOperations.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/IRObjectOperations.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/IRObjectOperations.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,10 +26,10 @@
/**
-* The interface for IRObject. For more information on
-* Operations interfaces, see
-* "Generated Files: Operations files".
-*/
+ * The interface for {@code IRObject}. For more information on
+ * Operations interfaces, see
+ * "Generated Files: Operations files".
+ */
/*
tempout/org/omg/CORBA/IRObjectOperations.java
@@ -39,7 +39,7 @@
*/
/**
- * This is the Operations interface for the mapping from IRObject.
+ * This is the Operations interface for the mapping from {@code IRObject}.
* Several interfaces are used as base interfaces for objects in
* the Interface Repository (IR). These base interfaces are not instantiable.
* A common set of operations is used to locate objects within the
@@ -59,8 +59,8 @@
// read interface
/**
- * Returns the DefinitionKind
corresponding to this Interface Repository object.
- * @return the DefinitionKind
corresponding to this Interface Repository object.
+ * Returns the {@code DefinitionKind} corresponding to this Interface Repository object.
+ * @return the {@code DefinitionKind} corresponding to this Interface Repository object.
*/
org.omg.CORBA.DefinitionKind def_kind ();
@@ -70,13 +70,13 @@
* this method is applied to all its contents. If the object contains an IDLType
* attribute for an anonymous type, that IDLType is destroyed.
* If the object is currently contained in some other object, it is removed.
- * If the method is invoked on a Repository
or on a PrimitiveDef
- * then the BAD_INV_ORDER
exception is raised with minor value 2.
+ * If the method is invoked on a {@code Repository} or on a {@code PrimitiveDef}
+ * then the {@code BAD_INV_ORDER} exception is raised with minor value 2.
* An attempt to destroy an object that would leave the repository in an
- * incoherent state causes BAD_INV_ORDER
exception to be raised
+ * incoherent state causes {@code BAD_INV_ORDER} exception to be raised
* with the minor code 1.
* @exception BAD_INV_ORDER if this method is invoked on a repository or
- * PrimitiveDef
, or if an attempt to destroy an
+ * {@code PrimitiveDef}, or if an attempt to destroy an
* object would leave the repository in an incoherent state
*/
void destroy ();
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/IdentifierHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/IdentifierHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/IdentifierHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,14 +26,14 @@
/**
-* The Helper for Identifier. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-* org/omg/CORBA/IdentifierHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ir.idl -* 03 June 1999 11:33:42 o'clock GMT+00:00 -*/ + * The Helper for {@code Identifier}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/IdentifierHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ir.idl + * 03 June 1999 11:33:42 o'clock GMT+00:00 + */ abstract public class IdentifierHelper { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/IntHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/IntHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/IntHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -30,57 +30,57 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for Int. For more information on + * The Holder for {@code Int}. For more information on * Holder files, see * "Generated Files: Holder Files".
- * A Holder class for an int
+ * A Holder class for an {@code int}
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL long
as an "out"
+ * If an IDL method signature has an IDL {@code long} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * IntHolder
as the corresponding
+ * {@code IntHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myIntHolder
is an instance of IntHolder
,
- * the value stored in its value
field can be accessed with
- * myIntHolder.value
.
+ * If {@code myIntHolder} is an instance of {@code IntHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myIntHolder.value}.
*
* @since JDK1.2
*/
public final class IntHolder implements Streamable {
/**
- * The int
value held by this IntHolder
- * object in its value
field.
+ * The {@code int} value held by this {@code IntHolder}
+ * object in its {@code value} field.
*/
public int value;
/**
- * Constructs a new IntHolder
object with its
- * value
field initialized to 0
.
+ * Constructs a new {@code IntHolder} object with its
+ * {@code value} field initialized to {@code 0}.
*/
public IntHolder() {
}
/**
- * Constructs a new IntHolder
object with its
- * value
field initialized to the given
- * int
.
- * @param initial the int
with which to initialize
- * the value
field of the newly-created
- * IntHolder
object
+ * Constructs a new {@code IntHolder} object with its
+ * {@code value} field initialized to the given
+ * {@code int}.
+ * @param initial the {@code int} with which to initialize
+ * the {@code value} field of the newly-created
+ * {@code IntHolder} object
*/
public IntHolder(int initial) {
value = initial;
}
/**
- * Reads unmarshalled data from input
and assigns it to
- * the value
field in this IntHolder
object.
+ * Reads unmarshalled data from {@code input} and assigns it to
+ * the {@code value} field in this {@code IntHolder} object.
*
- * @param input the InputStream
object containing CDR
+ * @param input the {@code InputStream} object containing CDR
* formatted data from the wire
*/
public void _read(InputStream input) {
@@ -88,10 +88,10 @@
}
/**
- * Marshals the value in this IntHolder
object's
- * value
field to the output stream output
.
+ * Marshals the value in this {@code IntHolder} object's
+ * {@code value} field to the output stream {@code output}.
*
- * @param output the OutputStream
object that will contain
+ * @param output the {@code OutputStream} object that will contain
* the CDR formatted data
*/
public void _write(OutputStream output) {
@@ -99,11 +99,11 @@
}
/**
- * Retrieves the TypeCode
object that corresponds
- * to the value held in this IntHolder
object's
- * value
field.
+ * Retrieves the {@code TypeCode} object that corresponds
+ * to the value held in this {@code IntHolder} object's
+ * {@code value} field.
*
- * @return the type code for the value held in this IntHolder
+ * @return the type code for the value held in this {@code IntHolder}
* object
*/
public org.omg.CORBA.TypeCode _type() {
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/LocalObject.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/LocalObject.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/LocalObject.java Tue Sep 22 11:01:54 2015 -0700
@@ -30,26 +30,26 @@
/**
* Used as a base class for implementation of a local IDL interface in the
* Java language mapping. It is a class which implements all the operations
- * in the org.omg.CORBA.Object interface.
+ * in the {@code org.omg.CORBA.Object} interface.
*
Local interfaces are implemented by using CORBA::LocalObject
- * to provide implementations of Object
pseudo
- * operations and any other ORB-specific support mechanisms that are
- * appropriate for such objects. Object implementation techniques are
- * inherently language-mapping specific. Therefore, the
- * LocalObject
type is not defined in IDL, but is specified
- * in each language mapping.
- *
Methods that do not apply to local objects throw
- * an org.omg.CORBA.NO_IMPLEMENT
exception with the message,
- * "This is a locally contrained object." Attempting to use a
- * LocalObject to create a DII request results in NO_IMPLEMENT
- * system exception. Attempting to marshal or stringify a
- * LocalObject results in a MARSHAL system exception. Narrowing
- * and widening references to LocalObjects must work as for regular
- * object references.
- *
LocalObject
is to be used as the base class of locally
- * constrained objects, such as those in the PortableServer module.
- * The specification here is based on the CORBA Components
- * Volume I - orbos/99-07-01
+ * to provide implementations of {@code Object} pseudo
+ * operations and any other ORB-specific support mechanisms that are
+ * appropriate for such objects. Object implementation techniques are
+ * inherently language-mapping specific. Therefore, the
+ * {@code LocalObject} type is not defined in IDL, but is specified
+ * in each language mapping.
+ *
Methods that do not apply to local objects throw + * an {@code org.omg.CORBA.NO_IMPLEMENT} exception with the message, + * "This is a locally contrained object." Attempting to use a + * {@code LocalObject} to create a DII request results in NO_IMPLEMENT + * system exception. Attempting to marshal or stringify a + * {@code LocalObject} results in a MARSHAL system exception. Narrowing + * and widening references to {@code LocalObjects} must work as for regular + * object references. + *
{@code LocalObject} is to be used as the base class of locally
+ * constrained objects, such as those in the PortableServer module.
+ * The specification here is based on the CORBA Components
+ * Volume I - orbos/99-07-01
*
* @see CORBA
package
* comments for unimplemented features
@@ -60,7 +60,7 @@
private static String reason = "This is a locally constrained object.";
/**
- * Constructs a default LocalObject
instance.
+ * Constructs a default {@code LocalObject} instance.
*/
public LocalObject() {}
@@ -75,9 +75,9 @@
*
Default implementation of the org.omg.CORBA.Object method.
*
* @param that the object reference with which to check for equivalence
- * @return
- * Returns
+ * Returns {@code true} for this {@code LocalObject} instance.
*
- * @return Called by a stub to obtain an OutputStream for
* marshaling arguments. The stub must supply the operation name,
* and indicate if a response is expected (i.e is this a oneway call).
*
* @param operation the name of the operation being requested
- * @param responseExpected Called to invoke an operation. The stub provides an
- * May optionally be called by a stub to release a
* reply stream back to the ORB when the unmarshaling has
- * completed. The stub passes the
- * A Holder class for a
- * If
-* org/omg/CORBA/LongLongSeqHelper.java
-* Generated by the IDL-to-Java compiler (portable), version "3.0"
-* from streams.idl
-* 13 May 1999 22:41:37 o'clock GMT+00:00
-*
-* The class definition has been modified to conform to the following
-* OMG specifications :
-* true
if this object reference is known to be
+ * @return {@code true} if this object reference is known to be
* equivalent to the given object reference.
- * Note that false
indicates only that the two
+ * Note that {@code false} indicates only that the two
* object references are distinct, not necessarily that
* they reference distinct objects.
*/
@@ -86,11 +86,11 @@
}
/**
- * Always returns false
.
+ * Always returns {@code false}.
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
- * @return false
+ * @return {@code false}
*/
public boolean _non_existent() {
return false;
@@ -100,9 +100,9 @@
* Returns a hash value that is consistent for the
* lifetime of the object, using the given number as the maximum.
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
- * @param maximum an int
identifying maximum value of
+ * @param maximum an {@code int} identifying maximum value of
* the hashcode
* @return this instance's hashcode
*/
@@ -111,13 +111,13 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object." This method
* does not apply to local objects and is therefore not implemented.
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
- * @param repository_id a String
+ * @param repository_id a {@code String}
* @return NO_IMPLEMENT because this is a locally constrained object
* and this method does not apply to local objects
* @exception NO_IMPLEMENT because this is a locally constrained object
@@ -130,12 +130,12 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
- * @return a duplicate of this LocalObject
instance.
+ * @return a duplicate of this {@code LocalObject} instance.
* @exception NO_IMPLEMENT
* @see CORBA
package
* comments for unimplemented features
@@ -145,10 +145,10 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
* @exception NO_IMPLEMENT
* @see CORBA
package
@@ -159,14 +159,14 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
- * @param operation a String
giving the name of an operation
+ * @param operation a {@code String} giving the name of an operation
* to be performed by the request that is returned
- * @return a Request
object with the given operation
+ * @return a {@code Request} object with the given operation
* @exception NO_IMPLEMENT
* @see CORBA
package
* comments for unimplemented features
@@ -176,20 +176,20 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
- * @param ctx a Context
object containing
+ * @param ctx a {@code Context} object containing
* a list of properties
- * @param operation the String
representing the name of the
+ * @param operation the {@code String} representing the name of the
* method to be invoked
- * @param arg_list an NVList
containing the actual arguments
+ * @param arg_list an {@code NVList} containing the actual arguments
* to the method being invoked
- * @param result a NamedValue
object to serve as a
+ * @param result a {@code NamedValue} object to serve as a
* container for the method's return value
- * @return a new Request
object initialized with the given
+ * @return a new {@code Request} object initialized with the given
* arguments
* @exception NO_IMPLEMENT
* @see CORBA
package
@@ -203,25 +203,25 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
- * @param ctx a Context
object containing
+ * @param ctx a {@code Context} object containing
* a list of properties
* @param operation the name of the method to be invoked
- * @param arg_list an NVList
containing the actual arguments
+ * @param arg_list an {@code NVList} containing the actual arguments
* to the method being invoked
- * @param result a NamedValue
object to serve as a
+ * @param result a {@code NamedValue} object to serve as a
* container for the method's return value
- * @param exceptions an ExceptionList
object containing a
+ * @param exceptions an {@code ExceptionList} object containing a
* list of possible exceptions the method can throw
- * @param contexts a ContextList
object containing a list of
+ * @param contexts a {@code ContextList} object containing a list of
* context strings that need to be resolved and sent
* with the
- * Request
instance
- * @return the new Request
object initialized with the given
+ * {@code Request} instance
+ * @return the new {@code Request} object initialized with the given
* arguments
* @exception NO_IMPLEMENT
* @see CORBA
package
@@ -237,11 +237,11 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object." This method
* does not apply to local objects and is therefore not implemented.
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
* @return NO_IMPLEMENT because this is a locally constrained object
* and this method does not apply to local objects
@@ -256,10 +256,10 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
* @exception NO_IMPLEMENT
* @see CORBA
package
@@ -278,12 +278,12 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
* @return the ORB instance that created the Delegate contained in this
- * ObjectImpl
+ * {@code ObjectImpl}
* @exception NO_IMPLEMENT
* @see CORBA
package
* comments for unimplemented features
@@ -293,13 +293,13 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object." This method
* does not apply to local objects and is therefore not implemented.
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
- * @param policy_type an int
+ * @param policy_type an {@code int}
* @return NO_IMPLEMENT because this is a locally constrained object
* and this method does not apply to local objects
* @exception NO_IMPLEMENT because this is a locally constrained object
@@ -313,11 +313,11 @@
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object." This method
* does not apply to local objects and is therefore not implemented.
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
* @exception NO_IMPLEMENT
* @see CORBA
package
@@ -328,11 +328,11 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object." This method
* does not apply to local objects and is therefore not implemented.
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
* @param policies an array
* @param set_add a flag
@@ -351,13 +351,13 @@
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.true
for this LocalObject
instance.
+ * {@code org.omg.CORBA.Object} method.true
always
+ * @return {@code true} always
* @exception NO_IMPLEMENT
* @see CORBA
package
* comments for unimplemented features
@@ -367,12 +367,12 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
- * @param operation a String
indicating which operation
+ * @param operation a {@code String} indicating which operation
* to preinvoke
* @param expectedType the class of the type of operation mentioned above
* @return NO_IMPLEMENT because this is a locally constrained object
@@ -388,10 +388,10 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
* @param servant the servant object on which to post-invoke
* @exception NO_IMPLEMENT
@@ -408,17 +408,17 @@
*/
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
* true
if a response is expected,
- * false
if it is a one-way call
+ * @param responseExpected {@code true} if a response is expected,
+ * {@code false} if it is a one-way call
* @return NO_IMPLEMENT because this is a locally constrained object
* and this method does not apply to local objects
* @exception NO_IMPLEMENT because this is a locally constrained object
@@ -432,32 +432,32 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
* OutputStream
that was previously returned by a
- * _request()
- * call. _invoke
returns an InputStream
which
+ * {@code OutputStream} that was previously returned by a
+ * {@code _request()}
+ * call. {@code _invoke} returns an {@code InputStream} which
* contains the
- * marshaled reply. If an exception occurs, _invoke
may throw an
- * ApplicationException
object which contains an
- * InputStream
from
+ * marshaled reply. If an exception occurs, {@code _invoke} may throw an
+ * {@code ApplicationException} object which contains an
+ * {@code InputStream} from
* which the user exception state may be unmarshaled.
*
- * @param output the OutputStream
to invoke
+ * @param output the {@code OutputStream} to invoke
* @return NO_IMPLEMENT because this is a locally constrained object
* and this method does not apply to local objects
* @throws ApplicationException If an exception occurs,
- * _invoke
may throw an
- * ApplicationException
object which contains
- * an InputStream
from
+ * {@code _invoke} may throw an
+ * {@code ApplicationException} object which contains
+ * an {@code InputStream} from
* which the user exception state may be unmarshaled.
* @throws RemarshalException If an exception occurs,
- * _invoke
may throw an
- * ApplicationException
object which contains
- * an InputStream
from
+ * {@code _invoke} may throw an
+ * {@code ApplicationException} object which contains
+ * an {@code InputStream} from
* which the user exception state may be unmarshaled.
* @exception NO_IMPLEMENT because this is a locally constrained object
* and this method does not apply to local objects
@@ -471,17 +471,17 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object."
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
* InputStream
returned by
- * _invoke()
or
- * ApplicationException.getInputStream()
.
+ * completed. The stub passes the {@code InputStream} returned by
+ * {@code _invoke()} or
+ * {@code ApplicationException.getInputStream()}.
* A null
- * value may also be passed to _releaseReply
, in which case the
+ * value may also be passed to {@code _releaseReply}, in which case the
* method is a no-op.
*
* @param input the reply stream back to the ORB or null
@@ -494,11 +494,11 @@
}
/**
- * Throws an org.omg.CORBA.NO_IMPLEMENT
exception with
+ * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with
* the message "This is a locally constrained object." This method
* does not apply to local objects and is therefore not implemented.
* This method is the default implementation of the
- * org.omg.CORBA.Object
method.
+ * {@code org.omg.CORBA.Object} method.
*
* @return NO_IMPLEMENT because this is a locally constrained object
* and this method does not apply to local objects
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/LongHolder.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/LongHolder.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/LongHolder.java Tue Sep 22 11:01:54 2015 -0700
@@ -30,54 +30,54 @@
import org.omg.CORBA.portable.OutputStream;
/**
- * The Holder for Long. For more information on
+ * The Holder for {@code Long}. For more information on
* Holder files, see
* "Generated Files: Holder Files".long
+ * A Holder class for a {@code long}
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL long long
as an "out"
+ * If an IDL method signature has an IDL {@code long long} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * LongHolder
as the corresponding
+ * {@code LongHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
* myLongHolder
is an instance of LongHolder
,
- * the value stored in its value
field can be accessed with
- * myLongHolder.value
.
+ * If {@code myLongHolder} is an instance of {@code LongHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myLongHolder.value}.
*
* @since JDK1.2
*/
public final class LongHolder implements Streamable {
/**
- * The long
value held by this LongHolder
+ * The {@code long} value held by this {@code LongHolder}
* object.
*/
public long value;
/**
- * Constructs a new LongHolder
object with its
- * value
field initialized to 0
.
+ * Constructs a new {@code LongHolder} object with its
+ * {@code value} field initialized to {@code 0}.
*/
public LongHolder() {
}
/**
- * Constructs a new LongHolder
object with its
- * value
field initialized to the given
- * long
.
- * @param initial the long
with which to initialize
- * the value
field of the newly-created
- * LongHolder
object
+ * Constructs a new {@code LongHolder} object with its
+ * {@code value} field initialized to the given
+ * {@code long}.
+ * @param initial the {@code long} with which to initialize
+ * the {@code value} field of the newly-created
+ * {@code LongHolder} object
*/
public LongHolder(long initial) {
value = initial;
}
/**
- * Reads from input
and initalizes the value in the Holder
+ * Reads from {@code input} and initalizes the value in the Holder
* with the unmarshalled data.
*
* @param input the InputStream containing CDR formatted data from the wire
@@ -87,7 +87,7 @@
}
/**
- * Marshals to output
the value in the Holder.
+ * Marshals to {@code output} the value in the Holder.
*
* @param output the OutputStream which will contain the CDR formatted data
*/
@@ -96,7 +96,7 @@
}
/**
- * Returns the TypeCode
object
+ * Returns the {@code TypeCode} object
* corresponding to the value held in the Holder.
*
* @return the TypeCode of the value held in the holder
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/LongLongSeqHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/LongLongSeqHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/LongLongSeqHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,26 +26,26 @@
/**
-* The Helper for LongLongSeq. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-*
-*/
+ * The Helper for {@code LongLongSeq}. For more information on
+ * Helper files, see
+ * "Generated Files: Helper Files".
+ * org/omg/CORBA/LongLongSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:37 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + *
-* org/omg/CORBA/LongLongSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code LongLongSeq}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/LongLongSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class LongLongSeqHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/LongSeqHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/LongSeqHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/LongSeqHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,26 +26,26 @@ /** -* The Helper for LongSeqHelper. For more information on -* Helper files, see -* "Generated Files: Helper Files".
-* org/omg/CORBA/LongSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -*
+ * org/omg/CORBA/LongSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + *
-* org/omg/CORBA/LongSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code LongSeq}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/LongSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class LongSeqHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/MARSHAL.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/MARSHAL.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/MARSHAL.java Tue Sep 22 11:01:54 2015 -0700 @@ -31,7 +31,7 @@ * or server-side run time. For example, if a reply from the server * indicates that the message contains 1000 bytes, but the actual * message is shorter or longer than 1000 bytes, the ORB raises - * this exception. MARSHAL can also be caused by using + * this exception. {@code MARSHAL} can also be caused by using * the DII or DSI incorrectly, for example, if the type of the * actual parameters sent does not agree with IDL signature of an * operation.
@@ -47,7 +47,7 @@
public final class MARSHAL extends SystemException {
/**
- * Constructs a MARSHAL
exception with a default minor code
+ * Constructs a {@code MARSHAL} exception with a default minor code
* of 0, a completion state of CompletionStatus.COMPLETED_NO,
* and a null description.
*/
@@ -56,7 +56,7 @@
}
/**
- * Constructs a MARSHAL
exception with the specified description message,
+ * Constructs a {@code MARSHAL} exception with the specified description message,
* a minor code of 0, and a completion state of COMPLETED_NO.
* @param s the String containing a description of the exception
*/
@@ -65,7 +65,7 @@
}
/**
- * Constructs a MARSHAL
exception with the specified
+ * Constructs a {@code MARSHAL} exception with the specified
* minor code and completion status.
* @param minor the minor code
* @param completed the completion status
@@ -75,7 +75,7 @@
}
/**
- * Constructs a MARSHAL
exception with the specified description
+ * Constructs a {@code MARSHAL} exception with the specified description
* message, minor code, and completion status.
* @param s the String containing a description message
* @param minor the minor code
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/NO_IMPLEMENT.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/NO_IMPLEMENT.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/NO_IMPLEMENT.java Tue Sep 22 11:01:54 2015 -0700
@@ -28,7 +28,7 @@
/**
* This exception indicates that even though the operation that
* was invoked exists (it has an IDL definition), no implementation
- * for that operation exists. NO_IMPLEMENT can, for
+ * for that operation exists. {@code NO_IMPLEMENT} can, for
* example, be raised by an ORB if a client asks for an object's
* type definition from the interface repository, but no interface
* repository is provided by the ORB.
@@ -44,7 +44,7 @@
public final class NO_IMPLEMENT extends SystemException {
/**
- * Constructs a NO_IMPLEMENT
exception with a default minor code
+ * Constructs a {@code NO_IMPLEMENT} exception with a default minor code
* of 0, a completion state of CompletionStatus.COMPLETED_NO,
* and a null description.
*/
@@ -53,7 +53,7 @@
}
/**
- * Constructs a NO_IMPLEMENT
exception with the specified description message,
+ * Constructs a {@code NO_IMPLEMENT} exception with the specified description message,
* a minor code of 0, and a completion state of COMPLETED_NO.
* @param s the String containing a description of the exception
*/
@@ -62,10 +62,10 @@
}
/**
- * Constructs a NO_IMPLEMENT
exception with the specified
+ * Constructs a {@code NO_IMPLEMENT} exception with the specified
* minor code and completion status.
- * @param minor an int
specifying the minor code
- * @param completed a CompletionStatus
instance indicating
+ * @param minor an {@code int} specifying the minor code
+ * @param completed a {@code CompletionStatus} instance indicating
* the completion status
*/
public NO_IMPLEMENT(int minor, CompletionStatus completed) {
@@ -73,11 +73,11 @@
}
/**
- * Constructs a NO_IMPLEMENT
exception with the specified description
+ * Constructs a {@code NO_IMPLEMENT} exception with the specified description
* message, minor code, and completion status.
* @param s the String containing a description message
- * @param minor an int
specifying the minor code
- * @param completed a CompletionStatus
instance indicating
+ * @param minor an {@code int} specifying the minor code
+ * @param completed a {@code CompletionStatus} instance indicating
* the completion status
*/
public NO_IMPLEMENT(String s, int minor, CompletionStatus completed) {
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/NameValuePair.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/NameValuePair.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/NameValuePair.java Tue Sep 22 11:01:54 2015 -0700
@@ -28,33 +28,33 @@
/**
* Associates a name with a value that is an
- * attribute of an IDL struct, and is used in the DynStruct APIs.
+ * attribute of an IDL struct, and is used in the {@code DynStruct} APIs.
*/
public final class NameValuePair implements org.omg.CORBA.portable.IDLEntity {
/**
- * The name to be associated with a value by this NameValuePair
object.
+ * The name to be associated with a value by this {@code NameValuePair} object.
*/
public String id;
/**
- * The value to be associated with a name by this NameValuePair
object.
+ * The value to be associated with a name by this {@code NameValuePair} object.
*/
public org.omg.CORBA.Any value;
/**
- * Constructs an empty NameValuePair
object.
+ * Constructs an empty {@code NameValuePair} object.
* To associate a name with a value after using this constructor, the fields
* of this object have to be accessed individually.
*/
public NameValuePair() { }
/**
- * Constructs a NameValuePair
object that associates
- * the given name with the given org.omg.CORBA.Any
object.
- * @param __id the name to be associated with the given Any
object
- * @param __value the Any
object to be associated with the given name
+ * Constructs a {@code NameValuePair} object that associates
+ * the given name with the given {@code org.omg.CORBA.Any} object.
+ * @param __id the name to be associated with the given {@code Any} object
+ * @param __value the {@code Any} object to be associated with the given name
*/
public NameValuePair(String __id, org.omg.CORBA.Any __value) {
id = __id;
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/NameValuePairHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/NameValuePairHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/NameValuePairHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,13 +26,13 @@
/**
-* The Helper for NameValuePair. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-* org/omg/CORBA/NameValuePairHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* 03 June 1999 11:52:03 o'clock GMT+00:00 -*/ + * The Helper for {@code NameValuePair}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/NameValuePairHelper.java
+ * Generated by the IDL-to-Java compiler (portable), version "3.0"
+ * 03 June 1999 11:52:03 o'clock GMT+00:00
+ */
abstract public class NameValuePairHelper
{
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ORB.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/ORB.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ORB.java Tue Sep 22 11:01:54 2015 -0700
@@ -40,7 +40,7 @@
/**
* A class providing APIs for the CORBA Object Request Broker
- * features. The ORB
class also provides
+ * features. The {@code ORB} class also provides
* "pluggable ORB implementation" APIs that allow another vendor's ORB
* implementation to be used.
*
@@ -49,12 +49,12 @@ * objects servicing requests (servers). *
*
- * The ORB
class, which
+ * The {@code ORB} class, which
* encapsulates generic CORBA functionality, does the following:
* (Note that items 5 and 6, which include most of the methods in
- * the class ORB
, are typically used with the Dynamic Invocation
- * Interface
(DII) and the Dynamic Skeleton Interface
- * (DSI).
+ * the class {@code ORB}, are typically used with the
+ * {@code Dynamic Invocation Interface} (DII) and
+ * the {@code Dynamic Skeleton Interface} (DSI).
* These interfaces may be used by a developer directly, but
* most commonly they are used by the ORB internally and are
* not seen by the general programmer.)
@@ -62,29 +62,29 @@
*
resolve_initial_references
+ * the NameService using the method {@code resolve_initial_references}
* TypeCode
- * Any
- * NamedValue
- * Context
- * Environment
- * NVList
) containing these objects
+ *
- * The ORB
class can be used to obtain references to objects
+ * The {@code ORB} class can be used to obtain references to objects
* implemented anywhere on the network.
*
* An application or applet gains access to the CORBA environment
- * by initializing itself into an ORB
using one of
- * three init
methods. Two of the three methods use the properties
+ * by initializing itself into an {@code ORB} using one of
+ * three {@code init} methods. Two of the three methods use the properties
* (associations of a name with a value) shown in the
* table below.
*
org.omg.CORBA.ORBClass | *class name of an ORB implementation |
org.omg.CORBA.ORBSingletonClass | - *class name of the ORB returned by init() | class name of the ORB returned by {@code init()} | *
- * These properties allow a different vendor's ORB
+ * These properties allow a different vendor's {@code ORB}
* implementation to be "plugged in."
*
* When an ORB instance is being created, the class name of the ORB @@ -122,12 +122,12 @@ *
* Note that Java IDL provides a default implementation for the
* fully-functional ORB and for the Singleton ORB. When the method
- * init
is given no parameters, the default Singleton
- * ORB is returned. When the method init
is given parameters
+ * {@code init} is given no parameters, the default Singleton
+ * ORB is returned. When the method {@code init} is given parameters
* but no ORB class is specified, the Java IDL ORB implementation
* is returned.
*
- * The following code fragment creates an ORB
object
+ * The following code fragment creates an {@code ORB} object
* initialized with the default ORB Singleton.
* This ORB has a
* restricted implementation to prevent malicious applets from doing
@@ -138,9 +138,9 @@
* ORB orb = ORB.init();
*
*
- * The following code fragment creates an ORB
object
- * for an application. The parameter args
- * represents the arguments supplied to the application's main
+ * The following code fragment creates an {@code ORB} object
+ * for an application. The parameter {@code args}
+ * represents the arguments supplied to the application's {@code main}
* method. Since the property specifies the ORB class to be
* "SomeORBImplementation", the new ORB will be initialized with
* that ORB implementation. If p had been null,
@@ -153,7 +153,7 @@
* ORB orb = ORB.init(args, p);
*
*
- * The following code fragment creates an ORB
object
+ * The following code fragment creates an {@code ORB} object
* for the applet supplied as the first parameter. If the given
* applet does not specify an ORB class, the new ORB will be
* initialized with the default Java IDL implementation.
@@ -271,27 +271,27 @@
}
/**
- * Returns the ORB
singleton object. This method always returns the
+ * Returns the {@code ORB} singleton object. This method always returns the
* same ORB instance, which is an instance of the class described by the
- * org.omg.CORBA.ORBSingletonClass
system property.
+ * {@code org.omg.CORBA.ORBSingletonClass} system property.
*
- * This no-argument version of the method init
is used primarily
- * as a factory for TypeCode
objects, which are used by
- * Helper
classes to implement the method type
.
- * It is also used to create Any
objects that are used to
- * describe union
labels (as part of creating a
- * TypeCode
object for a union
).
+ * This no-argument version of the method {@code init} is used primarily
+ * as a factory for {@code TypeCode} objects, which are used by
+ * {@code Helper} classes to implement the method {@code type}.
+ * It is also used to create {@code Any} objects that are used to
+ * describe {@code union} labels (as part of creating a
+ * {@code TypeCode} object for a {@code union}).
*
* This method is not intended to be used by applets, and in the event
* that it is called in an applet environment, the ORB it returns
* is restricted so that it can be used only as a factory for
- * TypeCode
objects. Any TypeCode
objects
+ * {@code TypeCode} objects. Any {@code TypeCode} objects
* it produces can be safely shared among untrusted applets.
*
* If an ORB is created using this method from an applet,
* a system exception will be thrown if
* methods other than those for
- * creating TypeCode
objects are invoked.
+ * creating {@code TypeCode} objects are invoked.
*
* @return the singleton ORB
*
@@ -350,13 +350,13 @@
}
/**
- * Creates a new ORB
instance for a standalone
+ * Creates a new {@code ORB} instance for a standalone
* application. This method may be called from applications
- * only and returns a new fully functional ORB
object
+ * only and returns a new fully functional {@code ORB} object
* each time it is called.
- * @param args command-line arguments for the application's main
- * method; may be null
- * @param props application-specific properties; may be null
+ * @param args command-line arguments for the application's {@code main}
+ * method; may be {@code null}
+ * @param props application-specific properties; may be {@code null}
* @return the newly-created ORB instance
*
* @implNote
@@ -394,11 +394,11 @@
/**
- * Creates a new ORB
instance for an applet. This
+ * Creates a new {@code ORB} instance for an applet. This
* method may be called from applets only and returns a new
- * fully-functional ORB
object each time it is called.
- * @param app the applet; may be null
- * @param props applet-specific properties; may be null
+ * fully-functional {@code ORB} object each time it is called.
+ * @param app the applet; may be {@code null}
+ * @param props applet-specific properties; may be {@code null}
* @return the newly-created ORB instance
*
* @implNote
@@ -430,11 +430,11 @@
* Allows the ORB implementation to be initialized with the given
* parameters and properties. This method, used in applications only,
* is implemented by subclass ORB implementations and called
- * by the appropriate init
method to pass in its parameters.
+ * by the appropriate {@code init} method to pass in its parameters.
*
- * @param args command-line arguments for the application's main
- * method; may be null
- * @param props application-specific properties; may be null
+ * @param args command-line arguments for the application's {@code main}
+ * method; may be {@code null}
+ * @param props application-specific properties; may be {@code null}
*/
abstract protected void set_parameters(String[] args, Properties props);
@@ -442,10 +442,10 @@
* Allows the ORB implementation to be initialized with the given
* applet and parameters. This method, used in applets only,
* is implemented by subclass ORB implementations and called
- * by the appropriate init
method to pass in its parameters.
+ * by the appropriate {@code init} method to pass in its parameters.
*
- * @param app the applet; may be null
- * @param props applet-specific properties; may be null
+ * @param app the applet; may be {@code null}
+ * @param props applet-specific properties; may be {@code null}
*/
abstract protected void set_parameters(Applet app, Properties props);
@@ -453,17 +453,17 @@
* Connects the given servant object (a Java object that is
* an instance of the server implementation class)
* to the ORB. The servant class must
- * extend the ImplBase
class corresponding to the interface that is
+ * extend the {@code ImplBase} class corresponding to the interface that is
* supported by the server. The servant must thus be a CORBA object
- * reference, and inherit from org.omg.CORBA.Object
.
+ * reference, and inherit from {@code org.omg.CORBA.Object}.
* Servants created by the user can start receiving remote invocations
- * after the method connect
has been called. A servant may also be
+ * after the method {@code connect} has been called. A servant may also be
* automatically and implicitly connected to the ORB if it is passed as
* an IDL parameter in an IDL method invocation on a non-local object,
* that is, if the servant object has to be marshalled and sent outside of the
* process address space.
*
- * Calling the method connect
has no effect
+ * Calling the method {@code connect} has no effect
* when the servant object is already connected to the ORB.
*
* Deprecated by the OMG in favor of the Portable Object Adapter APIs.
@@ -477,17 +477,17 @@
/**
* Destroys the ORB so that its resources can be reclaimed.
* Any operation invoked on a destroyed ORB reference will throw the
- * OBJECT_NOT_EXIST
exception.
- * Once an ORB has been destroyed, another call to init
+ * {@code OBJECT_NOT_EXIST} exception.
+ * Once an ORB has been destroyed, another call to {@code init}
* with the same ORBid will return a reference to a newly constructed ORB.
- * If destroy
is called on an ORB that has not been shut down,
+ * If {@code destroy} is called on an ORB that has not been shut down,
* it will start the shut down process and block until the ORB has shut down
* before it destroys the ORB.
- * If an application calls destroy
in a thread that is currently servicing
- * an invocation, the BAD_INV_ORDER
system exception will be thrown
+ * If an application calls {@code destroy} in a thread that is currently servicing
+ * an invocation, the {@code BAD_INV_ORDER} system exception will be thrown
* with the OMG minor code 3, since blocking would result in a deadlock.
* For maximum portability and to avoid resource leaks, an application should
- * always call shutdown
and destroy
+ * always call {@code shutdown} and {@code destroy}
* on all ORB instances before exiting.
*
* @throws org.omg.CORBA.BAD_INV_ORDER if the current thread is servicing an invocation
@@ -500,14 +500,14 @@
* Disconnects the given servant object from the ORB. After this method returns,
* the ORB will reject incoming remote requests for the disconnected
* servant and will send the exception
- * org.omg.CORBA.OBJECT_NOT_EXIST
back to the
+ * {@code org.omg.CORBA.OBJECT_NOT_EXIST} back to the
* remote client. Thus the object appears to be destroyed from the
* point of view of remote clients. Note, however, that local requests issued
* using the servant directly do not
* pass through the ORB; hence, they will continue to be processed by the
* servant.
*
- * Calling the method disconnect
has no effect
+ * Calling the method {@code disconnect} has no effect
* if the servant is not connected to the ORB.
*
* Deprecated by the OMG in favor of the Portable Object Adapter APIs.
@@ -535,7 +535,7 @@
* Returns a list of the initially available CORBA object references,
* such as "NameService" and "InterfaceRepository".
*
- * @return an array of String
objects that represent
+ * @return an array of {@code String} objects that represent
* the object references for CORBA services
* that are initially available with this ORB
*/
@@ -559,8 +559,8 @@
* strings generated by a different ORB to be converted back into an object
* reference.
*
- * The resulting String
object may be stored or communicated
- * in any way that a String
object can be manipulated.
+ * The resulting {@code String} object may be stored or communicated
+ * in any way that a {@code String} object can be manipulated.
*
* @param obj the object reference to stringify
* @return the string representing the object reference
@@ -568,43 +568,43 @@
abstract public String object_to_string(org.omg.CORBA.Object obj);
/**
- * Converts a string produced by the method object_to_string
+ * Converts a string produced by the method {@code object_to_string}
* back to a CORBA object reference.
*
* @param str the string to be converted back to an object reference. It must
* be the result of converting an object reference to a string using the
- * method object_to_string
.
+ * method {@code object_to_string}.
* @return the object reference
*/
abstract public org.omg.CORBA.Object string_to_object(String str);
/**
- * Allocates an NVList
with (probably) enough
- * space for the specified number of NamedValue
objects.
+ * Allocates an {@code NVList} with (probably) enough
+ * space for the specified number of {@code NamedValue} objects.
* Note that the specified size is only a hint to help with
* storage allocation and does not imply the maximum size of the list.
*
- * @param count suggested number of NamedValue
objects for
+ * @param count suggested number of {@code NamedValue} objects for
* which to allocate space
- * @return the newly-created NVList
+ * @return the newly-created {@code NVList}
*
* @see NVList
*/
abstract public NVList create_list(int count);
/**
- * Creates an NVList
initialized with argument
+ * Creates an {@code NVList} initialized with argument
* descriptions for the operation described in the given
- * OperationDef
object. This OperationDef
object
+ * {@code OperationDef} object. This {@code OperationDef} object
* is obtained from an Interface Repository. The arguments in the
- * returned NVList
object are in the same order as in the
+ * returned {@code NVList} object are in the same order as in the
* original IDL operation definition, which makes it possible for the list
* to be used in dynamic invocation requests.
*
- * @param oper the OperationDef
object to use to create the list
- * @return a newly-created NVList
object containing
+ * @param oper the {@code OperationDef} object to use to create the list
+ * @return a newly-created {@code NVList} object containing
* descriptions of the arguments to the method described in the given
- * OperationDef
object
+ * {@code OperationDef} object
*
* @see NVList
*/
@@ -657,63 +657,63 @@
/**
- * Creates a NamedValue
object
+ * Creates a {@code NamedValue} object
* using the given name, value, and argument mode flags.
*
- * A NamedValue
object serves as (1) a parameter or return
+ * A {@code NamedValue} object serves as (1) a parameter or return
* value or (2) a context property.
* It may be used by itself or
- * as an element in an NVList
object.
+ * as an element in an {@code NVList} object.
*
- * @param s the name of the NamedValue
object
- * @param any the Any
value to be inserted into the
- * NamedValue
object
- * @param flags the argument mode flags for the NamedValue
: one of
- * ARG_IN.value
, ARG_OUT.value
,
- * or ARG_INOUT.value
.
+ * @param s the name of the {@code NamedValue} object
+ * @param any the {@code Any} value to be inserted into the
+ * {@code NamedValue} object
+ * @param flags the argument mode flags for the {@code NamedValue}: one of
+ * {@code ARG_IN.value}, {@code ARG_OUT.value},
+ * or {@code ARG_INOUT.value}.
*
- * @return the newly-created NamedValue
object
+ * @return the newly-created {@code NamedValue} object
* @see NamedValue
*/
abstract public NamedValue create_named_value(String s, Any any, int flags);
/**
- * Creates an empty ExceptionList
object.
+ * Creates an empty {@code ExceptionList} object.
*
- * @return the newly-created ExceptionList
object
+ * @return the newly-created {@code ExceptionList} object
*/
abstract public ExceptionList create_exception_list();
/**
- * Creates an empty ContextList
object.
+ * Creates an empty {@code ContextList} object.
*
- * @return the newly-created ContextList
object
+ * @return the newly-created {@code ContextList} object
* @see ContextList
* @see Context
*/
abstract public ContextList create_context_list();
/**
- * Gets the default Context
object.
+ * Gets the default {@code Context} object.
*
- * @return the default Context
object
+ * @return the default {@code Context} object
* @see Context
*/
abstract public Context get_default_context();
/**
- * Creates an Environment
object.
+ * Creates an {@code Environment} object.
*
- * @return the newly-created Environment
object
+ * @return the newly-created {@code Environment} object
* @see Environment
*/
abstract public Environment create_environment();
/**
- * Creates a new org.omg.CORBA.portable.OutputStream
into which
+ * Creates a new {@code org.omg.CORBA.portable.OutputStream} into which
* IDL method parameters can be marshalled during method invocation.
- * @return the newly-created
- * org.omg.CORBA.portable.OutputStream
object
+ * @return the newly-created
+ * {@code org.omg.CORBA.portable.OutputStream} object
*/
abstract public org.omg.CORBA.portable.OutputStream create_output_stream();
@@ -722,31 +722,31 @@
* any responses. Note that oneway invocations are not guaranteed to
* reach the server.
*
- * @param req an array of request objects
+ * @param req an array of request objects
*/
abstract public void send_multiple_requests_oneway(Request[] req);
/**
* Sends multiple dynamic (DII) requests asynchronously.
*
- * @param req an array of Request
objects
+ * @param req an array of {@code Request} objects
*/
abstract public void send_multiple_requests_deferred(Request[] req);
/**
* Finds out if any of the deferred (asynchronous) invocations have
* a response yet.
- * @return true
if there is a response available;
- * false
otherwise
+ * @return {@code true} if there is a response available;
+ * {@code false} otherwise
*/
abstract public boolean poll_next_response();
/**
- * Gets the next Request
instance for which a response
+ * Gets the next {@code Request} instance for which a response
* has been received.
*
- * @return the next Request
object ready with a response
- * @exception WrongTransaction if the method get_next_response
+ * @return the next {@code Request} object ready with a response
+ * @exception WrongTransaction if the method {@code get_next_response}
* is called from a transaction scope different
* from the one from which the original request was sent. See the
* OMG Transaction Service specification for details.
@@ -754,150 +754,150 @@
abstract public Request get_next_response() throws WrongTransaction;
/**
- * Retrieves the TypeCode
object that represents
+ * Retrieves the {@code TypeCode} object that represents
* the given primitive IDL type.
*
- * @param tcKind the TCKind
instance corresponding to the
+ * @param tcKind the {@code TCKind} instance corresponding to the
* desired primitive type
- * @return the requested TypeCode
object
+ * @return the requested {@code TypeCode} object
*/
abstract public TypeCode get_primitive_tc(TCKind tcKind);
/**
- * Creates a TypeCode
object representing an IDL struct
.
- * The TypeCode
object is initialized with the given id,
+ * Creates a {@code TypeCode} object representing an IDL {@code struct}.
+ * The {@code TypeCode} object is initialized with the given id,
* name, and members.
*
- * @param id the repository id for the struct
- * @param name the name of the struct
- * @param members an array describing the members of the struct
- * @return a newly-created TypeCode
object describing
- * an IDL struct
+ * @param id the repository id for the {@code struct}
+ * @param name the name of the {@code struct}
+ * @param members an array describing the members of the {@code struct}
+ * @return a newly-created {@code TypeCode} object describing
+ * an IDL {@code struct}
*/
abstract public TypeCode create_struct_tc(String id, String name,
StructMember[] members);
/**
- * Creates a TypeCode
object representing an IDL union
.
- * The TypeCode
object is initialized with the given id,
+ * Creates a {@code TypeCode} object representing an IDL {@code union}.
+ * The {@code TypeCode} object is initialized with the given id,
* name, discriminator type, and members.
*
- * @param id the repository id of the union
- * @param name the name of the union
- * @param discriminator_type the type of the union
discriminator
- * @param members an array describing the members of the union
- * @return a newly-created TypeCode
object describing
- * an IDL union
+ * @param id the repository id of the {@code union}
+ * @param name the name of the {@code union}
+ * @param discriminator_type the type of the {@code union} discriminator
+ * @param members an array describing the members of the {@code union}
+ * @return a newly-created {@code TypeCode} object describing
+ * an IDL {@code union}
*/
abstract public TypeCode create_union_tc(String id, String name,
TypeCode discriminator_type,
UnionMember[] members);
/**
- * Creates a TypeCode
object representing an IDL enum
.
- * The TypeCode
object is initialized with the given id,
+ * Creates a {@code TypeCode} object representing an IDL {@code enum}.
+ * The {@code TypeCode} object is initialized with the given id,
* name, and members.
*
- * @param id the repository id for the enum
- * @param name the name for the enum
- * @param members an array describing the members of the enum
- * @return a newly-created TypeCode
object describing
- * an IDL enum
+ * @param id the repository id for the {@code enum}
+ * @param name the name for the {@code enum}
+ * @param members an array describing the members of the {@code enum}
+ * @return a newly-created {@code TypeCode} object describing
+ * an IDL {@code enum}
*/
abstract public TypeCode create_enum_tc(String id, String name, String[] members);
/**
- * Creates a TypeCode
object representing an IDL alias
- * (typedef
).
- * The TypeCode
object is initialized with the given id,
+ * Creates a {@code TypeCode} object representing an IDL {@code alias}
+ * ({@code typedef}).
+ * The {@code TypeCode} object is initialized with the given id,
* name, and original type.
*
* @param id the repository id for the alias
* @param name the name for the alias
* @param original_type
- * the TypeCode
object describing the original type
- * for which this is an alias
- * @return a newly-created TypeCode
object describing
- * an IDL alias
+ * the {@code TypeCode} object describing the original type
+ * for which this is an alias
+ * @return a newly-created {@code TypeCode} object describing
+ * an IDL {@code alias}
*/
abstract public TypeCode create_alias_tc(String id, String name,
TypeCode original_type);
/**
- * Creates a TypeCode
object representing an IDL exception
.
- * The TypeCode
object is initialized with the given id,
+ * Creates a {@code TypeCode} object representing an IDL {@code exception}.
+ * The {@code TypeCode} object is initialized with the given id,
* name, and members.
*
- * @param id the repository id for the exception
- * @param name the name for the exception
- * @param members an array describing the members of the exception
- * @return a newly-created TypeCode
object describing
- * an IDL exception
+ * @param id the repository id for the {@code exception}
+ * @param name the name for the {@code exception}
+ * @param members an array describing the members of the {@code exception}
+ * @return a newly-created {@code TypeCode} object describing
+ * an IDL {@code exception}
*/
abstract public TypeCode create_exception_tc(String id, String name,
StructMember[] members);
/**
- * Creates a TypeCode
object representing an IDL interface
.
- * The TypeCode
object is initialized with the given id
+ * Creates a {@code TypeCode} object representing an IDL {@code interface}.
+ * The {@code TypeCode} object is initialized with the given id
* and name.
*
- * @param id the repository id for the interface
- * @param name the name for the interface
- * @return a newly-created TypeCode
object describing
- * an IDL interface
+ * @param id the repository id for the interface
+ * @param name the name for the interface
+ * @return a newly-created {@code TypeCode} object describing
+ * an IDL {@code interface}
*/
abstract public TypeCode create_interface_tc(String id, String name);
/**
- * Creates a TypeCode
object representing a bounded IDL
- * string
.
- * The TypeCode
object is initialized with the given bound,
+ * Creates a {@code TypeCode} object representing a bounded IDL
+ * {@code string}.
+ * The {@code TypeCode} object is initialized with the given bound,
* which represents the maximum length of the string. Zero indicates
* that the string described by this type code is unbounded.
*
- * @param bound the bound for the string
; cannot be negative
- * @return a newly-created TypeCode
object describing
- * a bounded IDL string
+ * @param bound the bound for the {@code string}; cannot be negative
+ * @return a newly-created {@code TypeCode} object describing
+ * a bounded IDL {@code string}
* @exception BAD_PARAM if bound is a negative value
*/
abstract public TypeCode create_string_tc(int bound);
/**
- * Creates a TypeCode
object representing a bounded IDL
- * wstring
(wide string).
- * The TypeCode
object is initialized with the given bound,
+ * Creates a {@code TypeCode} object representing a bounded IDL
+ * {@code wstring} (wide string).
+ * The {@code TypeCode} object is initialized with the given bound,
* which represents the maximum length of the wide string. Zero indicates
* that the string described by this type code is unbounded.
*
- * @param bound the bound for the wstring
; cannot be negative
- * @return a newly-created TypeCode
object describing
- * a bounded IDL wstring
+ * @param bound the bound for the {@code wstring}; cannot be negative
+ * @return a newly-created {@code TypeCode} object describing
+ * a bounded IDL {@code wstring}
* @exception BAD_PARAM if bound is a negative value
*/
abstract public TypeCode create_wstring_tc(int bound);
/**
- * Creates a TypeCode
object representing an IDL sequence
.
- * The TypeCode
object is initialized with the given bound and
+ * Creates a {@code TypeCode} object representing an IDL {@code sequence}.
+ * The {@code TypeCode} object is initialized with the given bound and
* element type.
*
- * @param bound the bound for the sequence
, 0 if unbounded
- * @param element_type
- * the TypeCode
object describing the elements
- * contained in the sequence
- * @return a newly-created TypeCode
object describing
- * an IDL sequence
+ * @param bound the bound for the {@code sequence}, 0 if unbounded
+ * @param element_type the {@code TypeCode} object describing
+ * the elements contained in the {@code sequence}
+ *
+ * @return a newly-created {@code TypeCode} object describing
+ * an IDL {@code sequence}
*/
abstract public TypeCode create_sequence_tc(int bound, TypeCode element_type);
/**
- * Creates a TypeCode
object representing a
- * a recursive IDL sequence
.
+ * Creates a {@code TypeCode} object representing a
+ * a recursive IDL {@code sequence}.
*
- * For the IDL struct
Node in following code fragment,
+ * For the IDL {@code struct} Node in following code fragment,
* the offset parameter for creating its sequence would be 1:
*
* Struct Node { @@ -907,10 +907,10 @@ ** * @param bound the bound for the sequence, 0 if unbounded - * @param offset the index to the enclosing
TypeCode
object
+ * @param offset the index to the enclosing {@code TypeCode} object
* that describes the elements of this sequence
- * @return a newly-created TypeCode
object describing
- * a recursive sequence
+ * @return a newly-created {@code TypeCode} object describing
+ * a recursive sequence
* @deprecated Use a combination of create_recursive_tc and create_sequence_tc instead
* @see #create_recursive_tc(String) create_recursive_tc
* @see #create_sequence_tc(int, TypeCode) create_sequence_tc
@@ -919,20 +919,20 @@
abstract public TypeCode create_recursive_sequence_tc(int bound, int offset);
/**
- * Creates a TypeCode
object representing an IDL array
.
- * The TypeCode
object is initialized with the given length and
+ * Creates a {@code TypeCode} object representing an IDL {@code array}.
+ * The {@code TypeCode} object is initialized with the given length and
* element type.
*
- * @param length the length of the array
- * @param element_type a TypeCode
object describing the type
- * of element contained in the array
- * @return a newly-created TypeCode
object describing
- * an IDL array
+ * @param length the length of the {@code array}
+ * @param element_type a {@code TypeCode} object describing the type
+ * of element contained in the {@code array}
+ * @return a newly-created {@code TypeCode} object describing
+ * an IDL {@code array}
*/
abstract public TypeCode create_array_tc(int length, TypeCode element_type);
/**
- * Create a TypeCode
object for an IDL native type.
+ * Create a {@code TypeCode} object for an IDL native type.
*
* @param id the logical id for the native type.
* @param name the name of the native type.
@@ -945,7 +945,7 @@
}
/**
- * Create a TypeCode
object for an IDL abstract interface.
+ * Create a {@code TypeCode} object for an IDL abstract interface.
*
* @param id the logical id for the abstract interface type.
* @param name the name of the abstract interface type.
@@ -960,7 +960,7 @@
/**
- * Create a TypeCode
object for an IDL fixed type.
+ * Create a {@code TypeCode} object for an IDL fixed type.
*
* @param digits specifies the total number of decimal digits in the number
* and must be from 1 to 31 inclusive.
@@ -977,7 +977,7 @@
/**
- * Create a TypeCode
object for an IDL value type.
+ * Create a {@code TypeCode} object for an IDL value type.
* The concrete_base parameter is the TypeCode for the immediate
* concrete valuetype base of the valuetype for which the TypeCode
* is being created.
@@ -987,7 +987,7 @@
* @param name the name of the value type.
* @param type_modifier one of the value type modifier constants:
* VM_NONE, VM_CUSTOM, VM_ABSTRACT or VM_TRUNCATABLE
- * @param concrete_base a TypeCode
object
+ * @param concrete_base a {@code TypeCode} object
* describing the concrete valuetype base
* @param members an array containing the members of the value type
* @return the requested TypeCode
@@ -1002,14 +1002,14 @@
}
/**
- * Create a recursive TypeCode
object which
+ * Create a recursive {@code TypeCode} object which
* serves as a placeholder for a concrete TypeCode during the process of creating
* TypeCodes which contain recursion. The id parameter specifies the repository id of
* the type for which the recursive TypeCode is serving as a placeholder. Once the
* recursive TypeCode has been properly embedded in the enclosing TypeCode which
* corresponds to the specified repository id, it will function as a normal TypeCode.
* Invoking operations on the recursive TypeCode before it has been embedded in the
- * enclosing TypeCode will result in a BAD_TYPECODE
exception.
+ * enclosing TypeCode will result in a {@code BAD_TYPECODE} exception.
* * For example, the following IDL type declaration contains recursion: *
@@ -1046,7 +1046,7 @@ } /** - * Creates aTypeCode
object for an IDL value box. + * Creates a {@code TypeCode} object for an IDL value box. * * @param id the logical id for the value type * @param name the name of the value type @@ -1064,11 +1064,11 @@ // orbos 98-01-18: Objects By Value -- end /** - * Creates an IDLAny
object initialized to - * contain aTypecode
object whosekind
field - * is set toTCKind.tc_null
. + * Creates an IDL {@code Any} object initialized to + * contain a {@code Typecode} object whose {@code kind} field + * is set to {@code TCKind.tc_null}. * - * @return a newly-createdAny
object + * @return a newly-created {@code Any} object */ abstract public Any create_any(); @@ -1076,15 +1076,15 @@ /** - * Retrieves aCurrent
object. - * TheCurrent
interface is used to manage thread-specific + * Retrieves a {@code Current} object. + * The {@code Current} interface is used to manage thread-specific * information for use by services such as transactions and security. * * @seeCORBA
package * comments for unimplemented features * - * @return a newly-createdCurrent
object - * @deprecated useresolve_initial_references
. + * @return a newly-created {@code Current} object + * @deprecated use {@code resolve_initial_references}. */ @Deprecated public org.omg.CORBA.Current get_current() @@ -1095,7 +1095,7 @@ /** * This operation blocks the current thread until the ORB has * completed the shutdown process, initiated when some thread calls - *shutdown
. It may be used by multiple threads which + * {@code shutdown}. It may be used by multiple threads which * get all notified when the ORB shuts down. * */ @@ -1107,29 +1107,29 @@ /** * Instructs the ORB to shut down, which causes all * object adapters to shut down, in preparation for destruction.
- * If thewait_for_completion
parameter + * If the {@code wait_for_completion} parameter * is true, this operation blocks until all ORB processing (including * processing of currently executing requests, object deactivation, * and other object adapter operations) has completed. * If an application does this in a thread that is currently servicing - * an invocation, theBAD_INV_ORDER
system exception + * an invocation, the {@code BAD_INV_ORDER} system exception * will be thrown with the OMG minor code 3, * since blocking would result in a deadlock.
- * If thewait_for_completion
parameter isFALSE
, + * If the {@code wait_for_completion} parameter is {@code FALSE}, * then shutdown may not have completed upon return.* While the ORB is in the process of shutting down, the ORB operates as normal, * servicing incoming and outgoing requests until all requests have been completed. * Once an ORB has shutdown, only object reference management operations * may be invoked on the ORB or any object reference obtained from it. - * An application may also invoke the
destroy
operation on the ORB itself. - * Invoking any other operation will throw theBAD_INV_ORDER
+ * An application may also invoke the {@code destroy} operation on the ORB itself. + * Invoking any other operation will throw the {@code BAD_INV_ORDER} * system exception with the OMG minor code 4.- * The
ORB.run
method will return after - *shutdown
has been called. + * The {@code ORB.run} method will return after + * {@code shutdown} has been called. * - * @param wait_for_completiontrue
if the call + * @param wait_for_completion {@code true} if the call * should block until the shutdown is complete; - *false
if it should return immediately + * {@code false} if it should return immediately * @throws org.omg.CORBA.BAD_INV_ORDER if the current thread is servicing * an invocation */ @@ -1139,12 +1139,12 @@ } /** - * Returnstrue
if the ORB needs the main thread to - * perform some work, andfalse
if the ORB does not + * Returns {@code true} if the ORB needs the main thread to + * perform some work, and {@code false} if the ORB does not * need the main thread. * - * @returntrue
if there is work pending, meaning that the ORB - * needs the main thread to perform some work;false
+ * @return {@code true} if there is work pending, meaning that the ORB + * needs the main thread to perform some work; {@code false} * if there is no work pending and thus the ORB does not need the * main thread * @@ -1157,7 +1157,7 @@ /** * Performs an implementation-dependent unit of work if called * by the main thread. Otherwise it does nothing. - * The methodswork_pending
andperform_work
+ * The methods {@code work_pending} and {@code perform_work} * can be used in * conjunction to implement a simple polling loop that multiplexes * the main thread among the ORB and other activities. @@ -1172,23 +1172,23 @@ * Used to obtain information about CORBA facilities and services * that are supported by this ORB. The service type for which * information is being requested is passed in as the in - * parameter service_type, the values defined by + * parameter {@code service_type}, the values defined by * constants in the CORBA module. If service information is * available for that type, that is returned in the out parameter - * service_info, and the operation returns the - * value true. If no information for the requested - * services type is available, the operation returns false + * {@code service_info}, and the operation returns the + * value {@code true}. If no information for the requested + * services type is available, the operation returns {@code false} * (i.e., the service is not supported by this ORB). * - * @param service_type ashort
indicating the + * @param service_type a {@code short} indicating the * service type for which information is being requested - * @param service_info aServiceInformationHolder
object - * that will hold theServiceInformation
object + * @param service_info a {@code ServiceInformationHolder} object + * that will hold the {@code ServiceInformation} object * produced by this method - * @returntrue
if service information is available - * for the service_type; - * false if no information for the - * requested services type is available + * @return {@code true} if service information is available + * for the {@code service_type}; + * {@code false} if no information for the + * requested services type is available * @seeCORBA
package * comments for unimplemented features */ @@ -1201,13 +1201,13 @@ // orbos 98-01-18: Objects By Value -- begin /** - * Creates a newDynAny
object from the given - *Any
object. + * Creates a new {@code DynAny} object from the given + * {@code Any} object. * - * @param value theAny
object from which to create a new - *DynAny
object - * @return the newDynAny
object created from the given - *Any
object + * @param value the {@code Any} object from which to create a new + * {@code DynAny} object + * @return the new {@code DynAny} object created from the given + * {@code Any} object * @seeCORBA
package * comments for unimplemented features * @deprecated Use the new DynAnyFactory API instead @@ -1219,15 +1219,15 @@ } /** - * Creates a basicDynAny
object from the given - *TypeCode
object. + * Creates a basic {@code DynAny} object from the given + * {@code TypeCode} object. * - * @param type theTypeCode
object from which to create a new - *DynAny
object - * @return the newDynAny
object created from the given - *TypeCode
object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynAny} object + * @return the new {@code DynAny} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - *TypeCode
object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @seeCORBA
package * comments for unimplemented features * @deprecated Use the new DynAnyFactory API instead @@ -1239,15 +1239,15 @@ } /** - * Creates a newDynStruct
object from the given - *TypeCode
object. + * Creates a new {@code DynStruct} object from the given + * {@code TypeCode} object. * - * @param type theTypeCode
object from which to create a new - *DynStruct
object - * @return the newDynStruct
object created from the given - *TypeCode
object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynStruct} object + * @return the new {@code DynStruct} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - *TypeCode
object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @seeCORBA
package * comments for unimplemented features * @deprecated Use the new DynAnyFactory API instead @@ -1259,15 +1259,15 @@ } /** - * Creates a newDynSequence
object from the given - *TypeCode
object. + * Creates a new {@code DynSequence} object from the given + * {@code TypeCode} object. * - * @param type theTypeCode
object from which to create a new - *DynSequence
object - * @return the newDynSequence
object created from the given - *TypeCode
object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynSequence} object + * @return the new {@code DynSequence} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - *TypeCode
object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @seeCORBA
package * comments for unimplemented features * @deprecated Use the new DynAnyFactory API instead @@ -1280,15 +1280,15 @@ /** - * Creates a newDynArray
object from the given - *TypeCode
object. + * Creates a new {@code DynArray} object from the given + * {@code TypeCode} object. * - * @param type theTypeCode
object from which to create a new - *DynArray
object - * @return the newDynArray
object created from the given - *TypeCode
object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynArray} object + * @return the new {@code DynArray} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - *TypeCode
object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @seeCORBA
package * comments for unimplemented features * @deprecated Use the new DynAnyFactory API instead @@ -1300,15 +1300,15 @@ } /** - * Creates a newDynUnion
object from the given - *TypeCode
object. + * Creates a new {@code DynUnion} object from the given + * {@code TypeCode} object. * - * @param type theTypeCode
object from which to create a new - *DynUnion
object - * @return the newDynUnion
object created from the given - *TypeCode
object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynUnion} object + * @return the new {@code DynUnion} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - *TypeCode
object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @seeCORBA
package * comments for unimplemented features * @deprecated Use the new DynAnyFactory API instead @@ -1320,15 +1320,15 @@ } /** - * Creates a newDynEnum
object from the given - *TypeCode
object. + * Creates a new {@code DynEnum} object from the given + * {@code TypeCode} object. * - * @param type theTypeCode
object from which to create a new - *DynEnum
object - * @return the newDynEnum
object created from the given - *TypeCode
object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynEnum} object + * @return the new {@code DynEnum} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - *TypeCode
object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @seeCORBA
package * comments for unimplemented features * @deprecated Use the new DynAnyFactory API instead @@ -1342,19 +1342,19 @@ /** * Can be invoked to create new instances of policy objects * of a specific type with specified initial state. If - * create_policy fails to instantiate a new Policy + * {@code create_policy} fails to instantiate a new Policy * object due to its inability to interpret the requested type - * and content of the policy, it raises the PolicyError + * and content of the policy, it raises the {@code PolicyError} * exception with the appropriate reason. - * @param type the PolicyType of the policy object to + * @param type the {@code PolicyType} of the policy object to * be created * @param val the value that will be used to set the initial - * state of the Policy object that is created - * @return Reference to a newly created Policy object - * of type specified by the type parameter and - * initialized to a state specified by the val + * state of the {@code Policy} object that is created + * @return Reference to a newly created {@code Policy} object + * of type specified by the {@code type} parameter and + * initialized to a state specified by the {@code val} * parameter - * @throws org.omg.CORBA.PolicyError when the requested + * @throws org.omg.CORBA.PolicyError when the requested * policy is not supported or a requested initial state * for the policy is not supported. */ diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ObjectHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ObjectHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ObjectHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -24,10 +24,10 @@ */ /** -* The Helper for Object. For more information on -* Helper files, see -* "Generated Files: Helper Files".-*/ + * The Helper for {@code Object}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ */ /* * Licensed Materials - Property of IBM diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ObjectHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ObjectHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ObjectHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -31,55 +31,55 @@ /** - * The Holder for Object. For more information on + * The Holder for {@code Object}. For more information on * Holder files, see * "Generated Files: Holder Files".
* A Holder class for a CORBA object reference (a value of type - *
org.omg.CORBA.Object
). It is usually + * {@code org.omg.CORBA.Object}). It is usually * used to store "out" and "inout" parameters in IDL methods. * If an IDL method signature has a CORBA Object reference as an "out" * or "inout" parameter, the programmer must pass an instance of - *ObjectHolder
as the corresponding + * {@code ObjectHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. *- * If
myObjectHolder
is an instance ofObjectHolder
, - * the value stored in itsvalue
field can be accessed with - *myObjectHolder.value
. + * If {@code myObjectHolder} is an instance of {@code ObjectHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myObjectHolder.value}. * * @since JDK1.2 */ public final class ObjectHolder implements Streamable { /** - * TheObject
value held by thisObjectHolder
+ * The {@code Object} value held by this {@code ObjectHolder} * object. */ public Object value; /** - * Constructs a newObjectHolder
object with its - *value
field initialized tonull
. + * Constructs a new {@code ObjectHolder} object with its + * {@code value} field initialized to {@code null}. */ public ObjectHolder() { } /** - * Constructs a newObjectHolder
object with its - *value
field initialized to the given - *Object
. - * @param initial theObject
with which to initialize - * thevalue
field of the newly-created - *ObjectHolder
object + * Constructs a new {@code ObjectHolder} object with its + * {@code value} field initialized to the given + * {@code Object}. + * @param initial the {@code Object} with which to initialize + * the {@code value} field of the newly-created + * {@code ObjectHolder} object */ public ObjectHolder(Object initial) { value = initial; } /** - * Reads frominput
and initalizes the value in - * thisObjectHolder
object + * Reads from {@code input} and initalizes the value in + * this {@code ObjectHolder} object * with the unmarshalled data. * * @param input the InputStream containing CDR formatted data from the wire. @@ -89,8 +89,8 @@ } /** - * Marshals tooutput
the value in - * thisObjectHolder
object. + * Marshals to {@code output} the value in + * this {@code ObjectHolder} object. * * @param output the OutputStream which will contain the CDR formatted data. */ @@ -100,10 +100,10 @@ /** * Returns the TypeCode corresponding to the value held in - * thisObjectHolder
object + * this {@code ObjectHolder} object * * @return the TypeCode of the value held in - * thisObjectHolder
object + * this {@code ObjectHolder} object */ public org.omg.CORBA.TypeCode _type() { return org.omg.CORBA.ORB.init().get_primitive_tc(TCKind.tk_objref); diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/OctetSeqHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/OctetSeqHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/OctetSeqHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,26 +26,26 @@ /** -* The Helper for OctetSeq. For more information on -* Helper files, see -* "Generated Files: Helper Files".-* org/omg/CORBA/OctetSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -*
+ * org/omg/CORBA/OctetSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + *
-* org/omg/CORBA/OctetSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code OctetSeq}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/OctetSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class OctetSeqHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/Policy.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/Policy.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/Policy.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,21 +26,21 @@ /** -* Interfaces derived from the Policy interface allow an -* ORB or CORBA service access to certain choices that affect -* its operation. This information is accessed in a structured -* manner using interfaces derived from the Policy -* interface defined in the CORBA module. A CORBA service does not -* have to use this method of accessing operating options, but -* may choose to do so. The Security Service in particular uses -* this technique for associating Security Policy with objects -* in the system. -* An interface generated by the IDL-to-Java compiler. -* org/omg/CORBA/Policy.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * Interfaces derived from the {@code Policy} interface allow an + * ORB or CORBA service access to certain choices that affect + * its operation. This information is accessed in a structured + * manner using interfaces derived from the {@code Policy} + * interface defined in the CORBA module. A CORBA service does not + * have to use this method of accessing operating options, but + * may choose to do so. The Security Service in particular uses + * this technique for associating Security Policy with objects + * in the system. + * An interface generated by the IDL-to-Java compiler. + * org/omg/CORBA/Policy.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:20 AM PDT + */ public interface Policy extends PolicyOperations, org.omg.CORBA.Object, org.omg.CORBA.portable.IDLEntity { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/PolicyHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,14 +26,14 @@ /** -* The Helper for Policy. For more information on -* Helper files, see -* "Generated Files: Helper Files".
-* org/omg/CORBA/PolicyHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * The Helper for {@code Policy}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/PolicyHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:20 AM PDT + */ abstract public class PolicyHelper { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/PolicyHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -25,14 +25,14 @@ package org.omg.CORBA; /** -* The Holder for Policy. For more information on -* Holder files, see -* "Generated Files: Holder Files".
-* org/omg/CORBA/PolicyHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * The Holder for {@code Policy}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/PolicyHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:20 AM PDT + */ public final class PolicyHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/PolicyListHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyListHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyListHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,14 +26,14 @@ /** -* The Helper for PolicyList. For more information on -* Helper files, see -* "Generated Files: Helper Files".
-* org/omg/CORBA/PolicyListHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT -*/ + * The Helper for {@code PolicyList}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/PolicyListHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT + */ abstract public class PolicyListHelper { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/PolicyListHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyListHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyListHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,14 +26,14 @@ /** -* The Holder for PolicyList. For more information on -* Holder files, see -* "Generated Files: Holder Files".
-* org/omg/CORBA/PolicyListHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT -*/ + * The Holder for {@code PolicyList}. For more information on + * Holder files, see + * "Generated Files: Holder Files".
+ * org/omg/CORBA/PolicyListHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT + */ public final class PolicyListHolder implements org.omg.CORBA.portable.Streamable { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/PolicyOperations.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyOperations.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyOperations.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,18 +26,18 @@ /** -* The interface for Policy. For more information on -* Operations interfaces, see -* "Generated Files: Operations files". -*
-* org/omg/CORBA/PolicyOperations.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * The interface for {@code Policy}. For more information on + * Operations interfaces, see + * "Generated Files: Operations files". + *
+ * org/omg/CORBA/PolicyOperations.java
+ * Generated by the IDL-to-Java compiler (portable), version "3.0"
+ * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl
+ * Saturday, July 17, 1999 12:26:20 AM PDT
+ */
/**
- * Provides the operations for a Policy
object.
+ * Provides the operations for a {@code Policy} object.
*/
public interface PolicyOperations
{
@@ -57,16 +57,16 @@
int policy_type ();
/**
- * Returns a copy of the Policy
object. The copy does not retain
+ * Returns a copy of the {@code Policy} object. The copy does not retain
* any relationships that the policy had with any domain or object.
*
- * @return a copy of the Policy
object
+ * @return a copy of the {@code Policy} object
*/
org.omg.CORBA.Policy copy ();
/**
- * Destroys the Policy
object. It is the responsibility of
- * the Policy
object to determine whether it can be destroyed.
+ * Destroys the {@code Policy} object. It is the responsibility of
+ * the {@code Policy} object to determine whether it can be destroyed.
*/
void destroy ();
} // interface PolicyOperations
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/PolicyTypeHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyTypeHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/PolicyTypeHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,14 +26,14 @@
/**
-* The Helper for PolicyType. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
-* org/omg/CORBA/PolicyTypeHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * The Helper for {@code PolicyType}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * org/omg/CORBA/PolicyTypeHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:20 AM PDT + */ // basic Policy definition diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/PrincipalHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/PrincipalHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/PrincipalHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -31,22 +31,22 @@ /** - * The Holder for Principal. For more information on + * The Holder for {@code Principal}. For more information on * Holder files, see * "Generated Files: Holder Files".
- * A container class for values of type Principal
+ * A container class for values of type {@code Principal}
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL Principal
as an "out"
+ * If an IDL method signature has an IDL {@code Principal} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * PrincipalHolder
as the corresponding
+ * {@code PrincipalHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myPrincipalHolder
is an instance of PrincipalHolder
,
- * the value stored in its value
field can be accessed with
- * myPrincipalHolder.value
.
+ * If {@code myPrincipalHolder} is an instance of {@code PrincipalHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myPrincipalHolder.value}.
*
* @since JDK1.2
* @deprecated Deprecated by CORBA 2.2.
@@ -54,25 +54,25 @@
@Deprecated
public final class PrincipalHolder implements Streamable {
/**
- * The Principal
value held by this PrincipalHolder
+ * The {@code Principal} value held by this {@code PrincipalHolder}
* object.
*/
public Principal value;
/**
- * Constructs a new PrincipalHolder
object with its
- * value
field initialized to null
.
+ * Constructs a new {@code PrincipalHolder} object with its
+ * {@code value} field initialized to {@code null}.
*/
public PrincipalHolder() {
}
/**
- * Constructs a new PrincipalHolder
object with its
- * value
field initialized to the given
- * Principal
object.
- * @param initial the Principal
with which to initialize
- * the value
field of the newly-created
- * PrincipalHolder
object
+ * Constructs a new {@code PrincipalHolder} object with its
+ * {@code value} field initialized to the given
+ * {@code Principal} object.
+ * @param initial the {@code Principal} with which to initialize
+ * the {@code value} field of the newly-created
+ * {@code PrincipalHolder} object
*/
public PrincipalHolder(Principal initial) {
value = initial;
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/RepositoryIdHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/RepositoryIdHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/RepositoryIdHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,15 +26,15 @@
/**
-* The Helper for RepositoryId. For more information on
-* Helper files, see
-* "Generated Files: Helper Files".
- -* org/omg/CORBA/RepositoryIdHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ir.idl -* 03 June 1999 11:33:43 o'clock GMT+00:00 -*/ + * The Helper for {@code RepositoryId}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ * + * org/omg/CORBA/RepositoryIdHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ir.idl + * 03 June 1999 11:33:43 o'clock GMT+00:00 + */ abstract public class RepositoryIdHelper { diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ServiceDetailHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ServiceDetailHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ServiceDetailHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -24,10 +24,10 @@ */ /** - * The Helper for ServiceDetail. For more information on - * Helper files, see - * "Generated Files: Helper Files".
- */ + * The Helper for {@code ServiceDetail}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ */ package org.omg.CORBA; diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ServiceInformation.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ServiceInformation.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ServiceInformation.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,9 +26,10 @@ package org.omg.CORBA; -/** An IDL struct in the CORBA module that +/** + * An IDL struct in the CORBA module that * stores information about a CORBA service available in the - * ORB implementation and is obtained from the ORB.get_service_information + * ORB implementation and is obtained from the {@code ORB.get_service_information} * method. */ public final class ServiceInformation implements org.omg.CORBA.portable.IDLEntity diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -24,10 +24,10 @@ */ /** - * The Helper for ServiceInformation. For more information on -* Helper files, see -* "Generated Files: Helper Files".
-*/ + * The Helper for {@code ServiceInformation}. For more information on + * Helper files, see + * "Generated Files: Helper Files".
+ */ package org.omg.CORBA; diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,48 +26,48 @@ package org.omg.CORBA; /** - * The Holder for ServiceInformation. For more information on + * The Holder for {@code ServiceInformation}. For more information on * Holder files, see * "Generated Files: Holder Files".
- * A Holder class for a ServiceInformation
object
+ * A Holder class for a {@code ServiceInformation} object
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL xxx
as an "out"
+ * If an IDL method signature has an IDL {@code xxx} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * ServiceInformationHolder
as the corresponding
+ * {@code ServiceInformationHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myServiceInformationHolder
is an instance of ServiceInformationHolder
,
- * the value stored in its value
field can be accessed with
- * myServiceInformationHolder.value
.
+ * If {@code myServiceInformationHolder} is an instance of {@code ServiceInformationHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myServiceInformationHolder.value}.
*/
public final class ServiceInformationHolder
implements org.omg.CORBA.portable.Streamable {
/**
- * The ServiceInformation
value held by this
- * ServiceInformationHolder
object in its value
field.
+ * The {@code ServiceInformation} value held by this
+ * {@code ServiceInformationHolder} object in its {@code value} field.
*/
public ServiceInformation value;
/**
- * Constructs a new ServiceInformationHolder
object with its
- * value
field initialized to null.
+ * Constructs a new {@code ServiceInformationHolder} object with its
+ * {@code value} field initialized to null.
*/
public ServiceInformationHolder() {
this(null);
}
/**
- * Constructs a new ServiceInformationHolder
object with its
- * value
field initialized to the given
- * ServiceInformation
object.
+ * Constructs a new {@code ServiceInformationHolder} object with its
+ * {@code value} field initialized to the given
+ * {@code ServiceInformation} object.
*
- * @param arg the ServiceInformation
object with which to initialize
- * the value
field of the newly-created
- * ServiceInformationHolder
object
+ * @param arg the {@code ServiceInformation} object with which to initialize
+ * the {@code value} field of the newly-created
+ * {@code ServiceInformationHolder} object
*/
public ServiceInformationHolder(org.omg.CORBA.ServiceInformation arg) {
value = arg;
@@ -75,10 +75,10 @@
/**
- * Marshals the value in this ServiceInformationHolder
object's
- * value
field to the output stream out
.
+ * Marshals the value in this {@code ServiceInformationHolder} object's
+ * {@code value} field to the output stream {@code out}.
*
- * @param out the OutputStream
object that will contain
+ * @param out the {@code OutputStream} object that will contain
* the CDR formatted data
*/
public void _write(org.omg.CORBA.portable.OutputStream out) {
@@ -86,10 +86,10 @@
}
/**
- * Reads unmarshalled data from the input stream in
and assigns it to
- * the value
field in this ServiceInformationHolder
object.
+ * Reads unmarshalled data from the input stream {@code in} and assigns it to
+ * the {@code value} field in this {@code ServiceInformationHolder} object.
*
- * @param in the InputStream
object containing CDR
+ * @param in the {@code InputStream} object containing CDR
* formatted data from the wire
*/
public void _read(org.omg.CORBA.portable.InputStream in) {
@@ -97,11 +97,11 @@
}
/**
- * Retrieves the TypeCode
object that corresponds
- * to the value held in this ServiceInformationHolder
object's
- * value
field.
+ * Retrieves the {@code TypeCode} object that corresponds
+ * to the value held in this {@code ServiceInformationHolder} object's
+ * {@code value} field.
*
- * @return the type code for the value held in this ServiceInformationHolder
+ * @return the type code for the value held in this {@code ServiceInformationHolder}
* object
*/
public org.omg.CORBA.TypeCode _type() {
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/SetOverrideTypeHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/SetOverrideTypeHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/SetOverrideTypeHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,7 +26,7 @@
/**
-* The Helper for SetOverrideType. For more information on
+* The Helper for {@code SetOverrideType}. For more information on
* Helper files, see
* "Generated Files: Helper Files".
* org/omg/CORBA/SetOverrideTypeHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ShortHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ShortHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ShortHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -30,55 +30,55 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for Short. For more information on + * The Holder for {@code Short}. For more information on * Holder files, see * "Generated Files: Holder Files". - *
A Holder class for a short
+ *
A Holder class for a {@code short}
* that is used to store "out" and "inout" parameters in IDL operations.
- * If an IDL operation signature has an IDL short
as an "out"
+ * If an IDL operation signature has an IDL {@code short} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * ShortHolder
as the corresponding
+ * {@code ShortHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myShortHolder
is an instance of ShortHolder
,
- * the value stored in its value
field can be accessed with
- * myShortHolder.value
.
+ * If {@code myShortHolder} is an instance of {@code ShortHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myShortHolder.value}.
*
* @since JDK1.2
*/
public final class ShortHolder implements Streamable {
/**
- * The short
value held by this ShortHolder
+ * The {@code short} value held by this {@code ShortHolder}
* object.
*/
public short value;
/**
- * Constructs a new ShortHolder
object with its
- * value
field initialized to 0
.
+ * Constructs a new {@code ShortHolder} object with its
+ * {@code value} field initialized to {@code 0}.
*/
public ShortHolder() {
}
/**
- * Constructs a new ShortHolder
object with its
- * value
field initialized to the given
- * short
.
- * @param initial the short
with which to initialize
- * the value
field of the newly-created
- * ShortHolder
object
+ * Constructs a new {@code ShortHolder} object with its
+ * {@code value} field initialized to the given
+ * {@code short}.
+ * @param initial the {@code short} with which to initialize
+ * the {@code value} field of the newly-created
+ * {@code ShortHolder} object
*/
public ShortHolder(short initial) {
value = initial;
}
/**
- * Reads from input
and initalizes the value in
- * this ShortHolder
object
+ * Reads from {@code input} and initalizes the value in
+ * this {@code ShortHolder} object
* with the unmarshalled data.
*
* @param input the InputStream containing CDR formatted data from the wire.
@@ -88,8 +88,8 @@
}
/**
- * Marshals to output
the value in
- * this ShortHolder
object.
+ * Marshals to {@code output} the value in
+ * this {@code ShortHolder} object.
*
* @param output the OutputStream which will contain the CDR formatted data.
*/
@@ -99,10 +99,10 @@
/**
* Returns the TypeCode corresponding to the value held in
- * this ShortHolder
object.
+ * this {@code ShortHolder} object.
*
* @return the TypeCode of the value held in
- * this ShortHolder
object
+ * this {@code ShortHolder} object
*/
public org.omg.CORBA.TypeCode _type() {
return ORB.init().get_primitive_tc(TCKind.tk_short);
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,7 +26,7 @@
/**
-* The Helper for ShortSeqHelper. For more information on
+* The Helper for {@code ShortSeqHelper}. For more information on
* Helper files, see
* "Generated Files: Helper Files".
* org/omg/CORBA/ShortSeqHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Holder for ShortSeq. For more information on +* The Holder for {@code ShortSeq}. For more information on * Holder files, see * "Generated Files: Holder Files".
* org/omg/CORBA/ShortSeqHolder.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/StringHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/StringHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/StringHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -30,55 +30,55 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for String. For more information on + * The Holder for {@code String}. For more information on * Holder files, see * "Generated Files: Holder Files".
- * A Holder class for a String
+ * A Holder class for a {@code String}
* that is used to store "out" and "inout" parameters in IDL operations.
- * If an IDL operation signature has an IDL string
as an "out"
+ * If an IDL operation signature has an IDL {@code string} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * StringHolder
as the corresponding
+ * {@code StringHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myStringHolder
is an instance of StringHolder
,
- * the value stored in its value
field can be accessed with
- * myStringHolder.value
.
+ * If {@code myStringHolder} is an instance of {@code StringHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myStringHolder.value}.
*
* @since JDK1.2
*/
public final class StringHolder implements Streamable {
/**
- * The String
value held by this StringHolder
+ * The {@code String} value held by this {@code StringHolder}
* object.
*/
public String value;
/**
- * Constructs a new StringHolder
object with its
- * value
field initialized to null
.
+ * Constructs a new {@code StringHolder} object with its
+ * {@code value} field initialized to {@code null}.
*/
public StringHolder() {
}
/**
- * Constructs a new StringHolder
object with its
- * value
field initialized to the given
- * String
.
- * @param initial the String
with which to initialize
- * the value
field of the newly-created
- * StringHolder
object
+ * Constructs a new {@code StringHolder} object with its
+ * {@code value} field initialized to the given
+ * {@code String}.
+ * @param initial the {@code String} with which to initialize
+ * the {@code value} field of the newly-created
+ * {@code StringHolder} object
*/
public StringHolder(String initial) {
value = initial;
}
/**
- * Reads the unmarshalled data from input
and assigns it to
- * the value
field of this StringHolder
object.
+ * Reads the unmarshalled data from {@code input} and assigns it to
+ * the {@code value} field of this {@code StringHolder} object.
*
* @param input the InputStream containing CDR formatted data from the wire.
*/
@@ -87,8 +87,8 @@
}
/**
- * Marshals the value held by this StringHolder
object
- * to the output stream output
.
+ * Marshals the value held by this {@code StringHolder} object
+ * to the output stream {@code output}.
*
* @param output the OutputStream which will contain the CDR formatted data.
*/
@@ -97,10 +97,10 @@
}
/**
- * Retrieves the TypeCode
object that corresponds to
- * the value held in this StringHolder
object.
+ * Retrieves the {@code TypeCode} object that corresponds to
+ * the value held in this {@code StringHolder} object.
*
- * @return the type code of the value held in this StringHolder
+ * @return the type code of the value held in this {@code StringHolder}
* object
*/
public org.omg.CORBA.TypeCode _type() {
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/StringValueHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/StringValueHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/StringValueHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -32,7 +32,7 @@
package org.omg.CORBA;
/**
-* The Helper for StringValue. For more information on
+* The Helper for {@code StringValue}. For more information on
* Helper files, see
* "Generated Files: Helper Files".
* org/omg/CORBA/StringValueHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/StructMemberHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/StructMemberHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/StructMemberHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Helper for StructMember. For more information on +* The Helper for {@code StructMember}. For more information on * Helper files, see * "Generated Files: Helper Files".
* org/omg/CORBA/StructMemberHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/TypeCodeHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/TypeCodeHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/TypeCodeHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -30,55 +30,55 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for TypeCode. For more information on + * The Holder for {@code TypeCode}. For more information on * Holder files, see * "Generated Files: Holder Files".
- * A Holder class for a TypeCode
object
+ * A Holder class for a {@code TypeCode} object
* that is used to store "out" and "inout" parameters in IDL operations.
- * If an IDL operation signature has an IDL TypeCode
as an "out"
+ * If an IDL operation signature has an IDL {@code TypeCode} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * TypeCodeHolder
as the corresponding
+ * {@code TypeCodeHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myTypeCodeHolder
is an instance of TypeCodeHolder
,
- * the value stored in its value
field can be accessed with
- * myTypeCodeHolder.value
.
+ * If {@code myTypeCodeHolder} is an instance of {@code TypeCodeHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myTypeCodeHolder.value}.
*
* @since JDK1.2
*/
public final class TypeCodeHolder implements Streamable {
/**
- * The TypeCode
value held by
- * this TypeCodeHolder
object.
+ * The {@code TypeCode} value held by
+ * this {@code TypeCodeHolder} object.
*/
public TypeCode value;
/**
- * Constructs a new TypeCodeHolder
object with its
- * value
field initialized to null
.
+ * Constructs a new {@code TypeCodeHolder} object with its
+ * {@code value} field initialized to {@code null}.
*/
public TypeCodeHolder() {
}
/**
- * Constructs a new TypeCodeHolder
object with its
- * value
field initialized to the given
- * TypeCode
object.
- * @param initial the TypeCode
object with which to initialize
- * the value
field of the newly-created
- * TypeCodeHolder
object
+ * Constructs a new {@code TypeCodeHolder} object with its
+ * {@code value} field initialized to the given
+ * {@code TypeCode} object.
+ * @param initial the {@code TypeCode} object with which to initialize
+ * the {@code value} field of the newly-created
+ * {@code TypeCodeHolder} object
*/
public TypeCodeHolder(TypeCode initial) {
value = initial;
}
/**
- * Reads from input
and initalizes the value in
- * this TypeCodeHolder
object
+ * Reads from {@code input} and initalizes the value in
+ * this {@code TypeCodeHolder} object
* with the unmarshalled data.
*
* @param input the InputStream containing CDR formatted data from the wire
@@ -88,8 +88,8 @@
}
/**
- * Marshals to output
the value in
- * this TypeCodeHolder
object.
+ * Marshals to {@code output} the value in
+ * this {@code TypeCodeHolder} object.
*
* @param output the OutputStream which will contain the CDR formatted data
*/
@@ -99,10 +99,10 @@
/**
* Returns the TypeCode corresponding to the value held in
- * this TypeCodeHolder
object.
+ * this {@code TypeCodeHolder} object.
*
* @return the TypeCode of the value held in
- * this TypeCodeHolder
object
+ * this {@code TypeCodeHolder} object
*/
public org.omg.CORBA.TypeCode _type() {
return ORB.init().get_primitive_tc(TCKind.tk_TypeCode);
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,7 +26,7 @@
/**
-* The Helper for ULongLongSeq. For more information on
+* The Helper for {@code ULongLongSeq}. For more information on
* Helper files, see
* "Generated Files: Helper Files".
* org/omg/CORBA/ULongLongSeqHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Holder for ULongLongSeq. For more information on +* The Holder for {@code ULongLongSeq}. For more information on * Holder files, see * "Generated Files: Holder Files".
* org/omg/CORBA/ULongLongSeqHolder.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Helper for ULongSeq. For more information on +* The Helper for {@code ULongSeq}. For more information on * Helper files, see * "Generated Files: Helper Files".
* org/omg/CORBA/ULongSeqHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Holder for ULongSeq. For more information on +* The Holder for {@code ULongSeq}. For more information on * Holder files, see * "Generated Files: Holder Files".
* org/omg/CORBA/ULongSeqHolder.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,8 +26,8 @@ package org.omg.CORBA; /** - * One of the PolicyErrorCodes which would be filled if - * the requested Policy is understood to be valid by the + * One of the {@code PolicyErrorCode}s which would be filled if + * the requested {@code Policy} is understood to be valid by the * ORB, but is not currently supported. * * @author rip-dev diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY_VALUE.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY_VALUE.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY_VALUE.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,8 +26,8 @@ package org.omg.CORBA; /** - * A PolicyErrorCode which would be filled if the value - * requested for the Policy is of a + * A {@code PolicyErrorCode} which would be filled if the value + * requested for the {@code Policy} is of a * valid type and within the valid range for that type, but this valid value * is not currently supported. * diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Helper for UShortSeq. For more information on +* The Helper for {@code UShortSeq}. For more information on * Helper files, see * "Generated Files: Helper Files".
* org/omg/CORBA/UShortSeqHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Holder for UShortSeq. For more information on +* The Holder for {@code UShortSeq}. For more information on * Holder files, see * "Generated Files: Holder Files".
* org/omg/CORBA/UShortSeqHolder.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/UnionMemberHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/UnionMemberHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/UnionMemberHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Helper for UnionMember. For more information on +* The Helper for {@code UnionMember}. For more information on * Helper files, see * "Generated Files: Helper Files".
* org/omg/CORBA/UnionMemberHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Helper for UnknownUserException. For more information on +* The Helper for {@code UnknownUserException}. For more information on * Helper files, see * "Generated Files: Helper Files".
* org/omg/CORBA/UnknownUserExceptionHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -25,7 +25,7 @@ package org.omg.CORBA; /** -* The Holder for UnknownUserException. For more information on +* The Holder for {@code UnknownUserException}. For more information on * Holder files, see * "Generated Files: Holder Files".
* org/omg/CORBA/UnknownUserExceptionHolder.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -24,7 +24,7 @@ */ /** - * The Helper for ValueBase. For more information on + * The Helper for {@code ValueBase}. For more information on * Helper files, see * "Generated Files: Helper Files".
*/ diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -30,53 +30,53 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for ValueBase. For more information on + * The Holder for {@code ValueBase}. For more information on * Holder files, see * "Generated Files: Holder Files".
- * A Holder class for a java.io.Serializable
+ * A Holder class for a {@code java.io.Serializable}
* that is used to store "out" and "inout" parameters in IDL methods.
- * If an IDL method signature has an IDL ValueBase
as an "out"
+ * If an IDL method signature has an IDL {@code ValueBase} as an "out"
* or "inout" parameter, the programmer must pass an instance of
- * ValueBaseHolder
as the corresponding
+ * {@code ValueBaseHolder} as the corresponding
* parameter in the method invocation; for "inout" parameters, the programmer
* must also fill the "in" value to be sent to the server.
* Before the method invocation returns, the ORB will fill in the
* value corresponding to the "out" value returned from the server.
*
- * If myValueBaseHolder
is an instance of ValueBaseHolder
,
- * the value stored in its value
field can be accessed with
- * myValueBaseHolder.value
.
+ * If {@code myValueBaseHolder} is an instance of {@code ValueBaseHolder},
+ * the value stored in its {@code value} field can be accessed with
+ * {@code myValueBaseHolder.value}.
*
*/
public final class ValueBaseHolder implements Streamable {
/**
- * The java.io.Serializable
value held by this
- * ValueBaseHolder
object.
+ * The {@code java.io.Serializable} value held by this
+ * {@code ValueBaseHolder} object.
*/
public java.io.Serializable value;
/**
- * Constructs a new ValueBaseHolder
object with its
- * value
field initialized to 0
.
+ * Constructs a new {@code ValueBaseHolder} object with its
+ * {@code value} field initialized to {@code 0}.
*/
public ValueBaseHolder() {
}
/**
- * Constructs a new ValueBaseHolder
object with its
- * value
field initialized to the given
- * java.io.Serializable
.
- * @param initial the java.io.Serializable
with which to initialize
- * the value
field of the newly-created
- * ValueBaseHolder
object
+ * Constructs a new {@code ValueBaseHolder} object with its
+ * {@code value} field initialized to the given
+ * {@code java.io.Serializable}.
+ * @param initial the {@code java.io.Serializable} with which to initialize
+ * the {@code value} field of the newly-created
+ * {@code ValueBaseHolder} object
*/
public ValueBaseHolder(java.io.Serializable initial) {
value = initial;
}
/**
- * Reads from input
and initalizes the value in the Holder
+ * Reads from {@code input} and initalizes the value in the Holder
* with the unmarshalled data.
*
* @param input the InputStream containing CDR formatted data from the wire
@@ -86,7 +86,7 @@
}
/**
- * Marshals to output
the value in the Holder.
+ * Marshals to {@code output} the value in the Holder.
*
* @param output the OutputStream which will contain the CDR formatted data
*/
@@ -95,7 +95,7 @@
}
/**
- * Returns the TypeCode
object
+ * Returns the {@code TypeCode} object
* corresponding to the value held in the Holder.
*
* @return the TypeCode of the value held in the holder
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/ValueMemberHelper.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/ValueMemberHelper.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/ValueMemberHelper.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,7 +26,7 @@
/**
-* The Helper for ValueMember. For more information on
+* The Helper for {@code ValueMember}. For more information on
* Helper files, see
* "Generated Files: Helper Files".
* org/omg/CORBA/ValueMemberHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/VersionSpecHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/VersionSpecHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/VersionSpecHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Helper for VersionSpec. For more information on +* The Helper for {@code VersionSpec}. For more information on * Helper files, see * "Generated Files: Helper Files".
* org/omg/CORBA/VersionSpecHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/VisibilityHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/VisibilityHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/VisibilityHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Helper for Visibility. For more information on +* The Helper for {@code Visibility}. For more information on * Helper files, see * "Generated Files: Helper Files".
* org/omg/CORBA/VisibilityHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Helper for WCharSeq. For more information on +* The Helper for {@code WCharSeq}. For more information on * Helper files, see * "Generated Files: Helper Files".
* org/omg/CORBA/WCharSeqHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Holder for WCharSeq. For more information on +* The Holder for {@code WCharSeq}. For more information on * Holder files, see * "Generated Files: Holder Files".
* org/omg/CORBA/WCharSeqHolder.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/WStringValueHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/WStringValueHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/WStringValueHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -24,7 +24,7 @@ */ /** -* The Helper for WStringValue. For more information on +* The Helper for {@code WStringValue}. For more information on * Helper files, see * "Generated Files: Helper Files".
*/ diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHelper.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHelper.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHelper.java Tue Sep 22 11:01:54 2015 -0700 @@ -25,7 +25,7 @@ package org.omg.CORBA; /** -* The Helper for WrongTransaction. For more information on +* The Helper for {@code WrongTransaction}. For more information on * Helper files, see * "Generated Files: Helper Files".
* org/omg/CORBA/WrongTransactionHelper.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHolder.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHolder.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHolder.java Tue Sep 22 11:01:54 2015 -0700 @@ -25,7 +25,7 @@ package org.omg.CORBA; /** -* The Holder for WrongTransaction. For more information on +* The Holder for {@code WrongTransaction}. For more information on * Holder files, see * "Generated Files: Holder Files".
* org/omg/CORBA/WrongTransactionHolder.java diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/_IDLTypeStub.java --- a/corba/src/java.corba/share/classes/org/omg/CORBA/_IDLTypeStub.java Thu Sep 17 09:19:40 2015 -0700 +++ b/corba/src/java.corba/share/classes/org/omg/CORBA/_IDLTypeStub.java Tue Sep 22 11:01:54 2015 -0700 @@ -26,7 +26,7 @@ /** -* The Stub for IDLType. For more information on +* The Stub for {@code IDLType}. For more information on * Stub files, see * "Generated Files: Stubs".
* org/omg/CORBA/_IDLTypeStub.java
@@ -38,9 +38,9 @@
public class _IDLTypeStub extends org.omg.CORBA.portable.ObjectImpl implements org.omg.CORBA.IDLType
{
/**
- * Constructs a default _IDLTypeStub
object.
+ * Constructs a default {@code _IDLTypeStub} object.
* NOTE: If the default constructor is used, the
- * object is useless until the method _set_delegate
+ * object is useless until the method {@code _set_delegate}
* has been called.
*/
// NOTE: This constructor is not required according to the spec. Only JCK expects it now.
@@ -50,8 +50,8 @@
}
/**
- * Constructs an _IDLTypeStub
object initialized
- * with the given Delegate
object.
+ * Constructs an {@code _IDLTypeStub} object initialized
+ * with the given {@code Delegate} object.
*
* @param delegate a Delegate object
*/
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/_PolicyStub.java
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/_PolicyStub.java Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/_PolicyStub.java Tue Sep 22 11:01:54 2015 -0700
@@ -26,7 +26,7 @@
/**
-* The Stub for Policy. For more information on
+* The Stub for {@code Policy}. For more information on
* Stub files, see
* "Generated Files: Stubs".
* org/omg/CORBA/_PolicyStub.java
@@ -47,8 +47,8 @@
super ();
}
- /** Constructs a _PolicyStub
object initialized
- * with the given Delegate
object.
+ /** Constructs a {@code _PolicyStub} object initialized
+ * with the given {@code Delegate} object.
*
* @param delegate a Delegate Object
*/
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/doc-files/compliance.html
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/doc-files/compliance.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/doc-files/compliance.html Tue Sep 22 11:01:54 2015 -0700
@@ -50,16 +50,16 @@
orb.properties
file.destroy
CodeFactory
and PICurrent
are requiredregister_initial_reference
StringSeq
and WStringSeq
are required.
+ This adds the following classes to org.omg.CORBA
:
StringSeqHolder
StringSeqHelper
WStringSeqHolder
WStringSeqHelper
TypeCode
APIs.
POA::id
is required.Coder
/Decoder
interfaces)
and all of chapter 21 (the interceptor specification).idlj
) complies with:
rmic
) complies with:
-idl
flag complies with CORBA 2.3.1 chapter 3.The files that are generated by the IDL-to-Java compiler, in accordance with
-the IDL-to-Java Language Mapping Specification,
+the
+IDL-to-Java Language Mapping Specification,
which is implemented in JavaTM SE 6
according the compliance document.
@@ -18,23 +19,25 @@
and identifiers with no change. Because of the nature of the Java language,
a single IDL construct may be mapped to several (differently named) Java constructs.
The additional names are constructed by appending a descriptive suffix.
-For example, the IDL interface foo is mapped to the Java
-interfaces foo and fooOperations, and additional
-Java classes fooHelper, fooHolder, fooPOA,
-and optionally fooPOATie.
+For example, the IDL interface foo
is mapped to the Java
+interfaces foo
and fooOperations
, and additional
+Java classes fooHelper
, fooHolder
, fooPOA
,
+and optionally fooPOATie
.
The mapping in effect reserves the use of several names for its own purposes. These are:
<type>Helper
,
+where <type>
is the name of an IDL defined type.
+<type>Holder
,
+where <type>
+is the name of an IDL defined type (with certain exceptions such as typedef
aliases).
+<basicJavaType>Holder
, where <basicJavaType>
is one of the Java primitive datatypes that is used by one of the IDL basic datatypes.
-<interface>Operations
, <interface>POA
,
+and <interface>POATie
, where <interface>
is the name of an IDL interface type.
+<interface>Package
, where <interface>
is the name of an IDL interface.
Helper files supply several static methods needed to manipulate the type.
-These include Any insert and extract operations for the type,
+These include Any
insert and extract operations for the type,
getting the repository id, getting the typecode, and reading
and writing the type from and to a stream.
The helper class for a mapped IDL interface or abstract interface also
-include narrow operation(s). The static narrow method allows an org.omg.CORBA.Object
+include narrow operation(s). The static narrow method allows an org.omg.CORBA.Object
to be narrowed to the object reference of a more specific type.
-The IDL exception CORBA::BAD_PARAM is thrown if the narrow fails because
+The IDL exception CORBA::BAD_PARAM
is thrown if the narrow fails because
the object reference does not support the requested type. A different system exception
-is raised to indicate other kinds of errors. Trying to narrow a null will always succeed with a return value of null.
+is raised to indicate other kinds of errors. Trying to narrow
+a null will always succeed with a return value of null.
Support for out and inout parameter passing modes requires the use of additional holder classes.
-These classes are available for all of the basic IDL datatypes in the org.omg.CORBA package
+These classes are available for all of the basic IDL datatypes in the org.omg.CORBA
package
and are generated for all named user defined IDL types except those defined by typedefs.
(Note that in this context user defined includes types that are defined in OMG specifications
such as those for the Interface Repository, and other OMG services.)
Each holder class has a constructor from an instance, a default constructor, and has
-a public instance member, value which is the typed value. The default constructor
+a public instance member, value
which is the typed value. The default constructor
sets the value field to the default value for the type as defined by the Java language:
false for boolean, 0 for numeric and char types, null for strings, null for object references.
To support portable stubs and skeletons, holder classes also implement
-the org.omg.CORBA.portable.Streamable interface.
+the org.omg.CORBA.portable.Streamable
interface.
A non abstract IDL interface is mapped to two public Java interfaces:
a signature interface and an operations interface.
-The signature interface, which extends IDLEntity, has the same
-name as the IDL interface name and is used as the signature type in method declarations
+The signature interface, which extends IDLEntity
, has the same
+name as the IDL interface name and is used
+as the signature type in method declarations
when interfaces of the specified type are used in other interfaces.
-The operations interface has the same name as the IDL interface with the suffix Operations
+The operations interface has the same name as the IDL interface
+with the suffix Operations
appended to the end and is used in the server-side mapping and as a mechanism
for providing optimized calls for collocated client and servers.
The Java operations interface contains the mapped operation signatures.
The Java signature interface extends the operations interface,
-the (mapped) base org.omg.CORBA.Object, as well as org.omg.portable.IDLEntity.
+the (mapped) base org.omg.CORBA.Object
,
+as well as org.omg.portable.IDLEntity
.
Methods can be invoked on the signature interface. Interface inheritance
-expressed in IDL is reflected in both the Java signature interface and operations interface hierarchies.
+expressed in IDL is reflected in both the Java signature
+interface and operations interface hierarchies.
Object-oriented programming languages, such as Java, C++, and Smalltalk, do not require stub interfaces. +
Object-oriented programming languages, such as Java,
+C++, and Smalltalk, do not require stub interfaces.
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CORBA/package.html
--- a/corba/src/java.corba/share/classes/org/omg/CORBA/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CORBA/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -34,27 +34,27 @@
ORB
, which is implemented
so that a programmer can use it as a fully-functional Object Request Broker
(ORB).
-For a precise list of supported sections of official CORBA specifications with which
-the Java[TM] Platform, Standard Edition 6 complies, see Official Specifications for CORBA support in
+ For a precise list of supported sections of official CORBA specifications with which
+the Java[TM] Platform, Standard Edition 6 complies, see Official Specifications for CORBA support in
Java[TM] SE 6.
The classes and interfaces described in this section can be put into
-four groups: ORB classes, Exceptions, Helper classes,
-and Holder classes.
+ The classes and interfaces described in this section can be put into
+four groups: An ORB handles (or brokers) method invocations between a client and
the method's implementation on a server. Because the client and server
@@ -63,92 +63,91 @@
deal of work behind the scenes to accomplish this communication.
Most of what an ORB does is completely transparent to the user, and a major
-portion of the CORBA package consists of classes used by the ORB
+portion of the Before an application can enter the CORBA environment, it must first:
+ Before an application can enter the CORBA environment, it must first:
The following operations are provided to initialize applications and obtain
the appropriate object references:
-When an application requires a CORBA environment it needs a mechanism to
-get an ORB object reference and possibly an OA object reference
-(such as the root POA). This serves two purposes. First, it initializes
-an application into the ORB and OA environments. Second, it returns the
-ORB object reference and the OA object reference to the application
-for use in future ORB and OA operations.
+When an application requires a CORBA environment it needs a mechanism to
+get an ORB object reference and possibly an OA object reference
+(such as the root POA). This serves two purposes. First, it initializes
+an application into the ORB and OA environments. Second, it returns the
+ORB object reference and the OA object reference to the application
+for use in future ORB and OA operations.
- In order to obtain an ORB object reference, applications call
-the ORB.init operation. The parameters to the call can comprise an
+ In order to obtain an ORB object reference, applications call
+the These are the ORB methods
+ These are the Using the init() method without parameters initiates
+ Using the Applications require a portable means by which to obtain their
-initial object references. References are required for the root
-POA, POA Current, Interface Repository, and various Object Services
+ Applications require a portable means by which to obtain their
+initial object references. References are required for the root
+POA, POA Current, Interface Repository, and various Object Services
instances. The functionality required by the application is similar
- to that provided by the Naming Service. However, the OMG does not
- want to mandate that the Naming Service be made available to all
- applications in order that they may be portably initialized.
- Consequently, the operations shown in this section provide a
- simplified, local version of the Naming Service that applications
- can use to obtain a small, defined set of object references which
- are essential to its operation. Because only a small well-defined
+ to that provided by the Naming Service. However, the OMG does not
+ want to mandate that the Naming Service be made available to all
+ applications in order that they may be portably initialized.
+ Consequently, the operations shown in this section provide a
+ simplified, local version of the Naming Service that applications
+ can use to obtain a small, defined set of object references which
+ are essential to its operation. Because only a small well-defined
set of objects are expected with this mechanism, the naming context
can be flattened to be a single-level name space. This simplification
results in only two operations being defined to achieve the functionality
required.
- Initial references are obtained via two operations provided in
-the ORB object interface, providing facilities to list and
+ Initial references are obtained via two operations provided in
+the ORB object interface, providing facilities to list and
resolve initial object references. These are:
An example that uses some of these methods is An example that uses some of these methods is
Getting Started with Java IDL.
@@ -156,7 +155,7 @@
Exceptions
Exceptions in Java IDL are similar to those in any code written in the
Java programming language. If a method is defined to throw an exception,
-then any code using that method must have a try/catch
+then any code using that method must have a The documentation on The following is a list of the system exceptions (which are unchecked
-exceptions inheriting through
-org.omg.CORBA.SystemException from
-java.lang.RuntimeException) that are defined in the package
-org.omg.CORBA:
+exceptions inheriting through
The following is a list of user-defined exceptions defined in the package
-org.omg.CORBA.
+ For example, the package
-org.omg.CORBA.TypeCodePackage contains
-two exceptions thrown by methods in the class TypeCode. These
+ For example, the package Another package that is a subpackage of CORBA is the
-portable package. It
-provides a set of ORB APIs that makes it
+ Another package that is a subpackage of Support for out and inout parameter passing modes requires the use of
-additional holder
-classes. Because the Java programming language does not support out or
+ Support for out and inout parameter passing modes requires the use of
+additional holder
+classes. Because the Java programming language does not support out or
inout parameters, holder classes are needed as a means of passing a parameter
-that can be modified. To support portable stubs and skeletons, holder classes also implement
- the org.omg.CORBA.portable.Streamable
- interface.
+that can be modified. To support portable stubs and skeletons,
+holder classes also implement the
+ Holder classes are named by appending "Holder" to the name of the type.
The name of the type refers to its name in the Java programming language. For
- example, a holder class for the interface named Account in the Java programming
- language would be named AccountHolder.
+ example, a holder class for the interface named Holder classes are available for all of the basic IDL
- datatypes in the org.omg.CORBA package. So, for example,
- there are already-defined classes for LongHolder, ShortHolder,
- FloatHolder, and so on. Classes are also generated for
- all named user-defined IDL types except those defined by typedefs.
- (Note that in this context user defined includes types that are
+ datatypes in the Each holder class has:
The default constructor sets the value field to the default value for the
-type as defined by the Java language:
+ The default constructor sets the value field to the default value for the
+type as defined by the Java language:
For more information on Holder classes, see Chapter 1.4, Mapping for
Basic Types in the
OMG IDL to Java Language Mapping. The Holder classes defined
-in the package org.omg.CORBA are:
- Helper files supply several static methods needed to manipulate the type.
These include:
The helper class for a mapped IDL interface or abstract interface
- also include narrow operation(s). The static narrow method allows
- an org.omg.CORBA.Object to be narrowed to the object reference
- of a more specific type. The IDL exception CORBA.BAD_PARAM
- is thrown if the narrow fails because the object reference does not
- support the requested type. A different system exception is raised
- to indicate other kinds of errors. Trying to narrow a null will always
- succeed with a return value of null. Generally, the only helper method an application programmer uses is
+also include narrow operation(s). The static narrow method allows
+an Helper classes
fall into two broad categories, helpers for value types and
-helpers for non value types. Because all of the helper
+helpers for non value types. Because all of the helper
classes in one category
-provide the same methods, one generic explanation of each
+provide the same methods, one generic explanation of each
category of helper classes is presented here.
-When OMG IDL is mapped to the Java programming language,
+When OMG IDL is mapped to the Java programming language,
a "helper" class is generated for each user-defined type.
This generated class will have the name of the user-defined type with
the suffix The Hello World
-tutorial uses a narrow method that looks
-like this:
+ The Hello World
+tutorial uses a The Helper classes defined in the package org.omg.CORBA are:
+ The Helper classes defined in the package This is why several interfaces in the org.omg.CORBA package
-consist of a single field, value, which is a short. This
+ This is why several interfaces in the The exception PolicyError uses the value field of
+ The exception Some of the API included in org.omg subpackages is provided for
+ Some of the API included in Some of the API included in org.omg subpackages throw
-NO_IMPLEMENT exceptions for various reasons. Among these reasons
+ Some of the API included in This package contains the following classes, which are used in
-org.omg.CosNaming.NamingContextExt:
+ This package contains the following classes, which are used in
+ For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
support in Java[tm] SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CosNaming/NamingContextPackage/package.html
--- a/corba/src/java.corba/share/classes/org/omg/CosNaming/NamingContextPackage/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CosNaming/NamingContextPackage/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -30,23 +30,23 @@
This package contains Exception classes for the org.omg.CosNaming
+ This package contains Exception classes for the For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
support in Java SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CosNaming/nameservice.idl
--- a/corba/src/java.corba/share/classes/org/omg/CosNaming/nameservice.idl Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CosNaming/nameservice.idl Tue Sep 22 11:01:54 2015 -0700
@@ -99,8 +99,8 @@
* The BindingIterator interface allows a client to iterate through
* the bindings using the next_one or next_n operations.
*
- * The bindings iterator is obtained by using the list
- * method on the NamingContext.
+ * The bindings iterator is obtained by using the
- The package and all its classes and interfaces
+ The package and all its classes and interfaces
were generated by running the tool For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6, ORB complies, see Official Specifications for CORBA
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6, ORB complies, see Official Specifications for CORBA
support in Java[tm] SE 6.
The interfaces are:
These two interfaces provide the means to bind/unbind names and object
@@ -68,7 +68,7 @@
the idlj compiler creates Java classes that can be thought of
as auxiliary classes.
Comments for the generated auxiliary classes
- used by the interfaces A name is an array of one or more
@@ -159,7 +159,7 @@
If the method Usage is as follows:
The following holder classes are generated for the package
- Note that in the
Note also that there is a
There is only one method in a helper class that an
application programmer uses: the
@@ -282,7 +282,7 @@
Sun's implementation of the
This associates
-Now when an application calls the method
+Now when an application calls the method
This package contains the Dynamic module specified in the OMG Portable
+ This package contains the For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
+
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
support in Java[tm] SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyFactoryPackage/package.html
--- a/corba/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyFactoryPackage/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyFactoryPackage/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -33,9 +33,9 @@
-This package contains classes and exceptions from the DynAnyFactory
+This package contains classes and exceptions from the For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
+
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
support in Java SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyPackage/package.html
--- a/corba/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyPackage/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyPackage/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -30,8 +30,8 @@
This package contains classes and exceptions from the DynAny
- interface of the DynamicAny module
+ This package contains classes and exceptions from the For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
support in Java[tm] SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/DynamicAny/package.html
--- a/corba/src/java.corba/share/classes/org/omg/DynamicAny/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/DynamicAny/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -48,15 +48,15 @@
helpful for writing generic clients (bridges, browsers, debuggers, user interface tools).
Each DynAny object maintains the notion of a current position into its collection
-of component DynAnys. The current position is identified by an index value that runs
+ Each This package contains the IOP module specified in the OMG document
+ This package contains the Please note that we do not provide all parts of the IOP module from
+ Please note that we do not provide all parts of the For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
+
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
support in Java[tm] SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/Messaging/package.html
--- a/corba/src/java.corba/share/classes/org/omg/Messaging/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/Messaging/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -30,22 +30,22 @@
This package contains the Messaging module specified in the OMG CORBA
+ This package contains the Please note that we do not provide all parts of the Messaging module from
+ Please note that we do not provide all parts of the For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
+
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
support in Java[tm] SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/PortableInterceptor/ORBInitInfoPackage/package.html
--- a/corba/src/java.corba/share/classes/org/omg/PortableInterceptor/ORBInitInfoPackage/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/PortableInterceptor/ORBInitInfoPackage/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -30,19 +30,19 @@
This package contains the exceptions and typedefs from the ORBInitInfo
-local interface of the PortableInterceptor module specified in the OMG
+ This package contains the exceptions and typedefs from the For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
+
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6 ORB complies, see Official Specifications for CORBA
support in Java SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/PortableServer/POAPackage/package.html
--- a/corba/src/java.corba/share/classes/org/omg/PortableServer/POAPackage/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/PortableServer/POAPackage/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -45,25 +45,34 @@
- Given an interface My defined in My.idl, the file MyPOA.java is generated by the idlj compiler. You must provide the implementation for My and it must inherit from MyPOA.
+ Given an interface MyPOA.java is a stream-based skeleton that extends org.omg.PortableServer.Servant and implements the InvokeHandler interface and the operations interface associated with the IDL interface the skeleton implements.
+ The PortableServer module for the Portable Object Adapter (POA) defines the native Servant type. In the Java programming language, the Servant type is mapped to the Java org.omg.PortableServer.Servant class. It serves as the base class for all POA servant implementations and provides a number of methods that may
-be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior.
-
+ The All Mapping corresponds to the Chapter 11 of
+
+ All Mapping corresponds to the Chapter 11 of
CORBA V2.3.1 specified by OMG document formal/99-10-07.pdf.
- The exception to this is the For a precise list of supported sections of official specifications with which
-the Java[tm] Platform, Standard Edition 6, ORB complies, see Official Specifications for CORBA
+ For a precise list of supported sections of official specifications with which
+the Java[tm] Platform, Standard Edition 6, ORB complies, see Official Specifications for CORBA
support in Java[tm] SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/PortableServer/ServantLocatorPackage/package.html
--- a/corba/src/java.corba/share/classes/org/omg/PortableServer/ServantLocatorPackage/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/PortableServer/ServantLocatorPackage/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -33,15 +33,15 @@
This package supplies a CookieHolder class for passing
-the Cookie type as an This package supplies a For a precise list of supported sections of official OMG specifications with which
-the Java[tm] Platform, Standard Edition 6 complies, see Official Specifications for CORBA
+
+ For a precise list of supported sections of official OMG specifications with which
+the Java[tm] Platform, Standard Edition 6 complies, see Official Specifications for CORBA
support in Java[tm] SE 6.
@since 1.4
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/PortableServer/package.html
--- a/corba/src/java.corba/share/classes/org/omg/PortableServer/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/PortableServer/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -2,7 +2,7 @@
General Information
-The information in this section is information relevant to someone who
+The information in this section is information relevant to someone who
compiles Interface Definition Language (IDL) files and uses the
ORB to write clients and servers.
-ORB classes
, Exceptions, Helper
classes,
+and Holder
classes.
-The ORB Class
+The ORB
Class
CORBA
package consists of classes used by the ORB
behind the scenes. The result is that most programmers will use only a
small part of this package directly. In fact, most programmers will use
-only a few methods from the ORB class, some exceptions, and
+only a few methods from the ORB
class, some exceptions, and
occasionally,
-a holder class.
+a holder class.
-ORB Methods
+ORB
Methods
-
ORB.init
operation. The parameters to the call can comprise an
identifier for the ORB for which the object reference is required,
- and an arg_list, which is used to allow environment-specific data to be
- passed into the call.
+ and an arg_list, which is used to allow environment-specific data to be
+ passed into the call.
-ORB
methods
that provide access to the ORB:
-init()
init(String [] args, Properties props)
init(Applet app, Properties props)
init()
method without parameters initiates
a singleton ORB, which can only
-give typecode creation anys needed in code generated
-in Helper classes by idlj.
+give typecode creation any
s needed in code generated
+in Helper classes by idlj
.
-
-resolve_initial_references(String name)
list_initial_services()
register_initial_reference(String id, org.omg.CORBA.Object obj)
try
/catch
block and handle that exception when it is thrown.
+org.omg.CORBA.SystemException
from
+java.lang.RuntimeException
) that are defined in the package
+org.omg.CORBA
:
BAD_CONTEXT
BAD_INV_ORDER
@@ -203,7 +202,7 @@
org.omg.CORBA
.
Bounds
UnknownUserException
@@ -212,37 +211,37 @@
Subpackages
-There are some packages inside the CORBA package with
+There are some packages inside the CORBA
package with
"Package" as part of their names. These packages are generally quite small
because all they do is provide exceptions or classes for use by interfaces
-and classes in the CORBA package.
+and classes in the CORBA
package.
-
+org.omg.CORBA.TypeCodePackage
contains
+two exceptions thrown by methods in the class TypeCode
. These
exceptions are:
-The package
-org.omg.CORBA.ORBPackage contains two exceptions:
+The package BadKind
Bounds
+org.omg.CORBA.ORBPackage
contains two exceptions:
-InvalidName
InconsistentTypeCode
CORBA
is the
+portable
+package. It provides a set of ORB APIs that makes it
possible for code generated by one vendor's IDL compiler to run
-on another vendor's ORB.
+on another vendor's ORB.
@@ -251,47 +250,49 @@
Holder classes
-org.omg.CORBA.portable.Streamable
+interface.
Account
+ in the Java programming
+ language would be named AccountHolder
.
org.omg.CORBA
package. So, for example,
+ there are already-defined classes for LongHolder
, ShortHolder
,
+ FloatHolder
, and so on. Classes are also generated for
+ all named user-defined IDL types except those defined by typedefs
.
+ (Note that in this context user defined includes types that are
defined in OMG specifications such as those for the Interface
- Repository, and other OMG services.)
+ Repository, and other OMG services.)
-value
which is the typed value.
+value
field
+value
field to an output stream
-
@@ -301,7 +302,7 @@
were mapped to the Java programming language, the following holder class
would be generated:
false
for boolean
+0
for numeric and char types
+null
for strings and object references
-public final class AccountHolder implements
+public final class AccountHolder implements
org.omg.CORBA.portable.Streamable
{
// field that holds an Account object
@@ -342,53 +343,52 @@
- AnyHolder
- AnySeqHolder
- BooleanHolder
- BooleanSeqHolder
- ByteHolder
- CharHolder
- CharSeqHolder
- CurrentHolder
- DoubleHolder
- DoubleSeqHolder
- FixedHolder
- FloatHolder
- FloatSeqHolder
- IntHolder
- LongHolder
- LongLongSeqHolder
- LongSeqHolder
- ObjectHolder
- OctetSeqHolder
- ParameterModeHolder
- PolicyErrorHolder
- PolicyListHolder
- PrincipalHolder
- ServiceInformationHolder
- ShortHolder
- ShortSeqHolder
- StringHolder
- StringSeqHolder
- TypeCodeHolder
- ULongLongSeqHolder
- ULongSeqHolder
- UnknownUserExceptionHolder
- UShortSeqHolder
- ValueBaseHolder
- WCharSeqHolder
- WrongTransactionHolder
- WStringSeqHolder
-
-
+in the package org.omg.CORBA
are:
+
+ AnyHolder
+ AnySeqHolder
+ BooleanHolder
+ BooleanSeqHolder
+ ByteHolder
+ CharHolder
+ CharSeqHolder
+ CurrentHolder
+ DoubleHolder
+ DoubleSeqHolder
+ FixedHolder
+ FloatHolder
+ FloatSeqHolder
+ IntHolder
+ LongHolder
+ LongLongSeqHolder
+ LongSeqHolder
+ ObjectHolder
+ OctetSeqHolder
+ ParameterModeHolder
+ PolicyErrorHolder
+ PolicyListHolder
+ PrincipalHolder
+ ServiceInformationHolder
+ ShortHolder
+ ShortSeqHolder
+ StringHolder
+ StringSeqHolder
+ TypeCodeHolder
+ ULongLongSeqHolder
+ ULongSeqHolder
+ UnknownUserExceptionHolder
+ UShortSeqHolder
+ ValueBaseHolder
+ WCharSeqHolder
+ WrongTransactionHolder
+ WStringSeqHolder
+
Helper Classes
-
Any
insert and extract operations for the type
org.omg.CORBA.Object
to be narrowed to the object reference
+of a more specific type. The IDL exception CORBA.BAD_PARAM
+is thrown if the narrow fails because the object reference does not
+support the requested type. A different system exception is raised
+to indicate other kinds of errors. Trying to narrow a null
will always
+succeed with a return value of null
.
+Generally, the only helper method an application programmer uses is
the narrow
method. The other methods are normally used behind
the scenes and are transparent to the programmer.
Helper
appended. For example, if the
@@ -423,7 +424,7 @@
idlj
compiler will automatically generate a class named
AccountHelper
. The AccountHelper
class
will contain the static methods needed for manipulating instances of the type,
-in this case, Account
objects.
+in this case, Account
objects.
@@ -442,14 +443,12 @@
not determines which narrow
method its helper class will provide.
The helper class for an interface
that is not abstract will have a narrow
method that takes a CORBA
-object, whereas the narrow
method for an interface that is abstract
-will
-take an object in the Java programming language. The helper class for a
+object, whereas the narrow
method for an interface that is abstract
+will take an object in the Java programming language. The helper class for a
non-abstract interface that has at least one abstract base interface will provide
both versions of the narrow
method.
-narrow
method that looks like this:
// create and initialize the ORB
ORB orb = ORB.init(args, null);
@@ -469,7 +468,7 @@
-Example of a Basic Helper Class
A basic helper class, for purposes of this explanation, is one with
-the methods that are provided by every helper class, plus a narrow
+the methods that are provided by every helper class, plus a narrow
method if the type defined in OMG IDL maps to an interface in the Java
programming language. Types that are not value types will have a basic
helper class generated for them.
@@ -626,57 +625,56 @@
}
org.omg.CORBA
are:
- AnySeqHelper
- BooleanSeqHelper
- CharSeqHelper
- CompletionStatusHelper
- CurrentHelper
- DefinitionKindHelper
- DoubleSeqHelper
- FieldNameHelper
- FloatSeqHelper
- IdentifierHelper
- IDLTypeHelper
- LongLongSeqHelper
- LongSeqHelper
- NameValuePairHelper
- ObjectHelper
- OctetSeqHelper
- ParameterModeHelper
- PolicyErrorCodeHelper
- PolicyErrorHelper
- PolicyHelper
- PolicyListHelper
- PolicyTypeHelper
- RepositoryIdHelper
- ServiceDetailHelper
- ServiceInformationHelper
- SetOverrideTypeHelper
- ShortSeqHelper
- StringSeqHelper
- StringValueHelper
- StructMemberHelper
- ULongLongSeqHelper
- ULongSeqHelper
- UnionMemberHelper
- UnknownUserExceptionHelper
- UShortSeqHelper
- ValueBaseHelper
- ValueMemberHelper
- VersionSpecHelper
- VisibilityHelper
- WCharSeqHelper
- WrongTransactionHelper
- WStringSeqHelper
- WStringValueHelper
-
+ AnySeqHelper
+ BooleanSeqHelper
+ CharSeqHelper
+ CompletionStatusHelper
+ CurrentHelper
+ DefinitionKindHelper
+ DoubleSeqHelper
+ FieldNameHelper
+ FloatSeqHelper
+ IdentifierHelper
+ IDLTypeHelper
+ LongLongSeqHelper
+ LongSeqHelper
+ NameValuePairHelper
+ ObjectHelper
+ OctetSeqHelper
+ ParameterModeHelper
+ PolicyErrorCodeHelper
+ PolicyErrorHelper
+ PolicyHelper
+ PolicyListHelper
+ PolicyTypeHelper
+ RepositoryIdHelper
+ ServiceDetailHelper
+ ServiceInformationHelper
+ SetOverrideTypeHelper
+ ShortSeqHelper
+ StringSeqHelper
+ StringValueHelper
+ StructMemberHelper
+ ULongLongSeqHelper
+ ULongSeqHelper
+ UnionMemberHelper
+ UnknownUserExceptionHelper
+ UShortSeqHelper
+ ValueBaseHelper
+ ValueMemberHelper
+ VersionSpecHelper
+ VisibilityHelper
+ WCharSeqHelper
+ WrongTransactionHelper
+ WStringSeqHelper
+ WStringValueHelper
Other Classes
-The other classes and interfaces in the CORBA package, which are
+The other classes and interfaces in the CORBA
package, which are
used behind the scenes, can be put into four groups. Three of the groups
are used with requests in some capacity, and the fourth group, concerning
the Interface Repository, is a category by itself.
@@ -686,38 +684,38 @@
information used in request operations.
@@ -726,23 +724,23 @@
The second group of classes deals with requests:
TCKind
-- indicates the kind (datatype) for a TypeCode
object
TypeCode
-- indicates a datatype and possibly other information
Any
-- contains a value and its typecode
NamedValue
-- contains a name, an Any
object, and an
+argument mode flag. NamedValue
objects contain information about
method arguments, method return values, or a context.
ContextList
-- a list of strings that describe the contexts that
need to be resolved and sent with an invocation
ExceptionList
-- a list of TypeCode
s for exceptions that
may be thrown by a method
Environment
-- a container for the exception thrown during a method
invocation
Context
-- a list of NamedValue
objects used to pass
auxiliary information from client to server
NVList
-- a list of NamedValue
objects, used to pass
arguments or get results
@@ -750,82 +748,82 @@
Interfaces That Serve as Constants
The third group contains interfaces that serve as constants. The IDL-to-Java
mapping mandates that IDL enums are mapped to a Java class with the enumerated
-values represented as public static final fields in that class (e.g.
+values represented as public static final fields in that class (e.g.
DefinitionKind).
On the other hand IDL constants defined outside of an IDL interface are
mapped to a Java interface for each constant.
-Object
-- the base class for all CORBA object references
Request
-- the main class in the DII, which contains methods for
adding arguments to the request, for accessing information about the method
being invoked (the method name, its arguments, exceptions it throws, and
so on), and for making invocations on the request
DynamicImplementation
-- the base class for server implementations
+using the DSI. It has the method invoke
, which is used by an
implementation
-of this class to determine the state of a ServerRequest object
+of this class to determine the state of a ServerRequest
object
and to set its result or exception
ServerRequest
-- captures the explicit state of a request for
the Dynamic Skeleton Interface
org.omg.CORBA
package
+consist of a single field, value
, which is a short
. This
field is a constant used for such things as an error code or value modifier.
-For example, the value field of the interface BAD_POLICY
-is one of the possible reasons for the exception PolicyError to
-be thrown. To specify this error code, you would use BAD_POLICY.value.
+For example, the value
field of the interface BAD_POLICY
+is one of the possible reasons for the exception PolicyError
to
+be thrown. To specify this error code, you would use BAD_POLICY.value
.
-PolicyError
uses the value
field of
the following interfaces as its possible error codes.
-The method TypeCode.type_modifier returns the value field
-of one of the following interfaces. The VM in the names of these
+The method BAD_POLICY
BAD_POLICY_TYPE
BAD_POLICY_VALUE
UNSUPPORTED_POLICY
UNSUPPORTED_POLICY_VALUE
TypeCode.type_modifier
returns the value
field
+of one of the following interfaces. The VM
in the names of these
interfaces stands for "value modifier."
The following constants are returned by a VM_NONE
VM_ABSTRACT
VM_CUSTOM
VM_TRUNCATABLE
ValueMember
object's
access method to denote the visibility of the ValueMember
object.
-These flags, used in NamedValue objects or as parameters to methods,
+These flags, used in PRIVATE_MEMBER
PUBLIC_MEMBER
NamedValue
objects or as parameters to methods,
are defined in the following interfaces:
ARG_IN
ARG_INOUT
ARG_OUT
CTX_RESTRICT_SCOPE
Interface Repository Interfaces and Classes
A fourth group contains the Interface Repository interfaces and classes,
-which are generated by the idlj compiler from the OMG IDL
-interface ir.idl. The purpose of the Interface Repository is to
+which are generated by the idlj
compiler from the OMG IDL
+interface ir.idl
. The purpose of the Interface Repository is to
identify the interfaces stored in it so that they can be accessed by an
ORB. Each module, type, interface, attribute, operation, parameter, exception,
constant, and so on is described completely by the Interface Repository
@@ -874,7 +872,7 @@
CORBA Features Not Implemented in Java IDL
-org.omg
subpackages is provided for
conformance with the current OMG CORBA specification but is not implemented
in Sun's release of the JDKTM. This enables
other JDK licensees to provide implementations of this API in standard
@@ -883,21 +881,21 @@
Features That Throw NO_IMPLEMENT
-org.omg
subpackages throw
+NO_IMPLEMENT
exceptions for various reasons. Among these reasons
are:
-
@@ -912,65 +910,67 @@
operation of Java IDL.
LocalObject
, the complete
+ implementation according to the specification indicates that
+ these API should throw NO_IMPLEMENT
.
- ORB.java
,
+ methods that throw
+ NO_IMPLEMENT
are actually implemented in subclasses
elsewhere in the ORB code.
- _get_interface_def()
+ and _get_interface
, API are really not yet implemented.
long double
.
org.omg.CORBA.Policy
)
+and methods for getting them are not implemented.
org.omg.CORBA.DomainManager
) and methods for
getting them are not implemented.
org.omg.CORBA.ServiceInformation
+and ORB method
+public boolean get_service_information(short service_type, ServiceInformationHolder service_info)
+are not implemented.
-perform_work
, work_pending
) are not implemented.
-Specific List of Unimplemented Features in Package org.omg.CORBA
+Specific List of Unimplemented Features in Package org.omg.CORBA
-Unimplemented Methods in package org.omg.CORBA:
+Unimplemented Methods in package org.omg.CORBA
:
ORB
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CosNaming/NamingContextExtPackage/package.html
--- a/corba/src/java.corba/share/classes/org/omg/CosNaming/NamingContextExtPackage/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CosNaming/NamingContextExtPackage/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -30,20 +30,20 @@
-public org.omg.CORBA.Policy create_policy(int type, org.omg.CORBA.Any val)
public void perform_work()
public boolean work_pending()
public org.omg.CORBA.Current get_current()
create_operation_list
get_default_context
get_service_information
DynAnys
(deprecated in favor of DynamicAny
package)
org.omg.CosNaming.NamingContextExt
:
-
AddressHelper
+ StringNameHelper
+ URLStringHelper
+ InvalidAddress
Package Specification
-org.omg.CosNaming
package. The list of exception classes are:
-
AlreadyBound
+ CannotProceed
+ InvalidName
+ NotEmpty
+ NotFound
+ NotFoundReason
Package Specification
-list
+ * method on the NamingContext
.
* @see org.omg.CosNaming.NamingContext#list
*/
interface BindingIterator
@@ -412,7 +412,7 @@
* contains a set of name bindings in which each name is unique and is
* part of Interoperable Naming Service.
* Different names can be bound to an object in the same or different
- * contexts at the same time. Using NamingContextExt, you can use
+ * contexts at the same time. Using NamingContextExt
, you can use
* URL-based names to bind and resolve.
*
* See
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/CosNaming/package.html
--- a/corba/src/java.corba/share/classes/org/omg/CosNaming/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/CosNaming/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -35,25 +35,25 @@
idlj
on the file
nameservice.idl
, which is a module written in OMG IDL.
Package Specification
-Interfaces
- The package org.omg.CosNaming contains two public interfaces
- and several auxiliary classes.
+ The package org.omg.CosNaming
contains two public interfaces
+ and several auxiliary classes.
-
NamingContext
+ BindingIterator
NamingContext
and
+ used by the interfaces NamingContext
and
BindingIterator
are included here.
Classes Used by
NamingContext
and
@@ -78,7 +78,7 @@
generated for each of the classes listed here, are discussed below.)
-
public final class NameComponent
--
+ public final class NameComponent
--
a building block for names. (Names are bound to object references
in a naming context.)
NameComponent
objects.
@@ -99,7 +99,7 @@
rather than a file extension or some other syntactic convention.
Examples of the value of the kind
field include the strings
"c_source"
, "object_code"
,
- "executable"
,
+ "executable"
,
"postscript"
, and ""
. It is not unusual
for the kind
field to be the empty string.
@@ -110,7 +110,7 @@
This is similar to a path name, in which the last name is the
file name, and all names before it are directory names.
- public final class Binding
--
+ public final class Binding
--
an object that associates a name with an object reference or a
naming context.
A Binding
object has two fields:
@@ -142,9 +142,9 @@
Binding
or used as parameters or return values. These
BindingType
objects are:
-
public static final BindingType nobject
--
+ public static final BindingType nobject
--
to indicate that the binding is with an object reference
- public static final BindingType ncontext
--
+ public static final BindingType ncontext
--
to indicate that the binding is with a naming context
from_int
is supplied with anything other
than _nobject
or _ncontext
, it will throw
- the exception org.omg.CORBA.BAD_PARAM
.
+ the exception org.omg.CORBA.BAD_PARAM
.
BindingType btObject = from_int(_nobject);
@@ -189,7 +189,7 @@
An instance of a holder class can be passed to a
Java method as a parameter, and
a value can be assigned to its
value
field. This allows
- it to perform the function of an OUT or INOUT parameter.
+ it to perform the function of an OUT or INOUT parameter.
org.omg.CosNaming
:
@@ -202,17 +202,17 @@
NameHolder
org.omg.CORBA
package,
+ Note that in the org.omg.CORBA
package,
there is a holder class for each of the basic Java types:
- IntHolder
, ShortHolder
,
+ IntHolder
, ShortHolder
,
StringHolder
, and so on.
NameHolder
class even though
there is no Name
class; similarly, there is a
BindingListHolder
class even though there is no
BindingList
class. This is true because in the OMG IDL
- interface, Name
and BindingList
are
- typedef
s. There is no mapping from an IDL
+ interface, Name
and BindingList
are
+ typedef
s. There is no mapping from an IDL
typedef
to a Java construct, but holder classes
are generated if the typedef
is for a sequence or
an array. As mapped to the
@@ -245,7 +245,7 @@
Helper Classes
Helper classes, which are generated for all user-defined types
in an OMG IDL interface, supply static methods needed to manipulate
- those types.
+ those types.
CosNaming
package complies
with the OMG COSNaming
specification. In other words,
the APIs in Sun's naming service are implemented according to the
-guidelines for a naming service provided by OMG. Therefore, if a
+guidelines for a naming service provided by OMG. Therefore, if a
third-party vendor has implemented a naming service that is OMG
compliant, it is possible to switch between Sun's implementation of
CosNaming
and the third-party vendor's implementation.
@@ -292,18 +292,17 @@
Instructions for Using a Third Party's Naming Service
Although we encourage using an ORB and ORB services that are both
-from one vendor, it is possible to plug in a third party's
+from one vendor, it is possible to plug in a third party's
COSNaming
implementation with Sun's RMI-IIOP ORB.
Here are the steps to follow:
/tmp/services
and put the following in it:
- NameService, <Stringified IOR of the Root Naming
-Context>
.
+ NameService, <Stringified IOR of the Root Naming Context>
.
NameService
with the Root Naming
- Context of the CosNaming
implementation that you
+ Context of the CosNaming
implementation that you
want to use.
@@ -318,7 +317,7 @@
specifying a port number is optional.
org.omg.CORBA.ORB.resolve_initial_references
, CORBA
processes will contact the Bootstrap Server to get the Root Naming
Context.
@@ -326,13 +325,13 @@
Package Specification
-
Related Documentation
-For an overview and examples of how to use the
+For an overview and examples of how to use the
CosNaming
API, please see:
Dynamic
module specified in the OMG Portable
Interceptor specification,
ptc/2000-08-06, section 21.9. Please
@@ -40,10 +40,10 @@
Package Specification
-
-DynAnyFactory
interface of the
-DynamicAny module
+DynamicAny
module
specified in the OMG The Common Object Request Broker: Architecture and
Specification,
@@ -43,10 +43,10 @@
refer to that OMG specification for further details.
Package Specification
-
-DynAny
+ interface of the DynamicAny
module
specified in the OMG The Common Object Request Broker: Architecture and
Specification,
@@ -42,9 +42,9 @@
Package Specification
-Any
values can be dynamically interpreted (traversed) and constructed through
-DynAny objects. A DynAny object is associated with a data
-value which corresponds to a copy of the value inserted into an Any. A
-DynAny object may be viewed as an ordered collection of component
-DynAnys. For DynAnys representing a basic type, such as long
,
+DynAny
objects. A DynAny
object is associated with a data
+value which corresponds to a copy of the value inserted into an Any
. A
+DynAny
object may be viewed as an ordered collection of component
+DynAny
s. For DynAny
s representing a basic type, such as long
,
or a type without components, such as an empty exception, the ordered collection of
components is empty.
-DynAny
object maintains the notion of a current position into its collection
+of component DynAny
s. The current position is identified by an index value that runs
from 0 to n-1, where n is the number of components. The special index value -1
indicates a current position that points nowhere.
For values that cannot have a current position (such as an empty exception),
diff -r 3851193a8c60 -r d7c393b4e0d3 corba/src/java.corba/share/classes/org/omg/IOP/package.html
--- a/corba/src/java.corba/share/classes/org/omg/IOP/package.html Thu Sep 17 09:19:40 2015 -0700
+++ b/corba/src/java.corba/share/classes/org/omg/IOP/package.html Tue Sep 22 11:01:54 2015 -0700
@@ -30,14 +30,14 @@
IOP
module specified in the OMG document
The Common
Object Request Broker: Architecture and Specification,
formal/99-10-07, section 13.6. Please
refer to that OMG specification for further details.
-IOP
module from
the specification. We only provide those parts that are referenced as
return values or parameter types in public APIs, most notably,
Portable Interceptors.
@@ -47,10 +47,10 @@
Package Specification
-
-Messaging
module specified in the OMG CORBA
Messaging specification,
formal/99-10-07. Please refer to that OMG
specification for further details.
-Messaging
module from
the specification. We only provide those parts that are referenced as
return values or parameter types in public APIs, most notably,
Portable Interceptors.
Package Specification
-
-ORBInitInfo
+local interface of the PortableInterceptor
module specified in the OMG
Portable Interceptor specification,
ptc/2000-08-06, section 21.7.2. Please
refer to that OMG specification for further details.
-
+
Package Specification
-
-My
defined in My.idl
, the file MyPOA.java
+is generated by the idlj
compiler. You must provide
+the implementation for My
and it must inherit from MyPOA
.
-MyPOA.java
is a stream-based skeleton that extends
+org.omg.PortableServer.Servant
and implements the InvokeHandler
+interface and the operations interface associated with the IDL interface the skeleton implements.
-PortableServer
module for the Portable Object Adapter (POA)
+defines the native Servant
type. In the Java programming language,
+the Servant
type is mapped to the Java org.omg.PortableServer.Servant
class.
+It serves as the base class for all POA servant implementations
+and provides a number of methods that may be invoked by the application programmer,
+as well as methods which are invoked by the POA itself
+and may be overridden by the user to control aspects of servant behavior.
-id
attribute, which is added in ptc/00-08-06,
+ The exception to this is the id
attribute, which is added in ptc/00-08-06,
section 11.3.8.26.
Package Specification
-out
parameter. The CookieHolder
class
+CookieHolder
class for passing
+the Cookie
type as an out
parameter. The CookieHolder
class
follows exactly the same pattern as the other holder classes for basic types.
-
+
Package Specification
-
-java.rmi
package.
@since 1.3
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/.hgtags
--- a/hotspot/.hgtags Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/.hgtags Tue Sep 22 11:01:54 2015 -0700
@@ -484,3 +484,4 @@
e9e63d93bbfe2c6c23447e2c1f5cc71c98671cba jdk9-b79
8e8377739c06b99b9011c003c77e0bef84c91e09 jdk9-b80
4142c190cd5ca4fb70ec367b4f97ef936272d8ef jdk9-b81
+1c453a12be3036d482abef1dd470f8aff536b6b9 jdk9-b82
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/Makefile
--- a/hotspot/make/Makefile Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/Makefile Tue Sep 22 11:01:54 2015 -0700
@@ -633,9 +633,9 @@
update_jdk: export_product_jdk export_fastdebug_jdk test_jdk
-copy_jdk: $(JDK_IMAGE_DIR)/jre/lib/rt.jar
+copy_jdk: $(JDK_IMAGE_DIR)/bin/java
-$(JDK_IMAGE_DIR)/jre/lib/rt.jar:
+$(JDK_IMAGE_DIR)/bin/java:
$(RM) -r $(JDK_IMAGE_DIR)
$(MKDIR) -p $(JDK_IMAGE_DIR)
($(CD) $(JDK_IMPORT_PATH) && \
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/aix/makefiles/mapfile-vers-debug
--- a/hotspot/make/aix/makefiles/mapfile-vers-debug Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/aix/makefiles/mapfile-vers-debug Tue Sep 22 11:01:54 2015 -0700
@@ -141,18 +141,6 @@
JVM_Halt;
JVM_HoldsLock;
JVM_IHashCode;
- JVM_ImageAttributeOffsets;
- JVM_ImageAttributeOffsetsLength;
- JVM_ImageClose;
- JVM_ImageFindAttributes;
- JVM_ImageGetAttributes;
- JVM_ImageGetAttributesCount;
- JVM_ImageGetDataAddress;
- JVM_ImageGetIndexAddress;
- JVM_ImageGetStringBytes;
- JVM_ImageOpen;
- JVM_ImageRead;
- JVM_ImageReadCompressed;
JVM_InitAgentProperties;
JVM_InitProperties;
JVM_InternString;
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/aix/makefiles/mapfile-vers-product
--- a/hotspot/make/aix/makefiles/mapfile-vers-product Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/aix/makefiles/mapfile-vers-product Tue Sep 22 11:01:54 2015 -0700
@@ -139,18 +139,6 @@
JVM_Halt;
JVM_HoldsLock;
JVM_IHashCode;
- JVM_ImageAttributeOffsets;
- JVM_ImageAttributeOffsetsLength;
- JVM_ImageClose;
- JVM_ImageFindAttributes;
- JVM_ImageGetAttributes;
- JVM_ImageGetAttributesCount;
- JVM_ImageGetDataAddress;
- JVM_ImageGetIndexAddress;
- JVM_ImageGetStringBytes;
- JVM_ImageOpen;
- JVM_ImageRead;
- JVM_ImageReadCompressed;
JVM_InitAgentProperties;
JVM_InitProperties;
JVM_InternString;
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/bsd/makefiles/mapfile-vers-darwin-debug
--- a/hotspot/make/bsd/makefiles/mapfile-vers-darwin-debug Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/bsd/makefiles/mapfile-vers-darwin-debug Tue Sep 22 11:01:54 2015 -0700
@@ -139,18 +139,6 @@
_JVM_Halt
_JVM_HoldsLock
_JVM_IHashCode
- _JVM_ImageAttributeOffsets
- _JVM_ImageAttributeOffsetsLength
- _JVM_ImageClose
- _JVM_ImageFindAttributes
- _JVM_ImageGetAttributes
- _JVM_ImageGetAttributesCount
- _JVM_ImageGetDataAddress
- _JVM_ImageGetIndexAddress
- _JVM_ImageGetStringBytes
- _JVM_ImageOpen
- _JVM_ImageRead
- _JVM_ImageReadCompressed
_JVM_InitAgentProperties
_JVM_InitProperties
_JVM_InternString
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/bsd/makefiles/mapfile-vers-darwin-product
--- a/hotspot/make/bsd/makefiles/mapfile-vers-darwin-product Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/bsd/makefiles/mapfile-vers-darwin-product Tue Sep 22 11:01:54 2015 -0700
@@ -139,18 +139,6 @@
_JVM_Halt
_JVM_HoldsLock
_JVM_IHashCode
- _JVM_ImageAttributeOffsets
- _JVM_ImageAttributeOffsetsLength
- _JVM_ImageClose
- _JVM_ImageFindAttributes
- _JVM_ImageGetAttributes
- _JVM_ImageGetAttributesCount
- _JVM_ImageGetDataAddress
- _JVM_ImageGetIndexAddress
- _JVM_ImageGetStringBytes
- _JVM_ImageOpen
- _JVM_ImageRead
- _JVM_ImageReadCompressed
_JVM_InitAgentProperties
_JVM_InitProperties
_JVM_InternString
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/bsd/makefiles/mapfile-vers-debug
--- a/hotspot/make/bsd/makefiles/mapfile-vers-debug Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/bsd/makefiles/mapfile-vers-debug Tue Sep 22 11:01:54 2015 -0700
@@ -141,18 +141,6 @@
JVM_Halt;
JVM_HoldsLock;
JVM_IHashCode;
- JVM_ImageAttributeOffsets;
- JVM_ImageAttributeOffsetsLength;
- JVM_ImageClose;
- JVM_ImageFindAttributes;
- JVM_ImageGetAttributes;
- JVM_ImageGetAttributesCount;
- JVM_ImageGetDataAddress;
- JVM_ImageGetIndexAddress;
- JVM_ImageGetStringBytes;
- JVM_ImageOpen;
- JVM_ImageRead;
- JVM_ImageReadCompressed;
JVM_InitAgentProperties;
JVM_InitProperties;
JVM_InternString;
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/bsd/makefiles/mapfile-vers-product
--- a/hotspot/make/bsd/makefiles/mapfile-vers-product Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/bsd/makefiles/mapfile-vers-product Tue Sep 22 11:01:54 2015 -0700
@@ -141,18 +141,6 @@
JVM_Halt;
JVM_HoldsLock;
JVM_IHashCode;
- JVM_ImageAttributeOffsets;
- JVM_ImageAttributeOffsetsLength;
- JVM_ImageClose;
- JVM_ImageFindAttributes;
- JVM_ImageGetAttributes;
- JVM_ImageGetAttributesCount;
- JVM_ImageGetDataAddress;
- JVM_ImageGetIndexAddress;
- JVM_ImageGetStringBytes;
- JVM_ImageOpen;
- JVM_ImageRead;
- JVM_ImageReadCompressed;
JVM_InitAgentProperties;
JVM_InitProperties;
JVM_InternString;
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/bsd/makefiles/vm.make
--- a/hotspot/make/bsd/makefiles/vm.make Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/bsd/makefiles/vm.make Tue Sep 22 11:01:54 2015 -0700
@@ -131,7 +131,7 @@
# By default, link the *.o into the library, not the executable.
LINK_INTO$(LINK_INTO) = LIBJVM
-JDK_LIBDIR = $(JAVA_HOME)/jre/lib/$(LIBARCH)
+JDK_LIBDIR = $(JAVA_HOME)/lib/$(LIBARCH)
#----------------------------------------------------------------------
# jvm_db & dtrace
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/build.sh
--- a/hotspot/make/build.sh Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/build.sh Tue Sep 22 11:01:54 2015 -0700
@@ -49,7 +49,7 @@
# Just in case:
JAVA_HOME=`( cd $JAVA_HOME; pwd )`
-if [ "${ALT_BOOTDIR-}" = "" -o ! -d "${ALT_BOOTDIR-}" -o ! -d ${ALT_BOOTDIR-}/jre/lib/ ]; then
+if [ "${ALT_BOOTDIR-}" = "" -o ! -d "${ALT_BOOTDIR-}" -o ! -d ${ALT_BOOTDIR-}/lib/ ]; then
ALT_BOOTDIR=${JAVA_HOME}
fi
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/hotspot.script
--- a/hotspot/make/hotspot.script Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/hotspot.script Tue Sep 22 11:01:54 2015 -0700
@@ -127,7 +127,7 @@
# o $JRE/lib/$ARCH
# followed by the user's previous effective LD_LIBRARY_PATH, if
# any.
-JRE=$JDK/jre
+JRE=$JDK
JAVA_HOME=$JDK
export JAVA_HOME
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/linux/makefiles/mapfile-vers-debug
--- a/hotspot/make/linux/makefiles/mapfile-vers-debug Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/linux/makefiles/mapfile-vers-debug Tue Sep 22 11:01:54 2015 -0700
@@ -141,18 +141,6 @@
JVM_Halt;
JVM_HoldsLock;
JVM_IHashCode;
- JVM_ImageAttributeOffsets;
- JVM_ImageAttributeOffsetsLength;
- JVM_ImageClose;
- JVM_ImageFindAttributes;
- JVM_ImageGetAttributes;
- JVM_ImageGetAttributesCount;
- JVM_ImageGetDataAddress;
- JVM_ImageGetIndexAddress;
- JVM_ImageGetStringBytes;
- JVM_ImageOpen;
- JVM_ImageRead;
- JVM_ImageReadCompressed;
JVM_InitAgentProperties;
JVM_InitProperties;
JVM_InternString;
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/linux/makefiles/mapfile-vers-product
--- a/hotspot/make/linux/makefiles/mapfile-vers-product Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/linux/makefiles/mapfile-vers-product Tue Sep 22 11:01:54 2015 -0700
@@ -141,18 +141,6 @@
JVM_Halt;
JVM_HoldsLock;
JVM_IHashCode;
- JVM_ImageAttributeOffsets;
- JVM_ImageAttributeOffsetsLength;
- JVM_ImageClose;
- JVM_ImageFindAttributes;
- JVM_ImageGetAttributes;
- JVM_ImageGetAttributesCount;
- JVM_ImageGetDataAddress;
- JVM_ImageGetIndexAddress;
- JVM_ImageGetStringBytes;
- JVM_ImageOpen;
- JVM_ImageRead;
- JVM_ImageReadCompressed;
JVM_InitAgentProperties;
JVM_InitProperties;
JVM_InternString;
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/solaris/makefiles/adlc.make
--- a/hotspot/make/solaris/makefiles/adlc.make Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/solaris/makefiles/adlc.make Tue Sep 22 11:01:54 2015 -0700
@@ -76,6 +76,11 @@
ifeq ($(shell expr $(COMPILER_REV_NUMERIC) \>= 509), 1)
CFLAGS_WARN = +w -errwarn
endif
+# When using compiler version 5.13 (Solaris Studio 12.4), calls to explicitly
+# instantiated template functions trigger this warning when +w is active.
+ifeq ($(shell expr $(COMPILER_REV_NUMERIC) \>= 513), 1)
+ CFLAGS_WARN += -erroff=notemsource
+endif
CFLAGS += $(CFLAGS_WARN)
ifeq ("${Platform_compiler}", "sparcWorks")
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/solaris/makefiles/buildtree.make
--- a/hotspot/make/solaris/makefiles/buildtree.make Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/solaris/makefiles/buildtree.make Tue Sep 22 11:01:54 2015 -0700
@@ -270,6 +270,7 @@
echo "CP ?= cp"; \
echo "MV ?= mv"; \
echo "include \$$(GAMMADIR)/make/$(OS_FAMILY)/makefiles/$(VARIANT).make"; \
+ echo "include \$$(GAMMADIR)/make/excludeSrc.make"; \
echo "include \$$(GAMMADIR)/make/$(OS_FAMILY)/makefiles/$(COMPILER).make"; \
) > $@
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/solaris/makefiles/mapfile-vers
--- a/hotspot/make/solaris/makefiles/mapfile-vers Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/solaris/makefiles/mapfile-vers Tue Sep 22 11:01:54 2015 -0700
@@ -141,18 +141,6 @@
JVM_Halt;
JVM_HoldsLock;
JVM_IHashCode;
- JVM_ImageAttributeOffsets;
- JVM_ImageAttributeOffsetsLength;
- JVM_ImageClose;
- JVM_ImageFindAttributes;
- JVM_ImageGetAttributes;
- JVM_ImageGetAttributesCount;
- JVM_ImageGetDataAddress;
- JVM_ImageGetIndexAddress;
- JVM_ImageGetStringBytes;
- JVM_ImageOpen;
- JVM_ImageRead;
- JVM_ImageReadCompressed;
JVM_InitAgentProperties;
JVM_InitProperties;
JVM_InternString;
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/make/solaris/makefiles/vm.make
--- a/hotspot/make/solaris/makefiles/vm.make Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/make/solaris/makefiles/vm.make Tue Sep 22 11:01:54 2015 -0700
@@ -197,7 +197,7 @@
Src_Dirs/COMPILER2 := $(CORE_PATHS) $(COMPILER2_PATHS)
Src_Dirs/TIERED := $(CORE_PATHS) $(COMPILER1_PATHS) $(COMPILER2_PATHS)
Src_Dirs/ZERO := $(CORE_PATHS)
-Src_Dirs/SHARK := $(CORE_PATHS)
+Src_Dirs/SHARK := $(CORE_PATHS) $(SHARK_PATHS)
Src_Dirs := $(Src_Dirs/$(TYPE))
COMPILER2_SPECIFIC_FILES := opto libadt bcEscapeAnalyzer.cpp c2_\* runtime_\*
@@ -206,7 +206,7 @@
ZERO_SPECIFIC_FILES := zero
# Always exclude these.
-Src_Files_EXCLUDE := dtrace jsig.c jvmtiEnvRecommended.cpp jvmtiEnvStub.cpp
+Src_Files_EXCLUDE += dtrace jsig.c jvmtiEnvRecommended.cpp jvmtiEnvStub.cpp
# Exclude per type.
Src_Files_EXCLUDE/CORE := $(COMPILER1_SPECIFIC_FILES) $(COMPILER2_SPECIFIC_FILES) $(ZERO_SPECIFIC_FILES) $(SHARK_SPECIFIC_FILES) ciTypeFlow.cpp
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/src/cpu/aarch64/vm/aarch64.ad
--- a/hotspot/src/cpu/aarch64/vm/aarch64.ad Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/src/cpu/aarch64/vm/aarch64.ad Tue Sep 22 11:01:54 2015 -0700
@@ -4373,12 +4373,12 @@
return;
}
- if (UseBiasedLocking) {
- __ biased_locking_enter(disp_hdr, oop, box, tmp, true, cont);
+ if (UseBiasedLocking && !UseOptoBiasInlining) {
+ __ biased_locking_enter(box, oop, disp_hdr, tmp, true, cont);
}
// Handle existing monitor
- if (EmitSync & 0x02) {
+ if ((EmitSync & 0x02) == 0) {
// we can use AArch64's bit test and branch here but
// markoopDesc does not define a bit index just the bit value
// so assert in case the bit pos changes
@@ -4518,7 +4518,7 @@
return;
}
- if (UseBiasedLocking) {
+ if (UseBiasedLocking && !UseOptoBiasInlining) {
__ biased_locking_exit(oop, tmp, cont);
}
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/src/cpu/aarch64/vm/assembler_aarch64.hpp
--- a/hotspot/src/cpu/aarch64/vm/assembler_aarch64.hpp Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/src/cpu/aarch64/vm/assembler_aarch64.hpp Tue Sep 22 11:01:54 2015 -0700
@@ -1210,7 +1210,7 @@
INSN(ldrs, 0b00, 1);
INSN(ldrd, 0b01, 1);
- INSN(ldrq, 0x10, 1);
+ INSN(ldrq, 0b10, 1);
#undef INSN
@@ -2285,13 +2285,13 @@
#undef INSN
// Table vector lookup
-#define INSN(NAME, op) \
- void NAME(FloatRegister Vd, SIMD_Arrangement T, FloatRegister Vn, unsigned registers, FloatRegister Vm) { \
- starti; \
- assert(T == T8B || T == T16B, "invalid arrangement"); \
- assert(0 < registers && registers <= 4, "invalid number of registers"); \
- f(0, 31), f((int)T & 1, 30), f(0b001110000, 29, 21), rf(Vm, 16), f(0, 15); \
- f(registers - 1, 14, 13), f(op, 12),f(0b00, 11, 10), rf(Vn, 5), rf(Vd, 0); \
+#define INSN(NAME, op) \
+ void NAME(FloatRegister Vd, SIMD_Arrangement T, FloatRegister Vn, unsigned registers, FloatRegister Vm) { \
+ starti; \
+ assert(T == T8B || T == T16B, "invalid arrangement"); \
+ assert(0 < registers && registers <= 4, "invalid number of registers"); \
+ f(0, 31), f((int)T & 1, 30), f(0b001110000, 29, 21), rf(Vm, 16), f(0, 15); \
+ f(registers - 1, 14, 13), f(op, 12),f(0b00, 11, 10), rf(Vn, 5), rf(Vd, 0); \
}
INSN(tbl, 0);
@@ -2299,6 +2299,7 @@
#undef INSN
+ // AdvSIMD two-reg misc
#define INSN(NAME, U, opcode) \
void NAME(FloatRegister Vd, SIMD_Arrangement T, FloatRegister Vn) { \
starti; \
@@ -2316,10 +2317,19 @@
#define ASSERTION (T == T8B || T == T16B || T == T4H || T == T8H)
INSN(rev32, 1, 0b00000);
+private:
+ INSN(_rbit, 1, 0b00101);
+public:
+
#undef ASSERTION
#define ASSERTION (T == T8B || T == T16B)
INSN(rev16, 0, 0b00001);
+ // RBIT only allows T8B and T16B but encodes them oddly. Argh...
+ void rbit(FloatRegister Vd, SIMD_Arrangement T, FloatRegister Vn) {
+ assert((ASSERTION), MSG);
+ _rbit(Vd, SIMD_Arrangement(T & 1 | 0b010), Vn);
+ }
#undef ASSERTION
#undef MSG
diff -r 3851193a8c60 -r d7c393b4e0d3 hotspot/src/cpu/aarch64/vm/macroAssembler_aarch64.cpp
--- a/hotspot/src/cpu/aarch64/vm/macroAssembler_aarch64.cpp Thu Sep 17 09:19:40 2015 -0700
+++ b/hotspot/src/cpu/aarch64/vm/macroAssembler_aarch64.cpp Tue Sep 22 11:01:54 2015 -0700
@@ -3043,7 +3043,9 @@
// register obj is destroyed afterwards.
BarrierSet* bs = Universe::heap()->barrier_set();
- assert(bs->kind() == BarrierSet::CardTableModRef, "Wrong barrier set kind");
+ assert(bs->kind() == BarrierSet::CardTableForRS ||
+ bs->kind() == BarrierSet::CardTableExtension,
+ "Wrong barrier set kind");
CardTableModRefBS* ct = barrier_set_cast