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

Все Суперинтерфейсы:

Cloneable, Сопоставимый <Объект>, Сериализуемый

Все Известные Классы с реализацией:

CompositeName, CompoundName, LdapName
```
public interface Name
extends Cloneable, Serializable, Comparable<Object>
```
Интерфейс Name представляет родовое название - упорядоченная последовательность компонентов. Это может быть составное имя (имена, которые охватывают многократные пространства имен), или составное имя (имена, которые используются в пределах отдельных иерархических систем именования).
Могут быть различные реализации Name; например, составьте имена, URL, или специфичные для пространства имен составные имена.
Компоненты имени нумеруются. Индексы имени с компонентами N колеблются от 0 до, но не включая, N. Этот диапазон может быть записан как [0, N). Старший значащий компонент по индексу 0. У пустого названия нет никаких компонентов.
Ни один из методов в этом интерфейсе не принимает нуль как допустимое значение для параметра, который является именем или компонентом имени. Аналогично, методы, которые возвращают имя или называют компонент, никогда не возвращают нуль.
Экземпляр Name не может синхронизироваться против параллельного многопоточного доступа, если тот доступ не только для чтения.

С тех пор:

1.3

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

Поля
Модификатор и Тип	Поле и Описание
`static long`	`serialVersionUID` Цифровой отпечаток класса, который устанавливается указать на совместимость сериализации с предыдущей версией класса.

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

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

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

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

Интерфейсное Имя

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

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

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

serialVersionUID

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

клон

compareTo

размер

isEmpty

getAll

добраться

getPrefix

getSuffix

startsWith

endsWith

addAll

addAll

добавить

добавить

удалить