Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface Name extends Cloneable, Serializable, Comparable<Object>
Могут быть различные реализации Name; например, составьте имена, URL, или специфичные для пространства имен составные имена.
Компоненты имени нумеруются. Индексирование имени с компонентами N колеблется от 0 до, но не включая, N. Этот диапазон может быть записан как [0, N). Старший значащий компонент в, индексируют 0. У пустого названия нет никаких компонентов.
Ни один из методов в этом интерфейсе не принимает нуль как допустимое значение для параметра, который является именем или компонентом имени. Аналогично, методы, которые возвращают имя или называют компонент, никогда не возвращают нуль.
Экземпляр Name не может синхронизироваться против параллельного многопоточного доступа, если тот доступ не только для чтения.
Модификатор и Тип | Поле и Описание |
---|---|
static long |
serialVersionUID
Цифровой отпечаток class, который устанавливается указать на совместимость сериализации с предыдущей версией class.
|
Модификатор и Тип | Метод и Описание |
---|---|
Имя |
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)
Определяет, запускается ли это имя с указанного префикса.
|
static final long serialVersionUID
Object clone()
Object.clone()
int compareTo(Object obj)
Как с Object.equals(), понятие упорядочивания для имен зависит от class, который реализует этот интерфейс. Например, упорядочивание может быть основано на лексикографическом упорядочивании компонентов имени. Определенные атрибуты имени, такой как, как это обрабатывает случай, могут влиять на упорядочивание. Вообще, два имени различных классов не могут быть сравнены.
compareTo
в интерфейсе Comparable<Object>
obj
- ненулевой объект сравниться с.ClassCastException
- если obj не является Name типа, который может быть по сравнению с этим именемComparable.compareTo(Object)
int size()
boolean isEmpty()
Enumeration<String> getAll()
String get(int posn)
posn
- на основе 0 индексируют компонента, чтобы получить. Должен быть в диапазоне [0, размер ()).ArrayIndexOutOfBoundsException
- если posn вне указанного диапазонаName getPrefix(int posn)
posn
- на основе 0 индексируют компонента, в котором можно остановиться. Должен быть в диапазоне [0, размер ()].ArrayIndexOutOfBoundsException
- если posn вне указанного диапазонаName getSuffix(int posn)
posn
- на основе 0 индексируют компонента, в котором можно запустить. Должен быть в диапазоне [0, размер ()].ArrayIndexOutOfBoundsException
- если posn вне указанного диапазонаboolean startsWith(Name n)
n
- имя к проверкеboolean endsWith(Name n)
n
- имя к проверкеName addAll(Name suffix) throws InvalidNameException
suffix
- компоненты, чтобы добавитьInvalidNameException
- если suffix не является допустимым именем, или если бы добавление компонентов нарушило бы правила синтаксиса этого имениName addAll(int posn, Name n) throws InvalidNameException
n
- компоненты, чтобы добавитьposn
- индексирование на это имя, в котором можно добавить новые компоненты. Должен быть в диапазоне [0, размер ()].ArrayIndexOutOfBoundsException
- если posn вне указанного диапазонаInvalidNameException
- если n не является допустимым именем, или если бы добавление компонентов нарушило бы правила синтаксиса этого имениName add(String comp) throws InvalidNameException
comp
- компонент, чтобы добавитьInvalidNameException
- если добавление comp нарушило бы правила синтаксиса этого имениName add(int posn, String comp) throws InvalidNameException
comp
- компонент, чтобы добавитьposn
- индексирование, при котором можно добавить новый компонент. Должен быть в диапазоне [0, размер ()].ArrayIndexOutOfBoundsException
- если posn вне указанного диапазонаInvalidNameException
- если добавление comp нарушило бы правила синтаксиса этого имениObject remove(int posn) throws InvalidNameException
posn
- индексирование компонента, чтобы удалить. Должен быть в диапазоне [0, размер ()).ArrayIndexOutOfBoundsException
- если posn вне указанного диапазонаInvalidNameException
- если удаление компонента нарушило бы правила синтаксиса имени
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92