微服务入门示例（二）服务提供者app-server

一、背景介绍

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

【注】：配置中心介绍请参考上一节内容，1、Eureka开发示例

二、服务提供者项目开发

1、创建项目

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

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

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

2、父pom文件配置

在app-server目录下，修改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-server</artifactId>
    <packaging>pom</packaging>
    <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.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_server.AppServerApplication</mainClass>
                </configuration>
                <executions>
                    <execution>
                        <id>repackage</id>
                        <goals>
                            <goal>repackage</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

3、创建Moudle

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

点击finish后项目结构如下

【注】：app-server-api是另外一个module，创建方式参考3、创建module；同时父pom中会增加两行如下代码

<modules>
    <module>app-server-main</module>
    <module>app-server-api</module>
</modules>

4、application配置

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

server:
  port: 8082

spring:
  application:
    #注意名称不要使用下划线'_'，可以使用'-'
    name: app-server
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、provider数据服务接口

定义一个最简单的数据服务，通过Rest对外提供/hello服务，后台打印一行请求日志，并返回请求方Hello Wrold字符串。

package com.nandy.provider.controller;

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @Author : Nandy
 * @Description :
 * @Date : create in 2022/9/21 18:24
 * @Version 1.0
 * ===================================================
 * Modifier        Modifytime        Description
 * ===================================================
 */
@Slf4j
@RestController
public class HelloController {
    @RequestMapping("hello")
    public String index() {
        log.info("===========================index is called=================");
        return "Hello World";
    }
}

6、启动类

package com.nandy.provider;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
// Eureka客户端注册或扫描监听
@EnableDiscoveryClient
public class AppServerApplication {

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

三、测试

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

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

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

服务端打印日志如下