javax.naming

Class NamingException

public class NamingException extends Exception

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 NamingException), the part of the Name that could be resolved (including the Object it resolved to) and the part of the Name that could not be resolved when the exception occured.

Since: 1.3

Field Summary
protected NameremainingName
If the exception was caused while resolving a Name then this field contains that part of the name that could not be resolved.
protected NameresolvedName
If the exception was caused while resolving a Name then this field contains that part of the name that could be resolved.
protected ObjectresolvedObj
If the exception was caused while resolving a Name then this field contains the object that part of the name could be resolved to.
protected ThrowablerootException
The root cause of this exception.
Constructor Summary
NamingException()
Creates a new NamingException without a message.
NamingException(String msg)
Creates a new NamingException with a detailed message.
Method Summary
voidappendRemainingComponent(String name)
Adds the given String to the remainingName field.
voidappendRemainingName(Name name)
Adds the given Name to the remainingName field.
StringgetExplanation()
Gets the message given to the constructor or null if no message was given.
NamegetRemainingName()
Gets the part of the name that could not be resolved before this exception happend.
NamegetResolvedName()
Gets the part of the name that could be resolved before this exception happend.
ObjectgetResolvedObj()
Gets the Object to which (part of) the name could be resolved before this exception happend.
ThrowablegetRootCause()
Gets the root cause field rootException of this Exception.
voidprintStackTrace()
Prints the stacktrace of this exception or of the root cause if not null.
voidprintStackTrace(PrintStream ps)
Prints the stacktrace of this exception or of the root cause if not null to the given PrintStream.
voidprintStackTrace(PrintWriter pw)
Prints the stacktrace of this exception or of the root cause if not null to the given PrintWriter.
voidsetRemainingName(Name name)
Sets the part of the name that could be resolved before this exception happend.
voidsetResolvedName(Name name)
Sets the part of the name that could be resolved before this exception happend.
voidsetResolvedObj(Object o)
Sets the Object to which (part of) the name could be resolved before this exception happend.
voidsetRootCause(Throwable e)
Sets the root cause field rootException of this Exception.
StringtoString(boolean objectInfo)
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.
StringtoString()
Returns a string representation of this exception.

Field Detail

remainingName

protected Name remainingName
If the exception was caused while resolving a Name then this field contains that part of the name that could not be resolved. Field might be null. Set by calling setRemainingName(). The field can be extended by calling appendRemainingName() or appendRemainingComponent(). Can be accessed by calling getRemainingName.

resolvedName

protected Name resolvedName
If the exception was caused while resolving a Name then this field contains that part of the name that could be resolved. Field might be null. Set by calling setResolvedName(). Can be accessed by calling getResolvedName.

resolvedObj

protected Object resolvedObj
If the exception was caused while resolving a Name then this field contains the object that part of the name could be resolved to. Field might be null. Set by calling setResolvedObj(). Can be accessed by calling getResolvedObj.

rootException

protected Throwable rootException
The root cause of this exception. Might be null. Set by calling setRootCause(), can be accessed by calling getRootCause().

Constructor Detail

NamingException

public NamingException()
Creates a new NamingException without a message. Does not set any of the rootException, resolvedName, resolvedObj or remainingObject fields. These fields can be set later.

NamingException

public NamingException(String msg)
Creates a new NamingException with a detailed message. Does not set the rootException, resolvedName, resolvedObj or remainingObject, fields. These fields can be set later.

Method Detail

appendRemainingComponent

public void appendRemainingComponent(String name)
Adds the given String to the remainingName field. Does nothing when name is null or when a InvalidNameException is thrown when adding the component.

See Also: add

appendRemainingName

public void appendRemainingName(Name name)
Adds the given Name to the remainingName field. Does nothing when name is null or when a InvalidNameException is thrown when adding the name.

See Also: addAll

getExplanation

public String getExplanation()
Gets the message given to the constructor or null if no message was given.

See Also: getMessage

getRemainingName

public Name getRemainingName()
Gets the part of the name that could not be resolved before this exception happend. Returns the remainingName field of this Exception.

getResolvedName

public Name getResolvedName()
Gets the part of the name that could be resolved before this exception happend. Returns the resolvedName field of this Exception.

getResolvedObj

public Object getResolvedObj()
Gets the Object to which (part of) the name could be resolved before this exception happend. Returns the resolvedObj field of this Exception.

getRootCause

public Throwable getRootCause()
Gets the root cause field rootException of this Exception.

printStackTrace

public void printStackTrace()
Prints the stacktrace of this exception or of the root cause if not null.

printStackTrace

public void printStackTrace(PrintStream ps)
Prints the stacktrace of this exception or of the root cause if not null to the given PrintStream.

printStackTrace

public void printStackTrace(PrintWriter pw)
Prints the stacktrace of this exception or of the root cause if not null to the given PrintWriter.

setRemainingName

public void setRemainingName(Name name)
Sets the part of the name that could be resolved before this exception happend. Sets the resolvedName field of this Exception. The field can be extended by calling appendRemainingName() or appendRemainingComponent().

setResolvedName

public void setResolvedName(Name name)
Sets the part of the name that could be resolved before this exception happend. Sets the resolvedName field of this Exception.

setResolvedObj

public void setResolvedObj(Object o)
Sets the Object to which (part of) the name could be resolved before this exception happend. Sets the resolvedObj field of this Exception.

setRootCause

public void setRootCause(Throwable e)
Sets the root cause field rootException of this Exception.

toString

public String toString(boolean objectInfo)
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.

toString

public String toString()
Returns a string representation of this exception. Calls toString(false).