Класс CannotProceedException

javax.naming.CannotProceedException

Все реализованные интерфейсы:: Serializable

public class CannotProceedException extends NamingException

Это исключение выбрасывается, чтобы указать, что операция достигла точки в имени, после которой она не может продолжаться. При выполнении операции над составным именем поставщик службы именования может достичь части имени, не принадлежащей его пространству имен. В этом случае он может создать CannotProceedException, а затем вызвать методы, предоставляемые javax.naming.spi.NamingManager (например, getContinuationContext()), чтобы найти другого поставщика для продолжения операции. Если это невозможно, исключение передается вызывающему коду операции контекста.

Если программе необходимо обработать именно это исключение, следует явно перехватить CannotProceedException до попытки перехватить NamingException.

Экземпляр CannotProceedException не синхронизирован для конкурентного многопоточного доступа. Потоки, пытающиеся получить доступ к CannotProceedException и изменить его, должны блокировать объект.

Начиная с версии:

1.3

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected Name`	`altName`	Содержит имя разрешенного объекта относительно контекста `altNameCtx`.
`protected Context`	`altNameCtx`	Содержит контекст, относительно которого указано `altName`.
`protected Hashtable<?,?>`	`environment`	Содержит среду, относящуюся к методу Context или DirContext, который не может продолжиться.
`protected Name`	`remainingNewName`	Содержит оставшуюся неразрешенную часть второго аргумента «name» метода Context.rename().

Поля, объявленные в классе NamingException

remainingName, resolvedName, resolvedObj, rootException

Модификатор и тип	Поле	Описание
`protected Name`	`remainingName`	Содержит оставшуюся часть имени, которая еще не была разрешена.
`protected Name`	`resolvedName`	Содержит часть имени, которая была успешно разрешена.
`protected Object`	`resolvedObj`	Содержит объект, разрешение имени которого завершилось успешно.
`protected Throwable`	`rootException`	Содержит исходное исключение, вызвавшее выброс этого NamingException.

Краткое описание конструкторов

Конструктор	Описание
`CannotProceedException()`	Создает новый экземпляр CannotProceedException.
`CannotProceedException(String explanation)`	Создает новый экземпляр CannotProceedException с пояснением.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Name`	`getAltName()`	Возвращает поле `altName` этого исключения.
`Context`	`getAltNameCtx()`	Возвращает поле `altNameCtx` этого исключения.
`Hashtable<?,?>`	`getEnvironment()`	Возвращает среду, действовавшую на момент создания этого исключения.
`Name`	`getRemainingNewName()`	Возвращает поле «оставшееся новое имя» этого исключения, используемое, когда это исключение выбрасывается во время операции rename().
`void`	`setAltName(Name altName)`	Задает поле `altName` этого исключения.
`void`	`setAltNameCtx(Context altNameCtx)`	Задает поле `altNameCtx` этого исключения.
`void`	`setEnvironment(Hashtable<?,?> environment)`	Задает среду, которая будет возвращена при вызове getEnvironment().
`void`	`setRemainingNewName(Name newName)`	Задает поле «оставшееся новое имя» этого исключения.

Методы, объявленные в классе NamingException

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString

Модификатор и тип	Метод	Описание
`void`	`appendRemainingComponent(String name)`	Добавляет имя в качестве последнего компонента оставшегося имени.
`void`	`appendRemainingName(Name name)`	Добавляет компоненты из 'name' в качестве последних компонентов оставшегося имени.
`Throwable`	`getCause()`	Возвращает причину этого исключения.
`String`	`getExplanation()`	Возвращает пояснение, связанное с этим исключением.
`Name`	`getRemainingName()`	Возвращает оставшуюся неразрешенную часть имени.
`Name`	`getResolvedName()`	Возвращает начальную часть имени, которая была успешно разрешена.
`Object`	`getResolvedObj()`	Возвращает объект, разрешение имени которого завершилось успешно.
`Throwable`	`getRootCause()`	Возвращает корневую причину этого NamingException, если она есть.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину этого исключения указанным значением.
`void`	`setRemainingName(Name name)`	Задает поле оставшегося имени этого исключения.
`void`	`setResolvedName(Name name)`	Задает поле разрешенного имени этого исключения.
`void`	`setResolvedObj(Object obj)`	Задает поле разрешенного объекта этого исключения.
`void`	`setRootCause(Throwable e)`	Записывает корневую причину этого NamingException.
`String`	`toString()`	Формирует строковое представление этого исключения.
`String`	`toString(boolean detail)`	Формирует более подробное строковое представление.

