Spring Boot 快速搭建微服务框架详细教程

前言：

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

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

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

Spring Boot的主要优点：

为所有Spring开发者更快的入门
开箱即用，提供各种默认配置来简化项目配置
内嵌式容器简化Web项目
没有冗余代码生成和XML配置的要求

技术栈：

Java 8
Maven
Spring-boot
Mybatis
Redis
Lombok
Swagger2
Jenkins
SonarQuber

1、使用Maven构建项目

1.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以上的版本

1.2 导入Spring-boot 相关依赖

　　项目初始化时，相关依赖如下：

spring-boot-starters：核心模块，包括自动配置支持、日志和YAML
spring-boot-starter-test：测试模块，包括JUnit、Hamcrest、Mockito
spring-boot-devtools：用于设置热部署

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

　　这里我们需要引入Web模块，需要添加：

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

1.3 启动项目

　　添加首页控制层：

@RestController
public class IndexController {

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

　　运行DemoApplication中的main方法，启动服务：

　　　　服务启动后，访问 http://localhost:8080/index ，可以看到页面输出Hello world！。

2、整合Mybatis

2.1 项目依赖

引入连接mysql的必要依赖mysql-connector-java
引入整合MyBatis的核心依赖mybatis-spring-boot-starter
引入tk.mybatis 依赖，实现对实体类的增删改查的代码
引入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

2.2 项目配置

　修改resources 下的application.properties文件：

spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.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
 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();
 }
}

4.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";
 }
}

完成上述代码添加上，启动Spring Boot程序，访问：http://localhost:8080/swagger-ui.html
。

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

4、接入Jenkins&SonarQube

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

1、修改项目打包类型：

com.Jaycekon
 demo
 0.0.1-SNAPSHOT
 war

2、修改Application.java 文件：

@SpringBootApplication
public 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);
 }
}

在我的上一篇博客，哆啦A梦的传送门，已经讲解了一些基本配置方法，这里为大家讲解一下，接入SonarQube 进行代码质量检测的配置（需要本地安装SonarQube服务）。

首先需要在metaData 中，加入SonarQube 的项目名（新建的命名）：

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

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

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

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

　源码地址：https://github.com/jaycekon/SpringBootDemo

总结：

　　本篇文章为大家带来了Spring-boot 的架构搭建，主要使用到了目前较为流行的技术。希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对考高分网网站的支持！

Spring Boot 快速搭建微服务框架详细教程

Java相关栏目本月热门文章