dubbo+springmvc+mybatis集成demo

dubbo是一个远程服务调用的分布式框架。

1.1、Dubbo是什么？

Dubbo是一个分布式服务框架，致力于提供高性能和透明化的RPC远程服务调用方案，以及SOA服务治理方案。简单的说，dubbo就是个服务框架，如果没有分布式的需求，其实是不需要用的，只有在分布式的时候，才有dubbo这样的分布式服务框架的需求，并且本质上是个服务调用的东东，说白了就是个远程服务调用的分布式框架

其核心部分包含:

1. 远程通讯: 提供对多种基于长连接的NIO框架抽象封装，包括多种线程模型，序列化，以及“请求-响应”模式的信息交换方式。

2. 集群容错: 提供基于接口方法的透明远程过程调用，包括多协议支持，以及软负载均衡，失败容错，地址路由，动态配置等集群支持。

3. 自动发现: 基于注册中心目录服务，使服务消费方能动态的查找服务提供方，使地址透明，使服务提供方可以平滑增加或减少机器。

1.2. Dubbo能做什么？

1.透明化的远程方法调用，就像调用本地方法一样调用远程方法，只需简单配置，没有任何API侵入。

2.软负载均衡及容错机制，可在内网替代F5等硬件负载均衡器，降低成本，减少单点。

3. 服务自动注册与发现，不再需要写死服务提供方地址，注册中心基于接口名查询服务提供者的IP地址，并且能够平滑添加或删除服务提供者。

1.3. dubbo的架构

dubbo架构图如下所示：



节点角色说明：

Provider: 暴露服务的服务提供方。

Consumer: 调用远程服务的服务消费方。

Registry: 服务注册与发现的注册中心。

Monitor: 统计服务的调用次调和调用时间的监控中心。

Container: 服务运行容器。

调用关系说明：

0.服务容器负责启动，加载，运行服务提供者。

1. 服务提供者在启动时，向注册中心注册自己提供的服务。

2. 服务消费者在启动时，向注册中心订阅自己所需的服务。

3. 注册中心返回服务提供者地址列表给消费者，如果有变更，注册中心将基于长连接推送变更数据给消费者。

4. 服务消费者，从提供者地址列表中，基于软负载均衡算法，选一台提供者进行调用，如果调用失败，再选另一台调用。

5. 服务消费者和提供者，在内存中累计调用次数和调用时间，定时每分钟发送一次统计数据到监控中心。

更详细资料请参阅官网介绍：http://dubbo.io/

下面来搭建dubbo+springmvc+mybatis的架构

一、集成demo的环境：

1、jdk1.8

2、开发工具：IDEA

3、服务注册中心：zookeeper-3.4.8

4、dubbo版本：2.5.6

5、maven

二、demo的架构如图：



其中：

dubbo-api：公共服务接口

dubbo-prodiver：dubbo服务提供者

dubbo-consumer：dubbo服务消费者

dubbo-consumer2：dubbo服务消费者

三、整个架构的依赖：

<properties>
<project.build.sourceEncoding>utf-8</project.build.sourceEncoding>
<java.version>1.8</java.version>
<spring-version>4.3.12.RELEASE</spring-version>
<log4j-version>1.2.17</log4j-version>
<dom4j.version>1.6.1</dom4j.version>
<mybatis-version>3.4.5</mybatis-version>
<mybatis-spring.version>1.3.0</mybatis-spring.version>
<junit.version>4.12</junit.version>
<slf4j>1.7.12</slf4j>
<dubbo.version>2.5.6</dubbo.version>
<zookeeper_version>3.4.7</zookeeper_version>
<zkclient_version>0.10</zkclient_version>
<httpClient.version>4.4</httpClient.version>
<validation_version>1.0.0.GA</validation_version>
<slf4j_version>1.7.25</slf4j_version>
<log4j_version>1.2.16</log4j_version>
<tk_mybatis_mapper.version>3.3.6</tk_mybatis_mapper.version>
<aspectj>1.8.12</aspectj>
<druid_version>1.1.5</druid_version>
<mysql_version>5.1.44</mysql_version>
<jackson_version>2.9.2</jackson_version>
</properties>

<dependencyManagement>
<dependencies>
<!--dubbo依赖 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>dubbo</artifactId>
<version>${dubbo.version}</version>
</dependency>
<!-- servlet begin -->
<dependency>
<groupId>javax.validation</groupId>
<artifactId>validation-api</artifactId>
<version>${validation_version}</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.0.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.1</version>
<scope>provided</scope>
</dependency>

<dependency>
<groupId>javax.ws.rs</groupId>
<artifactId>javax.ws.rs-api</artifactId>
<version>2.0</version>
</dependency>
<!-- servlet end -->

