Dubbo直連方式改造

山丘i發表於2020-08-23

一、dubbo 服務化最佳實踐

1. 分包

建議將服務介面、服務模型、服務異常等均放在公共包中

2. 粒度

服務介面儘可能大粒度,每個服務方法應代表一個功能,而不是某功能的一個步驟,否則將面臨分散式事務問題,Dubbo 暫未提供分散式事務支援

服務介面建議以業務場景為單位劃分,並對相近業務做抽象,防止介面數量爆炸

不建議使用過於抽象的通用介面,如:Map query(Map),這樣的介面沒有明確語義,會給後期維護帶來不便

3. 版本

每個介面都應定義版本號,為後續不相容升級提供可能,如: <dubbo:service interface="com.xxx.XxxService" version="1.0" />。
建議使用兩位版本號,要變更服務版本。先升級一半提供者為新版本,再將消費者全部升為新版本,然後將剩下的一半提供者升為新版本

二、改造 dubbo 專案

抽象分散在多個專案中的公共介面,實體類,異常,工具類到一個專案中(比如:link-interface)

在其他專案如服務提供者,消費者共用公共的資源

link-interface是一個maven Java工程
dubbo官方推薦使用的一個模式,將實體bean和業務介面存放到介面工程中

1. pom.xml

這只是一個java工程,這裡不用改變

<?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.md.dubbo</groupId>
    <artifactId>03-link-interface</artifactId>
    <version>1.0.0</version>


</project>

2. 實體類

package com.md.dubbo.model;

import java.io.Serializable;

/**
 * @author MD
 * @create 2020-08-19 10:40
 */
// 對於分散式開發,物件要進行序列化操作
public class User implements Serializable {
    private Integer id;

    private String username;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }
}

3. 公共介面

package com.md.dubbo.service;

import com.md.dubbo.model.User;

/**
 * @author MD
 * @create 2020-08-19 10:41
 */
public interface UserService {

    /**
     * 通過使用者id獲取使用者資訊
     * @param id
     * @return
     */
    User queryUserById(Integer id);


    /**
     * 獲取使用者總人數
     * @return
     */
    Integer queryAllUserCount();
}

四、提供者

建立maven web工程

1. pom.xml

注意引入介面工程的依賴

<?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.md.dubbo</groupId>
  <artifactId>04-link-userservice-provider</artifactId>
  <version>1.0.0</version>
  <packaging>war</packaging>


  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>

    <!--spring依賴-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.3.16.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.3.16.RELEASE</version>
    </dependency>


    <!--dubbo依賴-->
    <dependency>
      <groupId>com.alibaba</groupId>
      <artifactId>dubbo</artifactId>
      <version>2.6.2</version>
    </dependency>


    <!--引入介面工程-->
    <dependency>
      <groupId>com.md.dubbo</groupId>
      <artifactId>03-link-interface</artifactId>
      <version>1.0.0</version>
    </dependency>


  </dependencies>

  <build>

  </build>
</project>

2. 介面實現

這裡只是一個簡單的模擬

package com.md.dubbo.service.impl;

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

/**
 * @author MD
 * @create 2020-08-19 10:48
 */
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 9;
    }
}

3. 服務提供者的核心配置檔案

在resources目錄下建立dubbo-userservice-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://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服務提供者名稱:保證唯一性,通常用model名就可以-->
    <dubbo:application name="04-link-userservice-provider"/>


    <!--設定dubbo使用的協議和埠號-->
    <dubbo:protocol name="dubbo" port="20880"/>

    <!--暴露服務介面-->
    <dubbo:service interface="com.md.dubbo.service.UserService" ref="userService" registry="N/A"/>


    <!--載入業務介面的實現類到spring容器中-->
    <bean id="userService" class="com.md.dubbo.service.impl.UserServiceImpl"/>

</beans>

4. 新增監聽器

在web.xml中

<?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">

<!--預設的版本低的話換成這個版本的,直接複製即可-->

  <context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:dubbo-userservice-provider.xml</param-value>
  </context-param>

  <listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>

</web-app>

5. 配置Tomcat

埠號注意修改一下:避免衝突

HTTP port :8081

JMX port:1098

五、消費者

1. pom.xml

還是maven web專案

注意:新增了介面的依賴

<?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.md.dubbo</groupId>
  <artifactId>05-link-consumer</artifactId>
  <version>1.0.0</version>
  <packaging>war</packaging>



  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
    <!--spring依賴-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.3.16.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.3.16.RELEASE</version>
    </dependency>

    <!--dubbo依賴-->
    <dependency>
      <groupId>com.alibaba</groupId>
      <artifactId>dubbo</artifactId>
      <version>2.6.2</version>
    </dependency>


    <!--介面工程-->
    <!--此時不像之前的還得打jar包,這裡不用,03是普通的java工程,只提供介面-->
    <dependency>
      <groupId>com.md.dubbo</groupId>
      <artifactId>03-link-interface</artifactId>
      <version>1.0.0</version>
    </dependency>


  </dependencies>

  <build>

  </build>
</project>

2. 服務消費者的核心配置檔案

在resources目錄下建立dubbo-consumer.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://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="05-link-consumer"/>

    <!--引用遠端介面服務-->
    <dubbo:reference id="userService" interface="com.md.dubbo.service.UserService"
                     url="dubbo://localhost:20880"
                     registry="N/A"/>
    
</beans>

3. controller

package com.md.dubbo.web;

import com.md.dubbo.model.User;
import com.md.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;

/**
 * @author MD
 * @create 2020-08-19 11:11
 */
@Controller
public class UserController {

    @Autowired
    private UserService userService;

    @RequestMapping(value = "/userDetail")
    public String userDetail(Model model , Integer id){

        // 根據id獲取使用者資訊
        User user = userService.queryUserById(id);

        // 獲取使用者總人數
        Integer allUserCount = userService.queryAllUserCount();

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

        return "userDetail";
    }


}


4. applicationContext.xml

在resources目錄下建立spring配置檔案

<?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 http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!--掃描元件-->
    <context:component-scan base-package="com.md.dubbo.web"/>

    <!--配置註解驅動-->
    <mvc:annotation-driven/>

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/"/>
        <property name="suffix" value=".jsp"/>

    </bean>

</beans>

5. 配置中央排程器

在web.xml中

<?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">


  <!--中央排程器-->

  <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>

6. 配置Tomcat

此時使用預設的就可以了

7. 配置測試頁面

在webapp下 建立userDetail.jsp

<%--
  Created by IntelliJ IDEA.
  User: MD
  Date: 2020/8/19
  Time: 11:16
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<h1>hello Dubbo</h1>

<h2>使用者id:${user.id}</h2>
<h2>使用者姓名:${user.username}</h2>
<h2>使用者總數:${allUserCount}</h2>
</body>
</html>

8. 測試

  1. 首先開服務提供者的Tomcat
  2. 然後開服務消費者的Tomcat
  3. 然後在位址列輸入,就可以看到了

相關文章