快速搭建基于注解的Dubbo项目

安装注册中心

首先安装注册中心，这里我们选用zookeeper，直接去Apache官网下载，下载地址Apache ZooKeeper™ Releases

安装后进入bin目录，启动zkServer.cmd即可，如果是在linux上，就启动zkServer.sh即可，默认端口为2181

搭建管理控制台（可选）

首先，在空白目录下，打开控制台，输入（需要已安装maven）：

	git clone https://github.com/apache/incubator-dubbo-admin.git

接下来进入incubator-dubbo-admin，在目录下执行（需要已安装node.js）：

	mvn clean package

因为采用了前后端分离的项目构建方式，如果这里没有安装node.js，会在npm下载依赖的时候报错

如果刚才打包失败，报错如下异常，或其他类似的与SLF4J有关的异常：

这是由于日志版本太低或日志缺失导致的bug，进入incubator-dubbo-admin\dubbo-admin-server\pom.xml中，在标签下添加以下依赖

	<dependency>
	   <groupId>ch.qos.logbackgroupId>
	   <artifactId>logback-classicartifactId>
	   <version>1.2.3version>
	dependency>
	<dependency>
	   <groupId>ch.qos.logbackgroupId>
	   <artifactId>logback-coreartifactId>
	   <version>RELEASEversion>
	dependency>

然后返回上一级目录重新进行打包，打包中如果报其他异常可以无视，只要最后提示BUILD SUCCESS即可，打包完成后进入incubator-dubbo-admin\dubbo-admin-distribution\target目录下，执行以下命令运行jar包：

	java -jar dubbo-admin-0.1.jar

接着访问 http://localhost:8080，出现类似下面界面就说明我们的管理控制台搭建成功：

搭建Dubbo项目

接下来我们就要搭建一个简易的Dubbo项目，首先我们创建一个空目录（注意，不要新建项目），名字任意，这里我就用创建一个dubbo-annotation-demo文件夹，然后用idea打开（eclipse或sts操作类似）

创建接口

接下来我们创建公用接口模块，右键项目，创建module：

我们选择创建Maven项目，名字任意，但是最好按照规范，这里：


然后打开pom.xml，设置打包方式和编码格式：

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0modelVersion>

    <groupId>com.akiragroupId>
    <artifactId>dubbo-service-user-apiartifactId>
    <version>1.0.0-SNAPSHOTversion>
    <packaging>jarpackaging>

    <properties>
        <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8project.reporting.outputEncoding>
        <java.version>1.8java.version>
    properties>

project>

然后，进入源码目录src\main\java，创建包com.akira.dubbo.service.user.api，在包下创建我们的接口类，这里我们就采用dubbo官方的示例：

public interface UserService {

    String sayHi();
}

创建Provider

按照刚才的步骤创建Module，不过这里我们选择创建spring-boot项目，名字任意，而且不用添加任何依赖，我们一会儿手动添加：


然后我们打开pom.xml，添加以下依赖：

		
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starterartifactId>
        dependency>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-testartifactId>
            <scope>testscope>
        dependency>
        
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-actuatorartifactId>
        dependency>
		
		
        <dependency>
            <groupId>com.alibaba.bootgroupId>
            <artifactId>dubbo-spring-boot-starterartifactId>
            <version>0.2.0version>
        dependency>

        
        <dependency>
            <groupId>com.akiragroupId>
            <artifactId>dubbo-service-user-apiartifactId>
            <version>${project.version}version>
        dependency>

如果我们自己的接口依赖报红，就进入dubbo-service-user-api目录下（接口模块目录），打开cmd，执行mvn clean install即可

然后我们进入resources目录下，修改配置文件：

spring:
  application:
    name: dubbo-service-user-provider

# 因为8080端口已经被管理台占用，所以要换一个端口
server:
  port: 8180 
   
# 自定义配置，接口的版本号
user:
  service:
    version: 1.0.0
  
