Класс CompoundName

protected transient Properties mySyntax

protected CompoundName(Enumeration<String> comps, Properties syntax)

Параметры:

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

syntax — непустые свойства, задающие синтаксис этого составного имени. Содержимое свойств см. в описании класса.

public CompoundName(String n, Properties syntax) throws InvalidNameException

Параметры:

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

syntax — непустой список свойств, задающих синтаксис этого составного имени. Содержимое свойств см. в описании класса.

Исключения:

InvalidNameException — если 'n' нарушает синтаксис, заданный syntax.

public String toString()

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

toString в классе Object

Возвращает:

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

public boolean equals(Object obj)

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

• compareTo(java.lang.Object obj)

public int hashCode()

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

hashCode в классе Object

Возвращает:

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

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(Object)

public Object clone()

Определен в:

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

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

clone в классе Object

Возвращает:

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

См. также:

• Object.clone()

public int compareTo(Object obj)

Определен в:

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

Определен в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

• equals(java.lang.Object)

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 является CompoundName и префиксом этого составного имени, иначе false.

public boolean endsWith(Name n)

Определен в:

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

Параметры:

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

Возвращает:

true, если n является CompoundName и суффиксом этого составного имени, иначе false.

public Name addAll(Name suffix) throws InvalidNameException

Определен в:

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

Параметры:

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

Возвращает:

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

Исключения:

InvalidNameException — если suffix не является составным именем или добавление компонентов нарушает синтаксис этого составного имени (например, превышено допустимое количество компонентов).

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

Определен в:

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

InvalidNameException — если n не является составным именем или добавление компонентов нарушает синтаксис этого составного имени (например, превышено допустимое количество компонентов).

public Name add(String comp) throws InvalidNameException

Определен в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

Определен в:

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

Параметры:

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

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

Возвращает:

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

Исключения:

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

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

public Object remove(int posn) throws InvalidNameException

Определен в:

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

Параметры:

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

Возвращает:

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

Исключения:

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

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