使用 Visual Studio Code 开发 Java Web 应用
本教程向你展示如何使用 Visual Studio Code 创建 Java Web 应用程序。你将学习如何将 Java Web 应用程序部署到 Azure 应用服务中的 Linux Tomcat 服务器上。
场景
一个简单的 Hello World Web 应用。
准备工作
在运行和部署此示例之前,你的本地开发环境必须安装 Java SE Development Kit (JDK) 和 Apache Maven 构建工具。如果尚未安装,请进行安装。
下载并安装包含 JDK 11 的Java 扩展包。
注意:必须设置
JAVA_HOME
环境变量指向 JDK 的安装位置才能完成本教程。
下载 Apache Maven 版本 3 或更高版本
在你的本地开发环境中安装 Apache Maven
创建一个 Maven Web 应用项目
maven-archetype-webapp
是一个用于生成 Maven Web 应用项目的原型。要了解更多信息,请访问此文档。
- 在一个空文件夹中,运行以下命令从 Maven 原型生成一个新项目。
mvn archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-webapp -DarchetypeVersion=1.4
-
Maven 会要求你提供完成项目生成所需的值。在提示时提供以下值
提示 值 描述 groupId com.webappproject
一个在所有项目中唯一标识你项目的值,遵循 Java 的包命名规则。 artifactId webapp-project
一个表示 jar 名称的值,不带版本号。 version 1.0-SNAPSHOT
选择默认值。 package com.webappproject
一个表示生成的函数代码的 Java 包的值。使用默认值。 -
键入
Y
或按 Enter 确认。Maven 会在以 artifactId 为名称的新文件夹中创建项目文件,在本例中是
webapp-project
。 -
导航到项目文件夹
cd webapp-project
将 Web 应用部署到云端
我们刚刚构建了一个 Java Web 应用程序并在本地运行了它。现在你将学习如何从 Visual Studio Code 部署它,并在云中的 Azure 上运行它。
如果你没有 Azure 订阅,可以注册一个免费的 Azure 帐户。
安装 Azure App Service 扩展
Azure App Service 扩展用于创建、管理和部署到 Azure App Service,其主要功能包括
- 创建新的 Azure Web 应用/部署槽位
- 部署到 Azure Web 应用/部署槽位
- 启动、停止和重启 Azure Web 应用/部署槽位
- 查看 Web 应用的日志文件
- 交换部署槽位
要安装 Azure App Service 扩展,打开“扩展”视图(⇧⌘X (Windows, Linux Ctrl+Shift+X)),然后搜索 azure app service
来过滤结果。选择 Microsoft 的Azure App Service 扩展。对于更侧重命令行和 Maven 的体验,你还可以查看Azure App Service Linux Maven 插件教程。
登录到你的 Azure 订阅
要登录到 Azure,请从命令面板(⇧⌘P (Windows, Linux Ctrl+Shift+P))运行 Azure: Sign In。或者你也可以在资源管理器中点击 Sign in to Azure... 来登录你的 Azure 帐户。
在 Azure 上创建新的 Web 应用
扩展安装完成后,你可以按照以下步骤在 Azure 上创建一个新的 Web 应用。
-
在资源管理器视图中点击 Create 按钮并选择 Create App Service Web App...。
-
为新的 Web 应用输入一个唯一的名称。
-
选择 Web 应用的运行时任务,例如
Java 17
。 -
选择 Java Web 服务器堆栈,例如
Apache Tomcat 10.0
。 -
选择一个定价层,例如
Free(F1)
。
构建并部署到 Web 应用
部署过程利用了 Azure Resources 扩展(作为 Azure App Service 扩展的依赖项一起安装),你需要使用 Azure 订阅登录。如果你没有 Azure 订阅,立即注册免费的 30 天帐户,并获得 200 美元的 Azure 额度,以试用任意组合的 Azure 服务。
登录后,你可以打开命令提示符或终端窗口,使用 Maven 命令构建项目。这将在 target
目录中生成新的 war
或 jar
Artifact。
mvn clean package
构建项目后,在 VS Code 资源管理器中打开 target
目录。右键单击 Artifact,选择 Deploy to Web App,然后按照提示选择用于部署的 Web 应用。
在 VS Code 中打开输出窗口查看部署日志。部署完成后,会打印出你的 Web 应用的 URL。点击链接在浏览器中打开它,你就可以看到 Web 应用在 Azure 上运行了!
注意:有关 App Service 的更多高级功能,你可以查看Azure App Service 扩展。
清理资源
-
要删除你的 Web 应用,请导航到资源管理器并找到 App Services 项目。
-
右键单击要删除的 Web 应用,然后点击 Delete。
- 要删除你的应用服务计划或资源组,请访问Azure 门户,然后手动删除你订阅下的资源。
下一步
- 要容器化和部署 Web 应用程序,请查看VS Code 中的 Docker。
- 要了解更多关于 Java 调试功能的信息,请参阅Java 调试教程。