spring boot如何在最短时间里快速搭建微服务框架,详细教程贡上(spring boot)

网友投稿 805 2022-05-30

前言:

Spring Boot是为了简化Spring应用的创建、运行、调试、部署等而出现的,使用它可以做到专注于Spring应用的开发,而无需过多关注XML的配置。

简单来说,它提供了一堆依赖打包,并已经按照使用习惯解决了依赖问题—习惯大于约定。

Spring Boot默认使用tomcat作为服务器,使用logback提供日志记录。

Spring Boot的主要优点:

1.为所有Spring开发者更快的入门

2.开箱即用,提供各种默认配置来简化项目配置

3.内嵌式容器简化Web项目

4.没有冗余代码生成和XML配置的要求

技术栈:

1.Java 8

2.Maven

3.Spring-boot

4.Mybatis

5.Redis

6.Lombok

7.Swagger2

8.Jenkins

9.SonarQuber

一、使用Maven构建项目

1、通过 SPRING INITIALIZR 工具生产基础项目

通过访问:http://start.spring.io/ 快速创建Spring-boot 的服务框架。

初始化相应信息后,下载压缩包。解压完成后,用IDEA打开项目,项目的目录结构:

总体流程:

访问:http://start.spring.io/

选择构建工具Maven Project、Spring Boot版本1.3.2以及一些工程基本信息

点击Generate Project下载项目压缩包

解压项目包,并用IDE以Maven项目导入,以IntelliJ IDEA 14为例:

菜单中选择File–>New–>Project from Existing Sources…

选择解压后的项目文件夹,点击OK

点击Import project from external model并选择Maven,点击Next到底为止。

若你的环境有多个版本的JDK,注意到选择Java SDK的时候请选择Java 7以上的版本

2、导入Spring-boot 相关依赖

项目初始化时,相关依赖如下:

1.spring-boot-starters:核心模块,包括自动配置支持、日志和YAML

2.spring-boot-starter-test:测试模块,包括JUnit、Hamcrest、Mockito

3.spring-boot-devtools:用于设置热部署

org.springframework.boot spring-boot-starter org.springframework.boot spring-boot-starter-test test org.springframework.boot spring-boot-devtools true

1

2

3

4

5

6

7

8

9

10

Spring Boot如何在最短时间里快速搭建微服务框架,详细教程贡上(spring boot)

11

12

13

14

15

这里我们需要引入Web模块,需要添加:

org.springframework.boot spring-boot-starter-web

1

2

3

4

3、启动项目

添加首页控制层:

public String index() { return "hello world!"; } }

1

2

3

运行DemoApplication中的main方法,启动服务:

服务启动后, 访问

http://localhost:8080/index ,可以看到页面输出Hello world!。

二、整合Mybatis

1、项目依赖

1.引入连接mysql的必要依赖mysql-connector-java

2.引入整合MyBatis的核心依赖

mybatis-spring-boot-starter

3.引入tk.mybatis 依赖,实现对实体类的增删改查的代码

4.引入pagerhelper 依赖,实现分页功能

org.mybatis.spring.boot mybatis-spring-boot-starter 1.3.0 mysql mysql-connector-java 5.1.43 tk.mybatis mapper-spring-boot-starter 1.1.3 com.github.pagehelper pagehelper-spring-boot-starter 1.1.2

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

2、项目配置

修改resources 下的application.properties文件:

spring.datasource.url=jdbc:mysql://localhost:3306/testspring.datasource.username=root spring.datasource.password=root spring.datasource.driver-class-name=com.mysql.jdbc.Driver#实体类扫描包mybatis.type-aliases-package=com.jaycekon.demo.model#Mapper.xml文件扫描目录mybatis.mapper-locations=classpath:mapper/*.xml#驼峰命名mybatis.configuration.mapUnderscoreToCamelCase=true#tkmapper 工具类mapper.mappers=com.Jaycekon.demo.util.MyMapper mapper.not-empty=falsemapper.identity=MYSQL pagehelper.helperDialect=mysql pagehelper.reas`onable=truepagehelper.supportMethodsArguments=truepagehelper.params=count=countSql

1

2

3

4

5

6

3、单元测试

创建实体类,我们引入Lombok相关依赖,用于避免数据Get Set方法的重复创建:

org.projectlombok lombok 1.16.18 provided

1

2

3

4

5

6

实体类最终的代码如下:

@Data@NoArgsConstructor@AllArgsConstructor@Accessors(chain = true)public class User { private int id; private String username; private String idCard; private String phone; private String password; }

1

2

可以看出,在添加了Lombok之后,我们的Java实体类代码简洁了很多。

接下来,我们需要创建UserMapper数据库处理类。由于MyMapper已经帮我们实现了基本的CRUD操作,因此我们这里并不需要再重写操作,我可以先一个根据用户名查找的方法:

@Mapperpublic interface UserMapper extends MyMapper { @Select("select * from user where username=#{username}") User selectByName(String username); }

1

2

MyMapper 类位于util目录下:

public interface MyMapper extends Mapper, MySqlMapper { }

1

2

这里需要注意,MyMapper 与我们的实体类Mapper 不能放在同一个目录。

