NamingException (Платформа Java SE 7)

java.lang. Объект
- java.lang. Throwable
- - java.lang. Исключение
  - - javax.naming. NamingException

Все Реализованные Интерфейсы:

Сериализуемый

Прямые Известные Подклассы:

AttributeInUseException, AttributeModificationException, CannotProceedException, CommunicationException, ConfigurationException, ContextNotEmptyException, InsufficientResourcesException, InterruptedNamingException, InvalidAttributeIdentifierException, InvalidAttributesException, InvalidAttributeValueException, InvalidNameException, InvalidSearchControlsException, InvalidSearchFilterException, LimitExceededException, LinkException, NameAlreadyBoundException, NameNotFoundException, NamingSecurityException, NoInitialContextException, NoSuchAttributeException, NotContextException, OperationNotSupportedException, PartialResultException, ReferralException, SchemaViolationException, ServiceUnavailableException
```
public class NamingException
extends Exception
```
Это - суперкласс всех исключений, выданных операциями в интерфейсах Контекста и DirContext. Природа отказа описывается именем подкласса. Это исключение получает информационное точное определение, где отказавшая работа, такой как, где последнее разрешение продолжилось к.
- Разрешенное Имя. Часть имени, которое было разрешено.
- Разрешенный Объект. Объект, к которому продолжилось разрешение имени.
- Оставление Именем. Часть имени, которое не было разрешено.
- Объяснение. Деталь, объясняющая, почему разрешение имени перестало работать.
- Корневое Исключение. Исключение, которое заставило это исключение именования быть брошенным.
нуль является приемлемым значением для любого из этих полей. Когда нуль, это означает, что никакая такая информация не была записана для того поля.
Экземпляр NamingException не синхронизируется против параллельного многопоточного доступа. Многократные потоки, пытающиеся получить доступ и изменить единственный экземпляр NamingException, должны заблокировать объект.
Это исключение было retrofitted, чтобы соответствовать объединяющему в цепочку исключение механизму общего назначения. Корневое исключение (или первопричина) является тем же самым объектом как причина, возвращенная Throwable.getCause() метод.
С тех пор:

1.3

См. Также:
Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`protected Name`	`remainingName` Содержит остающееся имя, которое еще не было разрешено.
`protected Name`	`resolvedName` Содержит часть имени, которое было успешно разрешено.
`protected Object`	`resolvedObj` Содержит объект, к которому разрешение части имени было успешно.
`protected Throwable`	`rootException` Содержит исходное исключение, которое заставило этот NamingException быть брошенным.

Сводка конструктора

Конструкторы
Конструктор и Описание
`NamingException()` Создает новый NamingException.
`NamingException(String explanation)` Создает новый NamingException с объяснением.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`appendRemainingComponent(String name)` Добавьте имя как последний компонент на остающееся имя.
`void`	`appendRemainingName(Name name)` Добавьте компоненты с 'имени' как последние компоненты на остающееся имя.
`Throwable`	`getCause()` Возвращает причину этого исключения.
`Строка`	`getExplanation()` Получает объяснение, связанное с этим исключением.
`Имя`	`getRemainingName()` Получает остающуюся неразрешенную часть имени.
`Имя`	`getResolvedName()` Получает ведущую часть имени, которое было разрешено успешно.
`Объект`	`getResolvedObj()` Получает объект, к которому разрешение было успешно.
`Throwable`	`getRootCause()` Получает первопричину этого NamingException, если любой.
`Throwable`	`initCause(Throwable cause)` Инициализирует причину этого исключения к указанному значению.
`void`	`setRemainingName(Name name)` Устанавливает остающееся поле имени этого исключения.
`void`	`setResolvedName(Name name)` Устанавливает разрешенное поле имени этого исключения.
`void`	`setResolvedObj(Object obj)` Устанавливает разрешенное объектное поле этого исключения.
`void`	`setRootCause(Throwable e)` Записывает первопричину этого NamingException.
`Строка`	`toString()` Генерирует строковое представление этого исключения.
`Строка`	`toString(boolean detail)` Генерирует строковое представление более подробно.

Методы java.lang унаследованный от класса. Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - resolvedName
```
protected Name resolvedName
```
    Содержит часть имени, которое было успешно разрешено. Это - составное имя и может быть нулем. Это поле инициализируется конструкторами. Следует получить доступ и управлять этим полем через добираемые и установить методы.
    
    См. Также:
    getResolvedName(), setResolvedName(javax.naming.Name)
  - resolvedObj
```
protected Object resolvedObj
```
    Содержит объект, к которому разрешение части имени было успешно. Может быть нуль. Это поле инициализируется конструкторами. Следует получить доступ и управлять этим полем через добираемые и установить методы.
    
    См. Также:
    getResolvedObj(), setResolvedObj(java.lang.Object)
  - remainingName
