SpringCloudAlibaba笔记02

介绍

• 学习下SpringCloudAlibaba的使用,笔记主要是阿里云官网的Spring Cloud Alibaba 七天训练营中的内容和例子.
• 本地测试的demo地址在github上

SpringCloudAlibaba 体验-微服务开发入门教学

通过该教程，你将会：

• 使用 spring cloud alibaba 搭建一个最小化的微服务集群。
• 并完成客户端和服务端之间的调用示例。
  案例学习时间预计15分钟左右。

沙盒中代码编译报错，测试代码为本地调试，需要注意端口号等配置问题

准备工作

本节，你将通过 git 命令下载程序代码，并启动 Nacos 服务端

获取客户端程序代码

请使用下面的命令获取客户端程序代码

cloudshell-git-open "https://start.aliyun.com/type=maven-project&language=java&architecture=none&bootVersion=2.3.4.RELEASE&baseDir=client&groupId=com.example&artifactId=client&name=client&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.client&packaging=jar&javaVersion=1.8&dependencies=sca-nacos-discovery,web,cloud-feign&demos=nacosdiscoveryconsumer/client.git" /home/shell/client

获取服务端程序工程

请使用下面的命令获取服务端程序代码

cloudshell-git-open "https://start.aliyun.com/type=maven-project&language=java&architecture=none&bootVersion=2.3.4.RELEASE&baseDir=server&groupId=com.example&artifactId=server&name=server&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.server&packaging=jar&javaVersion=1.8&dependencies=sca-nacos-discovery,web&demos=nacosdiscoveryprovider/server.git" /home/shell/server

启动 Nacos 服务端

通过如下命令启动服务端

sh ~/prepare.sh

完成以上操作后，你将会获得链各个工程的代码，如下：

ls -l /home/shell/
drwxr-xr-x 5 shell shell 4096 Dec 15 14:26 client
drwxr-xr-x 5 shell shell 4096 Dec 15 14:26 server

通过如下命令观察nacos启动日志:

cat /home/shell/nacos/logs/start.out

待出现如下输出时，代表启动完成（如果未完成启动，可以重复执行上一条命令）:

INFO Tomcat started on port(s): 65000 (http) with context path '/nacos'
……
INFO Nacos started successfully in stand alone mode. use embedded storage

修改配置

本节，你讲修改代码的一些基本配置，让程序可以运行。
请认真按照本节的引导操作。在完成修改后，一定要记得保存哦。

修改服务端配置

• 打开 服务端的 application.properties 文件
• 修改 Web 访问端口

将 server.port 的值改为 60000
出于安全性和其他平台限制的考虑，目前外部只能使用6[0-5]000六个端口。

• 修改注册中心地址

将注册中心改为刚才启动的 Nacos 服务端的地址

spring.cloud.nacos.discovery.server-addr=127.0.0.1:65000

修改客户端配置

打开 客户端的 application.properties 文件

• 修改 Web 访问端口

将 server.port 的值改为 61000
要避免和服务端发生端口冲突，而60000已经被分配给了服务端，这里就用61000。

• 修改注册中心地址

将注册中心改为刚才启动的 Nacos 服务端的地址

spring.cloud.nacos.discovery.server-addr=127.0.0.1:65000

• 修改OpenFeign方式调用的服务名称

打开文件 EchoService
将其中的 nacos-discovery-provider-sample 替换为 server

• 修改RestTemplate方式调用的服务名称

打开文件 RestTemplateController
将其中的 nacos-discovery-provider-sample 替换为 server

对EchoService 和 RestTemplateController 修改，会在下一节做详细说明

功能&代码说明

本节主要是对内容的说明和介绍，没有对项目的操作内容；

服务端

在本案例中，服务端只提供一个服务，即： EchoServiceController
该服务只有一个方法，接收字符串型的消息，并返回 "[ECHO] : " + message 内容。这里的逻辑实现，并不具有太多的业务意义，只是对服务端逻辑执行的演示。