测试类:

@RunWith(SpringRunner.class)@SpringBootTest@MapperScan("com.Jaycekon.demo.mapper")public class UserMapperTest { @Autowired private UserMapper mapper; @Test public void testInset() { User user = new User(1, "Jaycekon","1234","1234","123"); int i = mapper.insert(user); Assert.assertNotEquals(0, i); } @Test public void testSelect(){ User user = mapper.selectByName("Jaycekon"); Assert.assertNotEquals(null,user); } }

1

2

3

4

5

6

7

8

9

10

11

三、整合Redis

1、相关依赖

Spring Boot提供的数据访问框架Spring Data Redis基于Jedis。可以通过引入 spring-boot-starter-redis 来配置依赖关系。

org.springframework.boot spring-boot-starter-redis

1

2

3

2、Redis 配置

1、Spring-boot连接单机版Redis的配置如下:

#REDIS (RedisProperties)# Redis数据库索引(默认为0)spring.redis.database=0# Redis服务器地址spring.redis.host=localhost# Redis服务器连接端口spring.redis.port=6379# Redis服务器连接密码(默认为空)spring.redis.password=# 连接池最大连接数(使用负值表示没有限制)spring.redis.pool.max-active=8# 连接池最大阻塞等待时间(使用负值表示没有限制)spring.redis.pool.max-wait=-1# 连接池中的最大空闲连接spring.redis.pool.max-idle=8# 连接池中的最小空闲连接spring.redis.pool.min-idle=0# 连接超时时间(毫秒)spring.redis.timeout=0

2、Spring-boot连接Sentinel哨兵集群配置:

#REDIS (RedisProperties)# Redis数据库索引(默认为0)spring.redis.database=0# Redis服务器地址#spring.redis.host=localhost# Redis服务器连接端口#spring.redis.port=6379# Redis服务器连接密码(默认为空)spring.redis.password=# 连接池最大连接数(使用负值表示没有限制)spring.redis.pool.max-active=8# 连接池最大阻塞等待时间(使用负值表示没有限制)spring.redis.pool.max-wait=-1# 连接池中的最大空闲连接spring.redis.pool.max-idle=8# 连接池中的最小空闲连接spring.redis.pool.min-idle=0# 连接超时时间(毫秒)spring.redis.timeout=0#哨兵监听redis server名称spring.redis.sentinel.master=cn-test-master#哨兵的配置列表spring.redis.sentinel.nodes=localhost:26379,localhost:36379,localhost:46379

3、Redis 操作工具类

1、StringRedisTemplate工具类

StringRedisTemplate 工具类可以解决字符串级别的Redis操作。在写好配置后,可以直接通过Autowried 就可以注入对象。

