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

См. также:

getRemainingNewName()
setRemainingNewName(javax.naming.Name)

environment

protected Hashtable<?,?> environment

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

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

См. также:

getEnvironment()
setEnvironment(java.util.Hashtable<?, ?>)

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

См. также:

Throwable.getMessage()

CannotProceedException

public CannotProceedException()

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

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

getEnvironment

public Hashtable<?,?> getEnvironment()

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

Возвращает:

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

См. также:

setEnvironment(java.util.Hashtable<?, ?>)

setEnvironment

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

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

Параметры:

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

См. также:

getEnvironment()

getRemainingNewName

public Name getRemainingNewName()

Возвращает поле «оставшееся новое имя» этой ошибки, которое используется при возникновении этой ошибки во время операции переименования.

Возвращает:

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

См. также:

setRemainingNewName(javax.naming.Name)

setRemainingNewName

public void setRemainingNewName(Name newName)

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

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

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

Параметры:

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

См. также:

getRemainingNewName()

getAltName

public Name getAltName()

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

Возвращает:

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

См. также:

setAltName

public void setAltName(Name altName)

Устанавливает поле altName этой ошибки.

Параметры:

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

См. также:

getAltName()
setAltNameCtx(javax.naming.Context)

getAltNameCtx

public Context getAltNameCtx()

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

Возвращает:

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

См. также:

setAltNameCtx

public void setAltNameCtx(Context altNameCtx)

Устанавливает поле altNameCtx этой ошибки.

Параметры:

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

См. также:

getAltNameCtx()
setAltName(javax.naming.Name)

© 1993, 2021, 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/17/docs/api/java.naming/javax/naming/CannotProceedException.html