Класс SAXParseException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- org.xml.sax.SAXException
-
- org.xml.sax.SAXParseException
- Все реализованные интерфейсы:
Serializable
public class SAXParseException extends SAXException
Заворачивает ошибку или предупреждение при разборе XML.
Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не имеет ГАРАНТИЙ. Смотрите http://www.saxproject.org для получения дополнительной информации.
Эта исключительная ситуация может содержать информацию для определения места ошибки в исходном документе XML, как если бы она исходила от объекта Locator. Обратите внимание, что хотя приложение получит SAXParseException в качестве аргумента обработчикам в интерфейсе ErrorHandler, приложение не обязано фактически генерировать исключение; вместо этого оно может просто прочитать информацию в нём и предпринять другие действия.
Поскольку это исключение является подклассом SAXException, оно наследует возможность обертывания другого исключения.
- С тех пор:
- 1.4, SAX 1.0
- См. также:
-
SAXException,Locator,ErrorHandler, Сериализованная форма
Конструкторы
| Конструктор | Описание |
|---|---|
SAXParseException(String message,
String publicId,
String systemId,
int lineNumber,
int columnNumber) |
Создаёт новый SAXParseException. |
SAXParseException(String message,
String publicId,
String systemId,
int lineNumber,
int columnNumber,
Exception e) |
Создаёт новый SAXParseException с вложенным исключением. |
SAXParseException(String message,
Locator locator) |
Создаёт новый SAXParseException из сообщения и Locator. |
SAXParseException(String message,
Locator locator,
Exception e) |
Обертывает существующее исключение в SAXParseException. |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
int |
getColumnNumber() |
Номер столбца конца текста, где произошла ошибка. |
int |
getLineNumber() |
Номер строки конца текста, где произошла ошибка. |
String |
getPublicId() |
Получить общедоступный идентификатор сущности, где произошла ошибка. |
String |
getSystemId() |
Получить системный идентификатор сущности, где произошла ошибка. |
String |
toString() |
Переопределяет toString для предоставления более подробного сообщения об ошибке. |
Методы, объявленные в классе org.xml.sax.SAXException
getCause, getException, getMessage
Методы, объявленные в классе java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
Методы, объявленные в классе java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Конструкторы
SAXParseException
public SAXParseException(String message,
Locator locator)
Создаёт новый SAXParseException из сообщения и Locator.
Этот конструктор особенно полезен, когда приложение создаёт собственное исключение изнутри вызова ContentHandler.
- Параметры:
-
message- Сообщение об ошибке или предупреждении. -
locator- Объект locator для ошибки или предупреждения (может быть null). - См. также:
Locator
SAXParseException
public SAXParseException(String message,
Locator locator,
Exception e)
Обертывает существующее исключение в SAXParseException.
Этот конструктор особенно полезен, когда приложение создаёт собственное исключение изнутри вызова ContentHandler и нужно обернуть существующее исключение, которое не является подклассом SAXException.
- Параметры:
-
message- Сообщение об ошибке или предупреждении, или null для использования сообщения из вложенного исключения. -
locator- Объект locator для ошибки или предупреждения (может быть null). -
e- Любое исключение. - См. также:
Locator
SAXParseException
public SAXParseException(String message,
String publicId,
String systemId,
int lineNumber,
int columnNumber)
Создаёт новый SAXParseException.
Этот конструктор наиболее полезен для авторов парсеров.
Все параметры, кроме сообщения, как если бы они были предоставлены объектом Locator. Например, если системный идентификатор — URL (включая относительное имя файла), вызывающий метод должен разрешить его полностью перед созданием исключения.
- Параметры:
-
message- Сообщение об ошибке или предупреждении. -
publicId- Общедоступный идентификатор сущности, которая сгенерировала ошибку или предупреждение. -
systemId- Системный идентификатор сущности, которая сгенерировала ошибку или предупреждение. -
lineNumber- Номер строки конца текста, вызвавшего ошибку или предупреждение. -
columnNumber- Номер столбца конца текста, вызвавшего ошибку или предупреждение.
SAXParseException
public SAXParseException(String message,
String publicId,
String systemId,
int lineNumber,
int columnNumber,
Exception e)
Создаёт новый SAXParseException с вложенным исключением.
Этот конструктор наиболее полезен для авторов парсеров, которым нужно обернуть исключение, которое не является подклассом SAXException.
Все параметры, кроме сообщения и исключения, как если бы они были предоставлены объектом Locator. Например, если системный идентификатор — URL (включая относительное имя файла), вызывающий метод должен разрешить его полностью перед созданием исключения.
- Параметры:
-
message- Сообщение об ошибке или предупреждении, или null для использования сообщения из вложенного исключения. -
publicId- Общедоступный идентификатор сущности, которая сгенерировала ошибку или предупреждение. -
systemId- Системный идентификатор сущности, которая сгенерировала ошибку или предупреждение. -
lineNumber- Номер строки конца текста, вызвавшего ошибку или предупреждение. -
columnNumber- Номер столбца конца текста, вызвавшего ошибку или предупреждение. -
e- Другое исключение для вложения в данное.
Методы
getPublicId
public String getPublicId()
Получить общедоступный идентификатор сущности, где произошла ошибка.
- Возвращает:
- Строка, содержащая общедоступный идентификатор, или null, если он недоступен.
- См. также:
Locator.getPublicId()
getSystemId
public String getSystemId()
Получить системный идентификатор сущности, где произошла ошибка.
Если системный идентификатор — URL, он будет полностью разрешён.
- Возвращает:
- Строка, содержащая системный идентификатор, или null, если он недоступен.
- См. также:
Locator.getSystemId()
getLineNumber
public int getLineNumber()
Номер строки конца текста, где произошла ошибка.
Первая строка — строка 1.
- Возвращает:
- Целое число, представляющее номер строки, или -1, если он недоступен.
- См. также:
Locator.getLineNumber()
getColumnNumber
public int getColumnNumber()
Номер столбца конца текста, где произошла ошибка.
Первый столбец в строке — позиция 1.
- Возвращает:
- Целое число, представляющее номер столбца, или -1, если он недоступен.
- См. также:
Locator.getColumnNumber()
toString
public String toString()
Переопределяет toString для предоставления более подробного сообщения об ошибке.
- Переопределяет:
-
toStringв классеSAXException - Возвращает:
- Строковое представление этого исключения.
© 1993, 2020, 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.xml/org/xml/sax/SAXParseException.html