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

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SpringBoot2.X最佳实践《一》 之 SpringBoot2.x初体验相关的知识,希望对你有一定的参考价值。

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启动流程和常用的注解、官方推荐的目录规范


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

技术分享图片

以上是关于SpringBoot2.X最佳实践《一》 之 SpringBoot2.x初体验的主要内容,如果未能解决你的问题,请参考以下文章

SAML SP 元数据:自签名证书或 CA 证书,最佳实践是啥?

SpringBoot2.x之WebMvcConfigurer

(汇总)Spring Boot 实践折腾记 & Spring Boot 2.x 实践记

springboot2.x整合kafka

SpringBoot2.x应用之手工创建web应用

网红框架SpringBoot2.x之定制参数浅析