```
protected Name remainingName
```
    Содержит остающееся имя, которое еще не было разрешено. Это - составное имя и может быть нулем. Это поле инициализируется конструкторами. Следует получить доступ и управлять этим полем через добираемые, установить, "добавить" методы.
    
    См. Также:
    getRemainingName(), setRemainingName(javax.naming.Name), appendRemainingName(javax.naming.Name), appendRemainingComponent(java.lang.String)
  - rootException
```
protected Throwable rootException
```
    Содержит исходное исключение, которое заставило этот NamingException быть брошенным. Это поле устанавливается, если есть дополнительная информация, которая могла бы быть получена из исходного исключения, или если исходное исключение не могло бы быть отображено на подкласс NamingException. Может быть нуль.
    Это поле предшествует средству объединения в цепочку исключения общего назначения. initCause(Throwable) и getCause() методы являются теперь привилегированными средствами доступа к этой информации.
    
    См. Также:
    getRootCause(), setRootCause(Throwable), initCause(Throwable), getCause()
- Деталь конструктора
  - NamingException
```
public NamingException(String explanation)
```
    Создает новый NamingException с объяснением. Все неуказанные поля, устанавливают в NULL.
    
    Параметры:
    explanation - Возможно пустая строка, содержащая дополнительную деталь об этом исключении.
    См. Также:
    Throwable.getMessage()
  - NamingException
```
public NamingException()
```
    Создает новый NamingException. Все поля, устанавливают в NULL.
- Деталь метода
  - getResolvedName
```
public Name getResolvedName()
```
    Получает ведущую часть имени, которое было разрешено успешно.
    
    Возвраты:
    Часть имени, которое было разрешено успешно. Это - составное имя. Это может быть нуль, что означает, что разрешенное поле имени не было установлено.
    См. Также:
    getResolvedObj(), setResolvedName(javax.naming.Name)
  - getRemainingName
```
public Name getRemainingName()
```
    Получает остающуюся неразрешенную часть имени.
    
    Возвраты:
    Часть имени, которое не было разрешено. Это - составное имя. Это может быть нуль, что означает, что остающееся поле имени не было установлено.
    См. Также:
    setRemainingName(javax.naming.Name), appendRemainingName(javax.naming.Name), appendRemainingComponent(java.lang.String)
  - getResolvedObj
```
public Object getResolvedObj()
```
    Получает объект, к которому разрешение было успешно. Это - объект, с которым связывается разрешенное имя.
    
    Возвраты:
    Возможно нулевой объект, который до сих пор разрешался. нуль означает, что разрешенное объектное поле не было установлено.
    См. Также:
    getResolvedName(), setResolvedObj(java.lang.Object)
  - getExplanation
```
public String getExplanation()
```
    Получает объяснение, связанное с этим исключением.
    
    Возвраты:
    Возможно нуль детализируют строку, объясняющую больше об этом исключении. Если ноль, это означает, что нет никакого сообщения детали для этого исключения.
    См. Также:
    Throwable.getMessage()
  - setResolvedName
```
public void setResolvedName(Name name)
```
    Устанавливает разрешенное поле имени этого исключения.
    name является составным именем. Если намерение состоит в том, чтобы установить это поле, используя составное имя или строку, Вы должны "stringify" составное имя, и создавать составное имя с единственным компонентом, используя строку. Можно тогда вызвать этот метод, используя получающееся составное имя.
    Копия name делается и сохранен. Последующие изменения к name не влияет на копию в этом NamingException и наоборот.
    
    Параметры:
    name - Возможно нуль называют, чтобы определить разрешенное имя к. Если ноль, это устанавливает разрешенное поле имени в NULL.
    См. Также:
    getResolvedName()
  - setRemainingName
```
public void setRemainingName(Name name)
```
    Устанавливает остающееся поле имени этого исключения.
    name является составным именем. Если намерение состоит в том, чтобы установить это поле, используя составное имя или строку, Вы должны "stringify" составное имя, и создавать составное имя с единственным компонентом, используя строку. Можно тогда вызвать этот метод, используя получающееся составное имя.
    Копия name делается и сохранен. Последующие изменения к name не влияет на копию в этом NamingException и наоборот.
    
    Параметры:
    name - Возможно нуль называют, чтобы определить остающееся имя к. Если ноль, это устанавливает остающееся поле имени в NULL.
    См. Также:
    getRemainingName(), appendRemainingName(javax.naming.Name), appendRemainingComponent(java.lang.String)
  - setResolvedObj
```
public void setResolvedObj(Object obj)
```
    Устанавливает разрешенное объектное поле этого исключения.
    
    Параметры:
    obj - Возможно нуль возражают, чтобы установить разрешенный объект в. Если ноль, разрешенное объектное поле, устанавливают в NULL.
    См. Также:
    getResolvedObj()
  - appendRemainingComponent
