Правила доступа

Eclipse 3.1 позволяет разработчикам модулей ограничивать доступность определенных пакетов для других модулей.

Пакет может классифицироваться как:

  1. Доступно
  2. Запрещено
  3. Внутренний
  4. Внутренний с исключениями

На основе этих классов доступности PDE создает правила доступа во время компиляции. Поэтому их нарушение приводит к замечаниям или ошибкам во время компиляции - в зависимости от вида нарушения.

Это позволяет избежать ошибок загрузки классов во время выполнения и обнаружить обращения к внутренним (нежелательным для использования) типам.

Доступные пакеты

Доступные пакеты всегда видимы другим модулям.   Пакеты API должны всегда быть доступными, о доступности других пакетов нужно решать разработчику модуля.

Для того чтобы объявить пакет доступным, необходимо добавить его в раздел Экспортируемые пакеты на странице Среда выполнения в редакторе манифеста модуля и оставить значение по умолчанию для области видимости без изменения.

Доступные пакеты

 

Запрещенные пакеты

В любое время можно скрыть пакет от последующих модулей в потоке путем исключения его из списка в разделе Экспортируемые пакеты на странице Среда выполнения редактора манифеста модуля.

Обращения к типам из запрещенного пакета приводят к ошибкам к ошибкам загрузки классов во время выполнения.

Во избежание таких ошибок:

  1. Компилятор помечает обращения к недоступным типам сообщением как ошибки.
  2. Типы из недоступных пакетов не предлагаются помощником по работе с содержимым.

Примечания.

  1. Все модули Eclipse SDK перечисляют все свои пакеты в разделе Экспортируемые пакеты, поэтому доступ разрешен ко всем пакетам в SDK.
  2. Уровень серьезности для запрещенных обращений устанавливается на странице параметров Открыть страницу параметров серьезности неполадок Java > Компилятор > Ошибки/Предупреждения > Устаревший и запрещенный API.

    Рекомендуемый уровень серьезности для них - ошибка.

Запрещенные параметры

Внутренние пакеты

Внутренние пакеты - это пакеты, которые не предназначены для использования другими модулями. Но они доступны им по умолчанию.

Внутренние пакеты скрываются от других модулей только в строгом режиме запуска Eclipse (то есть при запуске с аргументом VM -Dosgi.resolverMode=strict).

Внутренние пакеты должны быть показаны в разделе Экспортируемые пакеты на странице Среда выполнения редактора манифеста модуля с выбранной опцией скрытый.

запрещенный доступ

Для препятствия доступу к внутренним пакетам других модулей принимаются две меры:

запрещенный доступ

запрещение помощника по содержимому

Уровень серьезности для нежелательных обращений можно установить на странице параметров Открыть страницу параметров серьезности неполадок Java > Компилятор > Ошибки/Предупреждения > Устаревший и запрещенный API.

Нежелательные параметры

Внутренние пакеты с исключениями

Необходимо разрешить модулю предоставлять полный доступ к своим внутренним пакетам для заданных дружественных ("friend") модулей. Например, код PDE разделен на несколько модулей, и модуль org.eclipse.pde.ui должен иметь полный доступ к внутренним пакетам org.eclipse.pde.core.

В следующем примере дружественный модуль org.eclipse.pde.ui имеет полный доступ к пакету org.eclipse.pde.internal.core.bundle из модуля org.eclipse.pde.core.

Дружественные модули

Дружественные модули могут обращаться к любому типу пакета org.eclipse.pde.internal.core.bundle без замечаний компилятора.

Если же какой-нибудь другой модуль обратится к типу из пакета org.eclipse.pde.internal.core.bundle, компилятор пометит это обращение как нежелательное обращение, как описано в предыдущем разделе.

Задействование ограничений доступа

Для использования описанных возможностей модуль должен содержать файл манифеста комплекта OSGi MANIFEST.MF. PDE обеспечит все, что требуется, включая работу с путем к классам модуля.

Если в модуле нет файла MANIFEST.MF, выполните следующие действия для его создания:

  1. Откройте файл plugin.xml в редакторе манифеста.
  2. В разделе Содержимое модуля на странице Обзор перейдите по ссылке 'создать манифест комплекта OSGi'.

преобразование в manifest.mf

Просмотр правил доступа

Просмотреть правила доступа для каждого элемента classpath можно на странице Путь компоновки Java страницы свойств модуля.

Свойства пути компоновки Java

Связанные справочники Связанные справочники

Редактор модулей
Страница Обзор
Страница Зависимости
Страница Среда выполнения
Страница Расширения
Страница Точки расширения
Страница Компоновка