编辑

Visual Studio Code 中的 Java Web 应用程序

Name: Visual Studio Code
Author: Microsoft

本教程将指导您如何使用 Visual Studio Code 创建 Java Web 应用程序。您将学习如何在本地运行、调试和编辑 Java Web 应用程序，并最终将其部署到云。

场景

一个简单的 Spring Boot 入门 Web 应用程序

Greeting from Java

开始之前

在运行和部署此示例之前，您必须在本地开发环境中安装 Java SE Development Kit (JDK) 和 Apache Maven 构建工具。如果您没有，请安装它们。

下载并安装适用于 Java 的扩展包，其中包含 JDK 11。

注意：为了完成本教程，必须将 JAVA_HOME 环境变量设置为 JDK 的安装位置。

下载 Apache Maven 版本 3 或更高版本

下载 Apache Maven

为本地开发环境安装 Apache Maven

安装 Apache Maven

下载并测试 Spring Boot 应用程序

将 Spring Boot 入门示例项目克隆到本地计算机。您可以使用 **命令面板** 中的 **Git：克隆** 命令克隆 Git 存储库（⇧⌘P（Windows、Linux Ctrl+Shift+P））。将 https://github.com/spring-guides/gs-spring-boot.git 粘贴为远程存储库的 URL，然后决定将本地存储库放在哪个父目录下。之后，通过导航到文件夹并键入 code .，在 VS Code 中打开克隆存储库中的 complete 文件夹。

注意：您可以从 https://vscode.js.cn 安装 Visual Studio Code，从 https://git.js.cn 安装 Git。

Clone Spring Repository

在 VS Code 中，打开 complete 文件夹中任何一个 Java 文件（例如 src\main\java\hello\Application.java）。如果您没有为 VS Code 安装 Java 语言扩展，系统将提示您安装 Microsoft 适用于 Java 的扩展包。按照说明进行操作，并在安装完成后重新加载 VS Code。

Install Java Extensions

安装适用于 Java 的扩展包后，它将自动为您构建项目（这可能需要几分钟）。您可以通过按 F5 并选择 **Java** 环境，在 VS Code 中运行应用程序。Java 调试扩展将为项目中的 .vscode 文件夹生成一个调试配置文件 launch.json。您可以在 VS Code 状态栏中查看构建进度，并在所有操作完成后，将显示最终的活动调试配置。

debug configuration in the Status Bar

您可以在调试启动配置中了解有关 VS Code 如何启动应用程序的更多信息。再次按 F5 启动调试器。

Run Spring Boot

通过使用 Web 浏览器浏览至 https://127.0.0.1:8080 来测试 Web 应用程序。您应该看到以下消息：“来自 Spring Boot 的问候！”。

Greeting from Spring

进行更改

现在，让我们编辑 HelloController.java，将“来自 Spring Boot 的问候！”更改为其他内容，例如“Hello World”。VS Code 为 Java 提供了出色的编辑体验，查看导航和编辑 Java 以了解有关 VS Code 的编辑和代码导航功能的更多信息。

单击编辑器顶部的 **重启** 按钮重新启动应用程序，并在重新加载浏览器后查看结果。

Restart Application

调试应用程序

在应用程序源代码中设置断点（F9），并重新加载浏览器以命中断点。

Debug Application

如果您想了解有关使用 VS Code 调试 Java 的更多信息，可以阅读 Java 调试。

恭喜，您已成功运行第一个 Spring Boot Web 应用程序！继续阅读以了解如何在云中托管它。

将 Web 应用程序部署到云

我们刚刚构建了一个 Java Web 应用程序并在本地运行了它。现在，您将学习如何从 Visual Studio Code 部署它，并在云中的 Azure 上运行它。

如果您没有 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，请从 **命令面板** 运行 **Azure：登录**（⇧⌘P（Windows、Linux Ctrl+Shift+P））。或者，您也可以通过单击 **资源** 资源管理器中的 **登录 Azure...** 登录 Azure 帐户。

Azure sign in code

在 Azure 上创建一个新的 Web 应用程序

安装扩展后，您可以执行以下步骤在 Azure 上创建一个新的 Web 应用程序。

单击 **资源** 资源管理器视图中的 **创建** 按钮，然后选择 **创建 App Service Web 应用程序...**。
输入新的 Web 应用程序的唯一名称。
选择 Web 应用程序的运行时任务，例如 Java 17。
选择 Java Web 服务器堆栈，例如 Java SE。
选择定价层。

Create a Web App

构建并部署到 Web 应用程序

部署过程利用了 Azure 资源扩展（作为依赖项与 Azure 应用服务扩展一起安装），您需要使用您的 Azure 订阅登录。如果您没有 Azure 订阅，请立即注册获取免费的 30 天帐户，并获得 200 美元的 Azure 积分，以试用任何 Azure 服务组合。

登录后，您可以打开命令提示符或终端窗口，并使用 Maven 命令构建项目。这将在 target 目录中生成一个新的 war 或 jar 文件。

mvn clean package

构建项目后，在 VS Code 资源管理器中打开 target 目录。右键单击工件，选择 **部署到 Web 应用**，然后按照提示选择要部署的 Web 应用。

Deploy to Web App

在 VS Code 中打开 **输出** 窗口以查看部署日志。部署完成后，它将打印出 Web 应用的 URL。单击链接在浏览器中打开它，您会看到在 Azure 上运行的 Web 应用！

Greeting from Spring Boot

注意：有关应用服务的更多高级功能，您可以查看 Azure 应用服务扩展。

连接到数据服务

Azure Cosmos DB 是一种全球分布式数据库服务，允许开发人员使用各种标准 API（如 SQL、MongoDB、Cassandra、Graph 和 Table）处理数据。

Spring Boot Starter 使得在 Azure Cosmos DB 中存储数据和检索数据变得容易，适用于 NoSQL 数据库。

在 Azure 上创建一个 Azure Cosmos DB 实体

转到 Azure 门户并单击“+”以 **创建资源**。
单击 **数据库**，然后单击 **Azure Cosmos DB** 创建您的数据库。
选择 **SQL（Document DB）API**，并键入您数据库的其他信息。
导航到您创建的数据库，单击 **密钥**，并复制您数据库的 **URI** 和 **主密钥**。

配置您的项目

您可以从 Spring Data Azure Cosmos DB 示例项目开始。

导航到 src/main/resources 并打开 application.properties。使用您的数据库信息替换 application.properties 中的以下属性。

azure.documentdb.uri=your-documentdb-uri
azure.documentdb.key=your-documentdb-key
azure.documentdb.database=your-documentdb-databasename

运行和调试应用程序

您可以按 F5 运行您的应用程序。要检查结果，请打开 Azure 门户并访问您的 Azure Cosmos DB 实例。选择 **数据资源管理器**，然后选择 **文档**。如果数据成功写入 Azure Cosmos DB，则会显示数据。您还可以使用 Azure 数据库扩展在 Azure Cosmos DB 中浏览您的数据条目。

在源代码中设置断点（F9）后，刷新浏览器以命中断点。有关调试的详细信息，请参阅 Java 调试

或者，您也可以使用 Maven 打包和运行您的项目，步骤如下

导航到 azure-spring-boot 目录并运行该命令。
```
mvn install
```

导航到 azure-documentdb-spring-boot-sample 目录并运行该命令。

mvn package
java -jar target/azure-documentdb-spring-boot-sample-0.0.1-SNAPSHOT.jar

后续步骤

要将 Web 应用程序容器化和部署，请查看 VS Code 中的 Docker。
要详细了解 Java 调试功能，请参阅 Java 调试教程。

3/2/2023