Класс CannotProceedException

java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - javax.naming.NamingException
    - - 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

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

См. также:: getAltName(), setAltName(javax.naming.Name), altNameCtx, ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)

altNameCtx

protected Context altNameCtx

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

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

См. также:: getAltNameCtx(), setAltNameCtx(javax.naming.Context), altName, ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)

Конструкторы

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()

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

Возвращает:: Возможная часть нового имени, которая не была разрешена. Это составное имя. Может быть 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(javax.naming.Name), getAltNameCtx(), ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)

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(javax.naming.Context), getAltName(), ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable<?, ?>)

setAltNameCtx

public void setAltNameCtx(Context altNameCtx)

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

Параметры:: altNameCtx - Контекст, относительно которого altName имеет имя. Если null, то подразумевается контекст по умолчанию.
См. также:: getAltNameCtx(), setAltName(javax.naming.Name)

© 1993, 2020, 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.