Класс 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, оно наследует возможность обертывания другого исключения.
- С:
- SAX 1.0
- Версия:
- 2.0.1 (sax2r2)
- См. также:
-
SAXException,Locator,ErrorHandler, Сериализованная форма
Конструкторы
| Конструктор и описание |
|---|
SAXParseException(String message,
Locator locator) Создаёт новый SAXParseException из сообщения и локатора. |
SAXParseException(String message,
Locator locator,
Exception e) Обертывает существующее исключение в SAXParseException. |
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 с вложенным исключением. |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
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 из сообщения и локатора.
Этот конструктор особенно полезен, когда приложение создаёт собственное исключение из внутри вызова ContentHandler.
- Параметры:
-
message- Сообщение об ошибке или предупреждении. -
locator- Объект локатора для ошибки или предупреждения (может быть null). - См. также:
Locator
SAXParseException
public SAXParseException(String message,
Locator locator,
Exception e)
Обертывает существующее исключение в SAXParseException.
Этот конструктор особенно полезен, когда приложение создаёт собственное исключение из внутри вызова ContentHandler и ему необходимо обернуть существующее исключение, которое не является подклассом SAXException.
- Параметры:
-
message- Сообщение об ошибке или предупреждении или null, чтобы использовать сообщение из вложенного исключения. -
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.