SpringBoot2.X最佳实践《一》 之 SpringBoot2.x初体验

Posted 2020-12-28

SpringBoot2.X最佳实践 前言

本系列文章，从零基础接触  SpringBoot2.x新版本，基础入门使用，热部署，到整合各个主流框架Redis4.x，消息队列AciveMQ, RocketMQ等，搜索框架ElasticSearch5.6版本，到web-flux反应式编程，到Actuator监控应用信息，官方最佳实践，最全的SpringBoot2.教程

技术选型和更新须知：

• 采用最新的SpringBoot2.x版本

• JDK1.8

• IDEA或者Eclipse编辑器

• Maven3.x版本

• 其他框架比如分布式缓存Redis，搜索框架ElasticSearch，消息队列RocketMQ和ActiveMQ等，均采用目前最新的版本

• 
  

资料和开发工具准备：

• JDK1.8下载：http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

• Maven3.x下载：http://maven.apache.org/download.cgi

• SpringBoot2.x官方文档: https://spring.io/projects/spring-boot#overview

  
  

SpringBoot是什么？

    学过javaweb的同学就知道，开发一个web应用，从最初开始接触Servlet结合Tomcat, 跑出一个Hello Wolrld程序，是要经历特别多的步骤； 后来就用了框架Struts，再后来是SpringMVC，到了现在的SpringBoot，过一两年又会有其他web框架出现；不知道你们有没经历过框架不断的演进，然后自己开发项目所有的技术也再不断的变化、改造，反正我是都经历过了，哈哈。

    言归正传，什么是SpringBoot呢，就是一个javaweb的开发框架，和SpringMVC类似，对比其他javaweb框架的好处，官方说是简化开发，约定大于配置，  you can "just run"，能迅速的开发web应用，几行代码开发一个http接口。

快速创建SpringBoot2.x应用

      学任何框架，都从hello world开始，这个也不例外，我们先创建一个http接口，返回json数据。

SpringBoot官方提供了一个快速创建应用的工具“Spring Initializr” , 地址：http://start.spring.io

通过这个可以帮我们生成一个项目的基础框架和目录规范，操作如下图的顺序

1、下载后导入到IDEA或者Eclipse里面，springboot默认加入了很多依赖包，所以需要从远端的maven仓库下载下来，初次导入需要下载很多的依赖包，会比较慢，不过也可以更改Maven仓库地址为国内的的仓库地址。

2、官方包目录接口说明

3、Maven依赖文件讲解

核心配置文件在图片上面，底部有很多暂时用不上的配置，比如仓库地址可以去除，下面的pom文件的都可以去除

<repositories>
		<repository>
			<id>spring-snapshots</id>
			<name>Spring Snapshots</name>
			<url>https://repo.spring.io/snapshot</url>
			<snapshots>
				<enabled>true</enabled>
			</snapshots>
		</repository>
		<repository>
			<id>spring-milestones</id>
			<name>Spring Milestones</name>
			<url>https://repo.spring.io/milestone</url>
			<snapshots>
				<enabled>false</enabled>
			</snapshots>
		</repository>
	</repositories>
	<pluginRepositories>
		<pluginRepository>
			<id>spring-snapshots</id>
			<name>Spring Snapshots</name>
			<url>https://repo.spring.io/snapshot</url>
			<snapshots>
				<enabled>true</enabled>
			</snapshots>
		</pluginRepository>
		<pluginRepository>
			<id>spring-milestones</id>
			<name>Spring Milestones</name>
			<url>https://repo.spring.io/milestone</url>
			<snapshots>
				<enabled>false</enabled>
			</snapshots>
		</pluginRepository>
	</pluginRepositories>

编写Http接口

1、新建一个包，domian用于存放实体类，并新建一个User.java类

package net.xdclass.demo.domain;
/**
 * 用户类
 */
public class User {
    private int id;
    private String name;
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
}

2、新建一个Controller，并建立一个UserController.java， 类加入注解@RestController (用于返回Json数据，如果用@controller的话，需要在加个@responseBody，才会返回json数据)，新建一个findUser方法，方法上加个注解，@RequestMapping("find")

package net.xdclass.demo.controller;

import net.xdclass.demo.domain.User;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * 使用 @RestController 定义一个控制器
 */
@RestController
public class UserController {
    
    /**
     * 定义一个接口，接受两个参数
     * @param id
     * @param name
     * @return
     */
    @RequestMapping("find")
    public User findUser(int id, String name){
        User user = new User();
        user.setName(name);
        user.setId(id);
        return user;
    }
}

3、使用CMD或者命令行工具进入项目根目录，把应用打包成一个可执行的jar包, 执行maven打包命令 mvn clean package 

[INFO]
[INFO] Results:
[INFO]
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO]
[INFO]
[INFO] --- maven-jar-plugin:3.0.2:jar (default-jar) @ demo ---
[INFO] Building jar: /Users/xdclass/Desktop/文章/第一篇/demo/target/demo-0.0.1-SNAPSHOT.jar
[INFO]
[INFO] --- spring-boot-maven-plugin:2.0.3.RELEASE:repackage (default) @ demo ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 5.459 s
[INFO] Finished at: 2018-07-16T08:34:57+08:00
[INFO] ------------------------------------------------------------------------

打包成功后最后会出现一个success，然后进入target目录，里面有个xxx.jar  （xxx就是项目的名字）就是可以直接执行的jar包.

启动  java -jar xxxx.jar， 启动大概花10来秒，底部可以看到启动成功的日志，springboot默认端口是8080, 所以可以直接访问

接口地址：http://localhost:8080/find?id=1&name=二当家小D

响应一个user对象，就成功了。

这就是一个成功的http接口，一个web应用就可以正常启动了访问和访问了，如果要开发其他接口，继续写就可以了。

下一篇文章，讲解Springboot2.x启动流程和常用的注解、官方推荐的目录规范

小编积累多年的干货文档免费赠送，包含前端后端和测试，系统架构，高并发处理，优化等