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. Убедитесь, что Forbidden reference (access rule) в Eclipse установлен на Info (Preferences → Java → Compiler → Errors/Warnings → Deprecated and restricted API → Forbidden reference (access rule)).

1. При необходимости установите Kotlin Plugin for Eclipse, если вам нужно выполнять тесты на Kotlin или разрабатывать Kotlin-расширения. - ПРИМЕЧАНИЕ: По состоянию на 21 сентября 2021 года, кажется, что Kotlin Plugin for Eclipse еще не работает с Eclipse 4.21.
2. При необходимости установите AspectJ Development Tools (AJDT), если вам нужно работать с проектом spring-aspects. - ПРИМЕЧАНИЕ: По состоянию на 21 сентября 2021 года, кажется, что AspectJ Development Tools еще не работают с Eclipse 4.21.
3. При необходимости установите TestNG plugin в Eclipse, если вам нужно выполнять отдельные тестовые классы или тесты в модуле spring-test. - В качестве альтернативы установке TestNG plugin, вы можете выполнить класс org.springframework.test.context.testng.TestNGTestSuite как "JUnit 5" тестовый класс в Eclipse.
4. Соберите spring-oxm из командной строки с помощью . /gradlew :spring-oxm:check.
5. Чтобы применить специфические настройки Spring Framework, выполните . /gradlew cleanEclipse eclipse из командной строки.Импортируйте все проекты в Eclipse (File → Import → Gradle → Existing Gradle Project → Перейдите к локально клонированному каталогу spring-framework → Выберите Finish). - Если вы не установили AJDT, исключите проект spring-aspects из импорта, если вас об этом попросят, или закройте его после импорта. - Если вы столкнетесь с ошибками при импорте, вам может потребоваться установить Java home для Gradle Buildship на путь к вашей установке JDK 8 в Eclipse (Preferences → Gradle → Java home).
6. Если вам нужно выполнять тесты, связанные с JAXB, в проекте spring-oxm и вы хотите, чтобы сгенерированные источники были доступны, добавьте папку build/generated-sources/jaxb в путь сборки (щелкните правой кнопкой мыши на папке jaxb и выберите "Build Path → Use as Source Folder"). - Если вы не видите папку build в проекте spring-oxm, убедитесь, что "Gradle build folder" не исключена из представления. Эта настройка доступна в разделе "Фильтры" в конфигурации Package Explorer (доступна при нажатии на три вертикальные точки в верхнем правом углу Package Explorer).
7. Продолжайте кодирование! ## Известные проблемы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, некоторые из них могут не проходить при запуске из IDE.
   • Решение этой проблемы находится в стадии разработки.
   • Если вы пытаетесь запустить все тесты JUnit изнутри IDE, вам может потребоваться установить следующие параметры виртуальной машины, чтобы избежать ошибок нехватки памяти: -XX:MaxPermSize=2048m -Xmx2048m -XX:MaxHeapSize=2048m

Советы

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