diff options
Diffstat (limited to 'libjava/javax/naming/NamingException.java')
| -rw-r--r-- | libjava/javax/naming/NamingException.java | 315 |
1 files changed, 0 insertions, 315 deletions
diff --git a/libjava/javax/naming/NamingException.java b/libjava/javax/naming/NamingException.java deleted file mode 100644 index ad39233..0000000 --- a/libjava/javax/naming/NamingException.java +++ /dev/null @@ -1,315 +0,0 @@ -/* NamingException.java -- Superclass of all naming Exceptions - Copyright (C) 2000, 2001 Free Software Foundation, Inc. - -This file is part of GNU Classpath. - -GNU Classpath is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2, or (at your option) -any later version. - -GNU Classpath 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 for more details. - -You should have received a copy of the GNU General Public License -along with GNU Classpath; see the file COPYING. If not, write to the -Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA -02110-1301 USA. - -Linking this library statically or dynamically with other modules is -making a combined work based on this library. Thus, the terms and -conditions of the GNU General Public License cover the whole -combination. - -As a special exception, the copyright holders of this library give you -permission to link this library with independent modules to produce an -executable, regardless of the license terms of these independent -modules, and to copy and distribute the resulting executable under -terms of your choice, provided that you also meet, for each linked -independent module, the terms and conditions of the license of that -module. An independent module is a module which is not derived from -or based on this library. If you modify this library, you may extend -this exception to your version of the library, but you are not -obligated to do so. If you do not wish to do so, delete this -exception statement from your version. */ - -package javax.naming; - -import java.io.PrintStream; -import java.io.PrintWriter; - -/** - * Superclass of all naming Exceptions. - * Can contain extra information about the root cause of this exception - * (for example when the original exception was not a subclass of - * <code>NamingException</code>), the part of the <code>Name</code> that - * could be resolved (including the <code>Object</code> it resolved to) - * and the part of the <code>Name</code> that could not be resolved when - * the exception occured. - * - * @since 1.3 - * @author Anthony Green (green@redhat.com) - * @author Mark Wielaard (mark@klomp.org) - */ -public class NamingException extends Exception -{ - private static final long serialVersionUID = -1299181962103167177L; - - /** - * The root cause of this exception. Might be null. Set by calling - * <code>setRootCause()</code>, can be accessed by calling - * <code>getRootCause()</code>. - */ - protected Throwable rootException; - - /** - * If the exception was caused while resolving a <code>Name</code> then - * this field contains that part of the name that could be resolved. - * Field might be null. Set by calling <code>setResolvedName()</code>. - * Can be accessed by calling <code>getResolvedName</code>. - */ - protected Name resolvedName; - - /** - * If the exception was caused while resolving a <code>Name</code> then - * this field contains the object that part of the name could be resolved to. - * Field might be null. Set by calling <code>setResolvedObj()</code>. - * Can be accessed by calling <code>getResolvedObj</code>. - */ - protected Object resolvedObj; - - /** - * If the exception was caused while resolving a <code>Name</code> then - * this field contains that part of the name that could not be resolved. - * Field might be null. Set by calling <code>setRemainingName()</code>. - * The field can be extended by calling <code>appendRemainingName()</code> - * or <code>appendRemainingComponent()</code>. - * Can be accessed by calling <code>getRemainingName</code>. - */ - protected Name remainingName; - - /** - * Creates a new NamingException without a message. Does not set any of the - * <code>rootException</code>, <code>resolvedName</code>, - * <code>resolvedObj</code> or <code>remainingObject</code> fields. - * These fields can be set later. - */ - public NamingException () - { - super(); - } - - /** - * Creates a new NamingException with a detailed message. Does not set - * the <code>rootException</code>, <code>resolvedName</code>, - * <code>resolvedObj</code> or <code>remainingObject,</code> fields. - * These fields can be set later. - */ - public NamingException (String msg) - { - super(msg); - } - - /** - * Gets the root cause field <code>rootException</code> of this Exception. - */ - public Throwable getRootCause () - { - return rootException; - } - - /** - * Sets the root cause field <code>rootException</code> of this Exception. - */ - public void setRootCause (Throwable e) - { - rootException = e; - } - - /** - * Gets the part of the name that could be resolved before this exception - * happend. Returns the <code>resolvedName</code> field of this Exception. - */ - public Name getResolvedName () - { - return resolvedName; - } - - /** - * Sets the part of the name that could be resolved before this exception - * happend. Sets the <code>resolvedName</code> field of this Exception. - */ - public void setResolvedName (Name name) - { - resolvedName = name; - } - - /** - * Gets the Object to which (part of) the name could be resolved before this - * exception happend. Returns the <code>resolvedObj</code> field of this - * Exception. - */ - public Object getResolvedObj () - { - return resolvedObj; - } - - /** - * Sets the Object to which (part of) the name could be resolved before this - * exception happend. Sets the <code>resolvedObj</code> field of this - * Exception. - */ - public void setResolvedObj (Object o) - { - resolvedObj = o; - } - - /** - * Gets the part of the name that could not be resolved before this exception - * happend. Returns the <code>remainingName</code> field of this Exception. - */ - public Name getRemainingName () - { - return remainingName; - } - - /** - * Sets the part of the name that could be resolved before this exception - * happend. Sets the <code>resolvedName</code> field of this Exception. - * The field can be extended by calling <code>appendRemainingName()</code> - * or <code>appendRemainingComponent()</code>. - */ - public void setRemainingName (Name name) - { - remainingName = name; - } - - /** - * Adds the given <code>Name</code> to the <code>remainingName</code> field. - * Does nothing when <code>name</code> is null or when a - * <code>InvalidNameException</code> is thrown when adding the name. - * - * @see Name#addAll(Name) - */ - public void appendRemainingName (Name name) - { - if (name != null) - try - { - remainingName.addAll(name); - } - catch(InvalidNameException ine) { /* ignored */ } - } - - /** - * Adds the given <code>String</code> to the <code>remainingName</code> field. - * Does nothing when <code>name</code> is null or when a - * <code>InvalidNameException</code> is thrown when adding the component. - * - * @see Name#add(String) - */ - public void appendRemainingComponent (String name) - { - if (name != null) - try - { - remainingName.add(name); - } - catch(InvalidNameException ine) { /* ignored */ } - } - - /** - * Gets the message given to the constructor or null if no message was given. - * - * @see Throwable#getMessage(); - */ - public String getExplanation() - { - return getMessage(); - } - - /** - * Returns a String representation of this exception and possibly including - * the part object that could be resolved if the given flag is set to true. - * Always includes the root cause and the remaining name if not null. - */ - public String toString(boolean objectInfo) - { - StringBuffer sb = new StringBuffer(super.toString()); - Throwable cause = getRootCause(); - if (cause != null) - { - sb.append(" caused by "); - sb.append(cause); - } - Name remaining = getRemainingName(); - if (remaining != null) - { - sb.append(" [remainingName: "); - sb.append(remaining); - } - Object resolved = getResolvedObj(); - if (objectInfo && resolved != null) - { - if (remainingName == null) - sb.append(" ["); - else - sb.append(", "); - sb.append("resolvedObj: "); - sb.append(resolved); - } - if ((remaining != null) || (objectInfo && resolved != null)) - sb.append(']'); - - return sb.toString(); - } - - /** - * Returns a string representation of this exception. - * Calls <code>toString(false)</code>. - */ - public String toString() - { - return toString(false); - } - /** - * Prints the stacktrace of this exception or of the root cause if not null. - */ - public void printStackTrace() - { - Throwable cause = getRootCause(); - if (cause != null) - cause.printStackTrace(); - else - super.printStackTrace(); - } - - /** - * Prints the stacktrace of this exception or of the root cause if not null - * to the given <code>PrintStream</code>. - */ - public void printStackTrace(PrintStream ps) - { - Throwable cause = getRootCause(); - if (cause != null) - cause.printStackTrace(ps); - else - super.printStackTrace(ps); - } - - /** - * Prints the stacktrace of this exception or of the root cause if not null - * to the given <code>PrintWriter</code>. - */ - public void printStackTrace(PrintWriter pw) - { - Throwable cause = getRootCause(); - if (cause != null) - cause.printStackTrace(pw); - else - super.printStackTrace(pw); - } -} - |