```
public void appendRemainingComponent(String name)
```
    Добавьте имя как последний компонент на остающееся имя.
    
    Параметры:
    name - Компонент, чтобы добавить. Если имя является нулем, этот метод ничего не делает.
    См. Также:
    setRemainingName(javax.naming.Name), getRemainingName(), appendRemainingName(javax.naming.Name)
  - appendRemainingName
```
public void appendRemainingName(Name name)
```
    Добавьте компоненты с 'имени' как последние компоненты на остающееся имя.
    name является составным именем. Если намерение состоит в том, чтобы добавить составное имя, Вы должны "stringify", составное имя тогда вызывает перегруженную форму, которая принимает Строковый параметр.
    Последующие изменения к name не влияет на остающееся поле имени в этом NamingException и наоборот.
    
    Параметры:
    name - Возможно нулевое имя, содержащее упорядоченный компоненты, чтобы добавить. Если имя является нулем, этот метод ничего не делает.
    См. Также:
    setRemainingName(javax.naming.Name), getRemainingName(), appendRemainingComponent(java.lang.String)
  - getRootCause
```
public Throwable getRootCause()
```
    Получает первопричину этого NamingException, если любой. Первопричина исключения именования используется, когда поставщик услуг хочет указать к вызывающей стороне на неименование связанное исключение, но одновременно хочет использовать структуру NamingException, чтобы указать как далеко продолженная операция именования.
    Этот метод предшествует средству объединения в цепочку исключения общего назначения. getCause() метод является теперь привилегированными средствами получения этой информации.
    
    Возвраты:
    Возможно нулевое исключение, которое вызвало это исключение именования. Если ноль, это означает, что никакая первопричина не была установлена для этого исключения именования.
    См. Также:
    setRootCause(java.lang.Throwable), rootException, getCause()
  - setRootCause
```
public void setRootCause(Throwable e)
```
    Записывает первопричину этого NamingException. Если e является this, этот метод ничего не делает.
    Этот метод предшествует средству объединения в цепочку исключения общего назначения. initCause(Throwable) метод является теперь привилегированными средствами записи этой информации.
    
    Параметры:
    e - Возможно нулевое исключение, которое заставило операцию именования перестать работать. Если ноль, это означает, что у этого исключения именования нет никакой первопричины.
    См. Также:
    getRootCause(), rootException, initCause(java.lang.Throwable)
  - getCause
```
public Throwable getCause()
```
    Возвращает причину этого исключения. Причиной является throwable, который заставил это исключение именования быть брошенным. Возвраты null если причина является несуществующей или неизвестной.
    
    Переопределения:
    
    getCause в классе Throwable
    
    Возвраты:
    причина этого исключения, или null если причина является несуществующей или неизвестной.
    С тех пор:
    
    1.4
    
    См. Также:
    initCause(Throwable)
  - initCause
```
public Throwable initCause(Throwable cause)
```
    Инициализирует причину этого исключения к указанному значению. Причиной является throwable, который заставил это исключение именования быть брошенным.
    Этот метод можно вызвать самое большее однажды.
    
    Переопределения:
    
    initCause в классе Throwable
    
    Параметры:
    cause - причина, которая сохраняется для более позднего извлечения getCause() метод. Значение null указывает, что причина является несуществующей или неизвестной.
    
    Возвраты:
    ссылка на это NamingException экземпляр.
    
    Броски:
    
    IllegalArgumentException - если cause это исключение. (throwable не может быть своей собственной причиной.)
    
    IllegalStateException - если этот метод уже вызвали на этом исключении.
    С тех пор:
    
    1.4
    
    См. Также:
    getCause()
  - toString
```
public String toString()
```
    Генерирует строковое представление этого исключения. Строковое представление состоит из имени класса этого исключения, его подробного сообщения, и если у этого есть первопричина, строковое представление исключения первопричины, сопровождаемого остающимся именем (если это не нуль). Эта строка используется для того, чтобы отладить и не предназначается, чтобы быть интерпретированной программно.
    
    Переопределения:
    
    toString в классе Throwable
    
    Возвраты:
    Непустая строка, содержащая строковое представление этого исключения.
  - toString
```
public String toString(boolean detail)
```
    Генерирует строковое представление более подробно. Это строковое представление состоит из информации, возвращенной toString (), который не берет параметров плюс строковое представление разрешенного объекта (если это не нуль). Эта строка используется для того, чтобы отладить и не предназначается, чтобы быть интерпретированной программно.
    
    Параметры:
    detail - Если это правда, включайте детали о разрешенном объекте в дополнение к другой информации.
    
    Возвраты:
    Непустая строка, содержащая строковое представление.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс NamingException

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Throwable

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

resolvedName

resolvedObj

remainingName

rootException

Деталь конструктора

NamingException

NamingException

Деталь метода

getResolvedName

getRemainingName

getResolvedObj

getExplanation

setResolvedName

setRemainingName

setResolvedObj

appendRemainingComponent

appendRemainingName

getRootCause

setRootCause

getCause

initCause

toString

toString