Dubbo——Dubbo中的常用标签、服务化最佳实践-阿里云开发者社区

文章目录：

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>

第三个是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的服务化最佳实践。