如何搭建微服务基础环境02

红太狼 2023-09-25 22:04 88阅读 0赞

###  ###

### 3.创建使用会员微服务模块-service consumer ###

#### 3.1需求分析 ####

![18984201550bcc8a9a8c7cacee3d187d.png][]

浏览器向service consumer请求某个数据，service consumer会去向service provider请求数据，然后将service provider返回的数据返回给浏览器。

添加数据同理。

#### 3.2思路分析 ####

1.  创建Module（member-service-consumer-80） & 完成配置
2.  创建controller
3.  完成测试

#### 3.3实现步骤 ####

3.3.1创建Module&完成配置

> 步骤同上一篇的2.3.1

（1）创建Module：`member-service-consumer-80`

![51035ed11db122e9f47a705f729ec39b.png][]

（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">
        <parent>
            <artifactId>E-Commerce-Center</artifactId>
            <groupId>com.li.springcloud</groupId>
            <version>1.0-SNAPSHOT</version>
        </parent>
        <modelVersion>4.0.0</modelVersion>
     
        <artifactId>member-service-consumer-80</artifactId>
     
        <properties>
            <maven.compiler.source>8</maven.compiler.source>
            <maven.compiler.target>8</maven.compiler.target>
        </properties>
     
        
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
     
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-actuator</artifactId>
            </dependency>
     
            
            <dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
            </dependency>
        </dependencies>
    </project>

（3）创建resources/application.yml

server:
      port: 80
    spring:
      application:
        name: member-service-consumer-80

（4）创建启动类

package com.li.springcloud;
     
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
     
    /**
     * @author 李
     * @version 1.0
     */
    @SpringBootApplication
    public class MemberConsumerApplication {
        public static void main(String[] args) {
            SpringApplication.run(MemberConsumerApplication.class,args);
        }
    }

测试，启动成功：

![e702e9cdf27aa224a084ce605548b95c.png][]

3.3.1业务实现

3.3.1.1utils层

创建工具类Result.java（略，见2.3.3.1）

3.3.1.2Entity层

Member.java

package com.li.springcloud.entity;
     
    import lombok.AllArgsConstructor;
    import lombok.Data;
    import lombok.NoArgsConstructor;
     
    /**
     * @author 李
     * @version 1.0
     */
    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    //因为对象在网络中以流的形式传递，这里最好实现Serializable接口
    public class Member implements Serializable{
        private Long id;
        private String name;
        private String pwd;
        private String mobile;
        private String email;
        private Integer gender;
    }

3.3.1.3注入RestTemplate

> RestTemplate 基本介绍：RestTemplate 是 Spring 提供的用于访问Rest服务的模板类，它提供来了许多便捷访问远程 Http 服务的方法。
> 
> 通过 RestTemplate，我们可以向另一个微服务模块发出 Http 请求（支持 Restful 风格），去调用该模块的 Controller 提供的 API 接口，就像浏览器发出请求调用该 API 接口一样。
> 
> RestTemplate 官网：[RestTemplate (Spring Framework 5.2.2.RELEASE API)][RestTemplate _Spring Framework 5.2.2.RELEASE API]

创建配置类，注入RestTemplate对象：

package com.li.springcloud.config;
     
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.web.client.RestTemplate;
     
    /**
     * @author 李
     * @version 1.0
     * 注入RestTemplate Bean
     */
    @Configuration
    public class CustomInitBean {
        @Bean
        public RestTemplate getRestTemplate() {
            return new RestTemplate();
        }
    }

3.3.1.4Controller层

MemberConsumerController.java：

