This commit is contained in:
Lana Steuck 2015-05-07 20:50:57 -07:00
commit a82a4a967e
114 changed files with 304 additions and 568 deletions

View File

@ -222,7 +222,7 @@ public class AnyImpl extends Any
/**
* returns the type of the element contained in the Any.
*
* @result the TypeCode for the element in the Any
* @return the TypeCode for the element in the Any
*/
public TypeCode type() {
return typeCode;
@ -267,7 +267,7 @@ public class AnyImpl extends Any
* checks for equality between Anys.
*
* @param otherAny the Any to be compared with.
* @result true if the Anys are equal, false otherwise.
* @return true if the Anys are equal, false otherwise.
*/
public boolean equal(Any otherAny)
{
@ -508,7 +508,7 @@ public class AnyImpl extends Any
/**
* returns an output stream that an Any value can be marshaled into.
*
* @result the OutputStream to marshal value of Any into
* @return the OutputStream to marshal value of Any into
*/
public org.omg.CORBA.portable.OutputStream create_output_stream()
{
@ -525,7 +525,7 @@ public class AnyImpl extends Any
/**
* returns an input stream that an Any value can be marshaled out of.
*
* @result the InputStream to marshal value of Any out of.
* @return the InputStream to marshal value of Any out of.
*/
public org.omg.CORBA.portable.InputStream create_input_stream()
{

View File

@ -166,7 +166,7 @@ public class CDROutputObject extends CorbaOutputObject
* Write the contents of the CDROutputStream to the specified
* output stream. Has the side-effect of pushing any current
* Message onto the Message list.
* @param s The output stream to write to.
* @param connection The output stream to write to.
*/
public void writeTo(CorbaConnection connection)
throws java.io.IOException

View File

@ -54,8 +54,9 @@ import com.sun.corba.se.spi.logging.CORBALogDomains;
* use NIO ByteBuffer and NIO CharBuffer, the interaction
* and interface between this class and the CDR streams
* should be looked at more closely for optimizations to
* avoid unnecessary copying of data between char[] &
* CharBuffer and byte[] & ByteBuffer, especially
* avoid unnecessary copying of data between
* {@code char[] & CharBuffer} and
* {@code byte[] & ByteBuffer}, especially
* DirectByteBuffers.
*
*/

View File

@ -171,9 +171,9 @@ public final class ValueHandlerImpl implements javax.rmi.CORBA.ValueHandlerMulti
* @param out The stream to write the value to
* @param value The value to be written to the stream
**/
public void writeValue(org.omg.CORBA.portable.OutputStream _out,
public void writeValue(org.omg.CORBA.portable.OutputStream out,
java.io.Serializable value) {
writeValueWithVersion(_out, value, STREAM_FORMAT_VERSION_1);
writeValueWithVersion(out, value, STREAM_FORMAT_VERSION_1);
}
private void writeValueWithVersion(org.omg.CORBA.portable.OutputStream _out,
@ -240,25 +240,25 @@ public final class ValueHandlerImpl implements javax.rmi.CORBA.ValueHandlerMulti
* Reads a value from the stream using java semantics.
* @param in The stream to read the value from
* @param clazz The type of the value to be read in
* @param sender The sending context runtime
* @param rt The sending context runtime
**/
public java.io.Serializable readValue(org.omg.CORBA.portable.InputStream _in,
public java.io.Serializable readValue(org.omg.CORBA.portable.InputStream in,
int offset,
java.lang.Class clazz,
String repositoryID,
org.omg.SendingContext.RunTime _sender)
org.omg.SendingContext.RunTime rt)
{
// Must use narrow rather than a direct cast to a com.sun
// class. Fix for bug 4379539.
CodeBase sender = CodeBaseHelper.narrow(_sender);
CodeBase sender = CodeBaseHelper.narrow(rt);
org.omg.CORBA_2_3.portable.InputStream in =
(org.omg.CORBA_2_3.portable.InputStream) _in;
org.omg.CORBA_2_3.portable.InputStream inStream =
(org.omg.CORBA_2_3.portable.InputStream) in;
if (!useHashtables) {
if (inputStreamBridge == null) {
inputStreamBridge = createInputStream();
inputStreamBridge.setOrbStream(in);
inputStreamBridge.setOrbStream(inStream);
inputStreamBridge.setSender(sender); //d11638
// backward compatability 4365188
inputStreamBridge.setValueHandler(this);
@ -269,7 +269,7 @@ public final class ValueHandlerImpl implements javax.rmi.CORBA.ValueHandlerMulti
try {
inputStreamBridge.increaseRecursionDepth();
result = (java.io.Serializable) readValueInternal(inputStreamBridge, in, offset, clazz, repositoryID, sender);
result = (java.io.Serializable) readValueInternal(inputStreamBridge, inStream, offset, clazz, repositoryID, sender);
} finally {
@ -287,16 +287,16 @@ public final class ValueHandlerImpl implements javax.rmi.CORBA.ValueHandlerMulti
if (inputStreamPairs == null)
inputStreamPairs = new Hashtable();
jdkToOrbInputStreamBridge = (IIOPInputStream)inputStreamPairs.get(_in);
jdkToOrbInputStreamBridge = (IIOPInputStream)inputStreamPairs.get(in);
if (jdkToOrbInputStreamBridge == null) {
jdkToOrbInputStreamBridge = createInputStream();
jdkToOrbInputStreamBridge.setOrbStream(in);
jdkToOrbInputStreamBridge.setOrbStream(inStream);
jdkToOrbInputStreamBridge.setSender(sender); //d11638
// backward compatability 4365188
jdkToOrbInputStreamBridge.setValueHandler(this);
inputStreamPairs.put(_in, jdkToOrbInputStreamBridge);
inputStreamPairs.put(in, jdkToOrbInputStreamBridge);
}
java.io.Serializable result = null;
@ -304,12 +304,12 @@ public final class ValueHandlerImpl implements javax.rmi.CORBA.ValueHandlerMulti
try {
jdkToOrbInputStreamBridge.increaseRecursionDepth();
result = (java.io.Serializable) readValueInternal(jdkToOrbInputStreamBridge, in, offset, clazz, repositoryID, sender);
result = (java.io.Serializable) readValueInternal(jdkToOrbInputStreamBridge, inStream, offset, clazz, repositoryID, sender);
} finally {
if (jdkToOrbInputStreamBridge.decreaseRecursionDepth() == 0) {
inputStreamPairs.remove(_in);
inputStreamPairs.remove(in);
}
}

View File

@ -33,7 +33,6 @@ import org.omg.CORBA_2_3.portable.OutputStream;
import com.sun.corba.se.spi.ior.Identifiable ;
/**
* @author
* This is used for unknown components and profiles. A TAG_MULTICOMPONENT_PROFILE will be represented this way.
*/
public abstract class GenericIdentifiable implements Identifiable

View File

@ -34,9 +34,6 @@ import com.sun.corba.se.spi.ior.iiop.GIOPVersion ;
import com.sun.corba.se.spi.ior.TaggedComponent ;
/**
* @author
*/
public class GenericTaggedComponent extends GenericIdentifiable
implements TaggedComponent
{
@ -52,8 +49,6 @@ public class GenericTaggedComponent extends GenericIdentifiable
/**
* @return org.omg.IOP.TaggedComponent
* @exception
* @author
*/
public org.omg.IOP.TaggedComponent getIOPComponent( ORB orb )
{

View File

@ -39,9 +39,6 @@ import com.sun.corba.se.spi.ior.iiop.GIOPVersion ;
import com.sun.corba.se.impl.encoding.EncapsOutputStream ;
/**
* @author
*/
public class GenericTaggedProfile extends GenericIdentifiable implements TaggedProfile
{
private ORB orb ;

View File

@ -47,7 +47,6 @@ import com.sun.corba.se.spi.orb.ORB ;
/**
* This class is a container of TaggedProfileTemplates.
* @author
*/
public class IORTemplateImpl extends IdentifiableContainerBase implements IORTemplate
{

View File

@ -31,7 +31,7 @@ import org.omg.CORBA_2_3.portable.OutputStream ;
/** ObjectAdapterIdNumber is used to represent pre-JDK 1.4 POA adapter
* IDs. The POA ID was simply represented as a single integer, which was
* mapped to the actual POA instance. Here, we just represent these
* internally as arrays of the form { "OldRootPOA", "<number>" },
* internally as arrays of the form {@code { "OldRootPOA", "<number>" }},
* and provide an extra method to get the number back.
*/
public class ObjectAdapterIdNumber extends ObjectAdapterIdArray {

View File

@ -29,9 +29,6 @@ import java.util.Arrays ;
import com.sun.corba.se.spi.ior.ObjectId ;
import org.omg.CORBA_2_3.portable.OutputStream ;
/**
* @author
*/
public final class ObjectIdImpl implements ObjectId
{
private byte[] id;

View File

@ -37,9 +37,6 @@ import com.sun.corba.se.spi.ior.ObjectKeyTemplate ;
import com.sun.corba.se.impl.encoding.EncapsOutputStream ;
/**
* @author
*/
public class ObjectKeyImpl implements ObjectKey
{
private ObjectKeyTemplate oktemp;

View File

@ -47,9 +47,6 @@ import com.sun.corba.se.impl.encoding.EncapsOutputStream ;
import com.sun.corba.se.impl.logging.IORSystemException ;
/**
* @author
*/
public abstract class ObjectKeyTemplateBase implements ObjectKeyTemplate
{
// Fixed constants for Java IDL object key template forms

View File

@ -42,9 +42,6 @@ import com.sun.corba.se.spi.ior.ObjectAdapterId ;
import com.sun.corba.se.impl.ior.ObjectKeyFactoryImpl ;
/**
* @author
*/
public final class POAObjectKeyTemplate extends NewObjectKeyTemplateBase
{
/** This constructor reads the template ONLY from the stream.

View File

@ -245,7 +245,7 @@ public class StubIORImpl
/**
* Returns a string representation of this stub. Returns the same string
* for all stubs that represent the same remote object.
* "SimpleIORImpl[<typeName>,[<profileID>]data, ...]"
* {@code "SimpleIORImpl[<typeName>,[<profileID>]data, ...]"}
* @return a string representation of this stub.
*/
public String toString()

View File

@ -33,9 +33,6 @@ import com.sun.corba.se.impl.ior.IdentifiableFactoryFinderBase ;
import org.omg.CORBA_2_3.portable.InputStream ;
/**
* @author
*/
public class TaggedProfileFactoryFinderImpl extends
IdentifiableFactoryFinderBase
{

View File

@ -35,9 +35,6 @@ import org.omg.CORBA_2_3.portable.InputStream ;
import org.omg.CORBA.INTERNAL ;
/**
* @author
*/
public class TaggedProfileTemplateFactoryFinderImpl extends
IdentifiableFactoryFinderBase
{

View File

@ -38,9 +38,6 @@ import com.sun.corba.se.impl.encoding.CodeSetComponentInfo ;
import com.sun.corba.se.impl.encoding.MarshalOutputStream ;
import com.sun.corba.se.impl.encoding.MarshalInputStream ;
/**
* @author
*/
public class CodeSetsComponentImpl extends TaggedComponentBase
implements CodeSetsComponent
{

View File

@ -32,9 +32,6 @@ import org.omg.CORBA_2_3.portable.OutputStream ;
import com.sun.corba.se.spi.ior.iiop.IIOPAddress ;
/**
* @author
*/
abstract class IIOPAddressBase implements IIOPAddress
{
// Ports are marshalled as shorts on the wire. The IDL

View File

@ -32,9 +32,6 @@ import org.omg.CORBA_2_3.portable.OutputStream ;
import com.sun.corba.se.spi.orbutil.closure.Closure ;
/**
* @author
*/
public final class IIOPAddressClosureImpl extends IIOPAddressBase
{
private Closure host;

View File

@ -36,9 +36,6 @@ import com.sun.corba.se.spi.logging.CORBALogDomains ;
import com.sun.corba.se.impl.logging.IORSystemException ;
/**
* @author
*/
public final class IIOPAddressImpl extends IIOPAddressBase
{
private ORB orb ;

View File

@ -76,9 +76,6 @@ import com.sun.corba.se.impl.util.JDKBridge;
import com.sun.corba.se.impl.logging.IORSystemException;
/**
* @author
*/
public class IIOPProfileImpl extends IdentifiableBase implements IIOPProfile
{
private ORB orb ;

View File

@ -55,7 +55,6 @@ import com.sun.corba.se.spi.ior.iiop.GIOPVersion ;
import com.sun.corba.se.spi.orb.ORB ;
/**
* @author
* If getMinorVersion==0, this does not contain any tagged components
*/
public class IIOPProfileTemplateImpl extends TaggedProfileTemplateBase

View File

@ -33,9 +33,6 @@ import com.sun.corba.se.spi.ior.TaggedComponentBase ;
import com.sun.corba.se.spi.ior.iiop.JavaCodebaseComponent ;
/**
* @author
*/
public class JavaCodebaseComponentImpl extends TaggedComponentBase
implements JavaCodebaseComponent
{

View File

@ -593,7 +593,7 @@ public class Util implements javax.rmi.CORBA.UtilDelegate
* @param className the name of the class.
* @param remoteCodebase a space-separated list of URLs at which
* the class might be found. May be null.
* @param loadingContext a class whose ClassLoader may be used to
* @param loader a class whose ClassLoader may be used to
* load the class if all other methods fail.
* @return the <code>Class</code> object representing the loaded class.
* @exception ClassNotFoundException if class cannot be loaded.

View File

@ -92,7 +92,7 @@ public abstract class BindingIteratorImpl extends BindingIteratorPOA
* Return the next n bindings. It also returns true or false, indicating
* whether there were more bindings.
* @param how_many The number of requested bindings in the BindingList.
* @param bl The BindingList as an out parameter.
* @param blh The BindingList as an out parameter.
* @return true if there were more bindings.
* @exception org.omg.CORBA.SystemException One of a fixed set of CORBA
* system exceptions.
@ -114,7 +114,7 @@ public abstract class BindingIteratorImpl extends BindingIteratorPOA
* scope, It will be called from NamingContext.list() operation or
* this.next_n().
* @param how_many The number of requested bindings in the BindingList.
* @param bl The BindingList as an out parameter.
* @param blh The BindingList as an out parameter.
* @return true if there were more bindings.
*/
public boolean list( int how_many, org.omg.CosNaming.BindingListHolder blh)

View File

@ -181,7 +181,7 @@ public abstract class NamingContextImpl
* exists. The NamingContext will participate in recursive resolving.
* @param n a sequence of NameComponents which is the name under which
* the object will be bound.
* @param obj the NamingContect object reference to be bound.
* @param nc the NamingContext object reference to be bound.
* @exception org.omg.CosNaming.NamingContextPackage.NotFound A name with
* multiple components was supplied, but the first component could not be
* resolved.
@ -278,7 +278,7 @@ public abstract class NamingContextImpl
* resolving.
* @param n a sequence of NameComponents which is the name under which
* the object will be bound.
* @param obj the object reference to be bound.
* @param nc the object reference to be bound.
* @exception org.omg.CosNaming.NamingContextPackage.NotFound A name with
* multiple components was supplied, but the first component could not be
* resolved.
@ -853,10 +853,9 @@ public abstract class NamingContextImpl
/**
* This operation creates a stringified name from the array of Name
* components.
* @param n Name of the object <p>
* @param n Name of the object
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
* Indicates the name does not identify a binding.<p>
*
* Indicates the name does not identify a binding.
*/
public String to_string(org.omg.CosNaming.NameComponent[] n)
throws org.omg.CosNaming.NamingContextPackage.InvalidName
@ -882,10 +881,9 @@ public abstract class NamingContextImpl
/**
* This operation converts a Stringified Name into an equivalent array
* of Name Components.
* @param sn Stringified Name of the object <p>
* @param sn Stringified Name of the object
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
* Indicates the name does not identify a binding.<p>
*
* Indicates the name does not identify a binding.
*/
public org.omg.CosNaming.NameComponent[] to_name(String sn)
throws org.omg.CosNaming.NamingContextPackage.InvalidName
@ -920,14 +918,13 @@ public abstract class NamingContextImpl
* This operation creates a URL based "iiopname://" format name
* from the Stringified Name of the object.
* @param addr internet based address of the host machine where
* Name Service is running <p>
* @param sn Stringified Name of the object <p>
* Name Service is running
* @param sn Stringified Name of the object
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
* Indicates the name does not identify a binding.<p>
* Indicates the name does not identify a binding.
* @exception org.omg.CosNaming.NamingContextPackage.InvalidAddress
* Indicates the internet based address of the host machine is
* incorrect <p>
*
* incorrect
*/
public String to_url(String addr, String sn)
@ -961,15 +958,15 @@ public abstract class NamingContextImpl
/**
* This operation resolves the Stringified name into the object
* reference.
* @param sn Stringified Name of the object <p>
* @param sn Stringified Name of the object
* @exception org.omg.CosNaming.NamingContextPackage.NotFound
* Indicates there is no object reference for the given name. <p>
* Indicates there is no object reference for the given name.
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed
* Indicates that the given compound name is incorrect <p>
* Indicates that the given compound name is incorrect
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
* Indicates the name does not identify a binding.<p>
* Indicates the name does not identify a binding.
* @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound
* Indicates the name is already bound.<p>
* Indicates the name is already bound.
*
*/
public org.omg.CORBA.Object resolve_str(String sn)

View File

@ -90,7 +90,7 @@ public class NamingUtils {
/**
* Create a error print stream to the supplied file.
* @param logFile the file to which error messages will go.
* @param errFile the file to which error messages will go.
* @exception IOException thrown if the file cannot be opened for output.
*/
public static void makeErrStream(File errFile)

View File

@ -63,7 +63,6 @@ public class TransientBindingIterator extends BindingIteratorImpl
* @param orb a org.omg.CORBA.ORB object.
* @param aTable A hashtable containing InternalBindingValues which is
* the content of the TransientNamingContext.
* @param java.lang.Exception a Java exception.
* @exception Exception a Java exception thrown of the base class cannot
* initialize.
*/

View File

@ -85,7 +85,7 @@ public class TransientNameService
* NamingContext, whose object
* reference can be obtained by the initialNamingContext method.
* @param orb The ORB object
* @param nameserviceName Stringified key used for INS Service registry
* @param serviceName Stringified key used for INS Service registry
* @exception org.omg.CORBA.INITIALIZE Thrown if
* the TransientNameService cannot initialize.
*/

View File

@ -33,7 +33,7 @@ import com.sun.corba.se.spi.logging.CORBALogDomains;
* will be stored in this object. This object is capable of storing CorbaLoc
* profiles as defined in the CorbaName grammer.
*
* @Author Hemanth
* @author Hemanth
*/
public class CorbanameURL extends INSURLBase
{

View File

@ -32,7 +32,7 @@ import com.sun.corba.se.impl.orbutil.ORBConstants;
* host information used in creating the Service Object reference
* from the -ORBInitDef and -ORBDefaultInitDef definitions.
*
* @Author Hemanth
* @author Hemanth
*/
public class IIOPEndpointInfo
{

View File

@ -29,7 +29,7 @@ package com.sun.corba.se.impl.naming.namingutil;
* INS URL is a generic interface for two different types of URL's specified
* in INS spec.
*
* @Author Hemanth
* @author Hemanth
*/
public interface INSURL {
public boolean getRIRFlag( );

View File

@ -30,7 +30,7 @@ import java.util.StringTokenizer;
/**
* This class is the entry point to parse different types of INS URL's.
*
* @Author Hemanth
* @author Hemanth
*/
public class INSURLHandler {

View File

@ -36,7 +36,7 @@ import com.sun.corba.se.spi.logging.CORBALogDomains;
/**
* Utility methods for Naming.
*
* @Author Hemanth
* @author Hemanth
*/
class Utility {
private static NamingSystemException wrapper =

View File

@ -186,7 +186,7 @@ public class NameService
/**
* getObjectReferenceFromKey returns the Object reference from the objectkey using POA.create_reference_with_id method
* @param Object Key as String
* @returns reference an CORBA.Object.
* @return a CORBA.Object reference.
*/
org.omg.CORBA.Object getObjectReferenceFromKey( String key )
{
@ -205,7 +205,7 @@ public class NameService
/**
* getObjectKey gets the Object Key from the reference using POA.reference_to_id method
* @param reference an CORBA.Object.
* @returns Object Key as String
* @return Object Key as String
*/
String getObjectKey( org.omg.CORBA.Object reference )
{

View File

@ -116,8 +116,8 @@ public class NamingContextImpl
* Runs the super constructor.
* @param orb an ORB object.
* @param objKey as String
* @param TheNameService as NameService
* @param TheServantManagerImpl as ServantManagerImpl
* @param theNameService as NameService
* @param theServantManagerImpl as ServantManagerImpl
* @exception java.lang.Exception a Java exception.
*/
@ -223,7 +223,7 @@ public class NamingContextImpl
* exists. The NamingContext will participate in recursive resolving.
* @param n a sequence of NameComponents which is the name under which
* the object will be bound.
* @param obj the NamingContect object reference to be bound.
* @param nc the NamingContect object reference to be bound.
* @exception org.omg.CosNaming.NamingContextPackage.NotFound A name with multiple
* components was supplied, but the first component could not be
* resolved.
@ -301,7 +301,7 @@ public class NamingContextImpl
* unbound first. The NamingContext will participate in recursive resolving.
* @param n a sequence of NameComponents which is the name under which
* the object will be bound.
* @param obj the object reference to be bound.
* @param nc the object reference to be bound.
* @exception org.omg.CosNaming.NamingContextPackage.NotFound A name with multiple
* components was supplied, but the first component could not be
* resolved.
@ -907,7 +907,7 @@ public class NamingContextImpl
* The doResolve( ) method calls Resolve( ) recursively to resolve n level
* Names.
* @param n a sequence of NameComponents which is the name to be resolved.
* @param bt Type of binding (as object or as context).
* @param bth Type of binding (as object or as context).
* @return the object reference bound under the supplied name.
* @exception org.omg.CosNaming.NamingContextPackage.NotFound Neither a NamingContext
* or a Corba Object reference not found under this Name
@ -1140,10 +1140,9 @@ public class NamingContextImpl
/**
* This operation creates a stringified name from the array of Name
* components.
* @param n Name of the object <p>
* @param n Name of the object
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
* Indicates the name does not identify a binding.<p>
*
* Indicates the name does not identify a binding.
*/
public String to_string(org.omg.CosNaming.NameComponent[] n)
throws org.omg.CosNaming.NamingContextPackage.InvalidName
@ -1167,10 +1166,9 @@ public class NamingContextImpl
/**
* This operation converts a Stringified Name into an equivalent array
* of Name Components.
* @param sn Stringified Name of the object <p>
* @param sn Stringified Name of the object
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
* Indicates the name does not identify a binding.<p>
*
* Indicates the name does not identify a binding.
*/
public org.omg.CosNaming.NameComponent[] to_name(String sn)
throws org.omg.CosNaming.NamingContextPackage.InvalidName
@ -1204,14 +1202,13 @@ public class NamingContextImpl
* This operation creates a URL based "iiopname://" format name
* from the Stringified Name of the object.
* @param addr internet based address of the host machine where
* Name Service is running <p>
* @param sn Stringified Name of the object <p>
* Name Service is running
* @param sn Stringified Name of the object
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
* Indicates the name does not identify a binding.<p>
* Indicates the name does not identify a binding.
* @exception org.omg.CosNaming.NamingContextPackage.InvalidAddress
* Indicates the internet based address of the host machine is
* incorrect <p>
*
* incorrect
*/
public String to_url(String addr, String sn)
@ -1247,14 +1244,13 @@ public class NamingContextImpl
/**
* This operation resolves the Stringified name into the object
* reference.
* @param sn Stringified Name of the object <p>
* @param sn Stringified Name of the object
* @exception org.omg.CosNaming.NamingContextPackage.NotFound
* Indicates there is no object reference for the given name. <p>
* Indicates there is no object reference for the given name.
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed
* Indicates that the given compound name is incorrect <p>
* Indicates that the given compound name is incorrect
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
* Indicates the name does not identify a binding.<p>
*
* Indicates the name does not identify a binding.
*/
public org.omg.CORBA.Object resolve_str(String sn)
throws org.omg.CosNaming.NamingContextPackage.NotFound,

View File

@ -64,7 +64,6 @@ public class PersistentBindingIterator extends BindingIteratorImpl
* @param orb a org.omg.CORBA.ORB object.
* @param aTable A hashtable containing InternalBindingValues which is
* the content of the PersistentNamingContext.
* @param java.lang.Exception a Java exception.
* @exception Exception a Java exception thrown of the base class cannot
* initialize.
*/

View File

@ -61,7 +61,7 @@ import com.sun.corba.se.impl.protocol.JIDLLocalCRDImpl ;
* Its characteristics include:
* <UL>
* <LI>There is only one OA instance of the TOA. Its OAId is { "TOA" }</LI>
* <LI>There is not adapter manager. The TOA manager ID is fixed.<LI>
* <LI>There is not adapter manager. The TOA manager ID is fixed.</LI>
* <LI>State is the same as ORB state (TBD)</LI>
* </UL>
* Other requirements:
@ -118,7 +118,7 @@ public class TOAImpl extends ObjectAdapterBase implements TOA
* This will update thread Current, so that subsequent calls to
* returnServant and removeCurrent from the same thread are for the
* same request.
* @param request is the request containing the rest of the request
* @param info is the request containing the rest of the request
*/
public void getInvocationServant( OAInvocationInfo info )
{

View File

@ -585,7 +585,7 @@ public class ORBImpl extends com.sun.corba.se.spi.orb.ORB
* Create an NVList
*
* @param count size of list to create
* @result NVList created
* @return NVList created
*
* @see NVList
*/
@ -599,7 +599,7 @@ public class ORBImpl extends com.sun.corba.se.spi.orb.ORB
* Create an NVList corresponding to an OperationDef
*
* @param oper operation def to use to create list
* @result NVList created
* @return NVList created
*
* @see NVList
*/
@ -612,7 +612,7 @@ public class ORBImpl extends com.sun.corba.se.spi.orb.ORB
/**
* Create a NamedValue
*
* @result NamedValue created
* @return NamedValue created
*/
public synchronized NamedValue create_named_value(String s, Any any, int flags)
{
@ -623,7 +623,7 @@ public class ORBImpl extends com.sun.corba.se.spi.orb.ORB
/**
* Create an ExceptionList
*
* @result ExceptionList created
* @return ExceptionList created
*/
public synchronized org.omg.CORBA.ExceptionList create_exception_list()
{
@ -634,7 +634,7 @@ public class ORBImpl extends com.sun.corba.se.spi.orb.ORB
/**
* Create a ContextList
*
* @result ContextList created
* @return ContextList created
*/
public synchronized org.omg.CORBA.ContextList create_context_list()
{
@ -645,7 +645,7 @@ public class ORBImpl extends com.sun.corba.se.spi.orb.ORB
/**
* Get the default Context object
*
* @result the default Context object
* @return the default Context object
*/
public synchronized org.omg.CORBA.Context get_default_context()
{
@ -656,7 +656,7 @@ public class ORBImpl extends com.sun.corba.se.spi.orb.ORB
/**
* Create an Environment
*
* @result Environment created
* @return Environment created
*/
public synchronized org.omg.CORBA.Environment create_environment()
{
@ -719,7 +719,7 @@ public class ORBImpl extends com.sun.corba.se.spi.orb.ORB
/**
* Get the next request that has gotten a response.
*
* @result the next request ready with a response.
* @return the next request ready with a response.
*/
public org.omg.CORBA.Request get_next_response()
throws org.omg.CORBA.WrongTransaction

View File

@ -42,8 +42,9 @@ public class DenseIntMapImpl
throw new IllegalArgumentException( "Key must be >= 0." ) ;
}
/** If key >= 0, return the value bound to key, or null if none.
* Throws IllegalArgumentException if key <0.
/**
* If {@code key >= 0}, return the value bound to key, or null if none.
* Throws IllegalArgumentException if {@code key < 0}.
*/
public Object get( int key )
{
@ -56,8 +57,9 @@ public class DenseIntMapImpl
return result ;
}
/** If key >= 0, bind value to the key.
* Throws IllegalArgumentException if key <0.
/**
* If {@code key >= 0}, bind value to the key.
* Throws IllegalArgumentException if {@code key < 0}.
*/
public void set( int key, Object value )
{

View File

@ -35,7 +35,7 @@ package com.sun.corba.se.impl.orbutil ;
* <code>AccessController.doPrivileged</code>.
*
* <p>The following code retrieves the value of the system
* property named <code>"prop"</code> as a privileged action: <p>
* property named <code>"prop"</code> as a privileged action:
*
* <pre>
* String s = (String) java.security.AccessController.doPrivileged(
@ -67,7 +67,7 @@ public class GetPropertyAction implements java.security.PrivilegedAction {
* value of that property.
*
* @param theProp the name of the system property.
* @param defaulVal the default value.
* @param defaultVal the default value.
*/
public GetPropertyAction(String theProp, String defaultVal) {
this.theProp = theProp;

View File

@ -150,8 +150,7 @@ import com.sun.corba.se.impl.orbutil.ORBUtility ;
*
* </pre>
* @see Mutex
* <p>[<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
* [<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
**/
public class CondVar {

View File

@ -126,7 +126,6 @@ package com.sun.corba.se.impl.orbutil.concurrent;
* // ... other similar traversal and update methods ...
* }
* </pre>
* <p>
* @see Semaphore
* <p>[<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
**/

View File

@ -181,11 +181,11 @@ package com.sun.corba.se.impl.orbutil.concurrent;
* }
* }
* }
*</pre>
* </pre>
* <p>
* Here is an even fancier version, that uses lock re-ordering
* upon conflict:
* <pre>
* <pre>{@code
* class Cell {
* long value;
* Sync lock = ...;
@ -214,8 +214,8 @@ package com.sun.corba.se.impl.orbutil.concurrent;
* }
* catch (InterruptedException ex) { return; }
* }
*}
*</pre>
* }
* }</pre>
* <p>
* Interruptions are in general handled as early as possible.
* Normally, InterruptionExceptions are thrown
@ -248,7 +248,7 @@ package com.sun.corba.se.impl.orbutil.concurrent;
* it is normally best to just use acquire(), various forms
* of busy waits can be implemented. For a simple example
* (but one that would probably never be preferable to using acquire()):
* <pre>
* <pre>{@code
* class X {
* Sync lock = ...
* void spinUntilAcquired() throws InterruptedException {
@ -269,17 +269,16 @@ package com.sun.corba.se.impl.orbutil.concurrent;
* }
* }
* }
* </pre>
* }</pre>
* <p>
* In addition pure synchronization control, Syncs
* may be useful in any context requiring before/after methods.
* For example, you can use an ObservableSync
* (perhaps as part of a LayeredSync) in order to obtain callbacks
* before and after each method invocation for a given class.
* <p>
* <p>[<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
**/
*
* [<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
**/
public interface Sync {

View File

@ -130,13 +130,13 @@ public abstract class CorbaConnectionCacheBase
* This method must be synchronized since one WorkerThread could
* be reclaming connections inside the synchronized backingStore
* block and a second WorkerThread (or a SelectorThread) could have
* already executed the if (numberOfConnections <= .... ). As a
* already executed the if (numberOfConnections {@literal <=} .... ). As a
* result the second thread would also attempt to reclaim connections.
*
* If connection reclamation becomes a performance issue, the connection
* reclamation could make its own task and consequently executed in
* a separate thread.
* Currently, the accept & reclaim are done in the same thread, WorkerThread
* Currently, the accept {@literal &} reclaim are done in the same thread, WorkerThread
* by default. It could be changed such that the SelectorThread would do
* it for SocketChannels and WorkerThreads for Sockets by updating the
* ParserTable.

View File

@ -59,7 +59,7 @@ public interface Acceptor
/**
* Used to determine if an <code>Acceptor</code> has been initialized.
*
* @return <code>true</code. if the <code>Acceptor</code> has been
* @return <code>true</code> if the <code>Acceptor</code> has been
* initialized.
*/
public boolean initialized();
@ -74,7 +74,7 @@ public interface Acceptor
/**
* Set the
* {@link com.sun.corba.se.pept.transport.Inbound.ConnectionCache InboundConnectionCache}
* {@link com.sun.corba.se.pept.transport.InboundConnectionCache InboundConnectionCache}
* to be used by this <code>Acceptor</code>.
*
* PEPt uses separate caches for each type of <code>Acceptor</code>
@ -88,7 +88,7 @@ public interface Acceptor
/**
* Get the
* {@link com.sun.corba.se.pept.transport.Inbound.ConnectionCache InboundConnectionCache}
* {@link com.sun.corba.se.pept.transport.InboundConnectionCache InboundConnectionCache}
* used by this <code>Acceptor</code>
*
* PEPt uses separate caches for each type of <code>Acceptor</code>

View File

@ -44,7 +44,7 @@ import com.sun.corba.se.impl.orbutil.ORBConstants ;
* <ol>
* <li>POA current semantics
* <li>Proper handling of POA destroy.
* <ol>
* </ol>
* POA current semantics requires maintaining a ThreadLocal stack of
* invocation information that is always available for POACurrent operations.
* Maintaining this stack is expensive on the timescale of optimized co-located

View File

@ -41,8 +41,8 @@ The abstract model of IORs works as follows:
<li>An IIOPProfile isA TaggedProfile.</li>
<li>An IIOPProfile is composed of an IIOPProfileTemplate and an object ID.</li>
<li>An IIOPProfileTemplate has an ObjectKeyTemplate, and contains TaggedComponents.</li>
<li>A TaggedComponent has an ID, and can be written to an OuputStream.<li>
<li>A TaggedComponentFactory reads a TaggedComponent from an InputStream.<li>
<li>A TaggedComponent has an ID, and can be written to an OuputStream.</li>
<li>A TaggedComponentFactory reads a TaggedComponent from an InputStream.</li>
</ul>
<p>
In all cases, containment is represented by having the appropriate interface (IOR and

View File

@ -48,7 +48,7 @@ import com.sun.corba.se.spi.transport.SocketInfo;
*
* property. <p>
*
* Example: <p>
* Example:
* <pre>
* -Dcom.sun.CORBA.connection.ORBSocketFactoryClass=MySocketFactory
@ -145,7 +145,7 @@ public interface ORBSocketFactory
*
* property. <p>
*
* Example usage:<p>
* Example usage:
*
* <pre>
* ... \
@ -203,7 +203,7 @@ public interface ORBSocketFactory
* Once you have the port you may add information to references
* created by the associated adapter by calling
*
* <code>IORInfo::add_ior_component</code><p> <p>
* <code>IORInfo::add_ior_component</code><p>
*
*
* Note: if one is using a POA and the lifespan policy of that
@ -247,7 +247,7 @@ public interface ORBSocketFactory
*
* <code>ORBConstants.BAD_SERVER_ID_HANDLER_CLASS_PROPERTY</code> <p>
*
* Example: <p>
* Example:
*
* <pre>
*
@ -271,7 +271,7 @@ public interface ORBSocketFactory
* <code>SOCKET_FACTORY_CLASS_PROPERTY</code> and
* <code>LISTEN_SOCKET_PROPERTY</code>
*
* as used by other clients and servers in your distributed system. <p>
* as used by other clients and servers in your distributed system.
*
*/
public ServerSocket createServerSocket(String type, int port)
@ -324,7 +324,7 @@ public interface ORBSocketFactory
*
* The <code>SocketInfo</code> given to <code>getEndPointInfo</code>
* is either null or an object obtained
* from <code>GetEndPointInfoAgainException</code> <p>
* from <code>GetEndPointInfoAgainException</code>
*
*/
public SocketInfo getEndPointInfo(org.omg.CORBA.ORB orb,
@ -333,7 +333,7 @@ public interface ORBSocketFactory
/**
* DEPRECATED. DEPRECATED. DEPRECATED. DEPRECATED. <p
* DEPRECATED. DEPRECATED. DEPRECATED. DEPRECATED. <p>
*
* This method is used by a client side ORB. <p>
*
@ -346,7 +346,7 @@ public interface ORBSocketFactory
*
* If this method throws GetEndPointInfoAgainException then the
* ORB calls <code>getEndPointInfo</code> again, passing it the
* <code>SocketInfo</code> object contained in the exception. <p>
* <code>SocketInfo</code> object contained in the exception.
*
*/
public Socket createSocket(SocketInfo socketInfo)

View File

@ -30,8 +30,7 @@ import com.sun.corba.se.spi.legacy.connection.Connection;
/**
* This interface is implemented by our implementation of
* PortableInterceptor.ClientRequestInfo and
* PortableInterceptor.ServerRequestInfo. <p>
*
* PortableInterceptor.ServerRequestInfo.
*/
public interface RequestInfoExt

View File

@ -27,13 +27,9 @@ package com.sun.corba.se.spi.monitoring;
import java.util.*;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* A Cleaner Abstraction to provide a Monitored Attribute of type 'Long'
* </p>
*/
public abstract class LongMonitoredAttributeBase extends MonitoredAttributeBase {
@ -42,20 +38,14 @@ public abstract class LongMonitoredAttributeBase extends MonitoredAttributeBase
/**
* <p>
* Constructs LongMonitoredAttribute, by creating the
* MonitoredAttributeInfo with 'Long' as the class type.
* Users are expected to extend this class and provide the implementation
* for getValue() and if needed clearState() as well.
* </p>
* <p>
*
* @param name of tthe MonitoredAttribute
* </p>
* <p>
* @param name of the MonitoredAttribute
* @param description of the Attribute, Please provid a well thought out
* description, so that the admin can make sense of the attribute supplied.
* </p>
*/
public LongMonitoredAttributeBase(String name, String description) {
super( name );

View File

@ -28,15 +28,11 @@ import com.sun.corba.se.spi.monitoring.MonitoredAttributeInfo;
import java.util.*;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* Monitored Attribute is the interface to represent a Monitorable
* Attribute. Using this interface, one can get the value of the attribute
* and set the value if it is a writeable attribute.
* </p>
*/
public interface MonitoredAttribute {
@ -44,34 +40,25 @@ public interface MonitoredAttribute {
// operations
/**
* <p>
* Gets the Monitored Attribute Info for the attribute.
* </p>
* <p>
*
* @param monitoredAttributeInfo for this Monitored Attribute.
* </p>
* @return monitoredAttributeInfo for this Monitored Attribute.
*/
public MonitoredAttributeInfo getAttributeInfo();
/**
* <p>
* Sets the value for the Monitored Attribute if isWritable() is false, the
* method will throw ILLEGAL Operation exception.
*
* Also, the type of 'value' should be same as specified in the
* MonitoredAttributeInfo for a particular instance.
* </p>
* <p>
*
* @param value should be any one of the Basic Java Type Objects which are
* Long, Double, Float, String, Integer, Short, Character, Byte.
* </p>
*/
public void setValue(Object value);
/**
* <p>
* Gets the value of the Monitored Attribute. The value can be obtained
* from different parts of the module. User may choose to delegate the call
* to getValue() to other variables.
@ -79,34 +66,21 @@ public interface MonitoredAttribute {
* NOTE: It is important to make sure that the type of Object returned in
* getvalue is same as the one specified in MonitoredAttributeInfo for this
* attribute.
* </p>
* <p>
*
* </p>
* <p>
*
* @param value is the current value for this MonitoredAttribute
* </p>
* @return the current value for this MonitoredAttribute
*/
public Object getValue();
/**
* <p>
* Gets the name of the Monitored Attribute.
* </p>
* <p>
*
* @param name of this Attribute
* </p>
* @return name of this Attribute
*/
public String getName();
/**
* <p>
* If this attribute needs to be cleared, the user needs to implement this
* method to reset the state to initial state. If the Monitored Attribute
* doesn't change like for example (ConnectionManager High Water Mark),
* then clearState() is a No Op.
* </p>
*
*/
public void clearState();

View File

@ -27,16 +27,11 @@ package com.sun.corba.se.spi.monitoring;
import java.util.*;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* A Convenient class provided to help users extend and implement only
* getValue(), if there is no need to clear the state and the attribute is not
* writable.
*
* </p>
*/
public abstract class MonitoredAttributeBase implements MonitoredAttribute {
String name;

View File

@ -27,14 +27,10 @@ package com.sun.corba.se.spi.monitoring;
import java.util.*;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* Monitored AttributeInfo contains the meta information of the Monitored
* Attribute.
* </p>
*/
public interface MonitoredAttributeInfo {
@ -42,45 +38,38 @@ public interface MonitoredAttributeInfo {
// operations
/**
* <p>
* If the Attribute is writable from ASAdmin then isWritable() will return
* true.
* </p>
* <p>
*
* @return a boolean with true or false
* </p>
*/
public boolean isWritable();
/**
* <p>
* isStatistic() is true if the attribute is presented as a Statistic.
* </p>
* <p>
*
* @return a boolean with true or false
* </p>
*/
public boolean isStatistic();
/**
* <p>
* Class Type: We will allow only basic class types: 1)Boolean 2)Integer
* 3)Byte 4)Long 5)Float 6)Double 7)String 8)Character
* </p>
* <p>
* Class Type: We will allow only basic class types:
* <ol>
* <li>Boolean</li>
* <li>Integer</li>
* <li>Byte</li>
* <li>Long</li>
* <li>Float</li>
* <li>Double</li>
* <li>String</li>
* <li>Character</li>
* </ol>
*
* @return a Class Type
* </p>
*/
public Class type();
/**
* <p>
* Get's the description for the Monitored Attribute.
* </p>
* <p>
*
* @return a String with description
* </p>
*/
public String getDescription();

View File

@ -25,17 +25,12 @@
package com.sun.corba.se.spi.monitoring;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* MonitoredAttributeInfoFactory used mostly by internal classes. If the
* User needs to define some special MonitoredAttributes like a Character
* type Monitored Attribute, they can use this factory to build the meta
* information.
*
* </p>
*/
public interface MonitoredAttributeInfoFactory {

View File

@ -30,161 +30,101 @@ import java.util.*;
import java.util.Collection;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* Monitored Object provides an Hierarchichal view of the ORB Monitoring
* System. It can contain multiple children and a single parent. Each
* Monitored Object may also contain Multiple Monitored Attributes.
* </p>
*/
public interface MonitoredObject {
///////////////////////////////////////
// operations
/**
* <p>
* Gets the name of this MonitoredObject
* </p><p>
*
* @return a String with name of this Monitored Object
* </p>
*/
public String getName();
/**
* <p>
* Gets the description of MonitoredObject
* </p><p>
*
* @return a String with Monitored Object Description.
* </p>
*/
public String getDescription();
/**
* <p>
* This method will add a child Monitored Object to this Monitored Object.
* </p>
* <p>
* </p>
*/
public void addChild( MonitoredObject m );
/**
* <p>
* This method will remove child Monitored Object identified by the given name
* </p>
* <p>
*
* @param name of the ChildMonitored Object
* </p>
*/
public void removeChild( String name );
/**
* <p>
* Gets the child MonitoredObject associated with this MonitoredObject
* instance using name as the key. The name should be fully qualified name
* like orb.connectionmanager
* </p>
* <p>
*
* @return a MonitoredObject identified by the given name
* </p>
* <p>
* @param name of the ChildMonitored Object
* </p>
*/
public MonitoredObject getChild(String name);
/**
* <p>
* Gets all the Children registered under this instance of Monitored
* Object.
* </p>
* <p>
*
* @return Collection of immediate Children associated with this MonitoredObject.
* </p>
*/
public Collection getChildren();
/**
* <p>
* Sets the parent for this Monitored Object.
* </p>
* <p>
* </p>
*/
public void setParent( MonitoredObject m );
/**
* <p>
* There will be only one parent for an instance of MontoredObject, this
* call gets parent and returns null if the Monitored Object is the root.
* </p>
* <p>
*
* @return a MonitoredObject which is a Parent of this Monitored Object instance
* </p>
*/
public MonitoredObject getParent();
/**
* <p>
* Adds the attribute with the given name.
* </p>
* <p>
*
* </p>
* <p>
* @param value is the MonitoredAttribute which will be set as one of the
* attribute of this MonitoredObject.
* </p>
*/
public void addAttribute(MonitoredAttribute value);
/**
* <p>
* Removes the attribute with the given name.
* </p>
* <p>
*
* </p>
* <p>
* @param name is the MonitoredAttribute name
* </p>
*/
public void removeAttribute(String name);
/**
* <p>
* Gets the Monitored Object registered by the given name
* </p>
*
* <p>
* @return a MonitoredAttribute identified by the given name
* </p>
* <p>
* @param name of the attribute
* </p>
*/
public MonitoredAttribute getAttribute(String name);
/**
* <p>
* Gets all the Monitored Attributes for this Monitored Objects. It doesn't
* include the Child Monitored Object, that needs to be traversed using
* getChild() or getChildren() call.
* </p>
* <p>
*
* @return Collection of all the Attributes for this MonitoredObject
* </p>
*/
public Collection getAttributes();
/**
* <p>
* Clears the state of all the Monitored Attributes associated with the
* Monitored Object. It will also clear the state on all it's child
* Monitored Object. The call to clearState will be initiated from
* CORBAMBean.startMonitoring() call.
* </p>
*
*/
public void clearState();

View File

@ -25,14 +25,9 @@
package com.sun.corba.se.spi.monitoring;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* MonitoredObject Factory to create Monitored Object.
* </p>
*/
public interface MonitoredObjectFactory {
/**

View File

@ -29,17 +29,13 @@ import com.sun.corba.se.impl.monitoring.MonitoredAttributeInfoFactoryImpl;
import com.sun.corba.se.impl.monitoring.MonitoringManagerFactoryImpl;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* This is used for getting the default factories for
* MonitoredObject, MonitoredAttributeInfo and MonitoringManager. We do not
* expect users to use the MonitoredAttributeInfo factory most of the time
* because the Info is automatically built by StringMonitoredAttributeBase
* and LongMonitoredAttributeBase.
* </p>
*/
public class MonitoringFactories {
///////////////////////////////////////
@ -57,20 +53,15 @@ public class MonitoringFactories {
// operations
/**
* <p>
* Gets the MonitoredObjectFactory
* </p>
* <p>
*
* @return a MonitoredObjectFactory
* </p>
*/
public static MonitoredObjectFactory getMonitoredObjectFactory( ) {
return monitoredObjectFactory;
}
/**
* <p>
* Gets the MonitoredAttributeInfoFactory. The user is not expected to use this
* Factory, since the MonitoredAttributeInfo is internally created by
* StringMonitoredAttributeBase, LongMonitoredAttributeBase and
@ -79,11 +70,8 @@ public class MonitoringFactories {
* build a DoubleMonitoredAttributeBase like LongMonitoredAttributeBase
* and build a MonitoredAttributeInfo required by MonitoredAttributeBase
* internally by using this Factory.
* </p>
* <p>
*
* @return a MonitoredAttributeInfoFactory
* </p>
*/
public static MonitoredAttributeInfoFactory
getMonitoredAttributeInfoFactory( )
@ -92,18 +80,14 @@ public class MonitoringFactories {
}
/**
* <p>
* Gets the MonitoredManagerFactory. The user is not expected to use this
* Factory, since the ORB will be automatically initialized with the
* MonitoringManager.
*
* User can get hold of MonitoringManager associated with ORB by calling
* orb.getMonitoringManager( )
* </p>
* <p>
*
* @return a MonitoredManagerFactory
* </p>
*/
public static MonitoringManagerFactory getMonitoringManagerFactory( ) {
return monitoringManagerFactory;

View File

@ -30,15 +30,11 @@ import com.sun.corba.se.spi.monitoring.MonitoredObject;
import java.util.*;
/**
* <p>
* Monitoring Manager will have a 1 to 1 association with the ORB. This
* gives access to the top level Monitored Object, using which more
* Monitored Objects and Attributes can be added and traversed.
* </p>
* <p>
*
* @author Hemanth Puttaswamy
* </p>
*/
public interface MonitoringManager extends Closeable {
@ -46,23 +42,14 @@ public interface MonitoringManager extends Closeable {
// operations
/**
* <p>
* Gets the Root Monitored Object which contains a Hierarchy Of Monitored
* Objects exposing various Monitorable Attributes of Various modules.
* </p>
* <p>
*
* @param MonitoredObject ...
* </p>
*/
public MonitoredObject getRootMonitoredObject();
/**
* <p>
* Initialize is called whenever there is a start monitoring call to CORBA
* MBean. This will result in triaging initialize to all the
* MonitoredObjects and it's Monitored Attributes.
* </p>
*
*/
public void clearState();

View File

@ -25,14 +25,10 @@
package com.sun.corba.se.spi.monitoring;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* MonitoringObjectFactory is used internally by the ORB, It is not for
* general public use.
* </p>
*/
public interface MonitoringManagerFactory {
/**

View File

@ -27,15 +27,11 @@ package com.sun.corba.se.spi.monitoring;
import java.util.*;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* StatisticsMonitoredAttribute is provided as a convenience to collect the
* Statistics of any entity. The getValue() call will be delegated to the
* StatisticsAccumulator set by the user.
* </p>
*/
public class StatisticMonitoredAttribute extends MonitoredAttributeBase {
@ -55,32 +51,19 @@ public class StatisticMonitoredAttribute extends MonitoredAttributeBase {
/**
* <p>
* Constructs the StaisticMonitoredAttribute, builds the required
* MonitoredAttributeInfo with Long as the class type and is always
* readonly attribute.
* </p>
* <p>
*
* @param name Of this attribute
* </p>
* <p>
* @return a StatisticMonitoredAttribute
* </p>
* <p>
* @param desc should provide a good description on the kind of statistics
* collected, a good example is "Connection Response Time Stats will Provide the
* detailed stats based on the samples provided from every request completion
* time"
* </p>
* <p>
* @param s is the StatisticsAcumulator that user will use to accumulate the
* samples and this Attribute Object will get the computed statistics values
* from.
* </p>
* <p>
* @param mutex using which clearState() and getValue() calls need to be locked.
* </p>
*/
public StatisticMonitoredAttribute(String name, String desc,
StatisticsAccumulator s, Object mutex)

View File

@ -27,11 +27,8 @@ package com.sun.corba.se.spi.monitoring;
import java.util.*;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* StatisticsAccumulator accumulates the samples provided by the user and
* computes the value of minimum, maximum, sum and sample square sum. When
* the StatisticMonitoredAttribute calls getValue(), it will compute all
@ -42,7 +39,6 @@ import java.util.*;
* Users can easily extend this class and provide the implementation of
* toString() method to format the stats as desired. By default all the stats
* are printed in a single line.
* </p>
*/
public class StatisticsAccumulator {
@ -72,19 +68,12 @@ public class StatisticsAccumulator {
/**
* <p>
* User will use this method to just register a sample with the
* StatisticsAccumulator. This is the only method that User will use to
* expose the statistics, internally the StatisticMonitoredAttribute will
* collect the information when requested from the ASAdmin.
* </p>
* <p>
*
* </p>
* <p>
*
* @param value a double value to make it more precise
* </p>
*/
public void sample(double value) {
sampleCount++;
@ -137,19 +126,11 @@ public class StatisticsAccumulator {
}
/**
* <p>
* Construct the Statistics Accumulator by providing the unit as a String.
* The examples of units are &quot;Hours&quot;, &quot;Minutes&quot;,
* &quot;Seconds&quot;, &quot;MilliSeconds&quot;, &quot;Micro Seconds&quot;
* etc.,
* </p>
* <p>
* The examples of units are "Hours", "Minutes",
* "Seconds", "MilliSeconds", "Micro Seconds" etc.
*
* @return a StatisticsAccumulator with ...
* </p>
* <p>
* @param unit a String representing the units for the samples collected
* </p>
*/
public StatisticsAccumulator( String unit ) {
this.unit = unit;

View File

@ -27,14 +27,10 @@ package com.sun.corba.se.spi.monitoring;
import java.util.*;
/**
* <p>
*
* @author Hemanth Puttaswamy
* </p>
* <p>
*
* A Convenient Abstraction to present String type Monitored Attribute. One
* of the examples of StringMonitoredAttribute is the State information.
* </p>
*/
public abstract class StringMonitoredAttributeBase
extends MonitoredAttributeBase
@ -45,20 +41,11 @@ public abstract class StringMonitoredAttributeBase
/**
* <p>
* Constructs StringMonitoredAttribute with the MonitoredAttributeInfo
* built with the class type of String.
* </p>
* <p>
*
* @param name of this attribute
* </p>
* <p>
* @param description of this attribute
* </p>
* <p>
* @return a StringMonitoredAttributeBase
* </p>
*/
public StringMonitoredAttributeBase(String name, String description) {
super( name );

View File

@ -89,7 +89,7 @@ import com.sun.corba.se.spi.ior.IORTemplate ;
* <li>A local invocation, where the dispatch is handled in the client subcontract.</li>
* <li>A cached local invocation, where the servant is cached when the IOR is established
* for the client subcontract, and the dispatch is handled in the client subcontract
* to the cached subcontract.<li>
* to the cached subcontract.</li>
* </ol>
* <p>
* Each of these 3 cases is handled a bit differently. On each request, assume as known
@ -111,11 +111,11 @@ import com.sun.corba.se.spi.ior.IORTemplate ;
* <li>oa.returnServant()</li>
* <li>oa.exit()</li>
* <li>pop info</li>
* <ol>
* </ol>
* </li>
* REVISIT: Is this the required order for exit/pop? Cna they be nested instead?
* <!-- REVISIT: Is this the required order for exit/pop? Cna they be nested instead?
* Note that getInvocationServant and returnServant may throw exceptions. In such cases,
* returnServant, exit, and pop must be called in the correct order.
* returnServant, exit, and pop must be called in the correct order. -->
* <li>The local pattern:
* <ol>
* <li>oa = oaf.find( oaid )</li>
@ -128,10 +128,10 @@ import com.sun.corba.se.spi.ior.IORTemplate ;
* <li>oa.returnServant()</li>
* <li>oa.exit()</li>
* <li>pop info</li>
* <ol>
* </ol>
* </li>
* This is the same as the remote case, except that setExecuteReturnServantInResponseConstructor
* is not needed (or possible, since there is no server request).
* <!-- This is the same as the remote case, except that setExecuteReturnServantInResponseConstructor
* is not needed (or possible, since there is no server request). -->
* <li>The fast local pattern: When delegate is constructed,
* first extract ObjectKey from IOR in delegate,
* then get ObjectId, ObjectAdapterId, and ObjectAdapterFactory (oaf). Then:
@ -143,14 +143,14 @@ import com.sun.corba.se.spi.ior.IORTemplate ;
* <li>pop info
* </ol>
* The info instance (which includes the Servant) is cached in the client subcontract.
* <p>Then, on each invocation:</p>
* <p>Then, on each invocation:
* <ol>
* <li>newinfo = copy of info (clone)</li>
* <li>info.setOperation( operation )</li>
* <li>push newinfo</li>
* <li>oa.enter()</li>
* <li>dispatch to servant</li>
* <li>oa.returnServant()</li> // XXX This is probably wrong: remove it.
* <li>oa.returnServant()</li> <!-- XXX This is probably wrong: remove it. -->
* <li>oa.exit()</li>
* <li>pop info</li>
* </ol>

View File

@ -58,7 +58,7 @@ public interface DataCollector {
* mappings in the resulting properties. Also, -ORBInitialServices
* is handled specially in applet mode: they are converted from
* relative to absolute URLs.
* @raises IllegalStateException if setPropertyNames has not
* @throws IllegalStateException if setPropertyNames has not
* been called.
*/
Properties getProperties() ;

View File

@ -46,8 +46,8 @@ public interface Action
* in the state machine, as the state could be corrupted.
* Any exception thrown by the Action for the transition
* will be propagated to doIt.
* @param FSM fsm is the state machine causing this action.
* @param Input in is the input that caused the transition.
* @param fsm the state machine causing this action.
* @param in the input that caused the transition.
*/
public void doIt( FSM fsm, Input in ) ;
}

View File

@ -93,8 +93,8 @@ public interface Guard
* input is retried when the thread runs again.
* </ul>
*
* @param FSM fsm is the state machine causing this action.
* @param Input in is the input that caused the transition.
* @param fsm is the state machine causing this action.
* @param in is the input that caused the transition.
*/
public Result evaluate( FSM fsm, Input in ) ;
}

View File

@ -42,9 +42,8 @@ import com.sun.corba.se.impl.orbutil.ORBUtility ;
* the service context and provides any needed methods for manipulating
* the service context. Each subclass must provide the following
* members:
* <p>
* <ul>
* </li>a public static final int SERVICE_CONTEXT_ID that gives the OMG
* <li>a public static final int SERVICE_CONTEXT_ID that gives the OMG
* (or other) defined id for the service context. This is needed for the
* registration mechanism defined in ServiceContexts. OMG defined
* service context ids are taken from section 13.6.7 of ptc/98-12-04.</li>

View File

@ -32,7 +32,7 @@ import org.omg.CORBA.portable.BoxedValueHelper;
* An interface that is implemented by valuetype helper classes.
* This interface appeared in CORBA 2.3 drafts but was removed from
* the published CORBA 2.3 specification.
* <P>
*
* @deprecated Deprecated by CORBA 2.3.
*/
@Deprecated

View File

@ -68,9 +68,9 @@ public class Arguments
* must check the arguments passed to it for validity and process the
* arguments appropriately. If it detects an invalid argument, it should
* throw an InvalidArgument exception. Arguments MUST be of the form
* `/<arg> [<qualifiers>]' or `-<arg> [<qualifiers>]' where <qualifiers>
* is optional (for example, -iC:\includes, `C:\includes' is the qualifier
* for the argument `i').
* {@code '/<arg> [<qualifiers>]'} or {@code '-<arg> [<qualifiers>]'} where {@code <qualifiers>}
* is optional (for example, -iC:\includes, 'C:\includes' is the qualifier
* for the argument 'i').
* @param args The arguments which are unknown by the framework.
* @param properties Environment-style properties collected from the
* file idl.config.
@ -289,7 +289,7 @@ public class Arguments
public Hashtable definedSymbols = new Hashtable ();
/**
* <f46082.46.01> True if new module entries are created for each
* (f46082.46.01) True if new module entries are created for each
* re-opened module.
**/
public boolean cppModule = false;

View File

@ -80,7 +80,7 @@ public class AttributeEntry extends MethodEntry
} // generate
/** Access the attribute generator.
@returns an object which implements the AttributeGen interface.
@return an object which implements the AttributeGen interface.
@see AttributeGen */
public Generator generator ()
{

View File

@ -52,7 +52,7 @@ import com.sun.tools.corba.se.idl.constExpr.DefaultExprFactory;
* Compiler usage:
* <br><br>
*
* java com.sun.tools.corba.se.idl.toJava.compile [options] <idl file>
* {@code java com.sun.tools.corba.se.idl.toJava.compile [options] <idl file>}
* <br><br>
*
* where &lt;idl file&gt; is the name of a file containing IDL definitions,
@ -62,17 +62,17 @@ import com.sun.tools.corba.se.idl.constExpr.DefaultExprFactory;
*
* Options:
* <dl>
* <dt>-i &lt;include path&gt;
* <dt>{@code -i <include path>}
* <dd>By default, the current directory is scanned for included files.
* This option adds another directory. See also Note 1 below.
*
* <dt>-d &lt;symbol&gt;
* <dd>This is equivalent to the following line in an IDL file: #define &lt;symbol&gt;
* <dt>{@code -d <symbol>}
* <dd>This is equivalent to the following line in an IDL file: {@code #define <symbol>}
*
* <dt>-emitAll
* <dt>{@code -emitAll}
* <dd>Emit all types, including those found in #included files.
*
* <dt>-v
* <dt>{@code -v}
* <dd>Verbose mode.
* </dl>
*
@ -81,9 +81,9 @@ import com.sun.tools.corba.se.idl.constExpr.DefaultExprFactory;
* time. Instead, these can be placed into a config file called idl.config.
* This file must be in the CLASSPATH. The format of the includes line is:
*
* <pre>
* <pre>{@code
* includes=<path1>;<path2>;...;<pathN>
* </pre>
* }</pre>
*
* Note that the path separator character, here shown as a semicolon, is
* machine dependent. For instance, on Windows 95 this character is a
@ -481,10 +481,10 @@ public class Compile
**/
public Arguments arguments = null;
/**
* This hashtable contains <real name, alias> pairs. It is filled in by
* This hashtable contains {@code <real name, alias>} pairs. It is filled in by
* extenders in cases where they wish to override an IDL type name with
* some other name. For instance, when mapping to Java, there could be
* an overrideNames entry of <"TRUE", "true">. NOTE: Do NOT change this
* an overrideNames entry of {@code <"TRUE", "true">}. NOTE: Do NOT change this
* variable to a new Hash table. Just add elements to it.
**/
protected Hashtable overrideNames = new Hashtable ();
@ -495,8 +495,8 @@ public class Compile
**/
protected Hashtable symbolTable = new Hashtable ();
/**
* This is a vector of strings of the form "IDLfile" or <IDLfile>. It is
* a list of the files included in the given IDL file. It will be empty
* This is a vector of strings of the form {@code "IDLfile"} or {@code <IDLfile>}.
* It is a list of the files included in the given IDL file. It will be empty
* until the parse method executes. If errors are encountered, the state
* of this vector is undefined.
**/

View File

@ -90,7 +90,7 @@ public class ConstEntry extends SymtabEntry
} // generate
/** Access the constant generator.
@returns an object which implements the ConstGen interface.
@return an object which implements the ConstGen interface.
@see ConstGen */
public Generator generator ()
{

View File

@ -202,7 +202,7 @@ public class DefaultSymtabFactory implements SymtabFactory
'char', 'octet', 'short', 'long', etc. The reason it is not limited
to these is that, as an extender, you may wish to override these names.
For instance, when generating Java code, octet translates to byte, so
there is an entry in Compile.overrideNames: <"octet", "byte"> and a
there is an entry in Compile.overrideNames: {@code <"octet", "byte">} and a
PrimitiveEntry in the symbol table for "byte". */
public PrimitiveEntry primitiveEntry (String name)
{

View File

@ -84,7 +84,7 @@ public class EnumEntry extends SymtabEntry
} // generate
/** Access the enumerator generator.
@returns an object which implements the EnumGen interface.
@return an object which implements the EnumGen interface.
@see EnumGen */
public Generator generator ()
{

View File

@ -80,7 +80,7 @@ public class ExceptionEntry extends StructEntry
} // generate
/** Access the exception generator.
@returns an object which implements the ExceptionGen interface.
@return an object which implements the ExceptionGen interface.
@see ExceptionGen */
public Generator generator ()
{

View File

@ -83,7 +83,7 @@ public class ForwardEntry extends SymtabEntry implements InterfaceType
} // generate
/** Access the interface generator.
@returns an object which implements the InterfaceGen interface.
@return an object which implements the InterfaceGen interface.
@see InterfaceGen */
public Generator generator ()
{

View File

@ -79,7 +79,7 @@ public class ForwardValueEntry extends ForwardEntry
} // generate
/** Access the interface generator.
@returns an object which implements the ForwardValueGen interface.
@return an object which implements the ForwardValueGen interface.
@see ValueGen */
public Generator generator ()
{

View File

@ -81,7 +81,7 @@ public class IncludeEntry extends SymtabEntry
} // generate
/** Access the Include type generator.
@returns an object which implements the IncludeGen interface.
@return an object which implements the IncludeGen interface.
@see IncludeGen */
public Generator generator ()
{
@ -97,7 +97,7 @@ public class IncludeEntry extends SymtabEntry
//d44810
/** Access the fully-qualified file specification of this include.
@returns a string containing the path of the include file. */
@return a string containing the path of the include file. */
public String absFilename ()
{
return _absFilename;

View File

@ -111,7 +111,7 @@ public class InterfaceEntry extends SymtabEntry implements InterfaceType
} // generate
/** Access the interface generator.
@returns an object which implements the InterfaceGen interface.
@return an object which implements the InterfaceGen interface.
@see InterfaceGen */
public Generator generator ()
{

View File

@ -89,7 +89,7 @@ public class MethodEntry extends SymtabEntry
} // generate
/** Access the method generator.
@returns an object which implements the MethodGen interface.
@return an object which implements the MethodGen interface.
@see MethodGen */
public Generator generator ()
{

View File

@ -84,7 +84,7 @@ public class ModuleEntry extends SymtabEntry
} // generate
/** Access the module generator.
@returns an object which implements the ModuleGen interface.
@return an object which implements the ModuleGen interface.
@see ModuleGen */
public Generator generator ()
{

View File

@ -73,7 +73,7 @@ public class NativeEntry extends SymtabEntry
} // generate
/** Access the constant generator.
@returns an object which implements the ConstGen interface.
@return an object which implements the ConstGen interface.
@see ConstGen */
public Generator generator ()
{

View File

@ -88,7 +88,7 @@ public class ParameterEntry extends SymtabEntry
} // generate
/** Access the parameter generator.
@returns an object which implements the ParameterGen interface.
@return an object which implements the ParameterGen interface.
@see ParameterGen */
public Generator generator ()
{

View File

@ -80,7 +80,7 @@ public class PragmaEntry extends SymtabEntry
} // generate
/** Access the Include type generator.
@returns an object which implements the IncludeGen interface.
@return an object which implements the IncludeGen interface.
@see IncludeGen */
public Generator generator ()
{

View File

@ -81,7 +81,7 @@ public class PrimitiveEntry extends SymtabEntry
} // generate
/** Access the primitive type generator.
@returns an object which implements the PrimitiveGen interface.
@return an object which implements the PrimitiveGen interface.
@see PrimitiveGen */
public Generator generator ()
{

View File

@ -68,8 +68,8 @@ public class RepositoryID
/**
* Determine is a supplied string meets the minimal format requirement
* for a Repository ID.
* @return true iff supplied string has form '<format>:<string>', where
* <format> is any non-empty string not containing ':'.
* @return true if supplied string has form {@code '<format>:<string>'}, where
* {@code <format>} is any non-empty string not containing ':'.
**/
public static boolean hasValidForm (String string)
{

View File

@ -101,7 +101,7 @@ public class SequenceEntry extends SymtabEntry
} // generate
/** Access the sequence generator.
@returns an object which implements the SequenceGen interface.
@return an object which implements the SequenceGen interface.
@see SequenceGen */
public Generator generator ()
{

View File

@ -91,7 +91,7 @@ public class StringEntry extends SymtabEntry
} // generate
/** Access the primitive type generator.
@returns an object which implements the PrimitiveGen interface.
@return an object which implements the PrimitiveGen interface.
@see PrimitiveGen */
public Generator generator ()
{

View File

@ -90,7 +90,7 @@ public class StructEntry extends SymtabEntry
} // generate
/** Access the struct generator.
@returns an object which implements the StructGen interface.
@return an object which implements the StructGen interface.
@see StructGen */
public Generator generator ()
{

View File

@ -127,7 +127,7 @@ public class SymtabEntry
/** Get the name of this entry's module. If there are modules within
modules, each module name is separated by '/'.
@returns this entry's module name. */
@return this entry's module name. */
public String module ()
{
return _module;

View File

@ -97,7 +97,7 @@ public interface SymtabFactory
char, octet, short, long, etc. The reason it is not limited to
these is that, as an extender, you may wish to override these names.
For instance, when generating Java code, octet translates to byte,
so there is an entry in Compile.overrideNames: <"octet", "byte">
so there is an entry in Compile.overrideNames: {@code <"octet", "byte">}
and a PrimitiveEntry in the symbol table for "byte". */
PrimitiveEntry primitiveEntry (String name);

View File

@ -332,7 +332,7 @@ class Token
* @param boolean[] collidesWithKeyword is an array containing one value: a flag
* representing whether this string is an identifier that collides with a keyword.
* This is set by this method.
* @returns Token The resulting Token corresponding to string.
* @return Token The resulting Token corresponding to string.
*/
public static Token makeKeywordToken(
String string, float corbaLevel, boolean escapedOK, boolean[] collision )

View File

@ -110,7 +110,7 @@ public class TypedefEntry extends SymtabEntry
}
/** Access the typedef generator.
@returns an object which implements the TypedefGen interface.
@return an object which implements the TypedefGen interface.
@see TypedefGen */
public Generator generator ()
{

View File

@ -46,29 +46,21 @@ import com.sun.tools.corba.se.idl.TypedefEntry;
* of what it may contain:
* <dl>
* <dt>
* <pre>
* case 1: short x;
* </pre>
* <dd><short x, <1>, false>
* {@code case 1: short x;}
* <dd>{@code <short x, <1>, false>}
* <dt>
* <pre>
* case 0:
* case 8:
* case 2: long x;
* </pre>
* <dd><long x, <0, 8, 2>, false>
* {@code case 0:}<br>
* {@code case 8:}<br>
* {@code case 2: long x;}
* <dd>{@code <long x, <0, 8, 2>, false>}
* <dt>
* <pre>
* default: long x;
* </pre>
* <dd><long x, <>, true>
* {@code default: long x;}
* <dd>{@code <long x, <>, true>}
* <dt>
* <pre>
* case 0:
* case 2:
* default: char c;
* </pre>
* <dd><char c, <0, 2>, true>
* {@code case 0:}<br>
* {@code case 2:}<br>
* {@code default: char c;}
* <dd>{@code <char c, <0, 2>, true>}
* </dl>
**/
public class UnionBranch

View File

@ -93,7 +93,7 @@ public class UnionEntry extends SymtabEntry
} // generate
/** Access the union generator.
@returns an object which implements the UnionGen interface.
@return an object which implements the UnionGen interface.
@see UnionGen */
public Generator generator ()
{

View File

@ -77,7 +77,7 @@ public class ValueBoxEntry extends ValueEntry
} // generate
/** Access the value generator.
@returns an object which implements the ValueGen interface.
@return an object which implements the ValueGen interface.
@see ValueGen */
public Generator generator ()
{

View File

@ -86,7 +86,7 @@ public class ValueEntry extends InterfaceEntry
} // generate
/** Access the value generator.
@returns an object which implements the ValueGen interface.
@return an object which implements the ValueGen interface.
@see ValueGen */
public Generator generator ()
{

View File

@ -43,11 +43,11 @@ import java.math.BigInteger;
/**
* This class contains values. Objects of this class are the terminal
* nodes of an expression tree.
* <b>
* <p>
* Note that there is a constructor for Double values, but not Float.
* CORBA defines that all floating point expressions are evaluated as
* double, and that the result is coerced back to float if necessary.
* <b>
* <p>
* Note also that there is a constructor for long values, but not for
* int or short. CORBA defines that all integral expressions are evaluated
* as unsigned long. A CORBA long is a Java int. There is no unsigned int

View File

@ -260,7 +260,7 @@ public class Arguments extends com.sun.tools.corba.se.idl.Arguments
} // packageFromProps
/**
* d57482 <klr> method added so default emitter check could be overriden.
* d57482 (klr) method added so default emitter check could be overriden.
**/
protected void setDefaultEmitter () {
// If the flag -fclient was not found, assume it.

Some files were not shown because too many files have changed in this diff Show More