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

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

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

Сериализуемый, Cloneable, Сопоставимый <Объект>, Имя
```
public class CompoundName
extends Object
implements Name
```
Этот класс представляет составное имя - имя от иерархического пространства имен. Каждый компонент на составное имя является атомарным именем.
Компоненты составного имени нумеруются. Индексы составного имени с компонентами N колеблются от 0 до, но не включая, N. Этот диапазон может быть записан как [0, N). Старший значащий компонент по индексу 0. У пустого составного имени нет никаких компонентов.

Составной Синтаксис Имени
Синтаксис составного имени определяется, используя ряд свойств:

jndi.syntax.direction
Направление для того, чтобы проанализировать ("right_to_left", "left_to_right", "плоский"). Если неуказанный, значения по умолчанию к "плоскому", что означает пространство имен, являются плоскими без иерархической структуры.
jndi.syntax.separator
Разделитель между атомарными компонентами имени. Требуемый, если направление не является "плоским".
jndi.syntax.ignorecase
Если существующий, "истинный" означает, игнорируют регистр, сравнивая компоненты имени. Если его значение не является "истиной", или если свойство не присутствует, случай рассматривают, сравнивая компоненты имени.
jndi.syntax.escape
Если существующий, определяет строку escape для того, чтобы переопределить разделитель, Escape и кавычки.
jndi.syntax.beginquote
Если существующий, определяет, что строковое разграничивание запускается заключенной в кавычки строки.
jndi.syntax.endquote
Строковый конец разграничивания заключенной в кавычки строки. Если существующий, определяет строку, разграничивающую конец заключенной в кавычки строки. Если не существующий, используйте syntax.beginquote в качестве кавычки конца.
jndi.syntax.beginquote2
Альтернативный набор начинается/заканчивается кавычки.
jndi.syntax.endquote2
Альтернативный набор начинается/заканчивается кавычки.
jndi.syntax.trimblanks
Если существующий, "истинный" означает обрезку какое-либо продвижение и запаздывающие пробелы в компоненте имени в целях сравнения. Если его значение не является "истиной", или если свойство не присутствует, пробелы являются существенными.
jndi.syntax.separator.ava
Если существующий, определяет строку, которая разделяет проверки значения атрибута, определяя многократные пары атрибут/значение. (например,"," в age=65, gender=male).
jndi.syntax.separator.typeval
Если существующий, определяет строку, которую разделители приписывают от значения (например, "=" в "age=65")
Эти свойства интерпретируются согласно следующим правилам:
1. В строке без кавычек или Escape, любой экземпляр разделителя разграничивает два атомарных имени. Каждое атомарное имя упоминается как компонент.
2. Разделителя, кавычки или escape оставляют если предшествующийся сразу (слева) escape.
3. Если есть два набора кавычек, определенная начинаться-кавычка должна быть соответствующей ее соответствующей кавычкой конца.
4. Неоставленная начинаться-кавычка, которая предшествует компоненту, должна быть соответствующей неоставленной кавычкой конца в конце компонента. Компонент, таким образом заключенный в кавычки, упоминается как заключенный в кавычки компонент. Это анализируется, удаляя существо - и конец - кавычки, и обрабатывая прошедшие символы как обычные символы, если одно из правил, включающих заключенные в кавычки упомянутые ниже компоненты, не применяется.
5. Кавычки, встроенные в незаключенные в кавычки компоненты, обрабатываются как обычные строки и не должны быть соответствующими.
6. Разделитель, которого оставляют или появляется между неоставленными кавычками, обрабатывается как обычная строка и не разделитель.
7. Строка escape в пределах заключенного в кавычки компонента действует как escape только когда сопровождающийся соответствующей строкой кавычки конца. Это может использоваться, чтобы встроить оставленную кавычку в пределах заключенного в кавычки компонента.
8. Оставленная строка escape не обрабатывается как строка escape.
9. Строка escape, которая не предшествует строке meta (кавычки или разделитель) и не является в конце компонента, обрабатывается как обычная строка.
10. Ведущий разделитель (составная строка имени начинается с разделителя) обозначает ведущий пустой атомарный компонент (состоящий из пустой строки). Запаздывающий разделитель (составные строковые концы имени с разделителем) обозначает запаздывающий пустой атомарный компонент. Смежные разделители обозначают пустой атомарный компонент.
Строковая форма составного имени следует за синтаксисом, описанным выше. Когда компоненты составного имени превращаются в их строковое представление, зарезервированные правила синтаксиса, описанные выше, применяются (например, встроенных разделителей оставляют или заключаются в кавычки) так, чтобы, когда та же самая строка анализируется, это привело к тем же самым компонентам исходного составного имени.

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

