- PVSM.RU - https://www.pvsm.ru -

Еще немного про разработку плагинов для IntelliJ

В последнее время на Хабре стали появляться статьи про создание расширений для Intellij IDE — одна [1], а вот и другая [2].

Я продолжу эту славную тенденцию и постараюсь описать те места Intellij OpenAPI, которых еще не коснулись; а примером будет plug-in [3] с веселыми комиксами.

Еще немного про разработку плагинов для IntelliJ

Расширение, на самом деле, занимается всего одной простой вещью — отображает в панельке свежие картинки с моего любимого Geek&Poke [4], периодически выкачивая их с сайта и кэшируя на диск. Исходники, кстати, на GitHub'e [5].

Для особо бдительных — комиксы находятся под доброй лицензией CC BY-SA 3.0 [6], так что все законно:)

Поскольку само создание проекта, написание plugin.xml и другие основные вещи — как и ссылки на соответствующую документацию — уже описаны в вышеупомянутых статьях, повторяться не будем; и я просто опишу несколько возникших у меня при разработке вопросов с их решениями.

Поддержка proxy

IntelliJ IDEA (да и другие IDE) умеют подключаться к сети через прокси, настройка подробно описана в документации [7].

А вот чтобы заставить свое расширение использовать глобальные настройки IDE, стоит посмотреть в сторону класса com.intellij.util.net.HttpConfigurable. В его публичных полях содержится вся необходимая информация: флаг USE_HTTP_PROXY, к примеру, говорит, используем ли мы вообще прокси или нет; а также есть информация о хосте, порте и пользователе.