dubbo:
  scan:
    basePackages: com.akira.dubbo.service.user.provider.api
  application:
    id: dubbo-service-user-provider
    name: dubbo-service-user-provider
    qos-port: 22222
    qos-enable: true
  protocol:
    id: dubbo
    name: dubbo
    port: 12345
    status: server
  # 与注册中心保持一致
  registry:
    id: zookeeper
    address: zookeeper://127.0.0.1:2181

接着我们进入源码目录下，创建api.impl包，在包下创建UserServiceImpl我们接口的实现类：

@Service(version = "${user.service.version}")
public class UserServiceImpl implements UserService {

    @Override
    public String sayHi() {
        return "Hello Dubbo";
    }
}

注意，这个@Service注解是com.alibaba.dubbo.config.annotation.Service包下的，千万别导错了

最后，我们在DubboServiceUserProviderApplication中的main方法最后添加一行代码，用于启动Provider，要注意两点：

• 一定要先启动注册中心，这里我们使用zookeeper，就一定要先启动zookeeper，再启动我们的provider项目
• 这个Main对象是com.alibaba.dubbo.container.Main包下的类，不要导错了

@SpringBootApplication
public class DubboServiceUserProviderApplication {

    public static void main(String[] args) {
        SpringApplication.run(DubboServiceUserProviderApplication.class, args);

        Main.main(args);
    }
}

然后启动该应用模块，我们的服务提供者就完成了

创建consumer

和创建provider的步骤大致相同，这里我就不再赘述了，模块名字我这里使用dubbo-serivce-user-consumer，需要注意的是，在pom.xml文件中的plugin中，需要配置入口类，如下：

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-maven-pluginartifactId>
                <configuration>
                    <mainClass>com.akira.dubbo.service.user.consumer.DubboServiceUserConsumerApplicationmainClass>
                configuration>
            plugin>
        plugins>
    build>

同时，因为我们服务消费者是一个web应用，所以需要把spring-boot-start的依赖改为spring-boot-starter-web，同时要添加dubbo和api的依赖：

        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-webartifactId>
        dependency>
        
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-actuatorartifactId>
        dependency>

        <dependency>
            <groupId>com.alibaba.bootgroupId>
            <artifactId>dubbo-spring-boot-starterartifactId>
            <version>0.2.0version>
        dependency>
        
         
        <dependency>
            <groupId>com.akiragroupId>
            <artifactId>dubbo-service-user-apiartifactId>
            <version>${project.version}version>
        dependency>

接着修改配置文件，这里我采用的yml配置方式，配置内容和provider基本一致，需要注意两点：

• 因为默认端口8080和管理中心端口冲突，所以需要修改端口
• 需要去掉dubbo.protocol.status的配置，否则会认为该模块为服务提供者

具体配置如下：

spring:
  application:
    name: dubbo-service-user-consumer

server:
  port: 8077

user:
  service:
    version: 1.0.0

dubbo:
  scan:
    basePackages: com.akira.dubbo.service.user.consumer.controller
  application:
    id: dubbo-service-user-consumer
    name: dubbo-service-user-consumer
  protocol:
    id: dubbo
    name: dubbo
    port: 12345
  registry:
    id: zookeeper
    address: zookeeper://127.0.0.1:2181

然后回到源码目录下，创建controller包，添加UserController类：

@RestController
public class UserController {

    @Reference(version = "${user.service.version}")
    private UserService userService;

    @GetMapping("hi")
    public String sayHi() {
        return userService.sayHi();
    }
}

注意，这里@Reference是dubbo包下的注解，可以把它当成@Autowired注解来使用
最后启动该应用模块，就完成了服务消费者的构建，注意启动顺序是：

1. zookeeper注册中心
2. dubbo-admin管理控制台
3. provider服务提供者
4. consumer服务消费者

显示结果

这样，我们的样例就完成了，关于dubbo的rpc原理在接下来我会写几篇文章来专门分析