1.3

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

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

Поля
Модификатор и Тип	Поле и Описание
`protected javax.naming.NameImpl`	`impl` Реализация этого составного имени.
`protected Properties`	`mySyntax` Свойства синтаксиса для этого составного имени.

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

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

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

Методы
Модификатор и Тип	Метод и Описание
`Имя`	`add(int posn, String comp)` Добавляет единственный компонент в указанной позиции в пределах этого составного имени.
`Имя`	`add(String comp)` Добавляет единственный компонент до конца этого составного имени.
`Имя`	`addAll(int posn, Name n)` Добавляют компоненты составного имени - в порядке - в указанной позиции в пределах этого составного имени.
`Имя`	`addAll(Name suffix)` Добавляют компоненты составного имени - в порядке - до конца этого составного имени.
`Объект`	`clone()` Создает копию этого составного имени.
`int`	`compareTo(Object obj)` Сравнивает этот CompoundName с указанным Объектом для порядка.
`boolean`	`endsWith(Name n)` Определяет, является ли составное имя суффиксом этого составного имени.
`boolean`	`equals(Object obj)` Определяет, равен ли 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

- Полевая Деталь
  - impl
```
protected transient javax.naming.NameImpl impl
```
    Реализация этого составного имени. Это поле инициализируется конструкторами и не может быть нулем. Это должно быть обработано как переменная только для чтения подклассами.
  - mySyntax
```
protected transient Properties mySyntax
```
    Свойства синтаксиса для этого составного имени. Это поле инициализируется конструкторами и не может быть нулем. Это должно быть обработано как переменная только для чтения подклассами. Любые необходимые изменения к mySyntax должны быть произведены в пределах конструкторов и не после того, как составное имя инстанцировали.
- Деталь конструктора
  - CompoundName
```
protected CompoundName(Enumeration<String> comps,
            Properties syntax)
```
    Создает новый составной экземпляр имени, используя компоненты, определенные в аккомпанементах и синтаксисе. Этот защищенный метод предназначается, чтобы быть, чтобы использоваться подклассами CompoundName, когда они переопределяют методы, такие как клон (), getPrefix (), getSuffix ().
    
    Параметры:
    comps - Ненулевое перечисление компонентов, чтобы добавить. Каждый элемент перечисления имеет Строку класса. Перечисление будет использовано, чтобы извлечь его элементы.
    syntax - Ненулевые свойства, которые определяют синтаксис этого составного имени. См. описание класса для содержания свойств.
  - CompoundName
```
public CompoundName(String n,
            Properties syntax)
             throws InvalidNameException
```
    Создает новый составной экземпляр имени, анализируя строку n использование синтаксиса, определенного предоставленными свойствами синтаксиса.
    
    Параметры:
    n - Непустая строка, чтобы проанализировать.
    syntax - Ненулевой список свойств, которые определяют синтаксис этого составного имени. См. описание класса для содержания свойств.
    
    Броски:
    
    InvalidNameException - Если 'n' нарушает синтаксис, определенный syntax.
- Деталь метода
  - toString
```
public String toString()
```
    Генерирует строковое представление этого составного имени, используя правила синтаксиса составного имени. Правила синтаксиса описываются в описании класса. Пустой компонент представляется пустой строкой. Строковое представление, таким образом сгенерированное, можно передать конструктору CompoundName с теми же самыми свойствами синтаксиса, чтобы создать новое эквивалентное составное имя.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    Представление непустой строки этого составного имени.
  - равняется
