duke@1: /* ohair@158: * Copyright (c) 1995, 2006, Oracle and/or its affiliates. All rights reserved. duke@1: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. duke@1: * duke@1: * This code is free software; you can redistribute it and/or modify it duke@1: * under the terms of the GNU General Public License version 2 only, as ohair@158: * published by the Free Software Foundation. Oracle designates this duke@1: * particular file as subject to the "Classpath" exception as provided ohair@158: * by Oracle in the LICENSE file that accompanied this code. duke@1: * duke@1: * This code is distributed in the hope that it will be useful, but WITHOUT duke@1: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or duke@1: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License duke@1: * version 2 for more details (a copy is included in the LICENSE file that duke@1: * accompanied this code). duke@1: * duke@1: * You should have received a copy of the GNU General Public License version duke@1: * 2 along with this work; if not, write to the Free Software Foundation, duke@1: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. duke@1: * ohair@158: * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA ohair@158: * or visit www.oracle.com if you need additional information or have any ohair@158: * questions. duke@1: */ duke@1: duke@1: package org.omg.CORBA; duke@1: duke@1: /** duke@1: * Exception thrown duke@1: * when a parameter passed to a call is out of range or duke@1: * otherwise considered illegal. An ORB may raise this exception duke@1: * if null values or null pointers are passed to an operation (for duke@1: * language mappings where the concept of a null pointers or null duke@1: * values applies). BAD_PARAM can also be raised as a result of a duke@1: * client generating requests with incorrect parameters using the DII.
duke@1: * It contains a minor code, which gives more detailed information about
duke@1: * what caused the exception, and a completion status. It may also contain
duke@1: * a string describing the exception.
duke@1: *
duke@1: * @see documentation on
duke@1: * Java IDL exceptions
duke@1: * @see meaning of
duke@1: * minor codes
duke@1: * @since JDK1.2
duke@1: */
duke@1:
duke@1: public final class BAD_PARAM extends SystemException {
duke@1:
duke@1: /**
duke@1: * Constructs a BAD_PARAM
exception with a default
duke@1: * minor code of 0 and a completion state of COMPLETED_NO.
duke@1: */
duke@1: public BAD_PARAM() {
duke@1: this("");
duke@1: }
duke@1:
duke@1: /**
duke@1: * Constructs a BAD_PARAM
exception with the specified detail
duke@1: * message, a minor code of 0, and a completion state of COMPLETED_NO.
duke@1: *
duke@1: * @param s the String containing a detail message describing this
duke@1: * exception
duke@1: */
duke@1: public BAD_PARAM(String s) {
duke@1: this(s, 0, CompletionStatus.COMPLETED_NO);
duke@1: }
duke@1:
duke@1: /**
duke@1: * Constructs a BAD_PARAM
exception with the specified
duke@1: * minor code and completion status.
duke@1: * @param minor the minor code
duke@1: * @param completed the completion status
duke@1: */
duke@1: public BAD_PARAM(int minor, CompletionStatus completed) {
duke@1: this("", minor, completed);
duke@1: }
duke@1:
duke@1: /**
duke@1: * Constructs a BAD_PARAM
exception with the specified detail
duke@1: * message, minor code, and completion status.
duke@1: * A detail message is a String
that describes
duke@1: * this particular exception.
duke@1: *
duke@1: * @param s the String
containing a detail message
duke@1: * @param minor the minor code
duke@1: * @param completed the completion status
duke@1: */
duke@1: public BAD_PARAM(String s, int minor, CompletionStatus completed) {
duke@1: super(s, minor, completed);
duke@1: }
duke@1: }