LexicalHandler (Платформа Java SE 7)

Все Известные Подынтерфейсы:

TransformerHandler

Все Известные Классы с реализацией:

DefaultHandler2
```
public interface LexicalHandler
```
Обработчик расширения SAX2 для лексических событий.
Этот модуль, и исходный код и документация, находится в Общедоступном Домене, и прибывает без ГАРАНТИИ. См. http://www.saxproject.org для дополнительной информации.

Это - дополнительный обработчик расширения для SAX2, чтобы предоставить лексическую информацию о XML-документе, таком как комментарии и границы раздела CDATA. Средства чтения XML не обязаны распознавать этот обработчик, и это не часть дистрибутивов SAX2 только для ядра.

События в лексическом обработчике применяются ко всему документу, не только к элементу документа, и все лексические события обработчика должны появиться между startDocument обработчика содержимого и endDocument событиями.

Чтобы установить LexicalHandler для средства чтения XML, используйте setProperty метод с именем свойства http://xml.org/sax/properties/lexical-handler и объект, реализовывая этот интерфейс (или нуль) как значение. Если читатель не сообщит о лексических событиях, то это бросит a SAXNotRecognizedException когда Вы пытаетесь зарегистрировать обработчик.

С тех пор:

SAX 2.0 (расширения 1.0)

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`comment(char[] ch, int start, int length)` Сообщите о XML-комментарии где угодно в документе.
`void`	`endCDATA()` Сообщите о конце раздела CDATA.
`void`	`endDTD()` Сообщите о конце объявлений DTD.
`void`	`endEntity(String name)` Сообщите о конце объекта.
`void`	`startCDATA()` Сообщите о запуске раздела CDATA.
`void`	`startDTD(String name, String publicId, String systemId)` Сообщите о запуске объявлений DTD, если любой.
`void`	`startEntity(String name)` Сообщите о начале некоторых внутренних и внешних объектов XML.

- Деталь метода
  - startDTD
```
void startDTD(String name,
            String publicId,
            String systemId)
              throws SAXException
```
    Сообщите о запуске объявлений DTD, если любой.
    Этот метод предназначается, чтобы сообщить о начале объявления DOCTYPE; если у документа не будет никакого объявления DOCTYPE, то этот метод не будет вызван.
    
    Все объявления, о которых сообщают через DTDHandler или DeclHandler события должны появиться между startDTD и endDTD события. Объявления, как предполагается, принадлежат внутреннему подмножеству DTD, если они не появляются между startEntity и endEntity события. О комментариях и инструкциях обработки от DTD нужно также сообщить между startDTD и endDTD событиями в их первоначальном заказе (логического) возникновения; они не обязаны появляться в их корректных расположениях относительно событий DTDHANDLER ИЛИ DECLHANDLER, как бы то ни было.
    
    Отметьте, что start/endDTD события появятся в пределах start/endDocument событий от ContentHandler и перед первым startElement событие.
    
    Параметры:
    name - Имя типа документа.
    publicId - Объявленный общедоступный идентификатор для внешнего подмножества DTD, или нуль, если ни один не был объявлен.
    systemId - Объявленный системный идентификатор для внешнего подмножества DTD, или нуль, если ни один не был объявлен. (Отметьте, что это не разрешается против URI основы документа.)
    
    Броски:
    
    SAXException - Приложение может повысить исключение.
    См. Также:
    endDTD(), startEntity(java.lang.String)
  - endDTD
```
void endDTD()
            throws SAXException
```
    Сообщите о конце объявлений DTD.
    Этот метод предназначается, чтобы сообщить о конце объявления DOCTYPE; если у документа не будет никакого объявления DOCTYPE, то этот метод не будет вызван.
    
    Броски:
    
    SAXException - Приложение может повысить исключение.
    См. Также:
    startDTD(java.lang.String, java.lang.String, java.lang.String)
  - startEntity
```
void startEntity(String name)
                 throws SAXException
```
    Сообщите о начале некоторых внутренних и внешних объектов XML.
    Создание отчетов объектов параметра (включая внешнее подмножество DTD) является дополнительными, и драйверами SAX2, которые сообщают, что события LexicalHandler, возможно, не реализуют это; можно использовать http://xml.org/sax/features/lexical-handler/parameter-entities функция, чтобы запросить или управлять созданием отчетов объектов параметра.
    
    Об общих объектах сообщают с их регулярными именами, объектам параметра предварительно ожидали '%' к их именам, и у внешнего подмножества DTD есть имя псевдообъекта" [дата]".
    
    Когда драйвер SAX2 обеспечивает эти события, все другие события должны быть должным образом вложены в пределах, запускают/заканчиваются события объекта. Нет никакого дополнительного требования этого события от DeclHandler или DTDHandler должным образом упорядочить.
    
    Отметьте, что о пропущенных объектах сообщат через skippedEntity событие, которое является частью интерфейса ContentHandler.
    
    Из-за модели событий потоковой передачи, которую использует SAX, о некоторых границах объекта нельзя сообщить ни при каких обстоятельствах:
    - общие объекты в пределах значений атрибута
    - объекты параметра в пределах объявлений
    Они будут тихо расширены без индикации относительно того, где исходные границы объекта были.
    
    Отметьте также, что о границах символьных ссылок (которые не являются действительно объектами так или иначе) не сообщают.
    
    Все start/endEntity события должны быть должным образом вложены.
    Параметры:
    name - Имя объекта. Если это будет объект параметра, то имя начнется 'с %', и если это будет внешнее подмножество DTD, то это будет" [дата]".
    
    Броски:
    
    SAXException - Приложение может повысить исключение.
    См. Также:
    endEntity(java.lang.String), DeclHandler.internalEntityDecl(java.lang.String, java.lang.String), DeclHandler.externalEntityDecl(java.lang.String, java.lang.String, java.lang.String)
  - endEntity
```
void endEntity(String name)
               throws SAXException
```
    Сообщите о конце объекта.
    
    Параметры:
    name - Имя объекта, который заканчивается.
    
    Броски:
    
    SAXException - Приложение может повысить исключение.
    См. Также:
    startEntity(java.lang.String)
  - startCDATA
```
void startCDATA()
                throws SAXException
```
    Сообщите о запуске раздела CDATA.
    О содержании раздела CDATA сообщат через постоянного клиента characters событие; это событие предназначается только, чтобы сообщить о границе.
    
    Броски:
    
    SAXException - Приложение может повысить исключение.
    См. Также:
    endCDATA()
  - endCDATA
```
void endCDATA()
              throws SAXException
```
    Сообщите о конце раздела CDATA.
    
    Броски:
    
    SAXException - Приложение может повысить исключение.
    См. Также:
    startCDATA()
  - комментарий
```
void comment(char[] ch,
           int start,
           int length)
             throws SAXException
```
    Сообщите о XML-комментарии где угодно в документе.
    Этот обратный вызов будет использоваться для комментариев внутри или снаружи элемента документа, включая комментарии во внешнем подмножестве DTD (если считано). Комментарии в DTD должны быть должным образом вложены внутри start/endDTD и start/endEntity события (если использующийся).
    
    Параметры:
    ch - Массив, содержащий символы в комментарии.
    start - Стартовая позиция в массиве.
    length - Число символов, чтобы использовать от массива.
    
    Броски:
    
    SAXException - Приложение может повысить исключение.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный LexicalHandler

Сводка метода

Деталь метода

startDTD

endDTD

startEntity

endEntity

startCDATA

endCDATA

комментарий