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"}
可知,成功調用了服務提供者的服務。
總結,本例子的結構圖: