最近在系统的学习SpringBoot框架,并且要用该框架做个项目……网上也大大小小看了很多教程,感觉很多写文章的人都不太负责任,只知道搬运,大概都没有实际操作过,问题也是有很多,所以自己写一篇文章记录一下,也打算养成个做笔记的习惯,也希望文章能多多少少的给大家带来些帮助。

一、搭建项目

首先新建项目,但是由于Maven作者之前就已经弄过了,没有配置和安装过的小伙伴可以网上找下教程,本篇暂时没有提到。


如图选择,点击next

包名什么的,自己修改下

要配置的一些服务,Thymeleaf主要是和返回前台页面和一些动态页面的处理有关,如果只做后台接口的话,可能用不到,但是为了测试还是建议勾选。Mysql,JDBC,Mybatis就顾名思义了。



其余部分就一直next,最后finish就好了。项目搭建好了之后,会加载一阵子,稍等即可。

二、配置文件

1、配置application.properties

然后进入到项目路径下的src/main/resources/application.properties文件

首先说明一点,这里也可以不使用application.properties文件,采用更加简洁的application.yml文件。网上很多教程也提到了,但是最终的原理SpringBoot底层会把application.yml文件解析为application.properties,所以就还是用了原来的文件,也有一些是个人使用原因,所以在这里,只提供application.properties的配置信息,yml可以参考网上的书写格式


# 数据库访问配置
# 主数据源,默认的
spring.datasource.url = jdbc:mysql://192.168.0.57:3306/XXXXXXXXXX
spring.datasource.username = root
spring.datasource.password = XXXXXXXXXXXXXXX
spring.datasource.driverClassName = com.mysql.jdbc.Driver
#页面热加载
spring.thymeleaf.cache = false
#端口
server.port=8080

#配置应用名称
spring.mvc.view.prefix=/templates/
spring.mvc.view.suffix=.html复制代码


2、配置pom.xml

<properties>    
    <!-- Java接口和实体类 -->    
    <targetJavaProject>${basedir}/src/main/java</targetJavaProject>    
    <targetMapperPackage>com.crow.mapper</targetMapperPackage>    
    <targetModelPackage>com.crow.entity</targetModelPackage>    
    <!-- XML生成路径 -->    
    <targetResourcesProject>${basedir}/src/main/resources</targetResourcesProject>    
    <targetXMLPackage>mapper</targetXMLPackage>    
    <!-- 依赖版本 -->    
    <mapper.version>3.4.0</mapper.version>    
    <mybatis.version>3.3.1</mybatis.version>    
    <mybatis.spring.version>1.2.4</mybatis.spring.version>    
    <pagehelper.version>4.1.1</pagehelper.version>
    
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>    
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>    
    <java.version>1.8</java.version>    
    <spring-cloud.version>Dalston.SR4</spring-cloud.version>
</properties>复制代码

重点是配置了几个全局的参数,已经自动生成代码的路径和存放位置


3、配置generatorConfig.xml

然后在resources文件夹下创建generator,mapper文件夹,前者是为了存放mybatis自动生成代码的插件的配置文件,后者是为了存放生成的xml文件

新建文件generatorConfig.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
        PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
        "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
    <!-- 数据库驱动:选择你的本地硬盘上面的数据库驱动包-->
    <classPathEntry  location="D:\crow1.0\mysql-connector-java-8.0.15.jar"/>
    <context id="DB2Tables"  targetRuntime="MyBatis3">
        <commentGenerator>
            <property name="suppressDate" value="true"/>
            <!-- 是否去除自动生成的注释 true:是 : false:否 -->
            <property name="suppressAllComments" value="false"/>
        </commentGenerator>
        <!--数据库连接驱动类,URL,用户名、密码 -->
        <jdbcConnection driverClass="com.mysql.jdbc.Driver" connectionURL="jdbc:mysql://192.168.0.57:3306/AAA" userId="BBB" password="CCC">
        </jdbcConnection>
        <javaTypeResolver>
            <property name="forceBigDecimals" value="false"/>
        </javaTypeResolver>
        <!-- 生成(实体)模型的包名和位置-->
        <javaModelGenerator targetPackage="${targetModelPackage}" targetProject="${targetJavaProject}">
            <property name="enableSubPackages" value="true"/>
            <property name="trimStrings" value="true"/>
        </javaModelGenerator>
        <!-- 生成XML映射文件的包名和位置-->
        <sqlMapGenerator targetPackage="${targetXMLPackage}" targetProject="${targetResourcesProject}">
            <property name="enableSubPackages" value="true"/>
        </sqlMapGenerator>
        <!-- 生成DAO接口的包名和位置-->
        <javaClientGenerator type="XMLMAPPER" targetPackage="${targetMapperPackage}" targetProject="${targetJavaProject}">
            <property name="enableSubPackages" value="true"/>
        </javaClientGenerator>
        <!-- 要生成的表 tableName是数据库中的表名或视图名 domainObjectName是实体类名-->
        <table tableName="DDD" domainObjectName="EEE" enableCountByExample="false" enableUpdateByExample="true" enableDeleteByExample="true" enableSelectByExample="true" selectByExampleQueryId="false"></table>
    </context>
