spring cloud 专题二（spring cloud 入门搭建之微服务搭建和注册）

2022-04-05 23:40:54

一、前言

本文为spring cloud 微服务框架专题的第二篇，主要讲解如何快速搭建微服务以及如何注册。本文理论不多，主要是傻瓜式的环境搭建，适合新手快速入门。

为了更好的懂得原理，大家可以下载《spring cloud 和docker微服务架构实战》pdf得书籍链接: https://pan.baidu.com/s/1LLSqy0QGOhFei-5XJ2HVSA 密码: d2x7

如果这个链接失效了，大家可以联系我的邮箱，我会很快回复并把pdf发送给您，邮箱地址 xinyudai_ifox@163.com

本教程代码地址为 https://github.com/daixiaoyu/springcloud-example-feign，大家可以下载下来运行

代码说明：为了力求真实开发实战，没有将注册中心，微服务，网关三个项目合在一个module中，而是拆分了，所以引入到idea中时请开三个idea分别引入

二、准备环境

maven（将maven配置到环境变量中，便于后期打包）、如果需要源码请安装git、jdk 、*需要运行第一篇专题的注册中心*

由于此微服务的暴露是基于Feign的思想的，如果大家没有这方面的知识可以先查看pdf中关于feign的讲解，或者阅读其他博客，我后面的专题会专门讲解Feign

三、搭建和注册微服务

将源码中的provider模块导入到Idea中，如果没有源码则可可以按照接下来的思路自己搭建，目录结构为下

可以看到provider中有两个模块，分别为cloud-provider 和cloud-provider-api，从命名上大概就可以清晰的看到，api模块只是

微服务需要向调用方提供的api接口，实际开发中，我们会将此模块打包到私服，而调用方可以通过Feign像调用本地方法一样

调用provier的真正实现，入参和返回值全实现了序列化接口并在api中定义

编写api模块，api模块没有任何的技术栈，是单纯的java Bean和接口规范，是为了给客户端约束调用参数和返回值的，我们来

大家可以看到，规范的写法是，一个Rao接口，一个param入参和一个response返回值。接下来我们来看看Rao接口的定义

package com.dai.cloud.Rao;

import com.dai.cloud.param.UserParam;

import com.dai.cloud.response.UserResponse;

import org.springframework.cloud.netflix.feign.FeignClient;

import org.springframework.web.bind.annotation.RequestBody;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RequestMethod;

import org.springframework.web.bind.annotation.RequestParam;

/**

 * @author <a href="mailto:daixinyu@sinoland666.com">代欣雨</a>

 * @description 服务提供者接口

 * @date 2018/1/19 15:54

 * @Version V1.0

 */

@FeignClient("provider-server")  //告诉客户端，这个接口需要到这个服务中去寻找

@RequestMapping(value = "/provider")

public interface ProviderRao {

    @RequestMapping(value = "/user",method = RequestMethod.POST)

        UserResponse getUserByParam(@RequestBody UserParam param);

}

　　大家可以看到，这里和spring mvc 的实现没有什么大的区别，对的，其实就是对外暴露接口而已，提供http服务

接下来我们来看看provider模块（api的具体实现），是一个提供了http接口的服务，我们先看看他的pom

   <dependencyManagement>    spring cloud 的依赖

        <dependencies>

            <dependency>

                <groupId>org.springframework.cloud</groupId>

                <artifactId>spring-cloud-dependencies</artifactId>

                <version>Camden.SR3</version>

                <type>pom</type>

                <scope>import</scope>

            </dependency>

        </dependencies>

    </dependencyManagement>

    <dependencies>

        <dependency>   <spring mvc的依赖>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-web</artifactId>

        </dependency>

        <dependency>   <注册中心的依赖，因为此微服务需要注册到注册中心>

            <groupId>org.springframework.cloud</groupId>

            <artifactId>spring-cloud-starter-eureka</artifactId>

        </dependency>

        <dependency>   <需要实现的api的接口,api>

            <groupId>com.dai.cloud</groupId>

            <artifactId>cloud-provicer-api</artifactId>

            <version>1.0-SNAPSHOT</version>

        </dependency>

    </dependencies>

　　再来看看他的配置文件

spring:

  application:

    name: provider-server    这里必须同api中rao接口中的@FeignClient的value值一样，不然调用方无法从注册中心获取到此服务地址

server:

    port: 8006   服务端口

eureka:

    client:

      service-url:

        defaultZone: http://localhost:9527/eureka/    注册中心地址，此微服务运行起来后会自动注册到地址

    instance:

        prefer-ip-address: true           /将ip配置到注册中心，实际的调用依然是ip ，http

        hostname: com.dai.provider.node1.com   /当前节点的名称

        instance-id: com.dai.provider.node1.com  /当前节点的id   实际开发中，一个微服务会运行多个实例，用于高可用，这两个配置都是用于区分每个实例

feign:       /这个是Feign的配置，大家可以暂时不了解，或者看pdf的书籍

   hystrix:

      enabled:true

接下来我们来看看Rao接口的实现

package com.dai.cloud.controller;

import com.dai.cloud.Rao.ProviderRao;

import com.dai.cloud.param.UserParam;

import com.dai.cloud.response.UserResponse;

import io.swagger.annotations.Api;

import io.swagger.annotations.ApiOperation;

import org.springframework.web.bind.annotation.RequestBody;

import org.springframework.web.bind.annotation.RestController;

/**

 * @author <a href="mailto:daixinyu@sinoland666.com">代欣雨</a>

 * @description 请填类描述

 * @date 2018/1/19 15:51

 * @Version V1.0

 */

@RestController  // spring mvc的注解，将此接口注册，必须是RestController

@Api(tags = "服务提供中心",description ="服务提供中心" )

public class ProviderController  implements ProviderRao {  // 可以看到这里实现了刚才在api中定义的接口，所有的连接地址都继承了，唯一需要注意的是入参的注解要写进来（@RequestBody等）

    @ApiOperation(value = "查询用户")

    @Override

    public UserResponse getUserByParam(@RequestBody UserParam param) {

        UserResponse response = new UserResponse();

        response.setUserId(param.getUserId());

        response.setUserName("代欣雨");

        return response;

    }

}

服务都已经搭建完成了，其实很简单，就是往常的服务器和接口实现，1、只是注册到了注册中心，让其他调用者不用显示的指定ip和端口（注册中心会维护和管理）2、对外提供了api的接口，这里其实和web service的思想差不多
接下来我们运行 Spring boot 的启动类（常规的，前提是注册中心已经运行）

我们就可以看见我们的服务已经注册到了注册中心，服务名，唯一服务id都已经指定，实际上在注册中心还保存了当前服务的ip地址端口号等信息。

下一篇我将编写远程的服务调用方，如果通过服务提供的api包就可以像调本地方法一样调用远程的服务，文章写得比较粗糙，我会不断优化和改进

谢谢大家，如果有哪里不明白的，或者运行不了我的源码项目的，可以给我发送邮件 xinyudai_ifox@163.com

码农公寓

相关文章