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

Содержит оставшуюся неразрешённую часть второго аргумента «name» для 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, содержащая дополнительные детали об этой ошибке. Если null, у этой ошибки нет сообщения об ошибке.
См. также:
Throwable.getMessage()

CannotProceedException

public CannotProceedException()

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

Методы

getEnvironment

public Hashtable<?,?> getEnvironment()

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

Возвращает:
Возможный набор свойств среды null. null означает, что для этой ошибки не было записано никакой среды.
См. также:
setEnvironment(java.util.Hashtable<?, ?>)

setEnvironment

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

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

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

getRemainingNewName

public Name getRemainingNewName()

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

Возвращает:
Возможно null, часть нового имени, которая не была разрешена. Это составное имя. Может быть null, что означает, что поле оставшегося нового имени не было установлено.
См. также:
setRemainingNewName(javax.naming.Name)

setRemainingNewName

public void setRemainingNewName(Name newName)

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

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

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

Параметры:
newName - Возможно null, имя, которое нужно установить в поле «оставшееся новое имя». Если 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.naming/javax/naming/CannotProceedException.html

Spec-Zone .ru
спецификации, руководства, описания, API