</generatorConfiguration>复制代码

基本上都有注释了,有几个地方再简单说明一下

数据库驱动的地方要引入一个数据库驱动包,我是单独找了个驱动包,然后放在了项目的路径下,D:\crow1.0\mysql-connector-java-8.0.15.jar也就是这个路径,这个要根据个人情况来修改

AAA数据库名,BBB用户名,CCC密码

DDD要去操作数据库中表的名称,EEE生成实体的名称

举例:DDD为user,EEE最好为User

最后部分的配置<table tableName="DDD" domainObjectName="EEE" enableCountByExample="false" enableUpdateByExample="true" enableDeleteByExample="true" enableSelectByExample="true" selectByExampleQueryId="false"></table>前两个刚才介绍过了,至于后面的选项,是false和true看实际需求,从参数名可以看出来,就是是否生成某类方法的意思,很多同学默认配置的时候都是false,所以就会出现生成的代码只有insert方法,就是这个问题。在这里,作者选择了update,delete,select方法。

三、项目运行

在这里,写一个简单的方法,来返回一个页面

首先在resources/templates下新建hello.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8"/>
    <title>Title</title>
    <link rel="stylesheet" href="../static/test.css" type="text/css"/>
</head>
<body>
    <h1>Hello World</h1>
</body>
</html>复制代码

在resources/static下新建test.css

body{
    color: red;
}复制代码

写一个controller

package com.crow.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

/**
 * @author tzz
 * @version 1.00
 * @time 2019/4/10 14:41
 */

@Controller
@RequestMapping(value ={"/hello"})
public class IndexController {

    @RequestMapping(value ="/index",method = RequestMethod.GET)
    public String index(){
        return "hello";
    }

}复制代码

然后根据运行并访问该接口http://localhost:8080/hello/index

但我觉得很多人第一次会出现问题


然后一步步的确认问题,首先并不是返回的页面找不到,因为在项目生成的路径下可以看到,直接访问都没有问题,排除。其次,打断点,发现根本就没有进入到这个接口里面。查阅资料发现,问题所在,如下图。

作者的目录结构是这样的


最后发现问题是因为

接口类也就是controller文件,和启动类proapplication不在一个包下。需要在启动类添加一个注解。


再次启动项目,成功。但是发现了个新问题,成功是成功了,但是test.css文件没有引入成功。


我在target文件中发现有test.css但是网页查看发现资源没有载入。然后修改一下application.properties配置文件。

注释掉之前的spring.mvc.view.prefix=/templates/

添加如下配置

spring.mvc.static-path-pattern=/static/**复制代码


搞定!

四、自动生成代码

上面已经配置好了自动生成代码,但是如何自动生成呢?

点击edit config或者点击菜单栏中的run中的edit config都可以


点击添加按钮,选择maven


然后根据个人情况,修改一下名称什么的,再添加command line参数:mybatis-generator:generate -e


然后选择刚刚配好的,启动测试一下


大功告成。以后要换表生成实体的话,只需要修改generatorConfig.xml配置文件中的表的参数就ok,就是那个DDD,忘记了的同学去上面找一下吧。


备注:有什么说的不当或者有问题的地方还希望可以指出,希望大家共同进步。