最近在系统的学习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,忘记了的同学去上面找一下吧。
备注:有什么说的不当或者有问题的地方还希望可以指出,希望大家共同进步。