一、dubbo 服務化最佳實踐
1. 分包
建議將服務介面、服務模型、服務異常等均放在公共包中
2. 粒度
服務介面儘可能大粒度,每個服務方法應代表一個功能,而不是某功能的一個步驟,否則將面臨分散式事務問題,Dubbo 暫未提供分散式事務支援
服務介面建議以業務場景為單位劃分,並對相近業務做抽象,防止介面數量爆炸
不建議使用過於抽象的通用介面,如:Map query(Map),這樣的介面沒有明確語義,會給後期維護帶來不便
3. 版本
每個介面都應定義版本號,為後續不相容升級提供可能,如: <dubbo:service interface="com.xxx.XxxService" version="1.0" />。
建議使用兩位版本號,要變更服務版本。先升級一半提供者為新版本,再將消費者全部升為新版本,然後將剩下的一半提供者升為新版本
二、改造 dubbo 專案
抽象分散在多個專案中的公共介面,實體類,異常,工具類到一個專案中(比如:link-interface)
在其他專案如服務提供者,消費者共用公共的資源
三、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. 測試
- 首先開服務提供者的Tomcat
- 然後開服務消費者的Tomcat
- 然後在位址列輸入,就可以看到了