```
public boolean equals(Object obj)
```
    Определяет, равен ли obj синтаксически этому составному имени. Если obj является нулем или не CompoundName, false возвращается. Два составных имени равны, если каждый компонент в каждый "равен" соответствующему компоненту в другом.
    Равенство также определяется с точки зрения синтаксиса этого составного имени. Реализация по умолчанию CompoundName использует свойства синтаксиса jndi.syntax.ignorecase и jndi.syntax.trimblanks, сравнивая два компонента для равенства. Если регистр игнорируется, две строки с той же самой последовательностью символов, но с различными случаями считают равными. Если пробелы обрезаются, начальные и конечные пробелы игнорируются с целью сравнения.
    У обоих составных имен должно быть то же самое число компонентов.
    Примечание реализации: В настоящий момент свойства синтаксиса двух составных имен не сравниваются для равенства. Они могли бы быть в будущем.
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    obj - Возможно нуль возражают, чтобы сравниться с.
    
    Возвраты:
    истина, если obj равен этому составному имени, ложь иначе.
    См. Также:
    compareTo(java.lang.Object obj)
  - хэш-код
```
public int hashCode()
```
    Вычисляет хэш-код этого составного имени. Хэш-код является суммой хэш-кодов "канонизировавших" форм отдельных компонентов этого составного имени. Каждый компонент "канонизируется" согласно синтаксису составного имени прежде, чем его хэш-код будет вычислен. Для нечувствительного к регистру имени, например, у формы uppercased имени есть тот же самый хэш-код как его печатаемый строчными литерами эквивалент.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    Интервал, представляющий хэш-код этого имени.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - клон
```
public Object clone()
```
    Создает копию этого составного имени. Изменения к компонентам этого составного имени не будут влиять на новую копию и наоборот. Клон и это составное имя совместно используют тот же самый синтаксис.
    
    Определенный:
    
    clone в интерфейсе Name
    
    Переопределения:
    
    clone в классе Object
    
    Возвраты:
    Ненулевая копия этого составного имени.
    См. Также:
    Cloneable
  - compareTo
```
public int compareTo(Object obj)
```
    Сравнивает этот CompoundName с указанным Объектом для порядка. Возвращает отрицательное целое число, нуль, или положительное целое число, поскольку это Имя является меньше чем, равный, или больше чем данный Объект.
    Если obj является нулем или не экземпляром CompoundName, ClassCastException бросается.
    См. равняется () для того, что это означает для двух составных имен быть равным. Если два составных имени равны, 0 возвращается.
    Упорядочивание составных имен зависит от синтаксиса составного имени. По умолчанию они следуют за лексикографическими правилами для сравнения строк с расширением, что это применяется ко всем компонентам на составное имя и что на сравнение отдельных компонентов влияют jndi.syntax.ignorecase и jndi.syntax.trimblanks свойства, идентичные тому, как они влияют, равняется (). Если это составное имя "лексикографически" меньше чем obj, отрицательное число возвращается. Если это составное имя "лексикографически" больше чем obj, положительное число возвращается.
    Примечание реализации: В настоящий момент свойства синтаксиса двух составных имен не сравниваются, проверяя порядок. Они могли бы быть в будущем.
    
    Определенный:
    
    compareTo в интерфейсе Comparable<Object>
    
    Определенный:
    
    compareTo в интерфейсе Name
    
    Параметры:
    obj - Ненулевой объект сравниться с.
    
    Возвраты:
    отрицательное целое число, нуль, или положительное целое число как это Имя являются меньше чем, равный, или больше чем данный Объект.
    
    Броски:
    
    ClassCastException - если obj не является CompoundName.
    См. Также:
    equals(java.lang.Object)
  - размер
