微服务入门示例（三）服务消费者app-client

八月他大
103 阅读3分钟

一、背景介绍

两个项目app-server和app-client，假定app-server对外提供服务接口，app-client消费接口服务（当前假设只是为了示例简单清晰，项目中请根据实际情况设计），可以使用Eureka做服务注册中心，自动发现微服务接口、管理查看服务、接口状态；使用Zuul做微服务网关，进行日志记录或者鉴权处理，配合Ribbon进行微服务负载均衡，Histrix对异常业务熔断、降级处理，Feign进行服务调用。

【注】：

配置中心介绍请参考第一节内容，1、Eureka开发示例

为消费者提供服务的参考上一节，2、服务提供者

二、服务消费者项目开发

1、创建项目

在IDEA中，点击File->New->Project...，选择Maven创建项目，如下图所示

image.png

点击Next，输入项目名称Name，存储地址Location和修改GroupId，如下图

image.png

点击Finish完成项目创建一个maven空项目。

2、父pom文件配置

在app-client目录下，修改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>org.nandy</groupId>
    <artifactId>app-client</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <java.version>1.8</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <spring-boot.version>2.3.7.RELEASE</spring-boot.version>
        <spring-cloud.version>Hoxton.SR9</spring-cloud.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>2.3.7.RELEASE</version>
                <configuration>
                    <mainClass>com.nandy.app_client.AppClientApplication</mainClass>
                </configuration>
                <executions>
                    <execution>
                        <id>repackage</id>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

3、创建Moudle

在项目上右键New->Moudle...，在弹出的窗口中选中Maven，点击Next弹出窗口如下：

image.png

4、application配置

在第3步创建的module中，修改application.yml配置如下

# 应用名称
spring:
  application:
    name: app-client

server:
  port: 8084

eureka:
  client:
    service-url:
      #Eureka服务的地址，在启动的时候需要将自身的信息注册到Eureka中去
      defaultZone: http://localhost:8081/eureka/
  instance:
    # 采用IP注册
    prefer-ip-address: true
    instance-id: ${spring.application.name}:${spring.cloud.client.ip-address}:${server.port}

5、消费者服务接口

定义一个服务接口，通过Rest对外提供/data服务，该服务自己对外提供的接口，同时定义 /callHello接口，在业务中调用服务端接口并打印日志。

package com.nandy.consumer.controller;

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;

/**
 * @Author : Nandy
 * @Description : 消费者服务接口
 * @Date : create in 2022/9/27 11:00
 * @Version 1.0
 * @Modify :
 * ===================================================
 * Modifier        Modifytime        Description
 * ===================================================
 */
@Slf4j
@RestController
public class UserController {

    @Autowired
    @Qualifier("restTemplate")
    private RestTemplate restTemplate;

    /**
     * 客户端对外提供的服务
     * @param name 姓名
     */
    @GetMapping("/data")
    public String hello(@RequestParam(name = "name") String name){
        String msg = "Customer, Hello " + name +"!";
        log.info("2、==========================="+msg+"=================");
        return msg;
    }

    /**
     * 调用服务提供者的服务，完成自己的业务后对外二次服务
     */
    @GetMapping("/callHello")
    public String callHello(){
        log.info("3、===========================This is provider service.=================");
        return restTemplate.getForObject("http://localhost:8082/hello", String.class);
    }
}

6、启动类

package com.nandy.consumer;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.context.annotation.Bean;
import org.springframework.web.client.RestTemplate;

@SpringBootApplication
@EnableDiscoveryClient
public class AppClientApplication {

    @Bean(name = "restTemplate")
    public RestTemplate restTemplate(){
        return new RestTemplate();
    }

    public static void main(String[] args) {
        SpringApplication.run(AppClientApplication.class, args);
    }

}

三、测试

首先启动Eureka配置中心，参考Eureka开发示例，再启动当前服务，在浏览器中输入：http://localhost:8081/ 如下图：

image.png 红色方框即为新开发的并被配置中心注册的微服务。

1、客户端接口调用测试

使用postman、apifox或者其他接口测试工具调用/data服务，能够正常返回，如下图

image.png

【注意】：1、客户端的ip、客户端服务端口和服务的uri，如IP:8084/data；2、示例中的客户端服务/data是需要带name参数的

下图为服务端日志

image.png

2、客户端业务中调用服务端接口测试

使用apifox接口测试工具调用/callHello服务，能够正常返回，如下图

image.png 客户端日志

image.png

服务端日志

image.png

avatar
文章
阅读
粉丝