Issue 2480:  export/unexport errors not well specified (java2idl-rtf)
Source:  (, )
Nature:  Uncategorized Issue
Severity: 
Summary: Summary: The text describing PortableRemoteObject does not describe the
 possible error cases very completely or precisely. 1. Change the paragraph:
 
    It is an error to call exportObject more than once for the same object.
 
    to the paragraph:
 
    It is an error to call exportObject on an object that is already
    exported.
 
 2. Change the sentence in the description of toStub:
   
    The argument object must either be a subclass of PortableRemoteObject
    or have been previously the target of a call on 
    PortableRemoteObject.exportObject.
 
    to the sentences:
 
    The argument object must currently be exported, either because it is
    a subclass of PortableRemoteObject or by virtue of a previous call 
    to PortableRemoteObject.exportObject.  If the object is not currently
    exported, a NoSuchObjectException is thrown.
 
 3. Change the sentence:
 
    The unexportObject method is used a deregister a server object from
    the ORB runtimes, allowing the object to become available for 
    garbage collection.  
 
    to the sentences:
 
    The unexportObject method is used a deregister a currently exported
    server object from the ORB runtimes, allowing the object to become 
    available for garbage collection.  If the object is not currently 
    exported, a NoSuchObjectException is thrown.  
 

Resolution: Closed, accepted
Revised Text: 1. Change the paragraph:

   It is an error to call exportObject more than once for the same object.

   to the paragraph:

   It is an error to call exportObject on an object that is already
   exported.

2. Change the sentence in the description of toStub:

   The argument object must either be a subclass of PortableRemoteObject
   or have been previously the target of a call on
   PortableRemoteObject.exportObject.

   to the sentences:

   The argument object must currently be exported, either because it is
   a subclass of PortableRemoteObject or by virtue of a previous call
   to PortableRemoteObject.exportObject.  If the object is not currently
   exported, a NoSuchObjectException is thrown.

3. Change the sentence:

   The unexportObject method is used a deregister a server object from
   the ORB runtimes, allowing the object to become available for
   garbage collection.

   to the sentences:

   The unexportObject method is used to deregister a currently exported
   server object from the ORB runtimes, allowing the object to become
   available for garbage collection.  If the object is not currently
   exported, a NoSuchObjectException is thrown.
Actions taken:
February 22, 1999: received issue
June 4, 1999: closed issue
Discussion: 

End of Annotations:=====
Date: Mon, 22 Feb 1999 15:14:01 +0000
From: Simon Nash <nash@hursley.ibm.com>
Organization: IBM
To: issues <issues@omg.org>
CC: java2idl <java2idl-rtf@omg.org>
Subject: export/unexport errors not well specified

The text describing PortableRemoteObject does not describe the
possible error cases very completely or precisely.  I propose the
following changes:

1. Change the paragraph:

   It is an error to call exportObject more than once for the same
object.

   to the paragraph:

   It is an error to call exportObject on an object that is already
   exported.

2. Change the sentence in the description of toStub:
  
   The argument object must either be a subclass of
PortableRemoteObject
   or have been previously the target of a call on 
   PortableRemoteObject.exportObject.

   to the sentences:

   The argument object must currently be exported, either because it
is
   a subclass of PortableRemoteObject or by virtue of a previous call 
   to PortableRemoteObject.exportObject.  If the object is not
currently
   exported, a NoSuchObjectException is thrown.

3. Change the sentence:

   The unexportObject method is used a deregister a server object from
   the ORB runtimes, allowing the object to become available for 
   garbage collection.  

   to the sentences:

   The unexportObject method is used a deregister a currently exported
   server object from the ORB runtimes, allowing the object to become 
   available for garbage collection.  If the object is not currently 
   exported, a NoSuchObjectException is thrown.  


-- 
Simon C Nash, Technology Architect, IBM Java Technology Centre
Tel. +44-1962-815156   Fax +44-1962-818999    Hursley, England
Internet: nash@hursley.ibm.com   Lotus Notes: Simon Nash@ibmgb