package com.li.springcloud.controller;
     
    import com.li.springcloud.entity.Member;
    import com.li.springcloud.utils.Result;
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.stereotype.Controller;
    import org.springframework.validation.annotation.Validated;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.PathVariable;
    import org.springframework.web.bind.annotation.PostMapping;
    import org.springframework.web.bind.annotation.RestController;
    import org.springframework.web.client.RestTemplate;
     
    import javax.annotation.Resource;
     
    /**
     * @author 李
     * @version 1.0
     */
    @RestController
    @Slf4j
    public class MemberConsumerController {
        @Resource
        private RestTemplate restTemplate;
     
        //定义一个基础的url
        public static final String MEMBER_SERVICE_PROVIDER_URL =
                "http://localhost:10000";
     
        //添加对象到数据库表中
        @PostMapping("/member/consumer/save")
        public Result<Member> save(Member member) {
            log.info("service-consumer member={}", member);
            /**
             * MEMBER_SERVICE_PROVIDER_URL + "/member/save"：就是向对应子模块发出的完整url请求
             * member：就是通过 restTemplate 发出的 post 请求携带的数据（对象）
             * Result.class：就是返回的对象类型
             */
            return restTemplate.postForObject
                    (MEMBER_SERVICE_PROVIDER_URL + "/member/save",
                            member,
                            Result.class);
        }
     
        //根据id调用服务接口，返回member对象信息
        @GetMapping("/member/consumer/get/{id}")
        public Result<Member> getMemberById(@PathVariable("id") Integer id) {
            return restTemplate.getForObject
                    (MEMBER_SERVICE_PROVIDER_URL + "/member/get/" + id,
                            Result.class);
        }
    }

3.3.1完成测试

分别启动两个子模块（service consumer、service provider）

（1）测试save方法：postman以表单形式发出数据：

![16dff49962ae4c3d2e36a5871560ef9a.png][]

结果显示添加成功，但是我们在数据库中看到的确是空值：

![5c25321acf7fc01ecc4861172d856dab.png][]

**原因是因为使用RestTemplate，它会将数据以json格式发送。解决方法是在服务模块对应方法参数中使用@RequestBody注解，将接收的json格式数据转换成对象。**

> 最好实体类实现Serializable，支持可序列化

![bf9ac9d193e3ffe15096f4529edb5839.png][]

重新启动模块，使用postman发送数据：数据库添加成功。

![5fdc735930fedc70fab0ee91d53f309b.png][]

（2）浏览器测试getMemberById方法：

![bdbf99f8906fad68134d0bb6605d2ca4.png][]

测试通过。

#### 3.4注意事项和使用细节 ####

当SpringCloud的服务有多个时，管理多个服务的启动使用右上角的run会不好管理，我们可以使用Run Dashboard：[idea中如何开启Dashboard][idea_Dashboard]

![e4f0b9d10d930b2f65ba28d5a6cbbb69.png][]

### 4.创建共用模块-供其他模块使用 ###

#### 4.1需求分析 ####

我们在 consumer 和 provider 模块都使用到了 Member 和 Result 类，我们可以将它们抽取到共用模块（e\_commerce\_center\_common-api），使用Maven 打包成 jar包，其他模块需要使用直接引入依赖即可。

#### 4.2思路分析 ####

1.  创建Module & 完成配置
2.  创建Entity，把共用的实体类放到对应的包下
3.  完成测试

#### 4.3实现步骤 ####

4.3.1创建Module&完成配置

（1）创建Module--e\_commerce\_center\_common-api

![6b54d0f8d7246baf37fe5276cdb0fcfc.png][]

（2）在本模块的pom.xml引入公共的依赖

<dependencies>
            
            <dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                
                <optional>true</optional>
            </dependency>
        </dependencies>

4.3.2抽取共用的API/类

创建多个子模块都要使用的公共类，**注意路径要和其他模块的路径相同**。

![2ca10cf6e693bcfbf98462467665fab1.png][]

4.3.3使用Maven打包成jar

（1）按如下步骤进行打包：

![9d05c4cfdd02493510b2bf2f9745cae7.png][]

（2）成功后会在target目录下生成对应的jar包：

![e1f14917bd89855b6ebbe7c60cd19200.png][]

并且maven-archiver下的pom.properties中生成了项目对应的坐标：

#Generated by Maven
    #Tue Apr 04 19:38:29 CST 2023
    version=1.0-SNAPSHOT
    groupId=com.li.springcloud
    artifactId=e_commerce_center_common-api

4.3.4工程重构

（1）在 member-service-provider-10000 模块删除当前模块的 entity 包和 utils 包

