springboot从零开始：新建springboot工程

前言：

本系列博客记录 springboot 求学之路：
万事开头难，第一步创建一个基础工程

1.环境和工具描述

开发工具：IDEA，版本 2018.03
JDK：版本1.8
Spring Boot：版本 2.26

2.新建工程

File -> New -> Project -> Spring Initializr

点击 Next，简单配置一下工程信息

点击 Next，初学者不要配置太多东西，只勾选下面一个

点击 Next，出现工程名、目录的配置，默认即可

点击Finish完成；工程目录如下，红色框里面的是一些说明或者帮助命令，和工程本身没任何关系，完全可以删了。

重点：
.gitignore 文件在提交代码到git仓库的时候有用，和工程本身没有关系
pom.xml 是工程的配置文件，包括 springboot的配置，打包，依赖，启动等
demo.iml 是 intellij idea的工程配置文件，里面是当前project的一些配置信息
.idea 目录每次打开工程会自动生成，也是没啥用的目录
controller 包是第3步创建的（暂时忽略它）
src 目录是代码目录，其下面

1. java 目录存放业务代码
2. test 目录是测试代码目录
3. resources 目录存放资源，例如配置文件
4. DemoApplication 是启动入口类，工程名称不一样，相应的类名也是不一样的

3.测试工程

工程建好以后运行 DemoApplication 是可以跑的，但是啥功能也没有，跑起来也没意义，所以我们创建一个接口类给大家打个招呼。

新建一个 controller 包用于存放接口声明，在controller 包里面新建一个TestController类

package com.test.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TestController {

    @GetMapping(path = "/")
    public String get() {
        return "hello, SpringBoot";
    }
}

启动工程，浏览器输入 http://127.0.0.1:8080/ 即可看到返回

重点： springboot 默认端口号 8080，端口号是可以修改的，配置在下节说

4.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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.6.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.test</groupId>
    <artifactId>demo</artifactId>
    <version>1.0</version>
    <name>demo</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>

        <!-- 提供web支持，包含RESTful，Spring MVC ，Tomcat内嵌容器等-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- 测试相关 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <!-- exclusions是dependency的子标签。用于排除运营是不需要的jar -->
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

5.代码层级关系

SpringBoot 里面的包名不能命名太随意，有一些通俗的约定在里面：

controller 包：放置路由，例子中的 TestController 类就是
service 包：放置逻辑处理类，一般 controller 包引用的方法都在这个包的类里面
dao 包：数据表的映射，例如 mysql 中表 user 的字段映射
mapper 包：放置 sql 的查询引用和声明（xml 或者 接口定义）
model 包：有时候也会和 dao 混在一起，主要放置数据层的类声明，也会放置数据传输中间类
dto 包：放置数据传输中间类
config 包：配置包，例如 mysql，redis，kafka 等的配置

包名层级没有硬性的约定，自己喜欢就好