Eclipse 3.1 позволяет разработчикам модулей ограничивать доступность определенных пакетов для других модулей.
Пакет может классифицироваться как:
На основе этих классов доступности PDE создает правила доступа во время компиляции. Поэтому их нарушение приводит к замечаниям или ошибкам во время компиляции - в зависимости от вида нарушения.
Это позволяет избежать ошибок загрузки классов во время выполнения и обнаружить обращения к внутренним (нежелательным для использования) типам.
Доступные пакеты всегда видимы другим модулям. Пакеты API должны всегда быть доступными, о доступности других пакетов нужно решать разработчику модуля.
Для того чтобы объявить пакет доступным, необходимо добавить его в раздел Экспортируемые пакеты на странице Среда выполнения в редакторе манифеста модуля и оставить значение по умолчанию для области видимости без изменения.
В любое время можно скрыть пакет от последующих модулей в потоке путем исключения его из списка в разделе Экспортируемые пакеты на странице Среда выполнения редактора манифеста модуля.
Обращения к типам из запрещенного пакета приводят к ошибкам к ошибкам загрузки классов во время выполнения.
Во избежание таких ошибок:
Примечания.
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, выполните следующие действия для его создания:
Просмотреть правила доступа для каждого элемента classpath можно на странице Путь компоновки Java страницы свойств модуля.
Связанные справочники
Редактор модулей
Страница Обзор
Страница Зависимости
Страница Среда выполнения
Страница Расширения
Страница Точки расширения
Страница Компоновка