SpringCloud之Eureka:服務發佈與調用例子

Eureka是Netflix開發的服務發現框架,自己是一個基於REST的服務,主要用於定位運行在AWS域中的中間層服務,以達到負載均衡和中間層服務故障轉移的目的。 
SpringCloud將它集成在其子項目spring-cloud-netflix中,以實現SpringCloud的服務發現功能。java

Eureka概述web

Eureka包含兩個組件:Eureka Server(服務器,或服務註冊中心)和Eureka Client(客戶端)。算法

Eureka Server提供服務註冊服務,各個節點啓動後,會在Eureka Server中進行註冊,這樣EurekaServer中的服務註冊表中將會存儲全部可用服務節點的信息,服務節點的信息能夠在界面中直觀的看到。
Eureka Client是一個java客戶端,用於簡化與Eureka Server的交互,客戶端同時也就是一個內置的、使用輪詢(round-robin)負載算法的負載均衡器。
在應用啓動後,將會向Eureka Server發送心跳,默認週期爲30秒,若是Eureka Server在多個心跳週期內沒有接收到某個節點的心跳,Eureka Server將會從服務註冊表中把這個服務節點移除(默認90秒)。spring

Eureka Server之間經過複製的方式完成數據的同步,Eureka還提供了客戶端緩存機制,即便全部的Eureka Server都掛掉,客戶端依然能夠利用緩存中的信息消費其餘服務的API。
綜上,Eureka經過心跳檢查、客戶端緩存等機制,確保了系統的高可用性、靈活性和可伸縮性。apache

 

  

 Eureka的服務發佈與調用簡單例子json

1、構建服務器(服務註冊中心)瀏覽器

一、建立項目緩存

開發工具:IntelliJ IDEA 2019.2.2
IDEA中建立一個新的SpringBoot項目,名稱爲「first-ek-server」,SpringBoot版本選擇2.1.9,在選擇Dependencies(依賴)的界面勾選Spring Cloud Discovert -> Eureka Server。服務器

 

建立完成後的pom.xml配置文件自動添加SpringCloud最新穩定版本依賴,當前爲Greenwich.SR3
加入的spring-cloud-starter-eureka-server會自動引入spring-boot-starter-web,所以只需加入該依賴,項目就具備Web容器的功能。
pom.xml完整內容以下:app

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.9.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>first-ek-server</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>first-ek-server</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
        <spring-cloud.version>Greenwich.SR3</spring-cloud.version>
    </properties>

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

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </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>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

二、修改配置application.yml

設置服務端口、服務器註冊開關。
默認狀況下,服務器啓動時會把本身當作一個客戶端,去註冊Eureka服務器,而且會到Eureka服務器抓取註冊信息。
但這裏只是做爲一個服務器,而不是服務的提供者(客戶端),所以設置屬性值爲flase,不然啓動時會在控制檯看到異常信息。
Caused by: java.net.ConnectException: Connection refused: connect
com.netflix.discovery.shared.transport.TransportException: Cannot execute request on any known server

server:
  port: 8761
eureka:
  client:
    register-with-eureka: false
    fetch-registry: false

三、修改啓動類代碼FirstEkServerApplication.java

增長註解@EnableEurekaServer,聲明這是一個Eureka服務器。

package com.example.firstekserver;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

@SpringBootApplication
@EnableEurekaServer
public class FirstEkServerApplication {

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

}

啓動服務,瀏覽器訪問http://localhost:8761,頁面顯示Eureka服務器控制檯,裏面有服務實例列表,當前是空的。

  

2、編寫服務提供者(生產者)

一、建立項目

IDEA中建立一個新的SpringBoot項目,除了名稱爲「first-ek-service-provider」,其它步驟和上面同樣,pom.xml的依賴項也同樣。

二、修改配置application.yml

配置應用名稱爲 first-service-provider,該服務將會被註冊到服務器 http://localhost:8761/eureka/

server:
  port: 8762
spring:
  application:
    name: first-service-provider
eureka:
  instance:
    hostname: localhost
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/

三、添加類 User.java

package com.example.firstekserviceprovider;

public class User {
    private Integer id;
    private String name;

    public User(Integer id, String name){
        this.id = id;
        this.name = name;
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

四、添加控制器 UserController.java

提供一個簡單的REST服務。

package com.example.firstekserviceprovider;

import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @RequestMapping(value = "/user/{userId}", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_VALUE)
    public User findUser(@PathVariable("userId") Integer userId){
        User user = new User(userId, "gdjlc");
        return user;
    }
}

五、修改啓動類代碼FirstEkServerApplication.java

添加註解@EnableEurekaClient,聲明這是一個Eureka客戶端。

package com.example.firstekserviceprovider;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;

@SpringBootApplication
@EnableEurekaClient
public class FirstEkServiceProviderApplication {

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

}

啓動服務,瀏覽器訪問http://localhost:8761,服務實例列表已經增長了FIRST-SERVICE-PROVIDER。

  

3、編寫服務調用者(消費者)

調用者是指一樣註冊到 Eureka的客戶端,來調用其它客戶端發佈的服務。

一、建立項目

IDEA中建立一個新的SpringBoot項目,除了名稱爲「first-ek-service-invoker」,其它步驟和依賴項和上面都同樣。

二、修改配置application.yml

配置應用名稱爲 first-service-invoker,該服務將會被註冊到服務器 http://localhost:8761/eureka/

server:
  port: 8763
spring:
  application:
    name: first-service-invoker
eureka:
  instance:
    hostname: localhost
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/

三、添加控制器 InvokerController.java

在控制器中,配置了RestTemplate的Bean,RestTemplate是spring-web模塊下面的類,主要用來調用REST服務。
自己不具備調用分佈式服務的能力,但被@LoadBalanced註解修飾後,這個RestTemplate實例就具備訪問調用分佈式服務的能力。
另外,下面調用服務,經過服務名稱進行調用。

package com.example.firstekserviceinvoker;

import org.springframework.cloud.client.loadbalancer.LoadBalanced;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;

@RestController
@Configuration
public class InvokerController {

    @Bean
    @LoadBalanced
    public RestTemplate getRestTemplate(){
        return new RestTemplate();
    }

    @RequestMapping(value = "/router", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_VALUE)
    public String router(){
        RestTemplate restTpl = getRestTemplate();
        //根據應用名稱調用服務
        String json = restTpl.getForObject("http://first-service-provider/user/1", String.class);
        return json;
    }
}

四、修改啓動類代碼FirstEkServiceInvokerApplication.java

添加註解@EnableDiscoveryClient,使得服務調用者能夠去Eureka中發現服務。
說明:@EnableDiscoveryClient註解已經包含了@EnableEurekaClient的功能。

package com.example.firstekserviceinvoker;

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

@SpringBootApplication
@EnableDiscoveryClient
public class FirstEkServiceInvokerApplication {

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

}

啓動服務,瀏覽器訪問http://localhost:8761,服務實例列表又增長了FIRST-SERVICE-INVOKER。

 

 備註:上面的紅色粗體警告信息表示Eureka已經進入自我保護模式,暫時不用理會。

瀏覽器訪問http://localhost:8763/router,頁面輸出:

{"id":1,"name":"gdjlc"}

可知,成功調用了服務提供者的服務。

總結,本例子的結構圖:

相關文章
相關標籤/搜索