```
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 возвращается.
    Примечание реализации: В настоящий момент свойства синтаксиса n не используются, делая сравнение. Они могли бы быть в будущем.
    
    Определенный:
    
    startsWith в интерфейсе Name
    
    Параметры:
    n - Возможно нуль соединяют имя к проверке.
    
    Возвраты:
    истина, если n является CompoundName и является префиксом этого составного имени, ложь иначе.
  - endsWith
```
public boolean endsWith(Name n)
```
    Определяет, является ли составное имя суффиксом этого составного имени. Составное имя 'n' является суффиксом, если это это равно getSuffix (размер ()-n.size ()) - другими словами, это составное имя концы с 'n'. Если n является нулем или не составным именем, false возвращается.
    Примечание реализации: В настоящий момент свойства синтаксиса n не используются, делая сравнение. Они могли бы быть в будущем.
    
    Определенный:
    
    endsWith в интерфейсе Name
    
    Параметры:
    n - Возможно нуль соединяют имя к проверке.
    
    Возвраты:
    истина, если n является CompoundName и является суффиксом этого составного имени, ложь иначе.
  - addAll
```
public Name addAll(Name suffix)
            throws InvalidNameException
```
    Добавляют компоненты составного имени - в порядке - до конца этого составного имени.
    Примечание реализации: В настоящий момент свойства синтаксиса суффикса не используются или проверяются. Они могли бы быть в будущем.
    
    Определенный:
    
    addAll в интерфейсе Name
    
    Параметры:
    suffix - Ненулевые компоненты, чтобы добавить.
    
    Возвраты:
    Обновленный CompoundName, не новый. Не может быть нуль.
    
    Броски:
    
    InvalidNameException - Если суффикс не является составным именем, или если добавление компонентов нарушает синтаксис этого составного имени (например, чрезмерное число компонентов).
  - addAll
```
public Name addAll(int posn,
          Name n)
            throws InvalidNameException
```
    Добавляют компоненты составного имени - в порядке - в указанной позиции в пределах этого составного имени. Компоненты этого составного имени в или после индекса первого нового компонента смещаются (далеко от индекса 0), чтобы разместить новые компоненты.
    Примечание реализации: В настоящий момент свойства синтаксиса суффикса не используются или проверяются. Они могли бы быть в будущем.
    
    Определенный:
    
    addAll в интерфейсе Name
    
    Параметры:
    n - Ненулевые компоненты, чтобы добавить.
    posn - Индекс на это имя, в котором можно добавить новые компоненты. Должен быть в диапазоне [0, размер ()].
    
    Возвраты:
    Обновленный CompoundName, не новый. Не может быть нуль.
    
    Броски:
    
    ArrayIndexOutOfBoundsException - Если posn вне указанного диапазона.
    
    InvalidNameException - Если n не является составным именем, или если добавление компонентов нарушает синтаксис этого составного имени (например, чрезмерное число компонентов).
  - добавить
```
public Name add(String comp)
         throws InvalidNameException
```
    Добавляет единственный компонент до конца этого составного имени.
    
    Определенный:
    
    add в интерфейсе Name
    
    Параметры:
    comp - Ненулевой компонент, чтобы добавить.
    
    Возвраты:
    Обновленный CompoundName, не новый. Не может быть нуль.
    
    Броски:
    
    InvalidNameException - Если добавление аккомпанемента в конце имени нарушило бы синтаксис составного имени.
  - добавить
```
public Name add(int posn,
       String comp)
         throws InvalidNameException
```
    Добавляет единственный компонент в указанной позиции в пределах этого составного имени. Компоненты этого составного имени в или после индекса нового компонента смещаются одним (далеко от индекса 0), чтобы разместить новый компонент.
    
    Определенный:
    
    add в интерфейсе Name
    
    Параметры:
    comp - Ненулевой компонент, чтобы добавить.
    posn - Индекс, по которому можно добавить новый компонент. Должен быть в диапазоне [0, размер ()].
    
    Возвраты:
    Обновленный CompoundName, не новый. Не может быть нуль.
    
    Броски:
    
    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 и/или его филиалы. Все права защищены.

Класс CompoundName

Составной Синтаксис Имени

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

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

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

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

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

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

impl

mySyntax

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

CompoundName

CompoundName

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

toString

равняется

хэш-код

клон

compareTo

размер

isEmpty

getAll

добраться

getPrefix

getSuffix

startsWith

endsWith

addAll

addAll

добавить

добавить

удалить