В этой статье представлен краткий обзор моих шагов по настройке среды на моем ноутбуке с Windows 10 для программирования на Java. Если вы выполните эти шаги, вы сможете приступить к кодированию, сборке, тестированию и упаковке приложений Java 14 на своем ноутбуке примерно через 20 минут.
Элементы, используемые в этой среде,
- Код Visual Studio
- Пакет расширений Java для VS Code
- JDK 14 (OpenJDK)
- Мавен
- Юнит
Скриншоты взяты из процесса установки в песочнице Windows (см. Введение в эту статью), но описание в равной степени относится и к вашей среде Windows за пределами песочницы.
Шаги:
- Установить VS-код
- Установите пакет расширений Java для VS Code
- Установить JDK
- Настроить JDK в VS Code
- Установить Мавен
- Настроить путь к исполняемому файлу Maven в VS Code
- Установите JUnit 5
- Настройте JUnit 5 в VS Code
- Протестируйте и запустите сгенерированное Java-приложение
В деталях:
Установить VS-код
Загрузите VS Code с https://code.visualstudio.com/download и запустите установщик. Однако я предполагаю, что у вас, вероятно, уже настроен и запущен VS Code.
После завершения загрузки и установки запустите VS Code.
Установите пакет расширений Java для VS Code
Откройте вкладку «Расширение». Введите «java ext» и щелкните ссылку «Установить» для элемента пакета расширений Java. Это загрузит и установит кураторский пакет расширений для разработки Java в VS Code.
Установить JDK
Откройте палитру команд — нажав CTRL + Shift + P — введите «java run». Затем выберите Java Configure Java Runtime из раскрывающегося списка.
Я выбрал OpenJDK 14, затем нажал кнопку загрузки.
Процесс загрузки запущен. Установщик загружен, и я запустил его после завершения загрузки.
Установщик проведет меня через очень простой процесс установки:
Как только установщик завершит свою задачу, он сообщит мне об этом. Следующий шаг — сообщить VS Code, где найти JDK.
Настроить JDK в VS Code
Сначала найдите место, где был установлен JDK. В моем случае это C:\Program Files\AdoptOpenJDK\jdk-14.0.2.12-hotspot — расположение по умолчанию.
Откройте settings.json с помощью CTRL+SHIFT+P и введите «sett»
Добавьте новую запись в settings.json с именем java.home и определите расположение JDK в качестве ее значения. Примечание: в Windows обратную косую черту в пути к каталогу необходимо экранировать — используя двойную обратную косую черту:
"java.home": "C:\\Program Files\\AdoptOpenJDK\\jdk-14.0.2.12-hotspot"
Теперь также определите переменную среды (Windows) JAVA_HOME:
и заставьте его ссылаться на каталог, содержащий каталог bin с java.exe и javac.exe.
Установить Мавен
Загрузите Maven с https://maven.apache.org/download.cgi,. В частности, я скачал Maven 3.6.3 Binary Zip Archive File.
Установите Maven: разархивируйте zip-файл, например, в c:\Program Files\Maven:
Настроить путь к исполняемому файлу Maven в VS Code
Расширение Maven в VS Code должно знать, как оно может запускать Maven. Поэтому необходимо настроить команду среды выполнения Maven. Откройте settings.json (снова) и добавьте настройки с именем «maven.executable.path» и установите в качестве значения полный путь к файлу mvn.cmd.
"maven.executable.path": "C:\\Program Files\\Maven\\apache-maven-3.6.3\\bin\\mvn.cmd"
В качестве альтернативы добавьте каталог Maven bin в системную переменную PATH.
Установите JUnit 5
Загрузите все включенные загрузки JUnit 5 (junit-platform-console-standalone) — с https://repo1.maven.org/maven2/org/junit/platform/junit-platform-console-standalone/
Я скачал релиз 1.7.0 (из каталога https://repo1.maven.org/maven2/org/junit/platform/junit-platform-console-standalone/1.7.0/) в виде файла junit- платформа-консоль-автономный-1.7.0-all.jar. Я скопировал этот файл в c:\Program Files\JUnit.
Настройте JUnit 5 в VS Code
Настройте параметры JUnit в Java Project в файле settings.json. Откройте этот файл в VS Code с помощью CTRL+SHIFT+P и введите «sett»
"java.project.referencedLibraries": [ "lib/**/*.jar", "C:\\Program Files\\JUnit\\junit-platform-console-standalone-1.7.0-all.jar" ]
Создайте новое Java-приложение
В палитре команд (CTRL+Shift+P) введите «java pr» и нажмите «Создать проект Java».
Нажмите на Мавен
Нажмите на архетип-быстрый старт-jdk8:
После выбора нужной версии архетипа — просто выберите самую последнюю — вам будет предложено указать папку, в которой должно быть создано Java-приложение. В моем случае: «c:\MyProject».
Когда вы выполняете эти шаги в первый раз после установки Maven, Maven будет выполнять много загрузок для заполнения локального репозитория. После нескольких минут загрузки (только в первый раз) в терминале запускается интерактивный диалог создания артефакта Maven. Укажите имена для идентификатора группы, идентификатора артефакта и версии:
и подтвердите тех. Затем Maven создаст макет приложения Java, указанный архетипом.
Откройте папку, созданную Maven для приложения Java — в моем случае c:\MyProject\myapp — в рабочую область VS Code.
Прежде чем мы сможем запустить что-либо в этом проекте Java, нам нужно переключить сервер языка Java в стандартный режим:
Переключите сервер языка Java в стандартный режим.
(из легкого веса), чтобы можно было собрать и запустить приложение.
Строка состояния указывает, в каком режиме находится текущая рабочая область, с помощью различных значков.
Щелчок по значку облегченного режима переключает в стандартный режим.
Запустите сгенерированное Java-приложение
На этом этапе мы можем запустить и отладить приложение Java. Приложение Open Class (файл App, .java).
Нажмите на маленькую ссылку «Выполнить», расположенную над основным методом в классе:
Класс запущен, и результат виден в терминале:
Тестирование сгенерированного Java-приложения (или, скорее, запуск сгенерированного теста)
Сгенерированное приложение в архетипе Maven настраивается для тестирования с помощью JUnit и создает тестовый пример класса App при инициализации приложения. Вы можете запустить класс AppTest — это то же самое, что выполнить тестовый пример для класса App, который вы можете сделать из обозревателя тестов:
Результат теста виден на панели
а отчет можно открыть, нажав на панель:
Примечание. Вы можете использовать java.test.report.showAfterExecution
для настройки автоматического отображения отчета о тестировании после выполнения. По умолчанию это будет показано, когда есть неудачные тесты.
Настройте подключаемый модуль компилятора Maven для каждого проекта Java
Файл Maven pom.xml в каждом Java-проекте необходимо настроить с помощью подключаемого модуля компилятора Maven, чтобы использовать выбранный JDK — в моем случае (JDK) 14 с включенными функциями предварительного просмотра. Откройте pom.xml для проекта Java и добавьте плагин следующим образом:
<plugin> <!-- https://mvnrepository.com/artifact/org.apache.maven.plugins/maven-compiler-plugin --> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <release>14</release> <compilerArgs>--enable-preview</compilerArgs> </configuration> </plugin>
Maven Docs, подробности о плагине компилятора: https://maven.apache.org/plugins/maven-compiler-plugin/.
Удалите или отключите свойства maven.compiler.source и maven.compiler.target (см. это руководство по плагину компилятора Maven)
Запустить команды Maven
VS Code через расширение Maven умеет запускать команды Maven. Он интерпретирует pom.xml, чтобы узнать об этапах, используемых плагинах, JDK и JRE для использования и т. д.
Команды Maven можно запускать из проекта Java или из навигатора Maven.
В первый раз, когда вы можете использовать команду Maven, вам, вероятно, придется выдержать очень много загрузок. Только после нескольких минут загрузки команда завершится. В последующих случаях та же самая команда будет выполняться намного быстрее.
Maven обычно запускает модульные тесты и проверяет качество кода перед упаковкой приложения — например, в виде толстого jar-файла. Когда проверки или тесты терпят неудачу, процесс прерывается.
Результат операций Maven записывается в целевое дерево каталогов — см., например, скриншот с полученным (толстым) jar, отчетами о тестировании и (пустым) отчетом checkstyle:
А теперь… самое интересное
До этого момента я не написал ни строчки кода. Я отредактировал файлы конфигурации и обработал код, созданный из архетипа Maven. Теперь, когда среда настроена — пришло время для моего (или вашего) собственного кода. Просто создавайте новые классы, используя функции, предлагаемые VS Code и пакетом расширений Java. Например, завершение кода IntelliSense и вставка фрагментов:
Отладка, навигация по коду, семантическая подсветка, свертывание/развертывание кода, рефакторинг,
Также: интеграция с Tomcat, Jetty и другими серверами приложений, поддержка Spring Boot, интеграция с Azure,
Ресурсы
Скачать VS Code — https://code.visualstudio.com/download
Пакет расширений Java для VS Code — https://code.visualstudio.com/docs/java/java-tutorial#_installing-extensions
Учебное пособие по VS Code Начало работы с Java в VS Code — https://code.visualstudio.com/docs/java/java-tutorial
Рефакторинг VS Code Java — https://code.visualstudio.com/docs/java/java-refactoring
Облегченный режим VS Code Java Language Server: https://code.visualstudio.com/docs/java/java-project#_lightweight-mode
Настройте JDK в VS Code Java Extension Pack: https://code.visualstudio.com/docs/java/java-tutorial#_settings-for-the-jdk
Часто задаваемые вопросы по VS Code. Как использовать Visual Studio Code с новыми версиями Java? — https://code.visualstudio.com/docs/java/java-faq#_how-can-i-use-visual-studio-code-with-new-java-versions
Checkstyle для расширения Java для VS Code — https://marketplace.visualstudio.com/items?itemName=shengchen.vscode-checkstyle
Расширение SonarLint для VS Code — https://marketplace.visualstudio.com/items?itemName=SonarSource.sonarlint-vscode, которое проверяет код Java на соответствие более чем 550 правилам (https://rules.sonarsource.com/java)
Документы Maven: Maven для Windows — https://maven.apache.org/guides/getting-started/windows-prerequisites.html
Скачать сайт для Maven: https://maven.apache.org/download.cgi
JUnit 5 — Домашняя страница — https://junit.org/junit5/docs/current/user-guide/#overview
JUnit 5 — загрузка все включено (junit-platform-console-standalone) — https://repo1.maven.org/maven2/org/junit/platform/junit-platform-console-standalone/
Первоначально опубликовано на https://technology.amis.nl 20 сентября 2020 г.