Класс 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`	Содержит оставшуюся неразрешённую часть второго аргумента «имя» метода Context.rename().

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

remainingName, resolvedName, resolvedObj, rootException

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

Конструктор	Описание
`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

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

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

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

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

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

remainingNewName

protected Name remainingNewName

Содержит оставшуюся неразрешённую часть второго аргумента «имя» метода 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.naming/javax/naming/CannotProceedException.html