Гайд по импорту проектов Spring Framework в Eclipse/STS

Данный документ поможет вам пройти процесс импорта проектов Spring Framework в Eclipse или Spring Tool Suite (STS). Рекомендуется использовать последнюю версию Eclipse. Минимально необходимым требованием является наличие Eclipse с полной поддержкой Java 17 и Eclipse Buildship.

Далее представлены инструкции, проверенные на STS 4.12.0 (скачать) (основанный на Eclipse 4.21) с использованием Eclipse Buildship. Эти инструкции должны работать с самой последней версией Eclipse при условии установки Buildship. Обратите внимание, что STS 4 уже включает Buildship по умолчанию.

Если вы используете Eclipse 4.21, вам потребуется установить поддержку Java 17 для Eclipse 2021-09 (4.21) через Eclipse Marketplace.

Шаги_Когда вам будет указано выполнить . /gradlew из командной строки, убедитесь, что вы выполняете его внутри локально клонированного рабочего каталога spring-framework. _

1. Убедитесь, что Запрещённый доступ (правило доступа) в Eclipse установлено как Info (Настройки -> Java -> Компилятор -> Ошибки/Предупреждения -> Устаревшие и ограниченные API -> Запрещённый доступ (правило доступа)).

2. По желанию установите плагин Kotlin для Eclipse, если вам требуется выполнение тестов на Kotlin или разработка расширений на Kotlin.

   • Примечание: На 21 сентября 2021 года кажется, что плагин Kotlin для Eclipse ещё не работает с Eclipse 4. 21.

3. По желанию установите инструменты разработки AspectJ (AJDT), если вам требуется работать с проектом spring-aspects.

   • Примечание: На 21 сентября 2021 года кажется, что инструменты разработки AspectJ ещё не работают с Eclipse 4. 21.

4. По желанию установите плагин TestNG в Eclipse, если вам требуется выполнение отдельных классов тестов TestNG или тестов в модуле spring-test.

   • В качестве альтернативы установке плагина TestNG вы можете выполнить класс org.springframework.test.context.testng.TestNGTestSuite как "JUnit 5" тестовый класс в Eclipse.

5. Соберите spring-oxm из командной строки с помощью . /gradlew :spring-oxm:check.

6. Чтобы применить специфические настройки для Spring Framework, запустите . /gradlew cleanEclipse eclipse из командной строки.Импортируйте все проекты в Eclipse (Файл > Импорт > Gradle > Существующий Gradle проект > Навигация до локально клонированного каталога spring-framework > Выберите завершение).

   • Если вы не установили AJDT, исключите проект spring-aspects при импорте, если вас спросят, или закройте его после импорта.
   • Если вы столкнулись с ошибками во время импорта, возможно, вам потребуется установить Java home для Gradle Buildship на путь к вашей установке JDK 8 в Eclipse (Настройки > Gradle > Java home).

7. Если вам требуется выполнение тестов, связанных с JAXB, в проекте spring-oxm, и вы хотите иметь доступ к сгенерированным источникам, добавьте папку build/generated-sources/jaxb в путь сборки (щелкните правой кнопкой мыши по папке jaxb и выберите "Путь сборки > Использовать как исходную папку").

   • Если вы не видите папку build в проекте spring-oxm, убедитесь, что "папка сборки Gradle" не отфильтрована из представления. Эта настройка доступна в разделе «Фильтры» в конфигурации пакетного эксплорера (доступна путём нажатия на три вертикальных точки в правом верхнем углу пакетного эксплорера).

8. Кодируйте!

Известные проблемы1. spring-core должен быть предварительно скомпилирован из-за переупакованных зависимостей.

• Увидеть задачи *RepackJar в файле сборки spring-core.gradle.

1. spring-oxm должен быть предварительно скомпилирован из-за сгенерированных типов JAXB для тестов.
   • Обратите внимание, что выполнение команды ./gradlew :spring-oxm:check, как указано выше в разделе Шаги, скомпилирует spring-core и сгенерирует типы JAXB для spring-oxm.
2. spring-aspects не компилируется из-за ссылок на аспекты, неизвестные Eclipse.
   • Если вы установили AJDT в Eclipse, это должно работать.
3. Хотя JUnit-тесты проходят с командной строки с использованием Gradle, некоторые из них могут провалиться при запуске из среды разработки.
   • Разрешение этой проблемы находится в процессе.
   • При попытке запустить все JUnit-тесты внутри среды разработки вам может потребоваться установить следующие параметры JVM для избежания ошибок "out of memory": -XX:MaxPermSize=2048m -Xmx2048m -XX:MaxHeapSize=2048m.

Советы

В любом случае, пожалуйста, не проверяйте в систему свои собственные сгенерированные файлы .classpath, .project или папку .settings. Вы заметите, что эти файлы уже намеренно включены в .gitignore. Та же политика применяется к метаданным IDEA.