这篇文章它介绍了如何使用 MongoDB 交互创建 Quarkus 微服务。本教程的完整代码在以下链接中:
quarkus-mongodb-panache-code
Quarkus 是一个强大的企业编程堆栈,很有可能席卷市场。可以使用 Java 创建超音速和亚原子应用程序,因此我们可以为 Serverless 创建超快的应用程序。
在云时代,我们需要速度和轻量级的应用程序,Quarkus 巧妙地使之成为可能。使用 Quarkus 启动 Java 应用程序,只需不到 500 毫秒。
快速启动您的 Quarkus 应用程序
为了快速开始使用 Quarkus,我们可以使用以下 URL code.quakus.io并在那里生成我们的应用程序。
安装 Docker
对于 MacBook,您可以使用以下链接安装 Docker:docker-for-mac-install
如果您使用的是 Windows,则可以访问以下链接:docker-for-windows-install
如果你想要 Docker for Ubuntu,你可以使用以下链接:docker-engine-install-ubuntu
如果您需要为另一个 Linux 发行版安装 Docker,只需浏览官方 Docker 网站。
此外,由于我们将在我们的应用程序中使用 docker-compose,因此有必要安装 docker-compose。您可以访问以下链接:docker-compose-install
简单地说,docker-compose 是一种在一个简单的命令 docker-compose up 中使用 docker 来启动你的服务或 docker-compose down 来销毁它的方法。
我们将使用 docker-compose 代替使用 docker run 来启动我们需要的服务,这样我们就不需要创建扩展的 docker run 命令。
所需设置
在开始本教程之前,您需要在您的机器上安装 Java SDK 11 和 Gradle。
起步
Quarkus 拥有一个令人难以置信的平台,其中包含许多强大的库,可帮助我们在云中创建可靠且强大的软件。在这个平台上,我们可以轻松地以我们想要的方式选择和创建我们的项目。
转到以下链接code.quarkus.io,让我们创建我们的简单项目。
在“选择您的扩展”部分,我们将向我们的项目添加以下依赖项:
MongoDB with PanacheRESTEasy JSON-BRESTEasy JacksonSmallRye Health
在 Build Tool 选项中,选择Gradle。
在为我们的项目选择我们想要的内容后,让我们点击“生成您的应用程序”。解压缩项目并将其导入您最喜欢的 IDE(我的是IntelliJ)。
现在让我们使用 Docker 来启动我们的 MongoDB 会话!
现在使用以下信息在我们的 Quarkus 项目的根目录中创建docker-compose.yml文件。
version: '3.7' |
然后通过在 Quarkus 项目的根目录中运行以下命令来启动 MongoDB 会话:
docker-compose up
构建应用程序代码
在下面的代码中,我们将:
1 – 配置项目以连接到 MongoDB
2 – 使用我们想要的字段创建 Knight 模型类,扩展 PanacheMongoEntity 类。
3 – 使用自定义搜索方法(例如 count、orderedByName 和 searchByName)创建我们的数据存储库。
4 – 创建 REST 端点以创建、更新、删除和搜索 Knights。
一旦我们运行了一个 Docker MongoDB 实例,我们就可以配置我们的 Quarkus 应用程序来连接到它。然后让我们在以下路径中创建application.properties文件:“src/main/resources/”。
在这个文件中,我们实际上是在设置 MongoDB 主机和数据库名称,这应该足以将 Quarkus 与 MongoDB 集成!
# configure the MongoDB client for a single node cluster on localhost |
使用 Panache,处理数据库事务真的很容易。我们可以简单地在属性文件中创建我们的数据库配置,创建我们的 Repository 类.
import io.quarkus.mongodb.panache.PanacheMongoEntity; |
然后,让我们创建 Repository 类,该类将扩展PanacheMongoRepository负责为我们提供基本的数据库操作,例如创建、更新、删除和搜索元素。
import io.quarkus.mongodb.panache.PanacheMongoRepository; |
运行您的 Quarkus 应用程序
现在您已经为 Quarkus 应用程序配置了一切,您需要运行您的应用程序。Quarkus 最强大的功能之一是可以在开发模式下运行您的应用程序,这允许我们更改代码并查看实时更改,而无需重新启动服务器!
要使用在开发模式下运行Quarkus gradle这个我们可以从项目的根路径使用以下命令:
./gradlew quarkusDev