Методы, объявленные в классе Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, подавленным при передаче этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`String`	`getLocalizedMessage()`	Создает локализованное описание этого объекта throwable.
`String`	`getMessage()`	Возвращает строку подробного сообщения этого объекта throwable.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к сведениям о трассировке стека, выводимым методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`-with-resources, при передаче этого исключения.
`void`	`printStackTrace()`	Выводит этот объект throwable и трассировку его стека в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит этот объект throwable и трассировку его стека в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит этот объект throwable и трассировку его стека в указанный объект печати.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задает элементы трассировки стека, которые будут возвращены методом `Throwable.getStackTrace()` и выведены методами `Throwable.printStackTrace()` и связанными с ним методами.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание полей

remainingNewName

protected Name remainingNewName

Содержит оставшуюся неразрешенную часть второго аргумента «name» метода Context.rename(). Эта информация необходима для продолжения операции Context.rename().

Это поле инициализируется значением null. Не следует изменять его напрямую: для доступа к нему и его обновления используйте getRemainingName() и setRemainingName().

См. также:

environment

protected Hashtable<?,?> environment

Содержит среду, относящуюся к методу Context или DirContext, который не может продолжиться.

Это поле инициализируется значением null. Не следует изменять его напрямую: для доступа к нему и его обновления используйте getEnvironment() и setEnvironment().

См. также:

altName

protected Name altName

Содержит имя разрешенного объекта относительно контекста altNameCtx. Это составное имя. Если значение равно null, имя не указано. Подробные сведения об использовании см. в методе javax.naming.spi.ObjectFactory.getObjectInstance.

Это поле инициализируется значением null. Не следует изменять его напрямую: для доступа к нему и его обновления используйте getAltName() и setAltName().

См. также:

altNameCtx

protected Context altNameCtx

Содержит контекст, относительно которого указано altName. Если значение равно null, подразумевается контекст начальной инициализации по умолчанию. Подробные сведения об использовании см. в методе javax.naming.spi.ObjectFactory.getObjectInstance.

Это поле инициализируется значением null. Не следует изменять его напрямую: для доступа к нему и его обновления используйте getAltNameCtx() и setAltNameCtx().

См. также:

Подробное описание конструкторов

CannotProceedException

public CannotProceedException(String explanation)

Создает новый экземпляр CannotProceedException с пояснением. Все неуказанные поля по умолчанию имеют значение null.

Параметры:

explanation — строка, возможно null, содержащая дополнительные сведения об этом исключении. Если значение равно null, у исключения нет подробного сообщения.

См. также:

CannotProceedException

public CannotProceedException()

Создает новый экземпляр CannotProceedException. Все поля по умолчанию имеют значение null.

Подробное описание методов

getEnvironment

public Hashtable<?,?> getEnvironment()

Возвращает среду, действовавшую на момент создания этого исключения.

Возвращает:

Набор свойств среды, возможно null. Значение null означает, что для этого исключения среда не записывалась.

См. также:

setEnvironment

public void setEnvironment(Hashtable<?,?> environment)

Задает среду, которая будет возвращена при вызове getEnvironment().

Параметры:

environment — набор свойств среды, возможно null. Значение null означает, что для этого исключения среда не записывается.

См. также:

getRemainingNewName

public Name getRemainingNewName()

Возвращает поле «оставшееся новое имя» этого исключения, используемое, когда это исключение выбрасывается во время операции rename().

Возвращает:

Возможно null часть нового имени, которая еще не была разрешена. Это составное имя. Значение может быть null, что означает, что поле оставшегося нового имени не задано.

См. также:

setRemainingNewName

public void setRemainingNewName(Name newName)

Задает поле «оставшееся новое имя» этого исключения. Это значение возвращается методом getRemainingNewName().

newName — составное имя. Если это поле нужно задать с помощью составного имени или строки, необходимо преобразовать составное имя в строку и создать составное имя с одним компонентом, используя эту строку. Затем можно вызвать этот метод с полученным составным именем.

Создается и сохраняется копия newName. Последующие изменения name не влияют на копию в этом NamingException, и наоборот.

Параметры:

newName — имя, возможно null, которое нужно задать в качестве «оставшегося нового имени». Если значение равно null, поле оставшегося имени устанавливается в null.

См. также:

getAltName

public Name getAltName()

Возвращает поле altName этого исключения. Это имя разрешенного объекта относительно контекста altNameCtx. Оно будет использовано при последующем вызове метода javax.naming.spi.ObjectFactory.getObjectInstance.

Возвращает:

Имя разрешенного объекта относительно altNameCtx. Это составное имя. Если значение равно null, имя не указано.

См. также:

setAltName

public void setAltName(Name altName)

Задает поле altName этого исключения.

Параметры:

altName — имя разрешенного объекта относительно altNameCtx. Это составное имя. Если значение равно null, имя не указано.

См. также:

getAltNameCtx

public Context getAltNameCtx()

Возвращает поле altNameCtx этого исключения. Это контекст, относительно которого именуется altName. Он будет использован при последующем вызове метода javax.naming.spi.ObjectFactory.getObjectInstance.

Возвращает:

Контекст, относительно которого именуется altName. Если значение равно null, подразумевается контекст начальной инициализации по умолчанию.

См. также:

setAltNameCtx

public void setAltNameCtx(Context altNameCtx)

Задает поле altNameCtx этого исключения.

Параметры:

altNameCtx — контекст, относительно которого именуется altName. Если значение равно null, подразумевается контекст начальной инициализации по умолчанию.

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.