Класс CompositeName

protected CompositeName(Enumeration<String> comps)

Параметры:

comps — непустое перечисление, содержащее компоненты нового составного имени. Каждый элемент имеет класс String. Элементы будут извлечены из перечисления, в результате чего оно будет исчерпано.

public CompositeName(String n) throws InvalidNameException

Параметры:

n — непустая строка для разбора.

Исключения:

InvalidNameException — если строка n имеет недопустимый синтаксис составного имени.

public CompositeName()

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

Непустое строковое представление этого составного имени.

public boolean equals(Object obj)

Переопределяет:

equals в классе Object

Параметры:

obj — объект, возможно равный null, для сравнения.

Возвращает:

true, если obj равен этому составному имени; в противном случае — false.

См. также:

• hashCode()

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

Значение int, представляющее хеш-код этого имени.

См. также:

• equals(Object)

public int compareTo(Object obj)

Определено в:

compareTo в интерфейсе Comparable<Object>

Определено в:

compareTo в интерфейсе Name

Параметры:

obj — непустой объект для сравнения.

Возвращает:

отрицательное целое число, ноль или положительное целое число, если это Name меньше, равно или больше заданного Object соответственно.

Исключения:

ClassCastException — если obj не является CompositeName.

См. также:

• Comparable.compareTo(Object)

public Object clone()

Определено в:

clone в интерфейсе Name

Переопределяет:

clone в классе Object

Возвращает:

Непустую копию этого составного имени.

См. также:

• Object.clone()

public int size()

Определено в:

size в интерфейсе Name

Возвращает:

Неотрицательное число компонентов в этом составном имени.

public boolean isEmpty()

Определено в:

isEmpty в интерфейсе Name

Возвращает:

true, если это составное имя пусто; в противном случае — false.

public Enumeration<String> getAll()

Определено в:

getAll в интерфейсе Name

Возвращает:

Непустое перечисление компонентов этого составного имени. Каждый элемент перечисления имеет класс String.

public String get(int posn)

Определено в:

get в интерфейсе Name

Параметры:

posn — индекс компонента для получения, начинающийся с 0. Должен находиться в диапазоне [0,size()).

Возвращает:

Непустой компонент с индексом posn.

Исключения:

ArrayIndexOutOfBoundsException — если posn находится вне указанного диапазона.

public Name getPrefix(int posn)

Определено в:

getPrefix в интерфейсе Name

Параметры:

posn — индекс компонента, на котором нужно остановиться, начиная с 0. Должен находиться в диапазоне [0,size()].

Возвращает:

Составное имя, включающее компоненты с индексами в диапазоне [0,posn).

Исключения:

ArrayIndexOutOfBoundsException — если posn находится вне указанного диапазона.

public Name getSuffix(int posn)

Определено в:

getSuffix в интерфейсе Name

Параметры:

posn — индекс компонента, с которого нужно начать, начиная с 0. Должен находиться в диапазоне [0,size()].

Возвращает:

Составное имя, включающее компоненты с индексами в диапазоне [posn,size()). Если posn равен size(), возвращается пустое составное имя.

Исключения:

ArrayIndexOutOfBoundsException — если posn находится вне указанного диапазона.

public boolean startsWith(Name n)

Определено в:

startsWith в интерфейсе Name

Параметры:

n — имя, возможно равное null, для проверки.

Возвращает:

true, если n является CompositeName и префиксом этого составного имени; в противном случае — false.

public boolean endsWith(Name n)

Определено в:

endsWith в интерфейсе Name

Параметры:

n — имя, возможно равное null, для проверки.

Возвращает:

true, если n является CompositeName и суффиксом этого составного имени; в противном случае — false.

public Name addAll(Name suffix) throws InvalidNameException

Определено в:

addAll в интерфейсе Name

Параметры:

suffix — непустые компоненты для добавления.

Возвращает:

Обновленный CompositeName, а не новый объект. Не может быть null.

Исключения:

InvalidNameException — если суффикс не является составным именем.

public Name addAll(int posn, Name n) throws InvalidNameException

Определено в:

addAll в интерфейсе Name

Параметры:

posn — индекс в этом имени, по которому нужно добавить новые компоненты. Должен находиться в диапазоне [0,size()].

n — непустые компоненты для добавления.

Возвращает:

Обновленный CompositeName, а не новый объект. Не может быть null.

Исключения:

InvalidNameException — если n не является составным именем.

ArrayIndexOutOfBoundsException — если posn находится вне указанного диапазона.

public Name add(String comp) throws InvalidNameException

Определено в:

add в интерфейсе Name

Параметры:

comp — непустой компонент для добавления.

Возвращает:

Обновленный CompositeName, а не новый объект. Не может быть null.

Исключения:

InvalidNameException — если добавление comp в конец имени нарушает синтаксис имени.

public Name add(int posn, String comp) throws InvalidNameException

Определено в:

add в интерфейсе Name

Параметры:

posn — индекс, по которому нужно добавить новый компонент. Должен находиться в диапазоне [0,size()].

comp — непустой компонент для добавления.

Возвращает:

Обновленный CompositeName, а не новый объект. Не может быть null.

Исключения:

ArrayIndexOutOfBoundsException — если posn находится вне указанного диапазона.

InvalidNameException — если добавление comp в указанную позицию нарушает синтаксис имени.

public Object remove(int posn) throws InvalidNameException

Определено в:

remove в интерфейсе Name

Параметры:

posn — индекс удаляемого компонента. Должен находиться в диапазоне [0,size()).

Возвращает:

Удаленный компонент (String).

Исключения:

ArrayIndexOutOfBoundsException — если posn находится вне указанного диапазона (включая случай, когда составное имя пусто).

InvalidNameException — если удаление компонента нарушает синтаксис имени.