环境说明
JDK:1.8
maven: 3.8.1
Spring Boot: 2.3.2.RELEASE
Spring Cloud: Hoxton.SR8
开发工具: IntelliJ IDEA 2021.1 x64
系统: Windows 10
Spring Boot、 Cloud、Cloud Alibaba三者对应的关系:
Spring Cloud 基于 Spring Boot
Spring Cloud Alibaba 是 Spring Cloud 的子项目
前置环境
安装JDK
查阅对应资料
安装Maven
查阅对应资料
搭建微服务
比如我们预搭建一个物联网平台的项目。
规划有父工程iot-plat,包含两个子工程iot-common和iot-usercenter。
iot-plat:父工程,包含iot-common以及iot-usercenter两个子工程,进行依赖的统一管理。
iot-common:子工程,公共模块,包含实体类,公共依赖,工具类等。
iot-usercenter:子工程,提供用户中心服务。
创建父工程iot-plat
创建maven模块
创建一个iot-plat的父工程
步骤如下:
1)New Project
2)Maven
3)填写工程信息
配置pom.xml文件
Iot-parent为父工程,用父工程的pom文件做依赖的版本管理用。需要引入springcloud以及springboot的依赖。
初始pom文件如下:
- <properties>标签
添加springcloud以及springboot的版本号,进行统一维护,内容如下:<
!-- 版本号统一管理 -->
<properties>
<!-- 指定SpringBoot版本 -->
<spring-boot.version>2.3.2.RELEASE</spring-boot.version>
<!-- 指定SpringCloud版本 -->
<spring-cloud.version>Hoxton.SR8</spring-cloud.version>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
- <dependencyManagement>标签
使用dependencyManagement 元素来提供了一种管理依赖版本号的方式。通常会在一个组织或者项目的最顶层的父POM 中看到dependencyManagement 元素。能让所有在子项目中引用一个依赖而不用显式的列出版本号。Maven 会沿着父子层次向上走,直到找到一个拥有dependencyManagement 元素的项目,然后它就会使用这个dependencyManagement 元素中指定的版本号。
dependencyManagement: 对所依赖jar包进行版本管理的管理器,声明依赖,并不实现引入。
(1)不在子项目中声明依赖,是不会从父项目中继承下来的
(2)只有在子项目中写了该依赖项,并且没有指定具体版本,才会从父项目中继承该项
(3)子项目中指定了版本号,那么会使用子项目中指定的jar版本。
- <dependencies>标签
添加<dependencies>标签,作为<dependency>标签的容器
- <dependency>标签
添加<dependency>标签,引入具体的依赖
内容如下:
<!-- 版本统一管理 -->
<dependencyManagement>
<dependencies>
<!-- 声明依赖 springBoot -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${spring-boot.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- 声明依赖 springCloud -->
<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>
完整的pom.xml文件内容如下:
<?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.iot</groupId>
<artifactId>iot-plat</artifactId>
<packaging>pom</packaging>
<version>1.0-SNAPSHOT</version>
<!-- 版本号统一管理 -->
<properties>
<!-- 指定SpringBoot版本 -->
<spring-boot.version>2.3.2.RELEASE</spring-boot.version>
<!-- 指定SpringCloud版本 -->
<spring-cloud.version>Hoxton.SR8</spring-cloud.version>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<!-- 版本统一管理 -->
<dependencyManagement>
<dependencies>
<!-- 声明依赖 springBoot -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${spring-boot.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- 声明依赖 springCloud -->
<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>
</project>
- <dependency>标签
删除src目录,父工程不写逻辑。
创建基础子工程iot-common
创建iot-common子模块作为一个微服务,拟为其他模块提供基础
创建Maven模块
具体步骤如下:
- 新建Modue
选中父工程,右键【New】-【Module】
- 选择Maven
【Maven】-【Next】
- 填写信息
填写信息 - 【Finish】
配置pom.xml文件
初始pom文件如下:
子工程引入springboot依赖
<dependencies>
<!-- springBoot -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
完整的pom.xml文件内容如下:
<?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">
<parent>
<artifactId>iot-plat</artifactId>
<groupId>com.iot</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>iot-common</artifactId>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<dependencies>
<!-- springBoot -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
</project>
配置application.yml文件
- 添加配置文件
右键【resources】目录,添加并配置application.yml文件,配置服务信息。
- 添加配置信息
服务端口号为:9090
服务名称为:iot-common
application.yml内容如下:
server:
port: 9090
spring:
application:
name: iot-common
创建Appication启动类
-
创建common包
右键【java】目录创建com.iot.common包从来存放common的内容
- 创建启动类
右键刚刚创建的【com.iot.common】目录,创建一个名为CommonApplication的启动类
- 添加注解
@SpringBootApplication 注解,注明为SpringBoot的启动类。
CommonApplication类代码如下:
package com.iot.common;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class CommonApplication {
public static void main(String[] args) {
SpringApplication.run(CommonApplication.class, args);
}
}
创建Controller类
- 创建controler包
右键【com.iot.common】目录,创建com.iot.common.controller包用来存放Controller类
- 创建Controler类
右键【com.iot.common.controller】目录,创建一个名为CommonController的Controller类,用于浏览器访问。
- 添加注解
@RestController
注明此类为一个Controller类
@RequestMapping("/common")
注明类的访问路径为http://....:port/common/
@RequestMapping("/index")
创建一个login方法,注明方法的访问路径为http://....:port/common/index
代码如下:
package com.iot.common.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/common")
public class CommonController {
private String name = "zhangsan";
private String age = "18";
//登录
@RequestMapping("/index")
public String login(){
String msg =" I am " + name + ",I am" + age + "years old!";
System.out.println(msg);
return msg;
}
}
启动服务并访问
启动类右键【Run】,启动服务
输入服务访问地址:http://localhost:9090/commonr/index
创建用户中心子工程iot-usercenter
同样的方法,创建iot-usercenter的maven工程,拟用来提供用户服务。
工程目录如下:
Maven模块
pom.xml文件
<?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">
<parent>
<artifactId>iot-plat</artifactId>
<groupId>com.iot</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>iot-usercenter</artifactId>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<dependencies>
<!-- springBoot -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
</project>
application.yml文件
server:
port: 9091
spring:
application:
name: iot-usercenter
java文件
- 启动类UserCenterAppication.java
package com.iot.usercenter;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class UserCenterApplication {
public static void main(String[] args){
SpringApplication.run(UserCenterApplication.class,args);
}
}
- Controler类UserControler.java
package com.iot.usercenter.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/user")
public class UserController {
private String name = "lisi";
private String age = "19";
//登录
@RequestMapping("/login")
public String login(){
String msg =" I am " + name + " , I am " + age + " years old!";
System.out.println(msg);
return msg;
}
}
启动服务并访问
启动服务,输入服务访问地址:http://localhost:9001/user/login