还在为项目初始化、依赖管理问题困扰？Dubbo Initializer 来了！

news2024/10/7 11:20:49

作者：Dubbo 社区

通过这篇文章，你将学习如何在 1 分钟内用 Dubbo Initializer 模板快速创建 Dubbo Spring Boot 项目，帮你解决项目初始化问题。

什么是 Dubbo Initializer？

Dubbo Initializer 是一款帮助开发者快速生成 Dubbo Spring Boot 项目的 UI 工具，它帮助生成具有基本 Dubbo 配置、代码示例、Web、SQL 等微服务组件的项目源码并提供 ZIP 包下载方式。下载后，你就可以将项目模板代码导入 IDE 开发环境并增加自己的业务逻辑，免去从头初始化项目的各种繁琐操作。

想马上体验使用 Dubbo Initializer 创建 Spring Boot 项目，请通过浏览器访问以下链接：https://start.dubbo.apache.org/

注：Initializer 仍在持续更新中，更多 Dubbo Feature 的支持将会陆续发布。

使用 Intializer 创建 Dubbo Spring Boot 微服务项目

使用浏览器打开 Initializer 地址：https://start.dubbo.apache.org/，你将看到以下界面：

在这里插入图片描述

选择 Dubbo 版本

Initializer 会使用 dubbo-spring-boot-starter 创建 Spring Boot 项目，因此我们首先需要选择 Dubbo 与 Spring Boot 的版本。

在这里插入图片描述

录入项目基本信息

接下来，填入项目基本信息，包括项目坐标、项目名称、包名、JDK 版本等。

在这里插入图片描述

选择项目结构

有两种项目结构可共选择，分别是单模块和多模块，在这个示例中我们选择单模块。

在这里插入图片描述

单模块，所有组件代码存放在一个 module 中，特点是结构简单。
多模块，生成的项目有 API、Service 两个模块，其中 API 用于存放 Dubbo 服务定义，Service 用于存放服务服务实现或调用逻辑。通常多模块更有利于服务定义的单独管理与发布。

选择依赖组件

我们为模板默认选择如下几个依赖组件：

Dubbo 组件

- Java Interface
- 注册中心，zookeeper
- 协议 TCP

常用微服务组件

- Web
- Mybatis
- 模版引擎

在这里插入图片描述

基于以上选项，生成的项目将以 Zookeeper 为注册中心，以高性能 Dubbo2 TCP 协议为 RPC 通信协议，并且增加了 Web、Mybatis 等组件依赖和示例。

注意：上面选中的 Dubbo 组件也都是默认选项，即在不手动添加任何依赖的情况下，打开页面后直接点击代码生成，生成的代码即包含以上 Dubbo 组件。

如手动添加依赖组件，请注意 Dubbo 各个依赖组件之间的隐含组合关系限制，比如

如果选择了【Dubbo Service API】-【IDL】，则目前仅支持选择【Dubbo Protocol】中的【HTTP/2】或【gRPC】协议。
同一个依赖分组下，相同类型的依赖只能选择一个，比如【Dubbo Registry&Config&Metadata】分组下，从注册中心视角【Zookeeper】、【Nacos】只能选一个，如果要设置多注册中心，请在生成的代码中手动修改配置。但注册中心、配置中心可以分别选一个，比如 Zookeeper 和 Apollo 可同时选中。

生成项目模板

点击 “浏览代码” 可在线浏览项目结构与代码
点击 “获取代码” 生成项目下载地址

在这里插入图片描述

解压的 ZIP 包下载到本地后，解压并导入 IDE 后即可根据需要开发定制 Dubbo 应用。

示例项目代码解读

以下以生成的单模块代码为例，讲解生成的代码含义。

服务定义

public interface DemoService {    String hello(String arg);}

业务逻辑实现

@DubboService
public class DemoServiceImpl implements DemoService {
    public String hello(String arg) {
        // put your microservice logic here
    }
}

项目配置

dubbo:
  application:
    name: dubbo-demo
  protocol:
    name: dubbo
    port: -1
  registry:
    address: zookeeper://127.0.0.1:2181

代码依赖

<dependencies>
      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-jdbc</artifactId>
      </dependency>
      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-thymeleaf</artifactId>
      </dependency>
      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-web</artifactId>
      </dependency>
      <dependency>
          <groupId>org.apache.dubbo</groupId>
          <artifactId>dubbo-dependencies-zookeeper</artifactId>
          <type>pom</type>
      </dependency>
      <dependency>
          <groupId>org.apache.dubbo</groupId>
          <artifactId>dubbo-spring-boot-starter</artifactId>
      </dependency>
      <dependency>
          <groupId>org.mybatis.spring.boot</groupId>
          <artifactId>mybatis-spring-boot-starter</artifactId>
          <version>2.3.0</version>
      </dependency>
  </dependencies>