使用Maven从0开始搭建spring boot2.x项目

￡神魔★判官ぃ 2023-06-27 06:15 82阅读 0赞

## 前言 ##

因为放了寒假，时间挺长的。然后想利用这段放假的时间把自己的个人博客网站搭建起来。之前学了`ssm`框架，然后使用`javaweb`\+`ssm`也写了两个比较小的项目。这次想试试大项目，把自己的博客搭的完完整整。然后考虑到这个项目我可能会终生维护。于是不再使用`javaweb` \+ `ssm`。而是使用`maven`搭建`sm`（spring boot + mybatis）框架来完成。但是我没有系统的学过`maven`和`spring boot`。于是我想考着`ssm`的基础。边学边做。于是就有了这篇博客。从0使用`maven`搭建`spring boot2.x`项目。为什么从0呢？因为使用idea的话，很容易就创建出一个什么都配好的项目。但是对于学习而言，并不友好。所以，应该从创建`maven`项目开始，然后一个一个的配置然后加入`maven依赖`。

## 使用maven创建一个web项目 ##

*当你看到这里，你必须安装了`maven`并且配置完成了环境变量。然后了解过`maven`的基本命令。*  
首先使用`maven`的模板创建一个web项目。使用`mvn archetype:generate`命令。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center][]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 1]  
然后会等待你输入。这里选择10，然后输入自己的项目组名，项目名版本号等等。（第一个要选10表示web项目，然后后面的下您要更改就输入，可以直接回车）。  
输入完成之后项目就会构建成功了。  
![在这里插入图片描述][20200104165451810.png_pic_center]  
构建成功之后然后切换当前工作目录到你的项目根目录下。（也就是含有pom.xml的目录）。  
![在这里插入图片描述][20200104193833447.png_pic_center]

## 添加`spring boot`相关依赖 ##

这时`maven`项目已经构建完成并且准备就绪。然后就是导入`spring boot`的相关依赖。  
将如下代码添加到pom.xml中。  
引入spring-boot的相关依赖文件 ，这个是最基本的包，里面包含了运行的相关组件，例如tomcat，以及其他的jar包。

<parent>
        
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.2.RELEASE</version>
        <relativePath /> 
      </parent>

接下来这个依赖。  
这样就能启动一个spring-boot的web项目，其中内嵌了相关的tomcat服务器

<dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

接下来添加maven对spring的支持的插件。

<build>
      <finalName>test</finalName>
      <plugins>
        
        
        <plugin>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-maven-plugin</artifactId>
          
          <executions>
              <execution>
                <goals>
                  <goal>repackage</goal>
                </goals>
              </execution>
            </executions>
        </plugin>
      </plugins>
    </build>

## `spring boot` 项目结构 ##

在spring boot项目中有如下几个注意项（算是规范吧）。

1.  `.java`文件都要放在`main/java`文件夹下
2.  **启动类最好是不要直接放在默认包下（也就是`main/java`），应该放在如: `main/java/com/`下**
3.  `html`等静态资源要放在`resources/static`下
4.  `spring boot`的配置文件要放在`resources`根目录

依赖导入后，接下来将web项目的目录结构进行修改。添加几个目录：`main\resources\static`、`main\java`。一个是存放`html`等前端页面的位置，一个是存放`java`代码的位置。标准的`spring boot项目`是没有`webapp`目录的，可以删除掉。  
修改后的目录结构具体如下。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 2]

## 配置`spring boot`项目访问端口 ##

其中`main\application.properties`是`spring boot`的配置文件，用来配置`spring boot`的启动参数等。如：给`application.properties`配置启动后访问的端口号为`80`。  
![在这里插入图片描述][20200105120540596.png_pic_center]  
`TestApplication.java`是`spring boot`的启动类，`spring boot`项目的入口。

package com.test;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    @SpringBootApplication
    public class TestApplication { 
        public static void main(String[] args) { 
            SpringApplication.run(TestApplication.class, args);
        }
    }

`index.html`是我新建的`html`文件，内容如下。  
![在这里插入图片描述][20200105131210860.png_pic_center]

## 启动`spring boot` ##

### 使用`vs code`启动`spring boot` ###

接下 点击`run`启动`spring boot`。  
当然这里直接点run能启动是因为下载了`VSCode`的[`spring boot`插件][spring boot]。  
然后`spring boot`就能直接启动了。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 3]  
因为插件内部其实配置了什么我们也不清楚。所以为了不使用陌生的东西，也可以使用`maven clean install`命令将spring boot项目打包出`war`来，然后放在tomcat下再运行tomcat。也可以打包出`jar`然后直接使用`java -jar`命令运行。考虑方便性，和spring boot的独立性，这里就打出`jar`包来然后运行。

### 使用`java -jar`运行`spring boot` ###

首先添加`pom.xml`配置打包为`jar`。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_10_color_FFFFFF_t_70_pic_center]  
然后使用`mvn install`命令将项目打包。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 4]  
打包完成会在`target`文件夹下发现一个`.jar`文件。这个文件就是我们需要的可执行文件。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 5]  
最后使用`powershell`切换到`target`文件夹中然后使用`java -jar`命令执行。就会看到如下效果：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 6]  
最后在浏览器中访问。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 7]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/20200104163504556.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 1]: https://img-blog.csdnimg.cn/20200104163711702.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx,size_16,color_FFFFFF,t_70#pic_center
[20200104165451810.png_pic_center]: https://img-blog.csdnimg.cn/20200104165451810.png#pic_center
[20200104193833447.png_pic_center]: https://img-blog.csdnimg.cn/20200104193833447.png#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 2]: https://img-blog.csdnimg.cn/20200105124110316.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx,size_16,color_FFFFFF,t_70#pic_center
[20200105120540596.png_pic_center]: https://img-blog.csdnimg.cn/20200105120540596.png#pic_center
[20200105131210860.png_pic_center]: https://img-blog.csdnimg.cn/20200105131210860.png#pic_center
[spring boot]: https://code.visualstudio.com/docs/java/java-spring-boot
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 3]: https://img-blog.csdnimg.cn/20200105120954148.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_10_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/20200105130554673.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx,size_10,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 4]: https://img-blog.csdnimg.cn/20200105124045107.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 5]: https://img-blog.csdnimg.cn/20200105130351496.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 6]: https://img-blog.csdnimg.cn/20200105130937395.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx_size_16_color_FFFFFF_t_70_pic_center 7]: https://img-blog.csdnimg.cn/20200105131039479.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNzA5ODAx,size_16,color_FFFFFF,t_70#pic_center