Руководство по импорту проектов Spring Framework в Eclipse или Spring Tool Suite (STS)

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

Данные инструкции были протестированы на STS 4.3.2 (скачать) (основанный на Eclipse 4.12) с Eclipse Buildship. Инструкции должны работать с последней версией Eclipse, если вы установите Buildship. Обратите внимание, что STS 4 поставляется с предустановленным Buildship.

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

1. Убедитесь, что Eclipse запускается с JDK 8.

   • Например, на Mac OS это можно настроить в файле Info.plist, расположенном в папке Contents установленного экземпляра Eclipse или STS (например, файл Eclipse.app).

2. Установите плагин Kotlin для Eclipse в Eclipse.

3. Установите Eclipse Groovy Development Tools в Eclipse.

4. Переключитесь на Groovy 2.5 (Preferences -> Groovy -> Compiler -> Переключиться на 2.5...) в Eclipse.

5. Измените Forbidden reference (access rule) в Eclipse с Error на Warning (Preferences -> Java -> Compiler -> Errors/Warnings -> Устаревшие и ограниченные API -> Forbidden reference (access rule)).

6. По желанию установите AspectJ Development Tools (AJDT), если вам нужно работать с проектом spring-aspects. AspectJ Development Tools, доступные на Eclipse Marketplace, были протестированы с этими инструкциями с использованием STS 4.5 (Eclipse 4.14).

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

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

9. Чтобы применить проектные настройки, выполните команду . /gradlew eclipseBuildship из командной строки.

10. Импортируйте в Eclipse (File -> Import -> Gradle -> Existing Gradle Project -> Перейти к локально клонированному каталогу spring-framework -> Выбрать Finish). - Если вы не установили AJDT, исключите проект spring-aspects из импорта, если вас об этом спросят, или закройте его после импорта.

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

11. Если вам нужно выполнять тесты, связанные с JAXB, в проекте spring-oxm и вы хотите иметь доступ к сгенерированным исходным файлам, добавьте папку build/generated-sources/jaxb в путь сборки (щелкните правой кнопкой мыши по папке jaxb и выберите Build Path -> Use as Source Folder). - Если вы не видите папку build в проекте spring-oxm, убедитесь, что "Gradle build folder" не отфильтрован из представления. Эта настройка доступна в разделе "Фильтры" в конфигурации пакетного эксплорера (доступна по клику на маленькую стрелку вниз в правом верхнем углу пакетного эксплорера).

12. Кодируй! ## Знаменитые проблемы1. spring-core и spring-oxm должны быть предварительно скомпилированы из-за переупакованных зависимостей.

• См. задачи *RepackJar в процессе сборки.

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

Советы

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