Горячее развертывание (Hot Deploy)

В разделе приведены сведения для диагностики и устранения проблем с Hot Deploy. Рекомендации следует применять с учетом версии IDE, проекта и используемых компонентов ТЕЗИС.

Возможные причины некорректной работы Hot Deploy приведены ниже.

Несоответствие значения cuba.confDir и путей Hot Deploy

Для проектов расширения ТЕЗИС по умолчанию используются пути развертывания файлов, указанные в настройках THESIS Studio.

  1. Эти пути должны соответствовать значению свойства cuba.confDir. По умолчанию для всех контекстов используется следующее значение:

    cuba.confDir=${catalina.base}/conf/${cuba.webContextName}
    

    Несоответствие может возникнуть по следующим причинам:

    • пути в настройках Hot Deploy были изменены вручную и не соответствуют значению cuba.confDir;

    • значение свойства cuba.confDir было изменено, но пути в настройках Hot Deploy не были приведены в соответствие;

    • установлена переменная среды CATALINA_BASE или CATALINA_HOME, содержащая путь к другой рабочей сборке. В этом случае файлы будут развертываться в сборку, указанную в переменной среды.

Изменения не поддерживаются Hot Deploy

Не все изменения могут применяться через Hot Deploy. В соответствии с документацией CUBA через Hot Deploy применяются только следующие изменения:

  • дескрипторы и контроллеры экранов, включая статические методы, расположенные в модулях web и gui;

  • реализации сервисов среднего слоя, расположенные в модуле core;

  • шаблоны портала.

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

Некорректное поведение

При развертывании копируются дополнительные классы

При Hot Deploy может копироваться не только контроллер или дескриптор экрана, но и другие классы. Такое поведение является штатным, так как при развертывании выполняется повторная компиляция контроллеров и связанных с ними классов.

В результате по зависимостям может быть перекомпилировано значительное количество классов модуля web, после чего они также будут скопированы через механизм Hot Deploy. Это может привести к неочевидным ошибкам, например к ClassCastException.

Возникает ClassCastException для одинаковых классов

Если возникает ошибка ClassCastException, а в описании указаны два одинаковых класса с идентичными полными квалифицированными именами, возможной причиной является конфликт загрузчиков классов: исходного класса и класса, скопированного через механизм Hot Deploy.

Для устранения проблемы выполните одно из действий:

  • завершите работу Tomcat и выполните задачи Gradle cleanConf, deploy, start;

  • выполните задачу restart;

  • заново запустите приложение через конфигурацию запуска. В этом случае также выполняются задачи cleanConf, deploy, start.