This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.


javax.naming
exception CannotProceedException

java.lang.Object extended by java.lang.Throwable extended by java.lang.Exception extended by javax.naming.NamingException extended by javax.naming.CannotProceedException
All Implemented Interfaces:
Serializable

Most common way to construct:

CannotProceedException cpe = new CannotProceedException();

Based on 14 examples


public exception CannotProceedException
extends NamingException

This exception is thrown to indicate that the operation reached a point in the name where the operation cannot proceed any further. When performing an operation on a composite name, a naming service provider may reach a part of the name that does not belong to its namespace. At that point, it can construct a CannotProceedException and then invoke methods provided by javax.naming.spi.NamingManager (such as getContinuationContext()) to locate another provider to continue the operation. If this is not possible, this exception is raised to the caller of the context operation.

If the program wants to handle this exception in particular, it should catch CannotProceedException explicitly before attempting to catch NamingException.

A CannotProceedException instance is not synchronized against concurrent multithreaded access. Multiple threads trying to access and modify CannotProceedException should lock the object.


Field Summary
protected Name altName
          Contains the name of the resolved object, relative to the context altNameCtx.
protected Context altNameCtx
          Contains the context relative to which altName is specified.
protected Hashtable environment
          Contains the environment relevant for the Context or DirContext method that cannot proceed.
protected Name remainingNewName
          Contains the remaining unresolved part of the second "name" argument to Context.rename().
 
Fields inherited from class javax.naming.NamingException
remainingName, resolvedName, resolvedObj, rootException
 
Constructor Summary

          Constructs a new instance of CannotProceedException.

          Constructs a new instance of CannotProceedException using an explanation.
 
Method Summary
 Name

          Retrieves the altName field of this exception.
 Context

          Retrieves the altNameCtx field of this exception.
 Hashtable

          Retrieves the environment that was in effect when this exception was created.
 Name

          Retrieves the "remaining new name" field of this exception, which is used when this exception is thrown during a rename() operation.
 void
setAltName(Name altName)

          Sets the altName field of this exception.
 void
setAltNameCtx(Context altNameCtx)

          Sets the altNameCtx field of this exception.
 void

          Sets the environment that will be returned when getEnvironment() is called.
 void

          Sets the "remaining new name" field of this exception.
 
Methods inherited from class javax.naming.NamingException
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

altName

protected Name altName
Contains the name of the resolved object, relative to the context altNameCtx. It is a composite name. If null, then no name is specified. See the javax.naming.spi.ObjectFactory.getObjectInstance method for details on how this is used.

This field is initialized to null. It should not be manipulated directly: it should be accessed and updated using getAltName() and setAltName().


altNameCtx

protected Context altNameCtx
Contains the context relative to which altName is specified. If null, then the default initial context is implied. See the javax.naming.spi.ObjectFactory.getObjectInstance method for details on how this is used.

This field is initialized to null. It should not be manipulated directly: it should be accessed and updated using getAltNameCtx() and setAltNameCtx().


environment

protected Hashtable environment
Contains the environment relevant for the Context or DirContext method that cannot proceed.

This field is initialized to null. It should not be manipulated directly: it should be accessed and updated using getEnvironment() and setEnvironment().


remainingNewName

protected Name remainingNewName
Contains the remaining unresolved part of the second "name" argument to Context.rename(). This information necessary for continuing the Context.rename() operation.

This field is initialized to null. It should not be manipulated directly: it should be accessed and updated using getRemainingName() and setRemainingName().

Constructor Detail

CannotProceedException

public CannotProceedException()
Constructs a new instance of CannotProceedException. All fields default to null.


CannotProceedException

public CannotProceedException(String explanation)
Constructs a new instance of CannotProceedException using an explanation. All unspecified fields default to null.

Parameters:
explanation - A possibly null string containing additional detail about this exception. If null, this exception has no detail message.
Method Detail

getAltName

public Name getAltName()
Retrieves the altName field of this exception. This is the name of the resolved object, relative to the context altNameCtx. It will be used during a subsequent call to the javax.naming.spi.ObjectFactory.getObjectInstance method.

Returns:
The name of the resolved object, relative to altNameCtx. It is a composite name. If null, then no name is specified.

getAltNameCtx

public Context getAltNameCtx()
Retrieves the altNameCtx field of this exception. This is the context relative to which altName is named. It will be used during a subsequent call to the javax.naming.spi.ObjectFactory.getObjectInstance method.

Returns:
The context relative to which altName is named. If null, then the default initial context is implied.

getEnvironment

public Hashtable getEnvironment()
Retrieves the environment that was in effect when this exception was created.

Returns:
Possibly null environment property set. null means no environment was recorded for this exception.

getRemainingNewName

public Name getRemainingNewName()
Retrieves the "remaining new name" field of this exception, which is used when this exception is thrown during a rename() operation.

Returns:
The possibly null part of the new name that has not been resolved. It is a composite name. It can be null, which means the remaining new name field has not been set.

setAltName

public void setAltName(Name altName)
Sets the altName field of this exception.

Parameters:
altName - The name of the resolved object, relative to altNameCtx. It is a composite name. If null, then no name is specified.

setAltNameCtx

public void setAltNameCtx(Context altNameCtx)
Sets the altNameCtx field of this exception.

Parameters:
altNameCtx - The context relative to which altName is named. If null, then the default initial context is implied.

setEnvironment

public void setEnvironment(Hashtable environment)
Sets the environment that will be returned when getEnvironment() is called.

Parameters:
environment - A possibly null environment property set. null means no environment is being recorded for this exception.

setRemainingNewName

public void setRemainingNewName(Name newName)
Sets the "remaining new name" field of this exception. This is the value returned by getRemainingNewName().

newName is a composite name. If the intent is to set this field using a compound name or string, you must "stringify" the compound name, and create a composite name with a single component using the string. You can then invoke this method using the resulting composite name.

A copy of newName is made and stored. Subsequent changes to name does not affect the copy in this NamingException and vice versa.

Parameters:
newName - The possibly null name to set the "remaining new name" to. If null, it sets the remaining name field to null.


This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
This page displays the Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.