Класс NameClassPair

java.lang.Object
- javax.naming.NameClassPair

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

Непосредственные известные подклассы:: Binding

public class NameClassPair
extends Object
implements Serializable

Этот класс представляет пару имени и имени класса объекта, найденную в контексте.

Контекст состоит из привязок имя-объект. Класс NameClassPair представляет имя и класс связанного объекта. Он состоит из имени и строки, представляющей имя класса с квалификацией пакета.

Используйте наследование для систем именования, которые динамически генерируют содержимое пары имя/класс.

Экземпляр NameClassPair не синхронизирован по отношению к одновременным обращениям нескольких потоков. Потоки, которым требуется одновременный доступ к NameClassPair, должны синхронизироваться между собой и обеспечить необходимую блокировку.

С:: 1.3
См. также:: Context.list(javax.naming.Name), Сериализованная форма

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

Конструктор	Описание
`NameClassPair(String name, String className)`	Создает экземпляр NameClassPair, задавая его имя и имя класса.
`NameClassPair(String name, String className, boolean isRelative)`	Создаёт экземпляр NameClassPair, задавая его имя, имя класса и то, относится ли оно к контексту перечисления.

Методы

Модификатор и тип	Метод	Описание
`String`	`getClassName()`	Возвращает имя класса объекта, привязанного к имени этой привязки.
`String`	`getName()`	Возвращает имя этой привязки.
`String`	`getNameInNamespace()`	Возвращает полное имя этой привязки.
`boolean`	`isRelative()`	Определяет, является ли имя этой привязки относительным к целевому контексту (который задаётся первым параметром метода `list()`).
`void`	`setClassName(String name)`	Устанавливает имя класса этой привязки.
`void`	`setName(String name)`	Устанавливает имя этой привязки.
`void`	`setNameInNamespace(String fullName)`	Устанавливает полное имя этой привязки.
`void`	`setRelative(boolean r)`	Устанавливает, является ли имя этой привязки относительным к целевому контексту (который задаётся первым параметром метода `list()`).
`String`	`toString()`	Генерирует строковое представление этой пары имя/класс.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

NameClassPair

public NameClassPair(String name,
                     String className)

Создаёт экземпляр NameClassPair, задавая его имя и имя класса.

Параметры:: name - Непустое имя объекта. Оно относительно целевого контекста (который задаётся первым параметром метода list()); className - Возможно null имя класса связанного объекта. Оно равно null, если привязанный объект равен null.
См. также:: getClassName(), setClassName(java.lang.String), getName(), setName(java.lang.String)

NameClassPair

public NameClassPair(String name,
                     String className,
                     boolean isRelative)

Создаёт экземпляр NameClassPair, задавая его имя, имя класса и то, относится ли оно к контексту перечисления.

Параметры:: name - Непустое имя объекта.; className - Возможно null имя класса связанного объекта. Оно равно null, если привязанный объект равен null.; isRelative - true, если name является именем, относительным к целевому контексту (который задаётся первым параметром метода list()); false, если name является строкой URL.
См. также:: getClassName(), setClassName(java.lang.String), getName(), setName(java.lang.String), isRelative(), setRelative(boolean)

Методы

getClassName

public String getClassName()

Возвращает имя класса объекта, привязанного к имени этой привязки. Если ссылка или другая косвенная информация привязана, возвращает имя класса конечного объекта, который будет возвращён методом Binding.getObject().

Возвращает:: Возможно null имя класса связанного объекта. Оно равно null, если привязанный объект равен null.
См. также:: Binding.getObject(), Binding.getClassName(), setClassName(java.lang.String)

getName

public String getName()

Возвращает имя этой привязки. Если isRelative() равно true, это имя относительно целевого контекста (который задаётся первым параметром метода list()). Если isRelative() равно false, это имя — строка URL.

Возвращает:: Непустое имя этой привязки.
См. также:: isRelative(), setName(java.lang.String)

setName

public void setName(String name)

Устанавливает имя этой привязки.

Параметры:: name - непустая строка, используемая в качестве имени.
См. также:: getName(), setRelative(boolean)

setClassName

public void setClassName(String name)

Устанавливает имя класса этой привязки.

Параметры:: name - возможно null строка, используемая в качестве имени класса. Если null, Binding.getClassName() вернёт фактическое имя класса объекта в привязке. Имя класса будет null, если привязанный объект равен null.
См. также:: getClassName(), Binding.getClassName()

isRelative

public boolean isRelative()

Определяет, является ли имя этой привязки относительным к целевому контексту (который задаётся первым параметром метода list()).

Возвращает:: true, если имя этой привязки относительно целевого контекста; false, если имя этой привязки — строка URL.
См. также:: setRelative(boolean), getName()

setRelative

public void setRelative(boolean r)

Устанавливает, является ли имя этой привязки относительным к целевому контексту (который задаётся первым параметром метода list()).

Параметры:: r - Если true, имя привязки относительно целевого контекста; если false, имя привязки — строка URL.
См. также:: isRelative(), setName(java.lang.String)

getNameInNamespace

public String getNameInNamespace()

Возвращает полное имя этой привязки. Полное имя — абсолютное имя этой привязки в её собственном пространстве имён. См. Context.getNameInNamespace().

В системах именования, для которых понятие полного имени не применимо к этой привязке, будет брошено исключение UnsupportedOperationException. Это исключение также будет брошено, если используется поставщик сервиса, написанный до появления этого метода.

Строка, возвращённая этим методом, не является составным именем JNDI и не должна передаваться непосредственно методам контекста.

Возвращает:: Полное имя этой привязки.
Исключения:: UnsupportedOperationException - если понятие полного имени неприменимо к этой привязке в системе именования.
С:: 1.5
См. также:: setNameInNamespace(java.lang.String), getName()

setNameInNamespace

public void setNameInNamespace(String fullName)

Устанавливает полное имя этой привязки. Этот метод должен вызываться для установки полного имени, когда создаётся NameClassPair, и полное имя применимо к этой привязке.

Установка полного имени в null или отсутствие установки вызовет исключение метода getNameInNamespace().

Параметры:: fullName - Полное имя для использования.
С:: 1.5
См. также:: getNameInNamespace(), setName(java.lang.String)

toString

public String toString()

Генерирует строковое представление этой пары имя/класс. Строковое представление состоит из имени и имени класса, разделённых двоеточием (:). Содержимое этой строки полезно для отладки и не предназначено для программной интерпретации.

Переопределяет:: toString в классе Object
Возвращает:: Строковое представление этой пары имя/класс.