Quarkus和MongoDB微服务简单案例源码

21-10-12 banq

这篇文章它介绍了如何使用 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'
      services:
      mongodb_container:
      image: mongo:latest
      ports:
      - 27017:27017
      volumes:
      - mongodb_data_container:/data/db

      volumes:
      mongodb_data_container:

然后通过在 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
quarkus.mongodb.connection-string=mongodb://localhost:27017
# mandatory if you don't specify the name of the database using @MongoEntity
quarkus.mongodb.database=knight
...

 

使用 Panache,处理数据库事务真的很容易。我们可以简单地在属性文件中创建我们的数据库配置,创建我们的 Repository 类.

import io.quarkus.mongodb.panache.PanacheMongoEntity;

public class Knight extends PanacheMongoEntity {

    public String name;
    public String swordName;

    public Knight() { }

    public Knight(String name, String swordName) {
        this.name = name;
        this.swordName = swordName;
    }
}

然后,让我们创建 Repository 类,该类将扩展PanacheMongoRepository负责为我们提供基本的数据库操作,例如创建、更新、删除和搜索元素。

import io.quarkus.mongodb.panache.PanacheMongoRepository;
import io.quarkus.panache.common.Sort;
import java.util.List;
import javax.enterprise.context.ApplicationScoped;

@ApplicationScoped
public class KnightRepository implements PanacheMongoRepository<Knight>{

    public Knight findByName(String name){
        return find("name", name).firstResult();
    }

    public List<Knight> findOrderedByName(){
        return findAll(Sort.by("name")).list();
    }

}

运行您的 Quarkus 应用程序

现在您已经为 Quarkus 应用程序配置了一切,您需要运行您的应用程序。Quarkus 最强大的功能之一是可以在开发模式下运行您的应用程序,这允许我们更改代码并查看实时更改,而无需重新启动服务器!

要使用在开发模式下运行Quarkus gradle这个我们可以从项目的根路径使用以下命令:

./gradlew quarkusDev

猜你喜欢