![52105c55e04aad446ea4cde015959c4d.png][]

（2）在 member-service-provider-10000 的 pom.xml 引入公共模块：

<dependency>
        <groupId>com.li.springcloud</groupId>
        <artifactId>e_commerce_center_common-api</artifactId>
        <version>1.0-SNAPSHOT</version>
    </dependency>

然后点击刷新Maven，这样就可以引入之前打包好的jar包代码了。

（3）同理，在 member-service-consumer-80 模块中也删除 entity 和 utils 包，然后在本模块的 pom.xml 文件中也引入公共模块，然后刷新。

4.3.5完成测试

分别启动 member-service-provider-10000 和 member-service-consumer-80 两个子模块，在浏览器中发送请求进行测试：

如下，测试成功，工程进行重构之后没有问题，公共模块引入各个模块之后依然可以工作。

![b97a002989ed4b44b76cd4bb5c31f662.png][]

--------------------

之后如果多个模块还有公共的类，依然可以通过这种方式来抽取共用的API/类，然后通过引入公共模块的方式来简化代码。

[18984201550bcc8a9a8c7cacee3d187d.png]: https://img-blog.csdnimg.cn/img_convert/18984201550bcc8a9a8c7cacee3d187d.png
[51035ed11db122e9f47a705f729ec39b.png]: https://img-blog.csdnimg.cn/img_convert/51035ed11db122e9f47a705f729ec39b.png
[e702e9cdf27aa224a084ce605548b95c.png]: https://img-blog.csdnimg.cn/img_convert/e702e9cdf27aa224a084ce605548b95c.png
[RestTemplate _Spring Framework 5.2.2.RELEASE API]: https://docs.spring.io/spring-framework/docs/5.2.2.RELEASE/javadoc-api/org/springframework/web/client/RestTemplate.html
[16dff49962ae4c3d2e36a5871560ef9a.png]: https://img-blog.csdnimg.cn/img_convert/16dff49962ae4c3d2e36a5871560ef9a.png
[5c25321acf7fc01ecc4861172d856dab.png]: https://img-blog.csdnimg.cn/img_convert/5c25321acf7fc01ecc4861172d856dab.png
[bf9ac9d193e3ffe15096f4529edb5839.png]: https://img-blog.csdnimg.cn/img_convert/bf9ac9d193e3ffe15096f4529edb5839.png
[5fdc735930fedc70fab0ee91d53f309b.png]: https://img-blog.csdnimg.cn/img_convert/5fdc735930fedc70fab0ee91d53f309b.png
[bdbf99f8906fad68134d0bb6605d2ca4.png]: https://img-blog.csdnimg.cn/img_convert/bdbf99f8906fad68134d0bb6605d2ca4.png
[idea_Dashboard]: https://blog.csdn.net/chinoukin/article/details/80577890
[e4f0b9d10d930b2f65ba28d5a6cbbb69.png]: https://img-blog.csdnimg.cn/img_convert/e4f0b9d10d930b2f65ba28d5a6cbbb69.png
[6b54d0f8d7246baf37fe5276cdb0fcfc.png]: https://img-blog.csdnimg.cn/img_convert/6b54d0f8d7246baf37fe5276cdb0fcfc.png
[2ca10cf6e693bcfbf98462467665fab1.png]: https://img-blog.csdnimg.cn/img_convert/2ca10cf6e693bcfbf98462467665fab1.png
[9d05c4cfdd02493510b2bf2f9745cae7.png]: https://img-blog.csdnimg.cn/img_convert/9d05c4cfdd02493510b2bf2f9745cae7.png
[e1f14917bd89855b6ebbe7c60cd19200.png]: https://img-blog.csdnimg.cn/img_convert/e1f14917bd89855b6ebbe7c60cd19200.png
[52105c55e04aad446ea4cde015959c4d.png]: https://img-blog.csdnimg.cn/img_convert/52105c55e04aad446ea4cde015959c4d.png
[b97a002989ed4b44b76cd4bb5c31f662.png]: https://img-blog.csdnimg.cn/img_convert/b97a002989ed4b44b76cd4bb5c31f662.png