[菜鸟SpringCloud实战入门]第一章：构建多模块的Maven项目+创建注册中心Eureka子模块

蛮三刀酱

发布于 2019-03-26 11:56:48

2.5K0

发布于 2019-03-26 11:56:48

文章被收录于专栏：蛮三刀的后端开发专栏蛮三刀的后端开发专栏

前言

欢迎来到菜鸟SpringCloud入门实战系列(SpringCloudForNoob)，该系列通过层层递进的实战视角，来一步步学习和理解SpringCloud。

本系列适合有一定Java以及SpringBoot基础的同学阅读。

每篇文章末尾都附有本文对应的Github源代码，方便同学调试。

Github仓库地址：

https://github.com/qqxx6661/springcloud_for_noob

菜鸟SpringCloud入门实战系列

你还可以通过以下两种途径查看菜鸟SpringCloud入门实战系列：

关注我的公众号：Rude3Knife 点击公众号下方：技术推文——SpringCloud
菜鸟SpringCloud实战专栏(CSDN)

实战版本

SpringBoot：2.0.3.RELEASE
SpringCloud：Finchley.RELEASE

-----正文开始-----

构建多模块的Maven项目 + 创建注册中心Eureka子模块

构建多模块的Maven项目

由于SpringCloud中有许多组件，每个组件都需要单独进行开发和维护，为了便于统一的版本维护和管理，我们经常会用到Maven的多模块模式。

结构如下：

创建主工程

首先创建一个Maven项目作为主工程，类型无所谓，这里建议使用maven-archetype-quickstart骨架，创建过程如下：

File–>New–>Project –>Maven–>Create from archetype–>maven-archetype-quickstart-Next –>GroupId={你的GroupId}–>AritifactId={你的ArtifactId} –>Next–>Next–>Finish–>New Whindow

创建子模块

在new-module里新建模块：

一路下一步即可：

在这里我们新建子模块名为eureka，用来放之后要用的eureka模块，新建好后，子模块的目录如下：

删除主工程多于目录

由于并不需要在主工程进行任何代码开发，所以删除其src目录。

可以看到现在我们的目录结构：

编辑主工程pom.xml

主工程的pom.xml里做的事：

配置Springboot和SpringCloud基础组件
配置子模块：可以看出现在有一个子模块`eureka``，以后有新的子模块被创建后，也需要到这里添加上。

<?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>com.pricemonitor</groupId>
  <artifactId>springcloud</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>pom</packaging>
  <name>springcloud</name>

  <!--子模块-->
  <modules>
    <module>eureka</module>
  </modules>

  <!--父级：Spring Boot-->
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.3.RELEASE</version>
  </parent>

  <!--参数-->
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
  </properties>

  <!--Spring Cloud 版本序列配置-->
  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-dependencies</artifactId>
        <version>Finchley.RELEASE</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <dependencies>
    <!--Spring Boot 执行器组件-->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <!--Spring Cloud 基础-->
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter</artifactId>
    </dependency>
    <!--Spring Cloud 服务注册组件-->
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <!--此处的依赖是SpringBoot2.0以后专用的，如果您使用的SpringBoot版本低于2.0请使用spring-cloud-starter-eureka-server-->
      <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
    </dependency>
    <!--Spring Boot Web组件-->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!--Spring Boot 测试组件-->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
    </dependency>
  </dependencies>

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

</project>

创建注册中心Eureka子模块

Eureka介绍

服务中心又称注册中心，管理各种服务功能包括服务的注册、发现、熔断、负载、降级等，比如dubbo admin后台的各种功能。
Spring Cloud 封装了 Netflix 公司开发的 Eureka 模块来实现服务注册和发现。Eureka 采用了 C-S 的设计架构。Eureka Server 作为服务注册功能的服务器，它是服务注册中心。而系统中的其他微服务，使用 Eureka 的客户端连接到 Eureka Server，并维持心跳连接。这样系统的维护人员就可以通过 Eureka Server 来监控系统中各个微服务是否正常运行。Spring Cloud 的一些其他模块（比如Zuul）就可以通过 Eureka Server 来发现系统中的其他微服务，并执行相关的逻辑。
Eureka由两个组件组成：Eureka服务器和Eureka客户端。Eureka服务器用作服务注册服务器。Eureka客户端是一个java客户端，用来简化与服务器的交互、作为轮询负载均衡器，并提供服务的故障切换支持。Netflix在其生产环境中使用的是另外的客户端，它提供基于流量、资源利用率以及出错状态的加权负载均衡。

上图简要描述了Eureka的基本架构，由3个角色组成：

1、Eureka Server

提供服务注册和发现

2、Service Provider

服务提供方
将自身服务注册到Eureka，从而使服务消费方能够找到

3、Service Consumer

服务消费方
从Eureka获取注册服务列表，从而能够消费服务

编辑子模块Eureka的pom.xml

接下来我们在子模块Eureka中创建一个SpringCloud的注册中心Eureka

代码重点：

继承了父pom.xml
可以看到这里并没有引入任何新的依赖，那如何引入eureka组件依赖呢，回到上面的主pom.xml，你会发现我在其中引入了spring-cloud-starter-netflix-eureka-server，这是因为在之后的大部分模块中，我们都会用到Eureka-server，所以将其放在主pom中供其他子模块共享使用
子模块是可以打包jar运行的：<packaging>jar</packaging>

<?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>

    <artifactId>eureka</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>eureka</name>
    <packaging>jar</packaging>
    <description>Demo project for Spring Boot</description>

    <!--父工程的依赖-->
    <parent>
        <groupId>com.pricemonitor</groupId>
        <artifactId>springcloud</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>


    <dependencies>

    </dependencies>

</project>

添加启动代码中添加@EnableEurekaServer注解

EurekaApplication.java

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

@SpringBootApplication
@EnableEurekaServer
public class EurekaApplication {

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

如果你发现@EnableEurekaServer无法引入，请检查你的SpringCloud版本与SpringBoot版本是否兼容：

springboot无法引入@enableeurekaserver以及Spring Cloud与Spring Boot版本匹配关系：

https://blog.csdn.net/zhang53141/article/details/83091032

配置文件

默认生成的配置文件是application.properties，也可以写成application.yml格式，配置如下：

# 端口号
server:
  port: 8761
# 服务注册相关配置
eureka:
  # 服务实例主机名
  instance:
    hostname: localhost
  # 服务提供者配置
  client:
    # 不进行注册（当服务注册中心是单点而非高可用时的配置方式）
    registerWithEureka: false
    # 不获取注册信息（当服务注册中心是单点而非高可用时的配置方式）
    fetchRegistry: false
    # 服务注册中心地址
    serviceUrl:
      defaultZone: http://${eureka.instance.hostname}:${server.port}/eureka/

注意：