SpringCloudマイクロサービス【実践編】 | サービス分割とリモート呼び出し

目次

1: サービス分割とリモート通話

1. サービス分割

2. サービス間の通話

3. プロバイダーと消費者 

---

1: サービス分割とリモート通話

1. サービス分割

サービスを分割する際の注意点

1. 単一の責任: 異なるマイクロサービスに対して同じビジネスを繰り返し開発しないでください。

2. データの独立性: 他のマイクロサービスのデータベースにはアクセスしません。

3. サービス指向: ビジネスを他のマイクロサービスが呼び出すためのインターフェイスとして公開します。

ケース: 親プロジェクトcloud-demo、サブプロジェクトの order-service は ID に基づいて注文をクエリし、user-service は ID に基づいてユーザー テーブルにクエリを実行します

ステップ 1: データベース テーブルの準備 --- データベースの分離

Cloud_user データベースの tb_user テーブル

Cloud_order データベースの tb_order テーブル

ステップ 2: 親プロジェクトのクラウドデモ---プロジェクトの分離

主に 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>cn.itcast.demo</groupId>
    <artifactId>cloud-demo</artifactId>
    <version>1.0</version>
    <modules>
        <module>user-service</module>
        <module>order-service</module>
    </modules>

    <packaging>pom</packaging>
    <!--SpringBoot项目-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.9.RELEASE</version>
        <relativePath/>
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <!--版本号-->
        <java.version>1.8</java.version>
        <spring-cloud.version>Hoxton.SR10</spring-cloud.version>
        <mysql.version>5.1.47</mysql.version>
        <mybatis.version>2.1.1</mybatis.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <!-- springCloud -->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!-- mysql驱动 -->
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>${mysql.version}</version>
            </dependency>
            <!--mybatis-->
            <dependency>
                <groupId>org.mybatis.spring.boot</groupId>
                <artifactId>mybatis-spring-boot-starter</artifactId>
                <version>${mybatis.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>
</project>

ステップ 3: サブプロジェクトの注文サービス

プロジェクト構造ディレクトリ:

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">
    <parent>
        <artifactId>cloud-demo</artifactId>
        <groupId>cn.itcast.demo</groupId>
        <version>1.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>order-service</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

PoJo クラス注文

package cn.itcast.order.pojo;

import lombok.Data;

@Data
public class Order {
    private Long id;
    private Long price;
    private String name;
    private Integer num;
    private Long userId;
    private User user;
}

Pojo类User

package cn.itcast.order.pojo;

import lombok.Data;

@Data
public class User {
    private Long id;
    private String username;
    private String address;
}

 マッパーインターフェース

package cn.itcast.order.mapper;

import cn.itcast.order.pojo.Order;
import org.apache.ibatis.annotations.Select;

public interface OrderMapper {

    @Select("select * from tb_order where id = #{id}")
    Order findById(Long id);
}

サービスコールマッパーインターフェース

package cn.itcast.order.service;

import cn.itcast.order.mapper.OrderMapper;
import cn.itcast.order.pojo.Order;
import cn.itcast.order.pojo.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

@Service
public class OrderService {

    @Autowired
    private OrderMapper orderMapper;

    public Order queryOrderById(Long orderId) {
        // 1.查询订单
        Order order = orderMapper.findById(orderId);
        // 4.返回
        return order;
    }
}

コントローラーがサービスを呼び出す

package cn.itcast.order.web;

import cn.itcast.order.pojo.Order;
import cn.itcast.order.service.OrderService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/order")
public class OrderController {

   @Autowired
   private OrderService orderService;

    @GetMapping("/{orderId}")
    // @RequestMapping("/order")  和@GetMapping("/{orderId}")等价于@GetMapping("/user/{orderId})
    public Order queryOrderByUserId(@PathVariable("orderId") Long orderId) {
        // 根据id查询订单并返回
        return orderService.queryOrderById(orderId);
    }
}

application.yml 設定

server:
  port: 8080
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/cloud_order?useSSL=false
    username: root
    password: 123456
    driver-class-name: com.mysql.jdbc.Driver
mybatis:
  type-aliases-package: cn.itcast.user.pojo
  configuration:
    map-underscore-to-camel-case: true
logging:
  level:
    cn.itcast: debug
  pattern:
    dateformat: MM-dd HH:mm:ss:SSS

ステップ 4: サブプロジェクトのユーザーサービス

プロジェクト構造ディレクトリ:

 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">
    <parent>
        <artifactId>cloud-demo</artifactId>
        <groupId>cn.itcast.demo</groupId>
        <version>1.0</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>user-service</artifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
        </dependency>
    </dependencies>
    <build>
        <finalName>app</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

Pojo类User

package cn.itcast.order.pojo;

import lombok.Data;

@Data
public class User {
    private Long id;
    private String username;
    private String address;
}

 マッパーインターフェース

package cn.itcast.user.mapper;

import cn.itcast.user.pojo.User;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

public interface UserMapper {
    
    @Select("select * from tb_user where id = #{id}")
    User findById(@Param("id") Long id);
}

サービスコールマッパーインターフェース

package cn.itcast.user.service;

import cn.itcast.user.mapper.UserMapper;
import cn.itcast.user.pojo.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    public User queryById(Long id) {
        return userMapper.findById(id);
    }
}

コントローラーがサービスを呼び出す

package cn.itcast.user.web;

import cn.itcast.user.pojo.User;
import cn.itcast.user.service.UserService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@Slf4j
@RestController
@RequestMapping("/user")
public class UserController {

