Класс LocatorImpl

java.lang.Object

org.xml.sax.helpers.LocatorImpl

Все реализуемые интерфейсы:: Locator

Прямые известные подклассы:: Locator2Impl

public class LocatorImpl extends Object implements Locator

Предоставляет необязательную удобную реализацию Locator.

Этот класс предназначен главным образом для разработчиков приложений, которые могут использовать его для создания постоянного снимка Locator в любой момент разбора документа:

 Locator locator;
 Locator startloc;

 public void setLocator (Locator locator)
 {
         // note the locator
   this.locator = locator;
 }

 public void startDocument ()
 {
         // save the location of the start of the document
         // for future use.
   Locator startloc = new LocatorImpl(locator);
 }

Как правило, разработчики парсеров не используют этот класс, поскольку эффективнее предоставлять сведения о местоположении только по запросу, а не постоянно обновлять объект Locator.

С версии:

1.4, SAX 1.0

См. также:

Краткое описание конструкторов

Конструктор	Описание
`LocatorImpl()`	Конструктор без аргументов.
`LocatorImpl(Locator locator)`	Конструктор копирования.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getColumnNumber()`	Возвращает сохранённый номер столбца (нумерация с 1).
`int`	`getLineNumber()`	Возвращает сохранённый номер строки (нумерация с 1).
`String`	`getPublicId()`	Возвращает сохранённый публичный идентификатор.
`String`	`getSystemId()`	Возвращает сохранённый системный идентификатор.
`void`	`setColumnNumber(int columnNumber)`	Задаёт номер столбца для этого Locator (нумерация с 1).
`void`	`setLineNumber(int lineNumber)`	Задаёт номер строки для этого Locator (нумерация с 1).
`void`	`setPublicId(String publicId)`	Задаёт публичный идентификатор для этого Locator.
`void`	`setSystemId(String systemId)`	Задаёт системный идентификатор для этого Locator.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии. Финализация признана устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

LocatorImpl

public LocatorImpl()

Конструктор без аргументов.

Обычно он не представляет особой пользы, поскольку основное назначение этого класса — создание снимка существующего Locator.

LocatorImpl

public LocatorImpl(Locator locator)

Конструктор копирования.

Создаёт постоянную копию текущего состояния Locator. Когда исходный Locator изменится, в этой копии сохранятся исходные значения (её можно использовать и вне области действия методов DocumentHandler).

Параметры:: locator — Locator, который нужно скопировать.

Подробное описание методов

getPublicId

public String getPublicId()

Возвращает сохранённый публичный идентификатор.

Указано в:

getPublicId в интерфейсе Locator

Возвращает:

Публичный идентификатор в виде строки или null, если он недоступен.

См. также:

getSystemId

public String getSystemId()

Возвращает сохранённый системный идентификатор.

Указано в:

getSystemId в интерфейсе Locator

Возвращает:

Системный идентификатор в виде строки или null, если он недоступен.

См. также:

getLineNumber

public int getLineNumber()

Возвращает сохранённый номер строки (нумерация с 1).

Указано в:

getLineNumber в интерфейсе Locator

Возвращает:

Номер строки в виде целого числа или -1, если он недоступен.

См. также:

getColumnNumber

public int getColumnNumber()

Возвращает сохранённый номер столбца (нумерация с 1).

Указано в:

getColumnNumber в интерфейсе Locator

Возвращает:

Номер столбца в виде целого числа или -1, если он недоступен.

См. также:

setPublicId

public void setPublicId(String publicId)

Задаёт публичный идентификатор для этого Locator.

Параметры:

publicId — новый публичный идентификатор или null, если он недоступен.

См. также:

setSystemId

public void setSystemId(String systemId)

Задаёт системный идентификатор для этого Locator.

Параметры:

systemId — новый системный идентификатор или null, если он недоступен.

См. также:

setLineNumber

public void setLineNumber(int lineNumber)

Задаёт номер строки для этого Locator (нумерация с 1).

Параметры:

lineNumber — номер строки или -1, если он недоступен.

См. также:

setColumnNumber

public void setColumnNumber(int columnNumber)

Задаёт номер столбца для этого Locator (нумерация с 1).

Параметры:

columnNumber — номер столбца или -1, если он недоступен.

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.