说明

教程版本信息:
– Idea2018
– JDK1.8
– dubbo 2.6.1
– SpringBoot2.0.0.RELEASE
– Redis4.0

需求简介

开发一个分布式的Restful Web应用,当用户访问网站的/hello/xxx(其中xxx为用户名)时,在页面打印 hello xxx的文字,但要求该服务的实现与控制器分离在不同的服务器上,在该教程中,是基于本机进行开发,因此我们只需观察控制台输出是否正确即可。

前置要求

阅读本教程,你需要掌握Spring / SpringMVC / Maven / SpringBoot 等知识

项目创建及主Module搭建

  1. 使用Idea创建一个Empty Project
  2. 在其中新增一个Maven Module,该model为主pom,pom内容如下

pom.xml详解:
1. SpringBoot默认的一些东西
2. Dubbo依赖
3. Redis依赖,用于Dubbo注册中心使用

<?xml version="1.0" encoding="UTF-8"?>
<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.0</modelVersion>

    <groupId>com.noesblog.demo.dubbo</groupId>
    <artifactId>dubbp-pom</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>dubbp-pom</name>
    <description>Demo project for Spring Boot</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.0.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

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

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-aop</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>dubbo</artifactId>
            <version>${dubbo.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.data</groupId>
            <artifactId>spring-data-redis</artifactId>
            <version>2.0.5.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-pool2</artifactId>
            <version>2.5.0</version>
        </dependency>
        <dependency>
            <groupId>redis.clients</groupId>
            <artifactId>jedis</artifactId>
            <version>2.9.0</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

到此主pom项目就已经创建完成了。

service模块搭建

Dubbo是一个分布式的RPC框架,因此接口模块可以抽为一个单独的Project,以供其他项目使用。

创建一个module,并修改pom文件为如下内容

<?xml version="1.0" encoding="UTF-8"?>
<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">
    <parent>
        <artifactId>dubbp-pom</artifactId>
        <groupId>com.noesblog.demo.dubbo</groupId>
        <version>0.0.1-SNAPSHOT</version>
        <relativePath>../dubbp-pom/pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>dubbo-service</artifactId>


</project>

添加一个DemoService接口

package com.noesblog.demo.dubbo.service;

public interface DemoService {

    String sayHello(String name);
}

现在我们已经完成了service模块的搭建

provider模块搭建

在项目中新增一个module,并继承你的主pom,内容如下

该pom引入了一个通用的module模块dubbo-service,Dubbo是一个分布式的RPC框架,因此接口模块可以抽为一个单独的Project,以供其他项目使用。

<?xml version="1.0" encoding="UTF-8"?>
<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">
    <parent>
        <artifactId>dubbp-pom</artifactId>
        <groupId>com.noesblog.demo.dubbo</groupId>
        <version>0.0.1-SNAPSHOT</version>
        <relativePath>../dubbp-pom/pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>dubbo-provider</artifactId>

    <dependencies>
        <dependency>
            <groupId>com.noesblog.demo.dubbo</groupId>
            <artifactId>dubbo-service</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
    </dependencies>

</project>

现在我们编写DemoService接口的实现

package com.noesblog.demo.dubbo.provider;

import com.noesblog.demo.dubbo.service.DemoService;
import org.springframework.stereotype.Service;

@Service
public class DemoServiceImpl implements DemoService {
    @Override
    public String sayHello(String name) {
        System.out.println("Provider1执行服务" + name);
        return "Hello" + name;
    }
}

并添加一个启动类

package com.noesblog.demo.dubbo;

import org.springframework.context.support.ClassPathXmlApplicationContext;

import java.io.IOException;

public class ProviderApplication {

    public static void main(String[] args) throws IOException {
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext(
                new String[] {"classpath*:provider.xml"});
        System.out.println("Provider1启动~~~");
        context.start();
        System.in.read();
    }
}

添加一个Dubbo的配置文件用于暴露服务
记得修改[Redis-IP]为你的Redis服务的IP地址
修改[Redis-Port]为你的Redis服务的端口号
provider.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
       xsi:schemaLocation="http://www.springframework.org/schema/beans        http://www.springframework.org/schema/beans/spring-beans.xsd        http://code.alibabatech.com/schema/dubbo        http://code.alibabatech.com/schema/dubbo/dubbo.xsd">

    <!-- 提供方应用信息,用于计算依赖关系 -->
    <dubbo:application name="hello-world-app"  />

    <!-- 使用multicast广播注册中心暴露服务地址 -->
    <dubbo:registry address="redis://[Redis-IP]:[Redis-Port]" />

    <!-- 用dubbo协议在20880端口暴露服务 -->
    <dubbo:protocol name="dubbo" port="20880" />

    <!-- 声明需要暴露的服务接口 -->
    <dubbo:service interface="com.noesblog.demo.dubbo.service.DemoService" ref="demoService" />

    <!-- 和本地bean一样实现服务 -->
    <bean id="demoService" class="com.noesblog.demo.dubbo.provider.DemoServiceImpl" />
</beans>

consumer模块搭建

在项目中新增一个module,并继承你的主pom,文件内容如下
pom.xml:
引入了SpringBoot的web starter,该依赖包含了SpringMVC等一系列依赖,用户访问的通常是该模块项目,由该模块项目调用provider模块的接口实现。

<?xml version="1.0" encoding="UTF-8"?>
<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">
    <parent>
        <artifactId>dubbp-pom</artifactId>
        <groupId>com.noesblog.demo.dubbo</groupId>
        <version>0.0.1-SNAPSHOT</version>
        <relativePath>../dubbp-pom/pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>dubbo-consumer</artifactId>

    <dependencies>
        <dependency>
            <groupId>com.noesblog.demo.dubbo</groupId>
            <artifactId>dubbo-service</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>
</project>

在项目的resources目录下新建一个consumer.xml文件,并添加以下内容
记得修改[Redis-IP]为你的Redis服务的IP地址
修改[Redis-Port]为你的Redis服务的端口号

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
       xsi:schemaLocation="http://www.springframework.org/schema/beans        http://www.springframework.org/schema/beans/spring-beans.xsd        http://code.alibabatech.com/schema/dubbo        http://code.alibabatech.com/schema/dubbo/dubbo.xsd">

    <!-- 消费方应用名,用于计算依赖关系,不是匹配条件,不要与提供方一样 -->
    <dubbo:application name="consumer-of-helloworld-app"  />

    <!-- 使用multicast广播注册中心暴露发现服务地址 -->
    <dubbo:registry address="redis://[Redis-IP]:[Redis-Port]" />

    <!-- 生成远程服务代理,可以和本地bean一样使用demoService -->
    <dubbo:reference id="demoService" interface="com.noesblog.demo.dubbo.service.DemoService" />
</beans>

并继续添加一个application.yml文件,文件内容如下

# ----------服务器端口配置----------
server:
  port: 7077

新建一个ConsumerApplication类,并修改为如下内容

package com.noesblog.demo.dubbo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.ImportResource;

@ImportResource(locations = {"classpath*:consumer.xml"})
@SpringBootApplication
public class ConsumerApplication {

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

由于该模块是调用方,为符合企业开发场景,因此我们创建一个控制器来进行测试。

创建HelloController

package com.noesblog.demo.dubbo.controller;

import com.noesblog.demo.dubbo.service.DemoService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @Autowired
    private DemoService demoService;

    @GetMapping("/hello/{name}")
    public String hello(@PathVariable(value = "name") String name){
        return demoService.sayHello(name);
    }
}

到此,consumer模块就已经完成搭建了。

项目文件夹

以上步骤全部完成后,你的项目应该包含以下内容

测试

现在我们开始测试项目是否按照我们的预期运行。
首先我们启动Consumer模块项目,运行ConsumerApplication即可。
然后我们打开浏览器,并访问http://localhost:7077/hello/night,通常它会出现如下错误

现在我们启动Provider模块项目,运行ProviderApplication即可,当控制台打印如下信息时:

Provider1启动~~~

说明该模块已经启动完毕了,现在回到浏览器,重新访问该地址http://localhost:7077/hello/night,你会在页面看到Hellonight的文字。

修改http://localhost:7077/hello/night中的night为其他内容,并刷新页面,你会发现每次都会打印不同的信息。

接下来回到Idea,打开Provider模块的控制台,你会发现打印了如下的调用信息:

Provider1执行操作night

到此整个需求就已经完成了。

发表评论

电子邮件地址不会被公开。