    @Autowired
    private UserService userService;

    /**
     * 路径： /user/110
     *
     * @param id 用户id
     * @return 用户
     */
    @GetMapping("/{id}")
    public User queryById(@PathVariable("id") Long id) {
        return userService.queryById(id);
    }
}

application.yml 設定

server:
  port: 8081
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/cloud_user?useSSL=false
    username: root
    password: 123456
    driver-class-name: com.mysql.jdbc.Driver
mybatis:
  type-aliases-package: cn.itcast.user.pojo
  configuration:
    map-underscore-to-camel-case: true
logging:
  level:
    cn.itcast: debug
  pattern:
    dateformat: MM-dd HH:mm:ss:SSS

これら 2 つのサーバーを起動します (両方のプロジェクトの起動クラスに @MapperScan の注釈を付ける必要があります)

注文は個別にアクセスされ、ユーザー情報は null です。

ユーザーのみのアクセス

2. サービス間の通話

前回のプロジェクトがデプロイされました 注文情報が確認できます ID単体で注文、ユーザー情報も確認できます User!しかし現在、顧客は注文要件を確認し、ユーザー情報も知りたいと求めています。

要件: 注文 ID に基づいて注文をクエリするときに、注文が属するユーザー情報を返します。 

分析: 注文モジュールは注文情報のみを検索でき、ユーザー モジュールはユーザー情報のみを検索できます。ただし、ユーザーが必要としているのは、クエリ中にユーザー情報を検索することです。注文情報。

したがって、注文モジュールの機能を変更し、注文情報をクエリする際に、注文情報の userId を介して相互のユーザー情報もクエリできるようにする必要があります。

考え:オーダー モジュールを直接使用してユーザー モジュールのデータを確認することはできますか?明らかにそうではありません。私たちはすでに開発ビジネスを分析しており、それを繰り返すべきではありません。注文からユーザーへのリモート通話を開始することしかできません。

解決する：

①実はユーザー情報は @GetMapping("/user/{id}) というリンクアドレスを通じて外部に公開されており、このリンクアドレスを通じてデータベースにアクセスし、ブラウザーにユーザー情報を取得することができます。

② この時点で注文モジュールが http プロトコルのリンク要求を発行できる場合は、ユーザー情報データを返し、元の注文情報データと結合して要件を完了することもできます。

さて、肝心の質問は、注文情報モジュールの Java コードで HTTP リクエストを送信する方法です。

Spring は、それを完了するためのRestTemplate クラスツールを提供します。具体的な実装手順は次のとおりです。

ステップ 1: RestTemplate を登録する

RestTemplate クラスをスタートアップ クラス OrderApplication に挿入します。

package cn.itcast.order;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.web.client.RestTemplate;

@MapperScan("cn.itcast.order.mapper")
@SpringBootApplication
public class OrderApplication {

    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class, args);
    }
    
    // 注册RestTemplate
    @Bean
    public RestTemplate restTemplate(){
        return new RestTemplate();
    }

}

ステップ 2: サービスがリモートで RestTemplate を呼び出す

この RestTemplate クラスを通じて getForObject() メソッドを呼び出します。最初のパラメーターは URL アドレス、2 番目のパラメーターは返される型です。

package cn.itcast.order.service;

import cn.itcast.order.mapper.OrderMapper;
import cn.itcast.order.pojo.Order;
import cn.itcast.order.pojo.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

@Service
public class OrderService {

    @Autowired
    private OrderMapper orderMapper;

    // 注入RestTemplate
    @Autowired
    private RestTemplate restTemplate;

    public Order queryOrderById(Long orderId) {
        // 1.查询订单
        Order order = orderMapper.findById(orderId);
        // 2.发出请求查询用户信息
        String url = "http://localhost:8081/user/"+order.getUserId();
        User user = restTemplate.getForObject(url, User.class);
        // 3. 把用户信息封装到order
        order.setUser(user);
        // 4.返回
        return order;
    }
}

このとき、Order のみにアクセスし、User 情報を表示することができます。

マイクロサービスの呼び出し方法のまとめ

①RestTemplateによって開始されたhttpリクエストに基づくリモート呼び出し。

② リモート通話の HTTP リクエストは、相手の IP、ポート、インターフェイス パス、リクエスト パラメータがわかっている限り、言語に依存しない通話です。

3. プロバイダーと消費者 

サービスプロバイダ: ビジネス内の他のマイクロサービスによって呼び出されるサービス。 (他のマイクロサービスへのインターフェースを提供します);

サービスコンシューマ: ビジネス内の他のマイクロサービスを呼び出すサービス。 (他のマイクロサービスによって提供されるインターフェイスを呼び出します);

では、上記の注文サービスとユーザー サービスの提供者はどちらでしょうか?消費者はどちらですか？

思考: サービス A はサービス B を呼び出し、サービス B はサービス C を呼び出します。では、サービス B はどのような役割を果たしますか?

サービス B はサービス A に対してプロバイダーであり、サービス B はサービス C に対してコンシューマーです。これは相対的なものであるため、サービスの役割をビジネスに分割することはできません。

サービスコールの関係を要約する

①サービスプロバイダー：他のマイクロサービスから呼び出されるインターフェースを公開します。

②サービスコンシューマ：他のマイクロサービスが提供するインターフェースを呼び出します。

③プロバイダーとコンシューマーの役割は実際には相対的です。サービスは、いつでもサービスでありえます。同時に、プロバイダーとサービス利用者も同様です。