SpringCloud入门（一）- Eureka

在前期准备的文章中也说过了Spring Cloud的5大组件，今天就来讲讲服务发现（注册）。无论是Spring Cloud H版还是最新的版本，Eureka都是作为服务发现和注册的常用组件。

项目搭建

构建一个eureka的「父模块」，具体怎么实现可以参考前篇文章。

在空项目里面构建「2个模块」

eureka的服务端，eureka的客户端，其中客户端在本例仅包括服务的生产者。

Eureka父模块的pom文件如下，为了方便直接引入了server和client

<?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>spring-cloud-learning</artifactId>
        <groupId>com.cutey.none</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>eureka</artifactId>
    <packaging>pom</packaging>
    <modules>
        <module>eureka-server8001</module>
        <module>eureka-client-provide7001</module>
        <module>eureka-client-consume9001</module>
    </modules>

    <properties>
        <maven.compiler.source>9</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>


    </dependencies>

</project>

可以看到pom文件中指明了父模块，同时也继承了父模块的依赖。全部完成后，我的项目结构如下图所示：

「项目的规约」，不一定是和真正开发一样，但是为了方便记忆：

「服务注册中心的端口为8xxx」
「生产端的端口为7xxx」
「消费端的端口为9xxx」

Eureka Server

在上一步的pom文件中就已经通过maven导入了Eureka Server的依赖。如果没有在父模块中导入，则需加入下面的代码：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
</dependency>

接下来要做的就是「增加配置文件」和「启动类」以及「业务代码」的编写。

「配置文件」

application.yml

server:
  port: 8001
eureka:
  instance:
    hostname: localhost
  client:
    register-with-eureka: false
    fetch-registry: false
    service-url:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

注意我这里的端口是8001，但是eureka默认的端口是8761，这个端口可以自行修改，所以问题不大。

还有一个需要注意的点是，defaultZone 「是一定需要的」，官方文档里面是说service-url 是以键值对的形式存储，所以必须要有key和value。

「启动类」

@SpringBootApplication
@EnableEurekaServer
public class EurekaServer8001 {
    public static void main(String[] args) {
        SpringApplication.run(EurekaServer8001.class, args);
    }
}

主要是加了一个@EnableEurekaServer 的注解，由于是服务端的原因，在这种demo中就没有添加其它多余的业务类。

Eureka Client生产端

生产端可以说真正调用的地方，提供了业务代码。同样在父模块中已经引入了Eureka Client依赖，如果没有在父类中引用，那么需要添加以下代码：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

「配置文件」

server:
  port: 7001
spring:
  application:
    name: eureka-provide

eureka:
  client:
    fetch-registry: true
    register-with-eureka: true
    service-url:
      defaultZone: http://localhost:8001/eureka/
  instance:
    instance-id: eureka-provide7001

其实会发现配置文件大差不差，客户端的时候因为需要往服务端中注册，所以register-with-eureka 为true，并且后续可能去注册中心获取其它地址，fetch-registry 也为true。然后这个instance-id 是服务注册到Eureka的实例id，在后面创建集群的时候也会说到。

「启动类和业务类」

本例把启动类和业务类放在了一起，因为仅仅是入门的原因，所以基本上能简则简，官网上的demo也是这样的。

@SpringBootApplication
@RestController
@EnableEurekaClient
public class EurekaProvide7001 {

    @Value("${server.port}")
    int port;

    @GetMapping("/eureka/provide")
    public String getInfo() {
        return "hello, eureka provide:" + port;
    }
    public static void main(String[] args) {
        SpringApplication.run(EurekaProvide7001.class, args);
    }
}