可以看到， 在 EchoServiceController 上增加了 @RestController 注解。熟悉 spring 的同学应该知道，这代表了被标注类是一个 Rest 风格的 http 接口。
在 echo 方法上，由于标注了 @GetMapping("/echo/{message}") 注解，所以可以通过 http://ip:port/echo/{message} 来直接访问。
其中的 {message} 可以被替换为你需要的任何消息。
后面章节会对具体的访问做演示。

客户端

客户端程序自身并没有业务逻辑的实现，而是通过调用服务端的业务服务来实现业务，所以在本案例中需要重点关注如何使用客户端调用服务端。

在本案例中，客户端通过 nacos 的注册中心功能实现对服务端的发现。所以你会发现在客户端里并没有配置任何 服务端的地址 信息。
参考：客户端的 application.properties

本案例中的客户端通过两种方式调用服务端，所谓的”两种方式“具体来说是两种消费客户端的编程模型：

使用 OpenFeign 方式

参考：OpenFeignController，EchoService

• OpenFeignController 作为web调用的入口，用于接收前端的调用请求，并向内调用业务与服务实现功能。

• EchoService 是应用中对服务端所提供服务的引用接口。
  在这个接口上，标注了 @FeignClient 注解，以表示这个接口的服务是哪个服务端提供的。
  @FeignClient 注解的值代表了服务端应用的 服务端应用名，以便于在多个不同的服务提供者之间确定具体的服务。

使用 RestTemplate方式

参考：RestTemplateController
RestTemplate 是 spring 对所有 restful 服务调用的封装。
在 RestTemplateController 中，通过 restTemplate.getForObject 来调用服务端的 EchoServiceController.echo 方法。
通过前文的操作，将 getForObject 的第一个参数改为 "http://server/echo/" + message。这看起来像是一个标准的url地址，但是其中的server并不是域名，而是服务提供者的应用名。

前文说到，客户端并不关注服务端的地址，但是需要关注服务端应用名，这两个概念是有区别的：

• 服务端应用名：是一个逻辑概念，代表可以被独立部署的一套应用程序；
• 服务端的地址：是物理概念，是实际部署以后具体的物理地址，例如IP；

每个服务端应用名可以部署多份实例，每个实例都有自己的服务端的地址。

编译打包

本节，你需要使用 maven 的命令将程序代码编译打包为可执行的 jar 包

编译服务端程序

• 进入服务端目录

cd /home/shell/server

• 执行编译命令

mvn clean package -Dmaven.test.skip

tips: 第一次编译，因为本地 maven 仓库缺少相关的类库，编译可能会花 1-2 分钟的时间

编译客户端程序

• 进入服务端目录

cd /home/shell/client

• 执行编译命令

mvn clean package -Dmaven.test.skip

tips: 如果修改代码以后，需要重新执行编译命令

运行程序

本节，你将使用 java 命令来运行上一步打包完成的 jar 文件

启动服务端

1、开启新 console 窗口：
2、在新窗口中执行命令

java -jar /home/shell/server/target/server-0.0.1-SNAPSHOT.jar

启动客户端

1、开启新 console 窗口：
2、在新窗口中执行命令

java -jar /home/shell/client/target/client-0.0.1-SNAPSHOT.jar

访问应用程序

本节，你将通过浏览器访问在上一节运行起来的服务端程序和客户端程序

直接访问服务端程序

由于服务端使用http协议提供服务，所以可以直接使用浏览器访问，我们先来验证服务端的功能。
通过链接 访问地址 http://{ip}:60000/echo/theonefx
看到下面的内容代表服务端可以正常工作

hello Nacos Discovery theonefx

访问客户端程序

由于客户端提供2种调用方式，这里也分别请求者两个入口，参照访问服务端的方式，选择 61000 端口访问客户端。

• Openfeign
  使用链接访问地址 http://{ip}:62000/echo-feign/{message} 其中 {message} 可以替换为你需要的信息，你可以看到下面的效果：

http://127.0.0.1:62000/echo-feign/feignclient

hello Nacos Discovery feignclient

• RestTemplate
  使用链接访问地址 http://{ip}:62000/echo-rest/{message} 其中 {message} 可以替换为你需要的信息，你可以看到下面的效果：

http://127.0.0.1:62000/echo-rest/restclient

hello Nacos Discovery restclient