@RunWith(SpringJUnit4ClassRunner.class)@SpringApplicationConfiguration(Application.class)public class ApplicationTests { @Autowired private StringRedisTemplate stringRedisTemplate; @Test public void test() throws Exception { // 保存字符串 stringRedisTemplate.opsForValue().set("aaa", "111"); Assert.assertEquals("111", stringRedisTemplate.opsForValue().get("aaa")); } }

1

2

3

4

5

6

7

2、RedisTemplate工具类

可以处理大部分的序列化操作,在这里我封装了一个简化Redis工具类,后续可以继续优化。

@Componentpublic class RedisComponent { @Autowired //操作字符串的template,StringRedisTemplate是RedisTemplate的一个子集 private StringRedisTemplate stringRedisTemplate; private Logger logger = LoggerFactory.getLogger(RedisComponent.class); @Autowired // RedisTemplate,可以进行所有的操作 private RedisTemplate redisTemplate; public void set(String key, String value) { ValueOperations ops = this.stringRedisTemplate.opsForValue(); boolean bExistent = this.stringRedisTemplate.hasKey(key); if (bExistent) { logger.info("this key is bExistent!"); } else { ops.set(key, value); } } public String get(String key) { return this.stringRedisTemplate.opsForValue().get(key); } public void del(String key) { this.stringRedisTemplate.delete(key); } public void sentinelSet(String key, Object object) { redisTemplate.opsForValue().set(key, JSON.toJSONString(object)); } public String sentinelGet(String key) { return String.valueOf(redisTemplate.opsForValue().get(key)); } }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

四、整合Swagger2

1、添加Swagger2依赖:

io.springfox springfox-swagger2 2.7.0 io.springfox springfox-swagger-ui 2.7.0

1

2

3

4

5

6

7

8

9

10

2、创建Swagger2配置类:

在Application.java同级创建一个Swagger2的配置类:

@Configuration@EnableSwagger2public class Swagger2 { @Bean public Docket webApi() { return new Docket(DocumentationType.SWAGGER_2) .groupName("DemoAPI接口文档") .apiInfo(apiInfo()) .select() .apis(RequestHandlerSelectors.basePackage("com.Jaycekon.demo.controller")) .paths(PathSelectors.any()).build(); } /** swagger2使用说明: @Api:用在类上,说明该类的作用 @ApiOperation:用在方法上,说明方法的作用 @ApiIgnore:使用该注解忽略这个API @ApiImplicitParams:用在方法上包含一组参数说明 @ApiImplicitParam:用在@ApiImplicitParams注解中,指定一个请求参数的各个方面 paramType:参数放在哪个地方 header-->请求参数的获取:@RequestHeader query-->请求参数的获取:@RequestParam path(用于restful接口)-->请求参数的获取:@PathVariable body(不常用) form(不常用) name:参数名 dataType:参数类型 required:参数是否必须传 value:参数的意思 defaultValue:参数的默认值 @ApiResponses:用于表示一组响应 @ApiResponse:用在@ApiResponses中,一般用于表达一个错误的响应信息 code:数字,例如400 message:信息,例如"请求参数没填好" response:抛出异常的类 @ApiModel:描述一个Model的信息(这种一般用在post创建的时候,使用@RequestBody这样的场景,请求参数无法使用@ApiImplicitParam注解进行描述的时候) @ApiModelProperty:描述一个model的属性 */ private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("Demo使用Swagger2构建RESTful APIs") .description("微信打卡服务") .contact(new Contact("Jaycekon", "http://petstore.swagger.io/v2/swagger.json", "jaycekon@163.com")) .version("1.0") .build(); } }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

3、在需要生成Api的接口添加注解:

@Api(tags = "测试用例")@RestController@RequestMapping(value="/users") // 通过这里配置使下面的映射都在/users下,可去除public class UserController { @ApiOperation(value="获取用户列表", notes="") @RequestMapping(value={""}, method= RequestMethod.GET) public List getUserList() { return new ArrayList<>(); } @ApiOperation(value="创建用户", notes="根据User对象创建用户") @ApiImplicitParam(name = "user", value = "用户详细实体user", required = true, dataType = "User") @RequestMapping(value="", method=RequestMethod.POST) public String postUser(@RequestBody User user) { return "success"; } @ApiOperation(value="获取用户详细信息", notes="根据url的id来获取用户详细信息") @ApiImplicitParam(name = "id", value = "用户ID", required = true, dataType = "Long") @RequestMapping(value="/{id}", method=RequestMethod.GET) public User getUser(@PathVariable Long id) { return new User(); } @ApiOperation(value="更新用户详细信息", notes="根据url的id来指定更新对象,并根据传过来的user信息来更新用户详细信息") @ApiImplicitParams({ @ApiImplicitParam(name = "id", value = "用户ID", required = true, dataType = "Long"), @ApiImplicitParam(name = "user", value = "用户详细实体user", required = true, dataType = "User") }) @RequestMapping(value="/{id}", method=RequestMethod.PUT) public String putUser(@PathVariable Long id, @RequestBody User user) { return "success"; } @ApiOperation(value="删除用户", notes="根据url的id来指定删除对象") @ApiImplicitParam(name = "id", value = "用户ID", required = true, dataType = "Long") @RequestMapping(value="/{id}", method=RequestMethod.DELETE) public String deleteUser(@PathVariable Long id) { return "success"; } }

1

2

3

4

5

6

7

8

完成上述代码添加上,启动Spring Boot程序,访问:

http://localhost:8080/swagger-ui.html

。就能看到前文所展示的RESTful API的页面。我们可以再点开具体的API请求,以POST类型的/users请求为例,可找到上述代码中我们配置的Notes信息以及参数user的描述信息,如下图所示。

Spring-boot:快速搭建微服务框架

四、接入Jenkins&SonarQube

项目框架搭建好后,我们可以通Jenkins 进行项目的自动发版,以及SonarQube 进行代码质量检测。在接入钱,我们需要将项目打包成war包,需要进行以下修改:

1、修改项目打包类型:

com.Jaycekon demo 0.0.1-SNAPSHOT war

1

2

3

4

2、修改Application.java 文件:

@SpringBootApplicationpublic class DemoApplication extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(DemoApplication.class); } public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }

1

2

3

4

5

首先需要在MetaData 中,加入SonarQube 的项目名(新建的命名):

然后在Post Steps 中选择添加 Execute SonarQube Scanner:

在配置好这两项后,Jenkins 在编译文件时,就会执行SonarQube 代码质量检测。

最后,我们可以设置项目在编译完后,执行shell 脚本,进行项目的自动发版:

项目编译完后,会找到项目下的playbook,执行里面的脚本,将我们的项目部署到设定的服务器中。

最后

对于Java后端的朋友来说应该是最全面最完整的面试备战资源库,为了更好地整理每个模块,我也参考了很多网上的优质博文和项目。

力求不漏掉每一个知识点,很多朋友靠着这些内容进行复习,拿到了BATJ等大厂的Offer,也已经帮助了很多的Java学习者,希望也能帮助到你~

领取方式:Java基础、算法、数据库、数据结构、缓存、大数据组件、消息队列、多线程、大数据组件原理、NIO&RPC。

Java Spring Spring Boot 微服务

版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:关于举办第十七届全国大学生 智能汽车竞赛的通知(关于举办第十七届全国大学生数智 化企业经营沙盘大赛)
下一篇:浅谈MatrixOne如何用Go语言设计与实现高性能哈希表(hystrix golang)
相关文章