<!-- apache commons begin -->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.1</version>
</dependency>
<dependency>
<groupId>commons-lang</groupId>
<artifactId>commons-lang</artifactId>
<version>2.6</version>
</dependency>
<dependency>
<groupId>commons-discovery</groupId>
<artifactId>commons-discovery</artifactId>
<version>0.5</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>${druid_version}</version>
</dependency>
<!-- apache commons end -->
<!-- dataSource begin -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql_version}</version>
</dependency>
<!-- dataSource end -->
<!-- log module   begin -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>${slf4j_version}</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>${slf4j_version}</version>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging-api</artifactId>
<version>${jcl_version}</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>${log4j_version}</version>
</dependency>
<!-- log module   end -->
<!-- spring相关jar包 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring-version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>${spring-version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>${spring-version}</version>
</dependency>

<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>${spring-version}</version>
</dependency>

<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aop</artifactId>
<version>${spring-version}</version>
</dependency>

<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>${spring-version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-orm</artifactId>
<version>${spring-version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
<version>${spring-version}</version>
</dependency>
<!-- spring webmvc相关jar包 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring-version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>${spring-version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-expression</artifactId>
<version>${spring-version}</version>
</dependency>
<!-- test scope begin -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit.version}</version>
<scope>test</scope>
</dependency>

<!--  mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>${mybatis-spring.version}</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>${mybatis-version}</version>
</dependency>
<dependency>
<groupId>org.apache.zookeeper</groupId>
<artifactId>zookeeper</artifactId>
<version>${zookeeper_version}</version>
<type>pom</type>
</dependency>
<dependency>
<groupId>com.101tec</groupId>
<artifactId>zkclient</artifactId>
<version>${zkclient_version}</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjrt</artifactId>
<version>${aspectj}</version>
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>${aspectj}</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>${jackson_version}</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>${jackson_version}</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>${jackson_version}</version>
</dependency>
</dependencies>
</dependencyManagement>

四、公共服务接口

项目的实体类以及公共服务的service接口，所有的服务提供者以及消费者都依赖与这个子module，所以公共服务接口需要指定 packaging是jar

/**
* Created by zhaojw
* Date: 2017/10/26
* Time: 18:03
*
* @author: zhaojw
*/
public interface UserService {

/**
* 根据id查询用户
* @param id
* @return
*/
User selectUserById(Long id);

/**
* 根据姓名查询用户
* @param userName
* @return
*/
User selectUserByUserName(String userName);
}

五、服务提供者

这个层与数据交互，实现公共服务接口。mybatis在此处发挥作用。

1、dubbo服务提供者的配置：

<!-- 引入spring-datasouce.xml -->
<import resource="classpath:spring/spring-datasource.xml"/>
<!-- 接入dubbo的应用程序名称 -->
<dubbo:application name="demo-provider" />
<!-- 注册仓库地址：zookeeper组件，192.168.61.128:2181 -->
<dubbo:registry address="zookeeper://192.168.1.102:2181" />
<!-- 用dubbo协议在20880端口暴露服务 -->
<dubbo:protocol name="dubbo" port="20880"   />
<!--
声明需要暴露的服务接口，
请注意ref属性中指定的HelloService接口实现类，它并没有在xml文件中定义，而是使用注解的方式在class中定义
-->
<dubbo:service interface="com.common.api.service.UserService" ref="userService"/>

<bean id="userService" class="com.provider.service.impl.UserServiceImpl"/>

其中需要在pom.xml中引入：

<dependency>
<groupId>com.dubbo.api</groupId>
<artifactId>dubbo-api</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>

2、公共服务接口的实现：

/**
* Created by zhaojw
* Date: 2017/10/26
* Time: 18:32
*
* @author: zhaojw
*/
@Service
public class UserServiceImpl implements UserService {

@Resource
private UserMapper userMapper;

/**
* 根据id查询用户
*
* @param id
* @return
*/
@Override
public User selectUserById(Long id) {
return userMapper.selectByPrimaryKey(id);
}

/**
* 根据姓名查询用户
*
* @param userName
* @return
*/
@Override
public User selectUserByUserName(String userName) {
return userMapper.selectUserByName(userName);
}
}

3、mybatis的maper接口：

/**
* Created by zhaojw
* Date: 2017/10/26
* Time: 18:29
*
* @author: zhaojw
*/
public interface UserMapper {

/**
* 根据id查询
* @param id
* @return
*/
User selectByPrimaryKey(Long id);

/**
* 根据登陆账户查询user
* @param userName
* @return
*/
User selectUserByName(String userName);
}

至于mapper.xml文件就不多说。

通常dubbo的服务提供者在生产环境当中是需要达成jar

包直接通过jar命令执行。而我们做测试时或者本地开发时只需要在本地启动一下就可以。

/**
* Created by zhaojw
* Date: 2017/10/27
* Time: 16:10
*
* @author: zhaojw
*/
public class ProdiverApplication {

public static void main(String[] args) throws Exception{
ClassPathXmlApplicationContext context=new ClassPathXmlApplicationContext("classpath:dubbo/dubbo-provider.xml");
context.start();

System.out.println(" Application run ");

System.in.read(); // 按任意键退出
}
}

此时运行main()方法，打开dubbo-admin可以发现有新的服务器提供者注册到zookeeper。



六、服务消费者

相当于一个controller层，调用提供者，获取相关的数据，或者相应的操作。

所以在这里需要配置springmvc的以及web.xml

1、服务消费者的配置：

<!-- 客户端应用程称呼名称 -->
<dubbo:application name="demo-consumer" />

<!-- 注册仓库地址：zookeeper组件，192.168.61.128:2181 -->
<dubbo:registry address="zookeeper://192.168.1.102:2181" />

<!-- 引用的服务，那个interface一定是一个被引入到DUBBO仓库的接口定义 -->
<dubbo:reference id="userService" interface="com.common.api.service.UserService"/>

controller：

/**
* Created by zhaojw
* Date: 2017/10/27
* Time: 16:42
*
* @author: zhaojw
*/
@RestController
public class UserController {

@Resource
private UserService userService;

@GetMapping("/getUserById/{id}")
public User getUser(@PathVariable("id") Long userId){
return userService.selectUserById(userId);
}
}

启动消费者1，消费者2，可以发现dubbo-admin有两个消费者注册进来。



请求一下消费者1的controller：

http://localhost:7077/dubbo/consumer/getUserById/2

返回结果：



至于增删改也可以相应的实现

此时一个简单的dubbo+springmvc+mybatis集成demo就完成了。

具体代码：https://github.com/zhaojw420/dubbo-master