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

Поля, объявленные в классе 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

Содержит оставшуюся неразрешённую часть второго аргумента "имя" для 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, что означает, что поле оставшегося нового имени не было установлено.

См. также:

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, 2023, 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/21/docs/api/java.naming/javax/naming/CannotProceedException.html