В разделе приведены сведения для диагностики и устранения проблем с Hot Deploy. Рекомендации следует применять с учетом версии IDE, проекта и используемых компонентов ТЕЗИС.
Возможные причины некорректной работы Hot Deploy приведены ниже.
Несоответствие значения cuba.confDir и путей Hot Deploy
Для проектов расширения ТЕЗИС по умолчанию используются пути развертывания файлов, указанные в настройках THESIS Studio.
-
Эти пути должны соответствовать значению свойства
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.
