SpringBoot项目开发后端脚手架搭建

SpringBoot项目开发后端脚手架搭建

一、准备工作

需要提前配置好电脑的 jdk 与 maven ，根据官方文档 springboot 3.0 架构需要 Maven 3.5 + 版本 以及 Java 17 兼容 19。

对于 springboot 2.0 架构只需要 Maven 3.3 + 版本 以及 Java 8 兼容 14。

首先，在电脑系统中确认你的 jdk 版本以及 maven 版本，可调出命令行窗口输入

java -version
mvn -v

这里可以看到你的 java 版本和 maven版本 （前提是，在安装 jdk 与 maven 时要记得正确配置好环境变量的路径）

接下来，配置你的 maven 文件

来到这里的路径下，打开 conf 文件夹，可以看到里面含有 settings.xml 文件，使用记事本或者其他可编辑应用打开

打开 settings.xml 文件后，我们需要修改三处地方，

第一个，找到

<localRepository> </localRepository>

这样的文件格式，我们知道 maven 是用来管理项目需要下载的依赖的组件，这个格式是用来指定本地存放依赖的路径文件的，可随意在一个地方建立一个文件夹用来存放依赖即可，将文件夹的路径加在中间

注意 ： 一定不要写到注释里面去！要写在箭头的外面！

第二处，我们下载依赖时使用外国的服务器会下载的非常的慢，因此我们需要配置国内的镜像网站来加快依赖的下载速度，找到文件中的 字段，在中间加入下列的阿里云镜像

<mirrors>
      <mirror>
        <id>nexus-aliyun</id>
        <mirrorOf>central</mirrorOf>
        <name>Nexus aliyun</name>
        <url>http://maven.aliyun.com/nexus/content/groups/public</url>
      </mirror>
  </mirrors>

第三处，配置项目使用的 jdk ，我项目使用的是 jdk1.8 因此配置 1.8 的 jdk (注意前提是电脑中一定要安装了对应版本的 jdk 才可以)，将下面的代码粘贴在 字段之间即可

  <profiles>
         <profile>
              <id>jdk-1.8</id>
              <activation>
                <activeByDefault>true</activeByDefault>
                <jdk>1.8</jdk>
              </activation>
              <properties>
                <maven.compiler.source>1.8</maven.compiler.source>
                <maven.compiler.target>1.8</maven.compiler.target>
                <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
              </properties>
         </profile>
  </profiles>

至此，maven 的配置就ok 了，还有一点要注意的是，在你使用 idea 开发项目时，要输你的 IDE 中设置的 maven路径正确，否则在下载更新依赖时会报错无法解析依赖

二、springboot 项目架构的搭建

搭建 springboot 项目架构有三种方法，第一种是到 springboot 的官网上配置对应的项目，然后下载到本地后在引入 idea 进行开发；第二种是新建 maven 工程，自定义引入配置 pom.xml 文件，引入对应的依赖设置；第三种则是使用现成的 spring initializr ，这个是spring的初始化向导，可以简化这个项目的配置（当有特殊需求时，建议自己配置maven工程文件依赖）

新建项目，选择 spring initializr ，选择项目使用的SDK ，这里我设置的是 1.8 版本（注意和 maven 的文件配置契合），然后选择下一步

自定义新建项目的包的名称，注意类型要选择 maven，打包方式常常使用 jar 包，java 的版本视情况而定，有时可能会出现不支持版本的报错，更换一个版本即可

下面这步呢，可以选择你要搭建的 springboot 架构的版本，还有你要引入的依赖，如想开发一个web应用，就引入web依赖，想使用数据库就引入数据库的依赖，这里我只引入了 Spring Web 和 Mybatis Framework 的依赖，后期想再次引入依赖，在pom.xml中配置即可，这里只是一个初始化而已

下面选择项目的存放路径即可新建项目

下面这是新建的项目的结构，图中标箭头的文件可以直接删除，对项目本身并无影响

打开项目的 pom.xml 配置文件，查看是否有下面两个依赖

spring-boot-starter-parent 是springboot 的父工程
spring-boot-starter-web 是开发 web 应用必不可少的启动依赖

接下来，找到 application.properties 配置文件，将他的后缀改为 .yml，这两种文件格式在作用上并无区别，只是yml文件显示配置时更加直观

在 application.yml 中 添加程序运行的端口号

在主启动类同级下建立 controller 包，并写一个简单的处理请求函数验证一下项目是否能运行

package com.example.fmms.controller;

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

@RestController
public class HelloController {
    
    
    @RequestMapping("/hello")
    public String hello(){
    
    
        return "Hello World!";
    }
}

运行项目，运行完成后到浏览器中访问对应端口号，发现返回了想要的字符串，项目构建成功