Dubbo——Dubbo中的常用标签服务化最佳实践

Posted 2021-06-14 张起灵-小哥

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Dubbo——Dubbo中的常用标签服务化最佳实践相关的知识，希望对你有一定的参考价值。

文章目录：

2.4.1 003-link-interface

2.4.2 004-link-userservice-provider

2.4.3 005-link-consumer

2.4.4 启动测试

1.Dubbo中的常用标签

Dubbo 中常用标签。分为三个类别：公用标签，服务提供者标签，服务消费者标签。

公用标签：配置应用信息 <dubbo:application/> 和配置注册中心 <dubbo:registry/>
服务提供者标签：配置暴露的服务 <dubbo:service interface=”服务接口名” ref=”服务实现对象 bean”>
服务消费者标签：引用远程服务 <dubbo:reference id=”服务引用 bean 的 id” interface=”服务接口名”/>

2.Dubbo中的服务化最佳实践

2.1 分包

建议将服务接口、服务模型、服务异常等均放在公共包中。

2.2 粒度

服务接口尽可能大粒度，每个服务方法应代表一个功能，而不是某功能的一个步骤，

否则将面临分布式事务问题，Dubbo 暂未提供分布式事务支持。

服务接口建议以业务场景为单位划分，并对相近业务做抽象，防止接口数量爆炸。

不建议使用过于抽象的通用接口，如：Map query(Map)，这样的接口没有明确语义，会给后期维护带来不便。

2.3 版本

每个接口都应定义版本号，为后续不兼容升级提供可能，如： <dubbo:service interface="com.xxx.XxxService" version="1.0" />。

建议使用两位版本号，要变更服务版本。先升级一半提供者为新版本，再将消费者全部升为新版本，然后将剩下的一半提供者升为新版本。

2.4 案例分析

在这个案例分析中，一共需要3个maven工程。

2.4.1 003-link-interface

第一个是maven java工程，它里面存放的是服务模型和服务接口。代码如下：👇👇👇

package com.szh.dubbo.model;

import java.io.Serializable;

/**
 *
 */
public class User implements Serializable {

    private Integer id;
    private String username;

    //getter and setter
}

package com.szh.dubbo.service;

import com.szh.dubbo.model.User;

/**
 *
 */
public interface UserService {

    User queryUserById(Integer id);

    Integer queryAllUserCount();
}

2.4.2 004-link-userservice-provider

第二个是maven web工程，它里面存放的是服务提供者的相关信息。其中包括对服务接口的实现、服务提供者的dubbo配置文件信息、web.xml配置文件信息。代码如下：👇👇👇

package com.szh.dubbo.service.impl;

import com.szh.dubbo.model.User;
import com.szh.dubbo.service.UserService;

/**
 *
 */
public class UserServiceImpl implements UserService {
    @Override
    public User queryUserById(Integer id) {
        User user=new User();
        user.setId(id);
        user.setUsername("张起灵");
        return user;
    }

    @Override
    public Integer queryAllUserCount() {
        return 21;
    }
}

<?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://dubbo.apache.org/schema/dubbo"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd">

    <!-- 声明dubbo服务提供者的名称：保证唯一性 -->
    <dubbo:application name="004-link-userservice-provider"/>

    <!-- 设置dubbo使用的协议和端口号 -->
    <dubbo:protocol name="dubbo" port="20880"/>

    <!-- 暴露服务接口 -->
    <dubbo:service interface="com.szh.dubbo.service.UserService"
                   ref="userService"
                   registry="N/A"/>

    <!-- 将业务接口的实现类加载到Spring容器中 -->
    <bean id="userService" class="com.szh.dubbo.service.impl.UserServiceImpl"/>

</beans>

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <!-- 读取dubbo配置文件信息 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:dubbo-userservice-provider.xml</param-value>
    </context-param>
    <!-- 配置Spring的监听器 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

</web-app>

2.4.3 005-link-consumer

第三个是maven web工程，它里面存放的是服务消费者的相关信息。其中包括对控制层的实现、服务消费者的dubbo配置文件信息、Spring配置文件信息、web.xml配置文件信息以及控制层响应的jsp页面。代码如下：👇👇👇

package com.szh.dubbo.controller;

import com.szh.dubbo.model.User;
import com.szh.dubbo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 *
 */
@Controller
public class UserController {

    @Autowired
    private UserService userService;

    @RequestMapping(value = "/userDetail")
    public String userDetail(Integer id, Model model) {
        User user=userService.queryUserById(id);

        Integer allUserCount=userService.queryAllUserCount();

        model.addAttribute("user",user);
        model.addAttribute("allUserCount",allUserCount);

        return "userDetail";
    }
}

<?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://dubbo.apache.org/schema/dubbo"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://dubbo.apache.org/schema/dubbo http://dubbo.apache.org/schema/dubbo/dubbo.xsd">

    <!-- 声明服务消费者名称：保证唯一性 -->
    <dubbo:application name="005-link-consumer"/>

    <!-- 引用远程接口服务 -->
    <dubbo:reference interface="com.szh.dubbo.service.UserService"
                     id="userService"
                     url="dubbo://localhost:20880"
                     registry="N/A"/>

</beans>

<?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:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 组件扫描器，扫描controller包下的注解 -->
    <context:component-scan base-package="com.szh.dubbo.controller"/>

    <!-- 开启SpringMVC注解驱动 -->
    <mvc:annotation-driven/>

    <!-- 配置视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

</beans>

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <!-- 配置SpringMVC的中央调度器，读取Spring、Dubbo配置文件信息 -->
    <servlet>
        <servlet-name>DispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:applicationContext.xml,classpath:dubbo-consumer.xml</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>DispatcherServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

<%@ page contentType="text/html;charset=utf-8" language="java" %>
<html>
<head>
    <title>$</title>
</head>
<body>
    <h3>用户详情</h3>
    <div>用户编号：${user.id}</div>
    <div>用户姓名：${user.username}</div>
    <div>用户总人数：${allUserCount}</div>
</body>
</html>

2.4.4 启动测试

为后两个maven web工程配置各自的Tomcat服务器，之后启动测试。

配置步骤可以参考这篇博客的结尾部分：https://blog.csdn.net/weixin_43823808/article/details/117335107

下面是测试结果，可以看到jsp页面中成功获取到了后端传来的数据。这就是Dubbo的服务化最佳实践。

以上是关于Dubbo——Dubbo中的常用标签服务化最佳实践的主要内容，如果未能解决你的问题，请参考以下文章

Dubbo应用上云最佳实践

Dubbo服务化最佳实践

EOSPlatform+Dubbo+Zookeeper最佳实践

springboot整合dubbo-服务化最佳实践

Dubbo Spring Boot 最佳实践整合 Demo 征集

合集DUBBO源码解析及最佳实践合集二十四篇