前言
SpringCloud 是微服务中的翘楚,最佳的落地方案。
Eureka 作为注册中心,是 SpringCloud 体系中最重要最核心的组件之一。
Feign 使用接口加注解的方式调用服务,配合 Eureka 还能实现负载均衡。
源码
GitHub地址:https://github.com/intomylife/SpringCloud
环境
1、JDK 1.8.0 +
2、Maven 3.0 +
3、SpringBoot 2.0.3
4、SpringCloud Finchley.RELEASE
开发工具
IntelliJ IDEA
正文
commons 工程
commons 工程 - POM 文件
<?xml version="1.0"encoding="UTF-8"?>4.0.0<!-- 三坐标 -->com.zwcspringcloud-eureka-commons1.0<!-- 工程名称和描述 -->springcloud-eureka-commons公用工程<!-- 打包方式 -->jar<!-- 在 properties下声明相应的版本信息,然后在dependency下引用的时候用 ${}就可以引入该版本jar包了 --><!-- 编码 -->UTF-8<!-- jdk -->1.8<!-- SpringBoot -->Cairo-SR3<!-- SpringCloud -->Finchley.RELEASE<!-- 加入依赖 --><!-- 依赖 jar 包版本管理的管理器 --><!-- 如果 dependencies 里的 dependency 自己没有声明 version 元素,那么 maven 就此处来找版本声明。 --><!-- 如果有,就会继承它;如果没有就会报错,告诉你没有版本信息 --><!-- 优先级:如果 dependencies 里的 dependency 已经声明了版本信息,就不会生效此处的版本信息了 --><!-- SpringBoot -->io.spring.platformplatform-bom${platform-bom.version}pomimport<!-- SpringCloud -->org.springframework.cloudspring-cloud-dependencies${spring-cloud-dependencies.version}pomimport<!-- 插件依赖 -->org.springframework.bootspring-boot-maven-plugin
配置一些共用依赖
commons 工程 - 项目结构
service 工程
此工程下有四个模块:一个注册中心,两个提供者以及一个消费者
registry-server(注册中心)
registry-server - POM 文件
<?xml version="1.0"encoding="UTF-8"?>4.0.0<!-- 继承父 -->com.zwcspringcloud-eureka-service1.0<!-- 三坐标 -->com.zwcspringcloud-eureka-registry-service0.0.1-SNAPSHOT<!-- 工程名称描述 -->springcloud-eureka-registry-service注册中心<!-- 打包方式 -->jar<!-- 在 properties下声明相应的版本信息,然后在dependency下引用的时候用 ${}就可以引入该版本jar包了 --><!-- 加入依赖 --><!-- commons工程 依赖 -->com.zwcspringcloud-eureka-commons1.0<!-- 服务注册中心 -->org.springframework.cloudspring-cloud-starter-netflix-eureka-server<!-- 插件依赖 -->org.springframework.bootspring-boot-maven-plugin
主要是加入 spring-cloud-starter-netflix-eureka-server 依赖
registry-server-application.yml配置文件# 端口server: port:8761# 应用名称spring: application: name:eurka-servereureka: instance:# 使用 ip 代替实例名 prefer-ip-address:true# 实例的主机名 hostname:${spring.cloud.client.ip-address}# 实例的 ID 规则 instance-id:${spring.cloud.client.ip-address}:${spring.application.name}:${server.port} client:# 是否向注册中心注册自己 registerWithEureka:false# 是否向注册中心获取注册信息 fetchRegistry:false serviceUrl:# 注册中心地址 defaultZone:http://${eureka.instance.hostname}:${server.port}/eureka/
这里使用了默认的 8761 端口,当然也可以更改,不过在发现调用服务端的注册中心地址端口要与它一致
registry-server - 启动类
packagecom.zwc;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importorg.springframework.cloud.netflix.eureka.server.EnableEurekaServer;@SpringBootApplication@EnableEurekaServerpublicclassSpringcloudEurekaRegistryServiceApplication{publicstaticvoidmain(String[] args) { SpringApplication.run(SpringcloudEurekaRegistryServiceApplication.class, args); } }
在启动类中添加 @EnableEurekaServer 注解表示此工程是注册中心
registry-server - 启动项目
1. 项目启动成功后访问 http://localhost:8761/ 即可看到 eureka-server 主页面
Provider(提供者)
Provider - POM 文件
<?xml version="1.0"encoding="UTF-8"?>4.0.0<!-- 继承父 -->com.zwcspringcloud-eureka-providerfirst-service1.0<!-- 三坐标 -->com.zwcspringcloud-eureka-providerfirst-service-core1.0<!-- 工程名称描述 -->springcloud-eureka-providerfirst-service-core提供者一号服务工程 - 核心<!-- 打包方式 -->jar<!-- 在 properties下声明相应的版本信息,然后在dependency下引用的时候用 ${}就可以引入该版本jar包了 --><!-- 加入依赖 --><!-- commons工程 依赖 -->com.zwcspringcloud-eureka-commons1.0<!-- api工程 依赖 -->com.zwcspringcloud-eureka-providerfirst-service-api1.0<!-- 提供者消费者 -->org.springframework.cloudspring-cloud-starter-netflix-eureka-client<!-- 插件依赖 -->org.springframework.bootspring-boot-maven-plugin
主要是加入 spring-cloud-starter-netflix-eureka-client 依赖
Provider - application.yml 配置文件
# 端口server: port:8090# 应用名称spring: application: name:say-helloeureka: instance:# 使用 ip 代替实例名 prefer-ip-address:true# 实例的主机名 hostname:${spring.cloud.client.ip-address}# 实例的 ID 规则 instance-id:${spring.cloud.client.ip-address}:${spring.application.name}:${server.port} client: serviceUrl:# 注册中心地址 defaultZone:http://${eureka.instance.hostname}:8761/eureka/
注意此处配置注册中心地址的端口为 8761 也就是上面注册中心工程配置的端口
有两个消费者工程,只有此处的端口不一致,此处端口为 8090,另一个端口为 8091。就不再赘述
两个消费者工程作用是为了达到负载均衡的效果
spring.application.name:应用名称,被消费者调用时需要用到
Provider - controller 前端控制器
packagecom.zwc.providerfirst.controller;importorg.springframework.beans.factory.annotation.Value;importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.bind.annotation.RestController;/**
* @ClassName SayHelloController
* @Desc TODO Say Hello
* @Date 2019/5/15 15:28
* @Version 1.0
*/@RestControllerpublic class SayHelloController {/*
* @ClassName SayHelloController
* @Desc TODO 读取配置文件中的端口
* @Date 2019/5/15 15:49
* @Version 1.0
*/@Value("${server.port}")privateStringport;/*
* @ClassName SayHelloController
* @Desc TODO Say Hello
* @Date 2019/5/15 15:30
* @Version 1.0
*/@RequestMapping("/hello") public String hello(){return"HelloSpringCloud!!!port:" +port; } }
提供一个服务:输出 Hello 和端口
Provider - 启动类
packagecom.zwc;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importorg.springframework.cloud.netflix.eureka.EnableEurekaClient;@SpringBootApplication@EnableEurekaClientpublicclassSpringcloudEurekaProviderfirstServiceCoreApplication{publicstaticvoidmain(String[] args) { SpringApplication.run(SpringcloudEurekaProviderfirstServiceCoreApplication.class, args); } }
在启动类中添加 @EnableEurekaClient 注解表示此工程可以提供服务或调用服务
Provider - 启动项目
1. 项目启动成功后访问 http://localhost:8090/hello 看到输出内容 'Hello Spring Cloud!!!port:8090'
2. 刷新 http://localhost:8761/(注册中心)可以看到服务已经被注册进来了
3. 同理,还有一个提供者工程只是端口不一致,也启动起来
4. 项目启动成功后访问 http://localhost:8091/hello 看到输出内容 'Hello Spring Cloud!!!port:8091'
5. 再次刷新 http://localhost:8761/(注册中心)可以看到相同的服务有两个提供者
Consumer(消费者)
Consumer - POM 文件
<?xml version="1.0"encoding="UTF-8"?>4.0.0<!-- 继承父 -->com.zwcspringcloud-eureka-consumer-service1.0<!-- 三坐标 -->com.zwcspringcloud-eureka-consumer-service-core1.0<!-- 工程名称描述 -->springcloud-eureka-consumer-service-core消费者服务工程 - 核心<!-- 打包方式 -->jar<!-- 在 properties下声明相应的版本信息,然后在dependency下引用的时候用 ${}就可以引入该版本jar包了 --><!-- 加入依赖 --><!-- commons工程 依赖 -->com.zwcspringcloud-eureka-commons1.0<!-- api工程 依赖 -->com.zwcspringcloud-eureka-consumer-service-api1.0<!-- 提供者消费者 -->org.springframework.cloudspring-cloud-starter-netflix-eureka-client<!-- feign -->org.springframework.cloudspring-cloud-starter-openfeign<!-- 插件依赖 -->org.springframework.bootspring-boot-maven-plugin
与提供者一致,需要加入 spring-cloud-starter-netflix-eureka-client 依赖
还需要加入 Feign 的起步依赖 spring-cloud-starter-openfeign
Consumer - application.yml 配置文件
# 端口server: port:8080# 应用名称spring: application: name:service-feigneureka: instance:# 使用 ip 代替实例名 prefer-ip-address:true# 实例的主机名 hostname:${spring.cloud.client.ip-address}# 实例的 ID 规则 instance-id:${spring.cloud.client.ip-address}:${spring.application.name}:${server.port} client: serviceUrl:# 注册中心地址 defaultZone:http://${eureka.instance.hostname}:8761/eureka/
注意此处配置注册中心地址的端口为 8761 也就是上面注册中心工程配置的端口
spring.application.name:应用名称,被消费者调用时需要用到,它在消费的同时也可以被消费
Consumer - 服务调用
packagecom.zwc.consumer.api.feign;importorg.springframework.cloud.openfeign.FeignClient;importorg.springframework.web.bind.annotation.RequestMapping;/**
* @ClassName FeignApi
* @Desc TODO 使用 Feign 调用 Api - 接口
* @Date 2019/5/15 16:11
* @Version 1.0
*/@FeignClient("say-hello")public interface FeignApi {/*
* @ClassName FeignApi
* @Desc TODO 通过 say-hello 服务名调用 /hello 方法
* @Date 2019/5/15 16:17
* @Version 1.0
*/@RequestMapping("/hello") String hello(); }
通过 @FeignClient("say-hello") 注解来指定调用哪个服务
say-hello 就是提供者的 spring.application.name:应用名称
String hello();:可以发现,此方法就是提供者 SayHelloController 中的方法,只不过这里要定义成接口
注意要与提供者具有相同返回值,相同方法名以及相同参数
Consumer - controller 前端控制器
packagecom.zwc.consumer.controller;importcom.zwc.consumer.api.feign.FeignApi;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.bind.annotation.RestController;importjavax.annotation.Resource;/**
* @ClassName FeignController
* @Desc TODO 使用 Feign 调用 Api - 前端控制器
* @Date 2019/5/15 16:18
* @Version 1.0
*/@RestControllerpublic class FeignController { @Autowired(required= false) private FeignApi feignApi;/*
* @ClassName FeignController
* @Desc TODO 调用 Say Hello 方法
* @Date 2019/5/15 16:20
* @Version 1.0
*/@RequestMapping("/feign") public String feign(){returnfeignApi.hello(); } }
使用 @Autowired 注解装配 Bean,通过此 Bean 中的方法调用服务
此类对外暴露接口,调用的实则是提供者的服务
Consumer - 启动类
packagecom.zwc;importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importorg.springframework.cloud.netflix.eureka.EnableEurekaClient;importorg.springframework.cloud.openfeign.EnableFeignClients;@SpringBootApplication@EnableEurekaClient@EnableFeignClientspublicclassSpringcloudEurekaConsumerServiceCoreApplication{publicstaticvoidmain(String[] args) { SpringApplication.run(SpringcloudEurekaConsumerServiceCoreApplication.class, args); } }
添加 @EnableEurekaClient 注解表示此工程可以提供服务或调用服务
添加 @EnableFeignClients 注解表示开启 Feign 功能进行远程调用
Consumer - 启动项目
项目启动成功后多次访问 http://localhost:8080/feign
2. 可以发现轮流输出 'Hello Spring Cloud!!!port:8090' 和 'Hello Spring Cloud!!!port:8091'
3. 此时已经达到了负载均衡的效果
4. 再次刷新 http://localhost:8761/(注册中心)可以看到此时多了一个消费者
把多工程项目使用 IntelliJ IDEA 打开
1.把项目从 GitHub 中下载到你的本地
2.打开 IntelliJ IDEA
3.点击 File -> Open
4.打开你下载到本地的项目目录
springcloud-eureka -> springcloud-eureka-service(选择打开此工程)
打开 service 工程后
再次点击 File -> Project Structrue
选择 Modules,点击 '+' 符号
点击 Import Module
还是打开你下载到本地的项目目录
springcloud-eureka -> springcloud-eureka-commons -> pom.xml
点击 OK
点击 Next,Finish
点击 Apply,OK
竟然都看到最后了,给小编点个关注吧,小编还会持续更新的,只收藏不点关注的都是在耍流氓!
网友评论