Класс 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().

Поля, объявленные в классе javax.naming.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)`	Устанавливает поле "оставшееся новое имя" этого исключения.

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

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

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

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

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

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

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

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, у исключения нет сообщения об ошибке.

См. также:

CannotProceedException

public CannotProceedException()

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

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

getEnvironment

public Hashtable<?,?> getEnvironment()

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

Возвращает:

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

См. также:

setEnvironment

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

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

Параметры:

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

См. также:

getRemainingNewName

public Name getRemainingNewName()

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

Возвращает:

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

См. также:

setRemainingNewName

public void setRemainingNewName(Name newName)

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

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

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

Параметры:

newName - Возможная имя для установки поля "оставшееся новое имя". Если 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://download.java.net/java/early_access/jdk24/docs/api/java.naming/javax/naming/CannotProceedException.html