< prev index next >

src/java.corba/share/classes/org/omg/CORBA/INV_OBJREF.java

Print this page




  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package org.omg.CORBA;
  27 
  28 /**
  29  * This exception indicates that an object reference is internally
  30  * malformed. For example, the repository ID may have incorrect
  31  * syntax or the addressing information may be invalid. This
  32  * exception is raised by ORB::string_to_object if the passed
  33  * string does not decode correctly. An ORB may choose to detect
  34  * calls via nil references (but is not obliged to do detect them).
  35  * <tt>INV_OBJREF</tt> is used to indicate this.<P>
  36  * It contains a minor code, which gives more detailed information about
  37  * what caused the exception, and a completion status. It may also contain
  38  * a string describing the exception.
  39  * <P>
  40  * See the section <A href="../../../../technotes/guides/idl/jidlExceptions.html#minorcodemeanings">Minor
  41  * Code Meanings</A> to see the minor codes for this exception.
  42  *
  43  * @see <A href="../../../../technotes/guides/idl/jidlExceptions.html">documentation on
  44  * Java&nbsp;IDL exceptions</A>
  45  * @since       JDK1.2
  46  */
  47 
  48 public final class INV_OBJREF extends SystemException {
  49     /**
  50      * Constructs an <code>INV_OBJREF</code> exception with a default
  51      * minor code of 0 and a completion state of COMPLETED_NO.
  52      */
  53     public INV_OBJREF() {
  54         this("");
  55     }
  56 
  57     /**
  58      * Constructs an <code>INV_OBJREF</code> exception with the specified detail
  59      * message, a minor code of 0, and a completion state of COMPLETED_NO.
  60      * @param s the String containing a detail message
  61      */
  62     public INV_OBJREF(String s) {
  63         this(s, 0, CompletionStatus.COMPLETED_NO);
  64     }
  65 
  66     /**
  67      * Constructs an <code>INV_OBJREF</code> exception with the specified
  68      * minor code and completion status.
  69      * @param minor the minor code
  70      * @param completed a <code>CompletionStatus</code> instance indicating
  71      *                  the completion status
  72      */
  73     public INV_OBJREF(int minor, CompletionStatus completed) {
  74         this("", minor, completed);
  75     }
  76 
  77     /**
  78      * Constructs an <code>INV_OBJREF</code> exception with the specified detail
  79      * message, minor code, and completion status.
  80      * A detail message is a String that describes this particular exception.
  81      * @param s the String containing a detail message
  82      * @param minor the minor code
  83      * @param completed a <code>CompletionStatus</code> instance indicating
  84      *                  the completion status
  85      */
  86     public INV_OBJREF(String s, int minor, CompletionStatus completed) {
  87         super(s, minor, completed);
  88     }
  89 }


  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package org.omg.CORBA;
  27 
  28 /**
  29  * This exception indicates that an object reference is internally
  30  * malformed. For example, the repository ID may have incorrect
  31  * syntax or the addressing information may be invalid. This
  32  * exception is raised by ORB::string_to_object if the passed
  33  * string does not decode correctly. An ORB may choose to detect
  34  * calls via nil references (but is not obliged to do detect them).
  35  * {@code INV_OBJREF} is used to indicate this.<P>
  36  * It contains a minor code, which gives more detailed information about
  37  * what caused the exception, and a completion status. It may also contain
  38  * a string describing the exception.
  39  * <P>
  40  * See the section <A href="../../../../technotes/guides/idl/jidlExceptions.html#minorcodemeanings">Minor
  41  * Code Meanings</A> to see the minor codes for this exception.
  42  *
  43  * @see <A href="../../../../technotes/guides/idl/jidlExceptions.html">documentation on
  44  * Java&nbsp;IDL exceptions</A>
  45  * @since       JDK1.2
  46  */
  47 
  48 public final class INV_OBJREF extends SystemException {
  49     /**
  50      * Constructs an {@code INV_OBJREF} exception with a default
  51      * minor code of 0 and a completion state of COMPLETED_NO.
  52      */
  53     public INV_OBJREF() {
  54         this("");
  55     }
  56 
  57     /**
  58      * Constructs an {@code INV_OBJREF} exception with the specified detail
  59      * message, a minor code of 0, and a completion state of COMPLETED_NO.
  60      * @param s the String containing a detail message
  61      */
  62     public INV_OBJREF(String s) {
  63         this(s, 0, CompletionStatus.COMPLETED_NO);
  64     }
  65 
  66     /**
  67      * Constructs an {@code INV_OBJREF} exception with the specified
  68      * minor code and completion status.
  69      * @param minor the minor code
  70      * @param completed a {@code CompletionStatus} instance indicating
  71      *                  the completion status
  72      */
  73     public INV_OBJREF(int minor, CompletionStatus completed) {
  74         this("", minor, completed);
  75     }
  76 
  77     /**
  78      * Constructs an {@code INV_OBJREF} exception with the specified detail
  79      * message, minor code, and completion status.
  80      * A detail message is a String that describes this particular exception.
  81      * @param s the String containing a detail message
  82      * @param minor the minor code
  83      * @param completed a {@code CompletionStatus} instance indicating
  84      *                  the completion status
  85      */
  86     public INV_OBJREF(String s, int minor, CompletionStatus completed) {
  87         super(s, minor, completed);
  88     }
  89 }
< prev index next >