На этой странице можно изменить структуру и свойства объектов схемы, составляющих грамматику схемы.
Структура объектов схемы настраивается в разделе Элементы точки расширения. Он размещается в левой верхней части области редактирования.
Свойства объектов схемы настраиваются в разделах <объект-схемы> - Сведения. Эти разделы отображаются в верхней правой части области редактирования в зависимости от типа элемента, выбранного в разделе Элементы точки расширения.
Данная страница складывается из следующих разделов:
Этот раздел позволяет выполнить следующее:
Открыть этот раздел можно напрямую со страницы Определение схемы.
Поле просмотра элементов схемы позволяет выполнить следующее:
Данное дерево состоит из следующих узлов:
Элементы:
Составные элементы:
Атрибуты:
Пример. Элемент расширение указывает, что его потомком может быть последовательность из одного или нескольких элементов ярлык. Для представления элемента ярлык служит ссылка на элемент. Составной элемент Последовательность указывает на последовательность элементов.
Пример: Элемент ярлык обозначает, что его потомком может быть либо элемент описание, либо категория. Элементы описание и категория представлены ссылками на элемент. Составной элемент Совокупность указывает на множество элементов.
Кнопка Добавить элемент позволяет добавить в грамматику схемы точки расширения объявление нового глобального элемента. Это действие доступно при любом выбранном узле. Примечание: Порядок объявлений элементов неважен
Кнопка Добавить атрибут добавляет объявление нового локального атрибута в выбранный элемент в грамматике схемы точки расширения. Это действие доступно для всех выбранных узлов элемент, кроме элемента расширение. Атрибуты узла элемент с расширением постоянны: ИД, имя и точка. Примечание: Порядок объявлений атрибутов неважен.
Для удаления объекта схемы из грамматики щелкните правой кнопкой мыши на нужном узле и выберите Удалить. Это действие доступно для всех узлов кроме узла элемент с расширением. Для необщих схем элемент с расширением - это особый корневой элемент, служащий для определения точки входа в грамматику редактируемой схемы. Для любого расширения, определенного в Редакторе манифеста модуля, должен быть указан родительский элемент с расширением, к которому будет привязываться XML-разметка.
Если в грамматике схемы требуется указать, что потомок элемента складывается из последовательности или совокупности других элементов, выполните следующие действия:
Примечание: Для того чтобы указать, что элемент является потомком другого элемента, в родительском элементе всегда следует применять промежуточный составной элемент Последовательность или Совокупность. Узлы составных элементов - это узлы-связки, тогда как узлы ссылка на элемент являются конечными. Следовательно, узлы составных элементов всегда должны иметь хотя бы одного потомка - ссылку на элемент.
Примечание: Составные элементы Последовательность и Совокупность можно вкладывать друг в друга неограниченное количество раз.
Примечание: В грамматике не должно быть циклов с рекурсивными ссылками элементов. Главным образом недопустимые циклы выглядят так: Элемент A требует своим потомком Элемент B, а для Элемента B требуется потомок Элемент A.
Для указания элемента без потомков, а также если необходимо задать текст в содержимом тега XML (символьное содержимое) просто оставьте структуру элемента как есть, не добавляя в нее ни атрибуты, ни составные элементы, ни ссылки на элементы (содержимое элемента). Примечание: В простом элементе нельзя смешивать разные типы содержимого (текст и содержимое элемента).
Этот раздел представляет собой краткое описание элементов, атрибутов и составных элементов в грамматике схемы.
Открыть этот раздел можно напрямую со страницы Определение схемы.
В поле Текст описания вводится краткое описание текущего элемента, атрибута или составного элемента, выбранного в разделе Элементы точки расширения. В этих полях можно применять разметку HTML.
Примечание: Если изменить описание ссылки на элемент, то изменится и описание в глобальном объявлении элемента, и наоборот.
В этом разделе можно изменять свойства элемента. Элементы бывают двух видов: элемент с расширением и элемент без расширения. Элемент с расширением - это особый корневой элемент, служащий для определения точки входа в грамматику схемы. Элемент без расширения - это глобально объявленный элемент, служащий основным конструктивным блоком грамматики.
Этот раздел открывается либо по выбору узла элемент с расширением, либо по выбору узла элемент без расширения в разделе Элементы точки расширения.
Раздел Сведения об элементе для элемента с расширением.
Раздел Сведения об элементе для элемента без расширения.
В поле Имя вводится имя элемента.
В поле Внутренний можно выбрать значение true или false и указать, является ли элемент внутренним. Внутренний код XML расширения будет помечен в Редакторе манифеста модуля значком предупреждения (это значение по умолчанию). Это поле аналогично атрибуту x-internal в экспортированных пакетах.
В поле Устарел можно выбрать значение true или false и указать, является ли элемент устаревшим. Устаревший код XML расширения будет помечен в Редакторе манифеста модуля значком предупреждения (это значение по умолчанию). Это поле аналогично тегу @deprecated в Javadoc Java.
Если элемент с расширением помечен как устаревший, то следует указать неустаревшую точку расширения с теми же функциями, которую пользователь будет применять вместо него. Это делается с помощью поля Замена.
В поле Метка можно выбрать один из атрибутов элемента, значение которого будет служить меткой этого элемента в Редакторе манифеста модуля. Например, если значение выбрано, то метка узла элемента в разделе Все расширения на странице Расширения в Редакторе манифеста модуля будет выглядеть так: значение-выбранного-атрибута (имя-элемента). Если же значение не выбрано, то метка будет просто (имя-элемента).
В поле Значок можно выбрать один из атрибутов типа ресурса элемента. Значок этого атрибута станет представлять узел элемента в Редакторе манифеста модуля. Для того чтобы значок узла элемента отображался в разделе Все расширения страницы Расширения в Редакторе манифеста модуля, должны соблюдаться следующие условия:
В поле Переводимый можно выбрать значение true или false и указать, является ли текст элемента переводимым. Это поле применимо только для элементов без потомков (содержимое элемента) и для атрибутов, внутри тега XML которых разрешен текст (символьное содержимое). Если текст элемента помечен как переводимый, то в целях поддержки нескольких языков этот текст можно перенести в файл свойств с помощью инструментов PDE.
В нередактируемом поле Эмуляция DTD показывается приблизительное взаимное однозначное преобразование элементов схемы в равнозначные элементы грамматики DTD. DTD (определение типа документа) - более удобно читаемая, упрощенная альтернатива схеме XML для задания формальной грамматики документа XML. Эмуляция DTD задается в следующем формате:
В этом разделе можно изменить свойства составного элемента. Составные элементы бывают двух типов: последовательность и совокупность. Последовательность позволяет указать, что потомок элемента представляет собой последовательность других элементов в грамматике схемы. Совокупность обозначает, что потомок элемента представляет собой множество других элементов.
Этот раздел открывается после выбора узла Последовательность или Совокупность в разделе Элементы точки расширения.
В поле Минимальное количество вхождений указывается минимальное число вхождений данного составного элемента (складывающегося из других простых и/или составных элементов) в код XML расширения. На основе этого значения PDE проверяет ограничения сложности в Редакторе манифеста модуля. Если у Элемента A должен быть ровно один потомок Элемент B или Элемент C, а он представляет собой составной элемент Совокупность минимум с двумя вхождениями, то в коде XML расширения должна быть определена комбинация из 2 экземпляров Элемента B и/или Элемента C в любых сочетаниях.
В поле Максимальное количество вхождений указывается максимальное число вхождений данного составного элемента (складывающегося из других простых и/или составных элементов) в код XML расширения. На основе этого значения PDE проверяет ограничения сложности в Редакторе манифеста модуля. Если у Элемента A должен быть ровно один потомок Элемент B или Элемент C, а он представляет собой составной элемент Совокупность максимум с двумя вхождениями, то в коде XML расширения может быть определена комбинация не более чем из 2 экземпляров Элемента B и/или Элемента C в любых сочетаниях.
Переключатель Не ограничено позволяет указать, что в XML расширения может быть сколько угодно данных составных элементов.
Поле Тип задает тип составного элемента - последовательность или совокупность.
В нередактируемом поле Эмуляция DTD показывается приблизительное взаимное однозначное преобразование составных элементов схемы в равнозначные составные элементы грамматики DTD. Формат записей в эмуляции DTD описывается в разделе Поля раздела Сведения об элементе этого документа.
В этом разделе можно изменять свойства ссылки на элемент. Ссылка на элемент - это ссылка на глобальное объявление элемента в грамматике схемы. Ссылки на элементы служат в качестве конструктивных блоков для определения грамматики глобальных объявлений элементов.
Этот раздел открывается после выбора узла ссылка на элемент в разделе Элементы точки расширения.
В поле Минимальное количество вхождений указывается минимальное число вхождений данного элемента в код XML расширения. На основе этого значения PDE проверяет ограничения сложности в Редакторе манифеста модуля. Если для Элемента A задано минимум 2 вхождения, то в коде XML расширения должно быть определено 2 экземпляра Элемента A.
В поле Максимальное количество вхождений указывается максимальное число вхождений данного элемента в код XML расширения. На основе этого значения PDE проверяет ограничения сложности в Редакторе манифеста модуля. Если для Элемента A задано максимум 2 вхождения, то в коде XML расширения может быть определено не более двух экземпляров Элемента A.
Переключатель Не ограничено позволяет указать, что в XML расширения может быть сколько угодно данных элементов.
В нередактируемом поле Эмуляция DTD показывается приблизительное взаимное однозначное преобразование элементов схемы в равнозначные элементы грамматики DTD. Формат записей в эмуляции DTD описывается в разделе Поля раздела Сведения об элементе этого документа.
Гиперссылка имя-элемента в поле Ссылка позволяет изменить свойства глобального объявления элемента, на который ссылается данный локальный элемент. В результате этого действия в разделе Элементы точки расширения будет выбран узел ссылки на элемент и откроется его раздел Сведения об элементе.
В этом разделе можно изменить свойства атрибута. Атрибуты содержат дополнительную информацию об элементах.
Этот раздел открывается после выбора узла обязательный атрибут, необязательный атрибут, атрибут класса или атрибут ресурса в разделе Элементы точки расширения.
Раздел Сведения об атрибуте для обязательного атрибута типа string, задающего ограничение на перечисление.
Раздел Сведения об атрибуте для необязательного атрибута типа boolean, задающего значение по умолчанию.
Раздел Сведения об атрибуте для атрибута класса, показывающего, что класс, представленный значением данного атрибута, должен расширять заданный класс и/или реализовывать заданный интерфейс.
Раздел Сведения об атрибуте для атрибута ресурса.
Авторы точек расширения могут определять атрибуты, обращающиеся к другим атрибутам. Сделать это можно, задав для атрибутов точки расширения тип identifier (идентификатор) и выбрав атрибут, к которому выполняется обращение. Примером может служить точка расширения org.eclipse.ui.handlers. Атрибут commandId ссылается на команды, определенные в точке расширения org.eclipse.ui.commands.
Затем разработчики расширений, создавая программу обработки, могут выбрать из всех допустимых идентификаторов атрибут commandId. Для несуществующих идентификаторов выдаются предупреждения, что позволяет избежать распространенной ошибки, связанной с ошибкой в написании идентификатора.
В поле Имя вводится название атрибута.
В поле Устарел можно выбрать значение true или false и указать, является ли атрибут устаревшим. Устаревший код XML расширения будет помечен в Редакторе манифеста модуля значком предупреждения (это значение по умолчанию). Это поле аналогично тегу @deprecated в Javadoc Java.
Выберите значение поля Использовать указывает, должен ли атрибут быть указан в определяющем элементе в коде XML расширения. Доступны следующие варианты:
Укажите в поле Значение по умолчанию значение по умолчанию, которое будет присвоено атрибуту, если тот не указан в определяющем элементе в XML расширения. Это поле применяется только если в поле Использовать выбрано значение по умолчанию.
Поле Тип задает тип значения атрибута. Доступны следующие варианты:
В поле Переводимый можно выбрать значение true или false и указать, является ли значение атрибута переводимым. Это поле применяется только если в поле Тип стоит значение string. Если значение атрибута помечено как переводимое, то в целях поддержки нескольких языков это значение можно перенести в файл свойств с помощью инструментов PDE.
В поле Ограничения отображается список строковых значений, ограничивающих собственное значение атрибута. Пустое поле означает отсутствие ограничений. Это поле применяется только если в поле Тип стоит значение string. Примечание: Для обеспечения этих функций в грамматике редактируемой схемы применяется ограничение перечисления в базовом типе string.
В поле Расширяет указывается полное имя класса в переменной classpath целевой платформы (например, org.eclipse.ui.part.EditorPart), производным классом которого должен быть класс, указанный в значении атрибута. PDE проверяет, расширяет ли суперкласс значение атрибута class в добавленной разметке расширения XML. Это поле применяется только если в поле Тип выбрано значение java.
В поле Реализует указывается полное имя интерфейса в переменной classpath целевой платформы (например, org.eclipse.ui.IEditorPart), который должен быть реализован классом, указанным в значении атрибута. PDE проверяет, реализует ли интерфейс значение атрибута class в добавленной разметке расширения XML. Это поле применяется только если в поле Тип выбрано значение java.
Кнопка Добавить... в поле Ограничения позволяет открыть окно Создать ограничение для добавления нового ограничения для значения атрибута. После заполнения полей этого окна новое ограничение добавляется к списку строковых значений, ограничивающих применение значения атрибута. Это действие применяется только если в поле Тип выбрано значение string.
Кнопка Удалить при выбранном строковом значении в поле Ограничения позволяет удалить ограничение из списка ограничений. Это действие применяется только если в поле Тип выбрано значение string.
Если значение, указанное в поле Расширяет, указывает на полное имя класса в переменной classpath целевой платформы, то по гиперссылке Расширяет этот класс открывается в новом окне редактора исходного кода Java. В противном случае по гиперссылке Расширяет открывается мастер Создание класса Java, позволяющий создать новый класс. Это действие применяется только если в поле Тип выбрано значение java.
Если значение, указанное в поле Реализует, указывает на полное имя интерфейса в переменной classpath целевой платформы, то по гиперссылке Реализует этот интерфейс открывается в новом окне редактора исходного кода Java. В противном случае по гиперссылке Реализует открывается мастер Создание класса Java, позволяющий создать новый интерфейс. Это действие применяется только если в поле Тип выбрано значение java.
Кнопка Обзор... открывает окно Выбор типа, в котором можно выбрать класс, существующий в пути к классам целевой платформы, чтобы указать его в поле Расширяет. Это действие применяется только если в поле Тип выбрано значение java.
Кнопка Обзор... открывает окно Выбор типа, в котором можно выбрать интерфейс, существующий в пути к классам целевой платформы, чтобы указать его в поле Реализует. Это действие применяется только если в поле Тип выбрано значение java.