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

java.lang. Объект
- javax.naming. CompositeName

Все Реализованные Интерфейсы:: Сериализуемый, Cloneable, Сопоставимый <Объект>, Имя

public class CompositeName
extends Object
implements Name

Этот класс представляет составное имя - последовательность имен компонентов, охватывающих многократные пространства имен. Каждый компонент является именем строки от пространства имен системы именования. Если компонент прибывает из иерархического пространства имен, тот компонент может быть далее проанализирован в его атомарные части при использовании класса CompoundName.

Компоненты составного имени нумеруются. Индексы составного имени с компонентами N колеблются от 0 до, но не включая, N. Этот диапазон может быть записан как [0, N). Старший значащий компонент по индексу 0. У пустого составного имени нет никаких компонентов.

Составной объект JNDI Называет Синтаксис

JNDI определяет стандартное строковое представление для составных имен. Это представление является связью компонентов составного имени, слева направо используя компонентный разделитель (символ наклонной черты вправо (/)), чтобы разделить каждый компонент. Синтаксис JNDI определяет следующие метасимволы:

escape (наклонная черта влево \),
символы кавычек (единственный (') и двойные кавычки (")), и
компонентный разделитель (символ наклонной черты вправо (/)).

Любому возникновению ведущей кавычки, escape, предшествующему любому метасимволу, escape в конце компонента, или компонентному символу разделителя в неупомянутом компоненте, должен предшествовать символ ESC, когда тот компонент составляется в составную строку имени. Альтернативно, чтобы избежать добавлять символы ESC как описано, весь компонент может быть заключен в кавычки, используя соответствие одинарных кавычек или соответствие двойных кавычек. Одинарную кавычку, происходящую в пределах двойным образом заключенного в кавычки компонента, не считают метасимволом (и не должен быть оставлен), и наоборот.

Когда два составных имени сравниваются, случай символов существенный.

Ведущий компонентный разделитель (составная строка имени начинается с разделителя) обозначает ведущий пустой компонент (компонент, состоящий из пустой строки). Запаздывающий компонентный разделитель (составные строковые концы имени с разделителем) обозначает запаздывающий пустой компонент. Смежные компонентные разделители обозначают пустой компонент.

Составные Примеры Имени

Эта таблица показывает примеры некоторых составных имен. Каждая строка показывает строковую форму составного имени и его соответствующую структурную форму (CompositeName).

Имя строки	CompositeName
""	{} (пустое название == новый CompositeName ("") == новый CompositeName ())
"x"	{"x"}
"x/y"	{"x", "y"}
"x /"	{"x", ""}
"/x"	{"" ", x"}
"/"	{""}
"//"	{"", ""}
"/x /"	{"" ", x", ""}
"x//y"	{"x", "" ", y"}

Примеры состава

Вот некоторые примеры состава. Правильный столбец показывает создание строковых имен составного объекта, в то время как левый столбец показывает создание соответствующего CompositeName s. Заметьте, что создание строковых форм двух составных имен просто включает конкатенацию их строковых форм вместе.

Названия строк	CompositeNames
"x/y" + "/" = x/y/	{"x", "y"} + {""} = {"x", "y", ""}
""+ "x" = "x"	{} + {"x"} = {"x"}
"/" + "x" = "/x"	{""} + {"x"} = {"" ", x"}
"x" + "" + "" = "x"	{"x"} + {} + {} = {"x"}

Многопоточный Доступ

Экземпляр CompositeName не синхронизируется против параллельного многопоточного доступа. Многократные потоки, пытающиеся получить доступ и изменить CompositeName, должны заблокировать объект.

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

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

Конструкторы
Модификатор	Конструктор и Описание
	`CompositeName()` Создает новое пустое составное имя.
`protected`	`CompositeName(Enumeration<String> comps)` Создает новый составной экземпляр имени, используя компоненты, определенные 'аккомпанементами'.
	`CompositeName(String n)` Создает новый составной экземпляр имени, анализируя строку n использование составного синтаксиса имени (слева направо, разделенная наклонная черта).

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

Методы
Модификатор и Тип	Метод и Описание
`Имя`	`add(int posn, String comp)` Добавляет единственный компонент в указанной позиции в пределах этого составного имени.
`Имя`	`add(String comp)` Добавляет единственный компонент до конца этого составного имени.
`Имя`	`addAll(int posn, Name n)` Добавляют компоненты составного имени - в порядке - в указанной позиции в пределах этого составного имени.
`Имя`	`addAll(Name suffix)` Добавляют компоненты составного имени - в порядке - до конца этого составного имени.
`Объект`	`clone()` Генерирует копию этого составного имени.
`int`	`compareTo(Object obj)` Сравнивает этот CompositeName с указанным Объектом для порядка.
`boolean`	`endsWith(Name n)` Определяет, является ли составное имя суффиксом этого составного имени.
`boolean`	`equals(Object obj)` Определяет, равны ли два составных имени.
`Строка`	`get(int posn)` Получает компонент этого составного имени.
`Enumeration<String>`	`getAll()` Получает компоненты этого составного имени как перечисление строк.
`Имя`	`getPrefix(int posn)` Создает составное имя, компоненты которого состоят из префикса компонентов на это составное имя.
`Имя`	`getSuffix(int posn)` Создает составное имя, компоненты которого состоят из суффикса компонентов на это составное имя.
`int`	`hashCode()` Вычисляет хэш-код этого составного имени.
`boolean`	`isEmpty()` Определяет, пусто ли это составное имя.
`Объект`	`remove(int posn)` Удаляет компонент из этого составного имени.
`int`	`size()` Получает число компонентов на это составное имя.
`boolean`	`startsWith(Name n)` Определяет, является ли составное имя префиксом этого составного имени.
`Строка`	`toString()` Генерирует строковое представление этого составного имени.

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

- Деталь конструктора
  - CompositeName
```
protected CompositeName(Enumeration<String> comps)
```
    Создает новый составной экземпляр имени, используя компоненты, определенные 'аккомпанементами'. Этот защищенный метод предназначается, чтобы быть, чтобы использоваться подклассами CompositeName, когда они переопределяют методы, такие как клон (), getPrefix (), getSuffix ().
    
    Параметры:
    comps - Ненулевое перечисление, содержащее компоненты для нового составного имени. Каждый элемент имеет Строку класса. Перечисление будет использовано, чтобы извлечь его элементы.
  - CompositeName
```
public CompositeName(String n)
              throws InvalidNameException
```
    Создает новый составной экземпляр имени, анализируя строку n использование составного синтаксиса имени (слева направо, разделенная наклонная черта). Составной синтаксис имени описывается подробно в описании класса.
    
    Параметры:
    n - Непустая строка, чтобы проанализировать.
    
    Броски:
    
    InvalidNameException - Если у n есть недопустимый составной синтаксис имени.
  - CompositeName
```
public CompositeName()
```
    Создает новое пустое составное имя. Такое имя возвращает true когда isEmpty() вызывается на это.
- Деталь метода
  - toString
```
public String toString()
```
    Генерирует строковое представление этого составного имени. Строковое представление состоит из перечисления в порядке каждый компонент составного имени и разделения каждого компонента символом наклонной черты вправо. Заключение в кавычки и символы ESC применяется где необходимый согласно синтаксису JNDI, который описывается в описании класса. Пустой компонент представляется пустой строкой. Строковое представление, таким образом сгенерированное, можно передать конструктору CompositeName, чтобы создать новое эквивалентное составное имя.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    Представление непустой строки этого составного имени.
  - равняется
```
public boolean equals(Object obj)
```
    Определяет, равны ли два составных имени. Если obj является нулем или не составным именем, false возвращается. Два составных имени равны, если каждый компонент в каждый равен соответствующему компоненту в другом. Это подразумевает, и имейте то же самое число компонентов, и каждый компонент равняется (), тест против соответствующего компонента на другое имя возвращает true.
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    obj - Возможно нуль возражают, чтобы сравниться с.
    
    Возвраты:
    истина, если obj равен этому составному имени, ложь иначе.
    См. Также:
    hashCode()
  - хэш-код
```
public int hashCode()
```
    Вычисляет хэш-код этого составного имени. Хэш-код является суммой хэш-кодов отдельных компонентов этого составного имени.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    Интервал, представляющий хэш-код этого имени.
    См. Также:
    equals(java.lang.Object)
  - compareTo
```
public int compareTo(Object obj)
```
    Сравнивает этот CompositeName с указанным Объектом для порядка. Возвращает отрицательное целое число, нуль, или положительное целое число, поскольку это Имя является меньше чем, равный, или больше чем данный Объект.
    Если obj является нулем или не экземпляром CompositeName, ClassCastException бросается.
    См. равняется () для того, что это означает для двух составных имен быть равным. Если два составных имени равны, 0 возвращается.
    Упорядочивание составных имен следует за лексикографическими правилами для сравнения строк с расширением, что это применяется ко всем компонентам на составное имя. Эффект состоит в том, как будто все компоненты были выстроены в линию в их упорядоченном указанном и лексикографические правила, примененные по этим двум очередям. Если это составное имя "лексикографически" меньше чем obj, отрицательное число возвращается. Если это составное имя "лексикографически" больше чем obj, положительное число возвращается.
    
    Определенный:
    
    compareTo в интерфейсе Comparable<Object>
    
    Определенный:
    
    compareTo в интерфейсе Name
    
    Параметры:
    obj - Ненулевой объект сравниться с.
    
    Возвраты:
    отрицательное целое число, нуль, или положительное целое число как это Имя являются меньше чем, равный, или больше чем данный Объект.
    
    Броски:
    
    ClassCastException - если obj не является CompositeName.
    См. Также:
    Comparable.compareTo(Object)
  - клон
```
public Object clone()
```
    Генерирует копию этого составного имени. Изменения к компонентам этого составного имени не будут влиять на новую копию и наоборот.
    
    Определенный:
    
    clone в интерфейсе Name
    
    Переопределения:
    
    clone в классе Object
    
    Возвраты:
    Ненулевая копия этого составного имени.
    См. Также:
    Cloneable
  - размер
```
public int size()
```
    Получает число компонентов на это составное имя.
    
    Определенный:
    
    size в интерфейсе Name
    
    Возвраты:
    Неотрицательное число компонентов на это составное имя.
  - isEmpty
```
public boolean isEmpty()
```
    Определяет, пусто ли это составное имя. Составное имя пусто, если у него есть нулевые компоненты.
    
    Определенный:
    
    isEmpty в интерфейсе Name
    
    Возвраты:
    истина, если это составное имя пусто, ложно иначе.
  - getAll
```
public Enumeration<String> getAll()
```
    Получает компоненты этого составного имени как перечисление строк. Эффекты обновлений к этому составному имени на этом перечислении неопределены.
    
    Определенный:
    
    getAll в интерфейсе Name
    
    Возвраты:
    Ненулевое перечисление компонентов этого составного имени. Каждый элемент перечисления имеет Строку класса.
  - добраться
```
public String get(int posn)
```
    Получает компонент этого составного имени.
    
    Определенный:
    
    get в интерфейсе Name
    
    Параметры:
    posn - Индекс на основе 0 компонента, чтобы получить. Должен быть в диапазоне [0, размер ()).
    
    Возвраты:
    Ненулевой компонент по индексу posn.
    
    Броски:
    
    ArrayIndexOutOfBoundsException - если posn вне указанного диапазона.
  - getPrefix
```
public Name getPrefix(int posn)
```
    Создает составное имя, компоненты которого состоят из префикса компонентов на это составное имя. Последующие изменения к этому составному имени не влияют на имя, которое возвращается.
    
    Определенный:
    
    getPrefix в интерфейсе Name
    
    Параметры:
    posn - Индекс на основе 0 компонента, в котором можно остановиться. Должен быть в диапазоне [0, размер ()].
    
    Возвраты:
    Составное имя, состоящее из компонентов по индексам в диапазоне [0, posn).
    
    Броски:
    
    ArrayIndexOutOfBoundsException - Если posn вне указанного диапазона.
  - getSuffix
```
public Name getSuffix(int posn)
```
    Создает составное имя, компоненты которого состоят из суффикса компонентов на это составное имя. Последующие изменения к этому составному имени не влияют на имя, которое возвращается.
    
    Определенный:
    
    getSuffix в интерфейсе Name
    
    Параметры:
    posn - Индекс на основе 0 компонента, в котором можно запустить. Должен быть в диапазоне [0, размер ()].
    
    Возвраты:
    Составное имя, состоящее из компонентов по индексам в диапазоне [posn, размер ()). Если posn равен размеру (), пустое составное имя возвращается.
    
    Броски:
    
    ArrayIndexOutOfBoundsException - Если posn вне указанного диапазона.
  - startsWith
```
public boolean startsWith(Name n)
```
    Определяет, является ли составное имя префиксом этого составного имени. Составное имя 'n' является префиксом, если это равно getPrefix (n.size) - другими словами, это составное имя запускается с 'n'. Если 'n' является нулем или не составным именем, false возвращается.
    
    Определенный:
    
    startsWith в интерфейсе Name
    
    Параметры:
    n - Возможно нуль называют к проверке.
    
    Возвраты:
    истина, если n является CompositeName и является префиксом этого составного имени, ложь иначе.
  - endsWith
```
public boolean endsWith(Name n)
```
    Определяет, является ли составное имя суффиксом этого составного имени. Составное имя 'n' является суффиксом, если это это равно getSuffix (размер ()-n.size ()) - другими словами, это составное имя концы с 'n'. Если n является нулем или не составным именем, false возвращается.
    
    Определенный:
    
    endsWith в интерфейсе Name
    
    Параметры:
    n - Возможно нуль называют к проверке.
    
    Возвраты:
    истина, если n является CompositeName и является суффиксом этого составного имени, ложь иначе.
  - addAll
```
public Name addAll(Name suffix)
            throws InvalidNameException
```
    Добавляют компоненты составного имени - в порядке - до конца этого составного имени.
    
    Определенный:
    
    addAll в интерфейсе Name
    
    Параметры:
    suffix - Ненулевые компоненты, чтобы добавить.
    
    Возвраты:
    Обновленный CompositeName, не новый. Не может быть нуль.
    
    Броски:
    
    InvalidNameException - Если суффикс не является составным именем.
  - addAll
```
public Name addAll(int posn,
          Name n)
            throws InvalidNameException
```
    Добавляют компоненты составного имени - в порядке - в указанной позиции в пределах этого составного имени. Компоненты этого составного имени в или после индекса первого нового компонента смещаются (далеко от индекса 0), чтобы разместить новые компоненты.
    
    Определенный:
    
    addAll в интерфейсе Name
    
    Параметры:
    n - Ненулевые компоненты, чтобы добавить.
    posn - Индекс на это имя, в котором можно добавить новые компоненты. Должен быть в диапазоне [0, размер ()].
    
    Возвраты:
    Обновленный CompositeName, не новый. Не может быть нуль.
    
    Броски:
    
    InvalidNameException - Если n не является составным именем.
    
    ArrayIndexOutOfBoundsException - Если posn вне указанного диапазона.
  - добавить
```
public Name add(String comp)
         throws InvalidNameException
```
    Добавляет единственный компонент до конца этого составного имени.
    
    Определенный:
    
    add в интерфейсе Name
    
    Параметры:
    comp - Ненулевой компонент, чтобы добавить.
    
    Возвраты:
    Обновленный CompositeName, не новый. Не может быть нуль.
    
    Броски:
    
    InvalidNameException - Если добавление аккомпанемента в конце имени нарушило бы синтаксис имени.
  - добавить
```
public Name add(int posn,
       String comp)
         throws InvalidNameException
```
    Добавляет единственный компонент в указанной позиции в пределах этого составного имени. Компоненты этого составного имени в или после индекса нового компонента смещаются одним (далеко от индекса 0), чтобы разместить новый компонент.
    
    Определенный:
    
    add в интерфейсе Name
    
    Параметры:
    comp - Ненулевой компонент, чтобы добавить.
    posn - Индекс, по которому можно добавить новый компонент. Должен быть в диапазоне [0, размер ()].
    
    Возвраты:
    Обновленный CompositeName, не новый. Не может быть нуль.
    
    Броски:
    
    ArrayIndexOutOfBoundsException - Если posn вне указанного диапазона.
    
    InvalidNameException - Если добавление аккомпанемента в указанной позиции нарушило бы синтаксис имени.
  - удалить
```
public Object remove(int posn)
              throws InvalidNameException
```
    Удаляет компонент из этого составного имени. Компонент этого составного имени в позиции 'posn' удаляется, и компоненты в индексах, больше, чем 'posn' смещаются вниз (к индексу 0) одним.
    
    Определенный:
    
    remove в интерфейсе Name
    
    Параметры:
    posn - Индекс компонента, чтобы удалить. Должен быть в диапазоне [0, размер ()).
    
    Возвраты:
    Удаленный компонент (Строка).
    
    Броски:
    
    ArrayIndexOutOfBoundsException - Если posn вне указанного диапазона (включает случай, где составное имя пусто).
    
    InvalidNameException - Если удаление компонента нарушило бы синтаксис имени.

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

Класс CompositeName

Составной объект JNDI Называет Синтаксис

Составные Примеры Имени

Примеры состава

Многопоточный Доступ

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

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

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

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

CompositeName

CompositeName

CompositeName

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

toString

равняется

хэш-код

compareTo

клон

размер

isEmpty

getAll

добраться

getPrefix

getSuffix

startsWith

endsWith

addAll

addAll

добавить

добавить

удалить