Проще всего воспользоваться методом prepareURL, вызывая его для каждого соединения:

  /**
   * Call this function before every HTTP connection.
   * If system configured to use HTTP proxy, this function
   * checks all required parameters and ask password if
   * required.
   * @param url URL for HTTP connection
   * @throws IOException
   */
  public void prepareURL (String url) throws IOException {

Например, в коде для некоторого url это может выглядеть так:

    // Ensure that proxy (if any) is set up for this request.
    final HttpConfigurable httpConfigurable = HttpConfigurable.getInstance();
    httpConfigurable.prepareURL(url.toExternalForm());

На форуме JetBrains кто-то ругается [8], что этот метод не помогает — но, по-моему, зря они так.

Запуск процесса при инициализации plug-in'a

Мне было нужно запустить отдельный поток, который бы периодически проверял главную страницу на наличие обновлений.

В этом поможет ApplicationComponent. Типы компонентов и их создание замечательно описаны в документации, в статье Plugin Structure [9].

Добавим в plugin.xml наш компонент:

    <application-components>
        <component>
            <implementation-class>com.abelsky.idea.geekandpoke.ComicsPlugin</implementation-class>
            <interface-class>com.abelsky.idea.geekandpoke.ComicsPlugin</interface-class>
        </component>
    </application-components>

А в нем самом определим метод initComponent:

public class ComicsPlugin implements ApplicationComponent {

    private static final int UPDATE_PERIOD = 15 * 60 * 60 * 1000;

    // Этот метод будет вызываться один раз при инициализации расширения;
    // если бы использовали ProjectComponent - то для каждого проекта.
    @Override
    public void initComponent() {
        startUpdateTimer();
    }

    private void startUpdateTimer() {
        final Timer timer = new Timer("Geek and Poke updater");
        timer.schedule(new TimerTask() {
            @Override
            public void run() {
                // А тут что-то делаем каждые 15 минут...
            }
        }, 0, ComicsPlugin.UPDATE_PERIOD);
    }

Локализация

Для локализации удобно использовать вот такой сниппет:

package com.abelsky.idea.geekandpoke.messages;

// ...

public class MessageBundle {

    private static Reference<ResourceBundle> bundleRef;

    // Сами тексты лежат в com/abelsky/idea/geekandpoke/messages/MessageBundle.properties
    //  - стандартный key-value .properties-файл.
    @NonNls
    private static final String BUNDLE = "com.abelsky.idea.geekandpoke.messages.MessageBundle";

    private MessageBundle() {
    }

    public static String message(@PropertyKey(resourceBundle = BUNDLE)String key, Object... params) {
        return CommonBundle.message(getBundle(), key, params);
    }

    private static ResourceBundle getBundle() {
        ResourceBundle bundle = null;
        if (MessageBundle.bundleRef != null) {
            bundle = MessageBundle.bundleRef.get();
        }

        if (bundle == null) {
            bundle = ResourceBundle.getBundle(BUNDLE);
            MessageBundle.bundleRef = new SoftReference<ResourceBundle>(bundle);
        }
        return bundle;
    }

}

Здесь стоит обратить внимание на несколько моментов.

Первое — храним ResourceBundle в SoftReference [10]. Это достаточно распространенная практика в исходниках IDEA — держать как можно больше объектов в не-hard ссылках.

К слову, советую посмотреть на класс com.intellij.reference.SoftReference — именно его сами разработчики используют вместо реализации из java.lang.ref. Отличие в том, что при подозрениях в утечке памяти com.intellij.reference.SoftReference можно быстро переделать в hard-ссылку, а это поможет при профилировании.

Второе — аннотация org.jetbrains.annotations.PropertyKey. Она указывает на то, что аннотированный аргумент метода может являться только строкой из указанного в параметре resourceBundle бандла. Ее использование добавляет уверенности в том, что ключи в .properties-файле и в коде не рассинхронизировались (да еще и рефакторинг в IDEA многое учится делать, так как появляется связь между ключем и бандлом).

Третье — аннотации org.jetbrains.annotations.NonNls/org.jetbrains.annotations.Nls, помечающие строки, которые не должны (или, наоборот, должны) быть переведены. Документация от JetBrains по использованию — здесь [11].

Нотификации

При некоторых событиях хочется показать красивое уведомление. Такое, например:

Еще немного про разработку плагинов для IntelliJ

Здесь стоит смотреть в сторону класса com.intellij.notification.Notifications. Например, так:

    private void notifyNewEntry() {
        final Notification newEntryNotification = new Notification(
                /* Группа нотификаций */
                MessageBundle.message("notification.new.strip.group"),		

                /* Заголовок */
                MessageBundle.message("notification.new.strip.title"),

                /* Содержание */
                MessageBundle.message("notification.new.strip.content"),

                NotificationType.INFORMATION);

        // Не обязательно вызывать из UI-треда - внутри все равно будет сделан invokeLater.
        Notifications.Bus.notify(newEntryNotification);
    }

Группа уведомления отображается в настройках IDE, подробнее — в документации [12].

Еще немного про разработку плагинов для IntelliJ

Настройки

Еще немного про разработку плагинов для IntelliJ

Про то, как сделать страницу настроек для plug-in'a, подробно написано в документации [13].

Но если вкратце, то, во-первых, регистрируемся в plugin.xml:

    <extensions defaultExtensionNs="com.intellij">
    	<!-- ... -->
        <applicationConfigurable instance="com.abelsky.idea.geekandpoke.ui.SettingsPanel"/>
    </extensions>

Во-вторых, реализуем методы интерфейса com.intellij.openapi.options.Configurable. Из них самый важный — createComponent — должен вернуть компонент, на котором отображаются наши настройки.

Offline cache

Моему plug-in'у понадобилось хранить картинки на диске — в принципе, тот же вопрос встанет и при записи всяких кэшей, которым не место ни в директории проекта, ни в %TMP%. Можно, к примеру, записывать их куда-нибудь в %USERPROFILE%, а можно сделать интереснее — использовать для этого директорию, в которую сам plug-in установлен.

Расширения по-умолчанию устанавливаются в %USERPROFILE%/.IdeaIC11/config/plugins/PLUGIN_NAME; этот путь, впрочем, можно поменять установкой переменной idea.plugins.path в idea.properties.

    // PLUGIN_ID - значение элемента id в plugin.xml.
    final PluginId id = PluginId.getId(PLUGIN_ID);

    final IdeaPluginDescriptor plugin = PluginManager.getPlugin(id);

    // Путь к установленному расширению.
    File path = plugin.getPath();

Полученный путь, к слову, легко может оказаться JAR-файлом — если расширение не распаковано в отдельную директорию.

P.S.

Надеюсь, этот короткий FAQ будет полезен начинающим копаться в платформе IntelliJ. А я, тем временем, приступаю к тому, ради чего и начал во всем этом разбираться — IDEA-плагину для поддержки одного очень интересного языка программирования;)

Автор: andy722


Сайт-источник PVSM.RU: https://www.pvsm.ru

Путь до страницы источника: https://www.pvsm.ru/plugins/14414

Ссылки в тексте:

[1] одна: http://habrahabr.ru/post/148996/

[2] другая: http://habrahabr.ru/post/149100/

[3] plug-in: http://plugins.jetbrains.com/plugin?pr=idea&pluginId=7088

[4] Geek&Poke: http://geekandpoke.typepad.com/

[5] GitHub'e: https://github.com/andy722/idea-comics

[6] CC BY-SA 3.0: http://creativecommons.org/licenses/by-sa/3.0/

[7] в документации: http://www.jetbrains.com/idea/webhelp/http-proxy.html

[8] кто-то ругается: http://devnet.jetbrains.net/thread/279485

[9] Plugin Structure: http://confluence.jetbrains.net/display/IDEADEV/IntelliJ+IDEA+Plugin+Structure#IntelliJIDEAPluginStructure-PluginComponents

[10] SoftReference: http://docs.oracle.com/javase/1.4.2/docs/api/java/lang/ref/SoftReference.html

[11] здесь: http://www.jetbrains.com/idea/webhelp/extracting-hard-coded-string-literals.html

[12] документации: http://www.jetbrains.com/idea/webhelp/notifications.html

[13] документации: http://confluence.jetbrains.net/display/IDEADEV/Customizing+the+IDEA+Settings+Dialog