使用Intellij Idea创建第一个SpringBoot+MyBatis+MySql项目并运行(附安装教程)，使用Maven构建项目并管理第三方jar
Intellij Idea
背景
自从前段时间被拉过来参与Java项目开发后，到现在也算告一段落了（半年过去了，要回到主业Android开发了），一个完整的项目结束了；因为是第一次参与实际Java项目开发，并且只是负责其中的一些模块开发，所以对整个项目的流程没有清晰的把握；比如这个项目是如何创建的，怎么运行的，使用的一些框架等，今天就通过这篇文章梳理下
开发工具及主要框架
开发工具：Intellij Idea，这个工具就不多说了，主流的Java开发工具
使用框架：
-
SpringBoot：如果不使用它，那么构建一个项目的程序还是挺麻烦的，但是使用它后极大简化新 Spring 应用的初始搭建以及开发过程，让应用部署变的简单（SpringBoot内置服务器，并装备启动类代码），可以快速开启一个Web容器进行开发；它默认配置了很多框架的使用方式，就像 Maven 整合了所有的 Jar 包，Spring Boot 整合了大量框架
-
mybatis：是一款支持普通 SQL查询，存储过程和高级映射的优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录
-
redis：全称Remote Dictionary Server，是一个基于键值对形式的非关系型数据库，性能极高（Redis能读的速度是110000次/s,写的速度是81000次/s），且数据之间没有耦合性,水平扩展很方便，特点有：
支持的数据类型很丰富（Strings, Lists, Hashes, Sets 及 Ordered Sets 数据类型操作）； - Redis的所有操作都是原子性的，意思就是要么成功执行要么失败完全不执行。单个操作是原子性的；多个操作也支持事务，即原子性，通过MULTI和EXEC指令包起来
- Redis还支持 publish/subscribe, 通知, key 过期等特性
quartz：是个开源的作业调度框架，不需要你自己管理那些繁琐的定时任务了
angularjs: 是一个开源的前端Js框架，通过 指令 扩展了 HTML，且通过 表达式 绑定数据到 HTML，核心特点有：MVC、模块化、自动化双向数据绑定、语义化标签、依赖注入等等
这里只列举一些主要框架，这篇文章就不详细介绍这些框架的细节了，后续看情况再写，今天的主题是怎么通过IDEA工具创建一个Spring Boot + Maven 项目，并成功运行起来
Maven
因为是使用maven管理第三方依赖等这些框架，同时它也是专门用来构建和管理Java项目，所以就需要先下载安装Maven
下载安装
官方下载地址：http://maven.apache.org/download.cgi
-
下载下来后就是一个压缩包，然后解压，如图
-
然后配置环境变量：MAVEN_HOME = D:\maven\apache-maven-3.2.3，还有一个是可选的：MAVEN_OPTS = -Xms128m -Xmx512m ，合理的增大运行所需内存可以加快Maven构建速度；最后在PATH变量里加上 %MAVEN_HOME%\bin
-
最后验证是否安装成功：打开cmd，输入 mvn -v ，看输出如图，你就成功了
settings.xml修改
使用Maven最直接的一个好处就是统一管理jar包或者第三方框架，以前都是同一份jar，这个项目要用的话就往该项目的lib目录拷贝一份，别的项目要用就再拷一份，显然这是不人道的；而Maven的作用如图：
统一管理的精髓在于不需要每个项目都拷贝一份jar了，而是在一个pom.xml文件中配置项目需要的第三方框架的依赖,如下的dependencies所属内容：
<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <dependencies> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.54</version> </dependency> </dependencies> </project>
然后Maven就会从本地仓库查找是否有这个目录：com\alibaba\fastjson\1.2.54（目录是由groupId，artifactId，version组成的）；如果没有就需要从远程仓库下载，这个远程仓库就是Maven官方提供的中央仓库（可以通过https://search
3ff7
.maven.org/访问），然后将其下载到本地仓库；
从上图可以看出所有项目所用的第三方框架都会下载到本地仓库，但是本地仓库的默认地址是：C:\Users\用户名.m2 目录下，所以需要修改，通过修改Maven安装目录下的apache-maven-3.6.0\conf\settings.xml文件，同时因为连接Maven中央仓库下载很慢，需要新增国内的镜像地址，当然有代理可用也可以设置代理，完整文件内容如下：
<?xml version="1.0" encoding="UTF-8"?> <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <pluginGroups/> <servers/> <localRepository>D:\Maven\repository</localRepository> <mirrors> <mirror> <id>alimaven</id> <name>aliyun maven</name> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror> <mirror> <id>central</id> <name>Maven Repository Switchboard</name> <url>http://repo1.maven.org/maven2/</url> <mirrorOf>central</mirrorOf> </mirror> <mirror> <id>repo2</id> <mirrorOf>central</mirrorOf> <name>Human Readable Name for this Mirror.</name> <url>http://repo2.maven.org/maven2/</url> </mirror> <mirror> <id>ibiblio</id> <mirrorOf>central</mirrorOf> <name>Human Readable Name for this Mirror.</name> <url>http://mirrors.ibiblio.org/pub/mirrors/maven2/</url> </mirror> <mirror> <id>jboss-public-repository-group</id> <mirrorOf>central</mirrorOf> <name>JBoss Public Repository Group</name> <url>http://repository.jboss.org/nexus/content/groups/public</url> </mirror> <mirror> <id>google-maven-central</id> <name>Google Maven Central</name> <url>https://maven-central.storage.googleapis.com </url> <mirrorOf>central</mirrorOf> </mirror> <!-- 中央仓库在中国的镜像 --> <mirror> <id>maven.net.cn</id> <name>oneof the central mirrors in china</name> <url>http://maven.net.cn/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors> <proxies> <proxy> <id>myproxy</id> <active>true</active> <protocol>http</protocol> <username>proxyuser</username> <password>proxypass</password> <host>xxx.xxx.xxx</host> <port>80</port> <!--<nonProxyHosts>local.net|some.host.com</nonProxyHosts>--> </proxy> </proxies> </settings>
IDEA配置Maven
使用ctrl+alt+s快捷键打开设置窗口，找到Maven选项，设置如图
主要三点：
- 配置Maven安装目录
- 配置settings文件目录
- 配置本地仓库地址
注册私有jar
有些jar包本地仓库没有，然后远程仓库也没有，是私有的，或者自己打的jar包；那这种情况下怎么使用呢？难道只能每个项目都将其拷贝到lib目录下吗？其实不用，我们可以将其注册到本地仓库，比如我将一个jar放在项目lib目录下，然后在idea中打开Terminal，输入
mvn install:install-file -Dfile=lib/jxl.jar -DgroupId=jxl.write.bif -DartifactId=jx-biff -Dversion=1.0 -Dpackaging=jar
其中-Dfile是jar相对目录，-DgroupId、-DartifactId、-Dversion就是dependency下的三个属性；执行该命令后就能在本地仓库找到它了；最后需要在pom文件中添加如下配置就可以使用了
<dependency> <groupId>jxl.write.bif</groupId> <artifactId>jx-biff</artifactId> <version>1.0</version> </dependency>
Maven打包
有三个打包命令，但是三个命令所经历的声明周期是不同的，如下：
-
mvn clean package：依次执行了clean、resources、compile、testResources、testCompile、test、jar(打包)等７个阶段。
-
mvn clean install：依次执行了clean、resources、compile、testResources、testCompile、test、jar(打包)、install等8个阶段。
-
mvn clean deploy：依次执行了clean、resources、compile、testResources、testCompile、test、jar(打包)、install、deploy等９个阶段
由上面的分析可知主要区别如下：
-
package命令完成了项目编译、单元测试、打包功能，但没有把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库和远程maven私服仓库
-
install命令完成了项目编译、单元测试、打包功能，同时把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库，但没有布署到远程maven私服仓库
-
deploy命令完成了项目编译、单元测试、打包功能，同时把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库和远程maven私服仓库
MySql安装
下载地址：https://dev.mysql.com/downloads/mysql/
我用的版本是community-5.7.22.1，比较稳定就没升级了，安装流程如图
配置环境变量
mysql默认安装在C:\Program Files\MySQL，如下
bin目录下保存了MySQL常用的命令工具以及管理工具、include目录和lib目录是MySQL所依赖的头文件以及库文件、share目录下保存目录文件以及日志文件
为了方便执行mysql 命令，将bin目录添加到环境变量，然后打开cmd，输入mysql -uroot -p，接着输入密码回车，如图
使用root帐号和我刚新增的mango帐号都可以连上数据库
接下来可以使用Navicat 操作，比如我这里新建一个数据库mango：
Intellij Idea
接下来就进入正题，新建项目，接下来得步骤我以图片得形式叙述
新建Spring Boot工程
这一步结束就到IDEA主界面了
刚开始的时候会下载一些需要的第三方库，默认下载的地址是在C:\Users\用户名.m2 目录下，这个需要自己配置Maven信息，方法在上面已经提到了，这里就不在叙述了
下载完成后如图
可以看到使用Spring Boot框架，idea会给我们生成一个DemoApplication类，打开看看
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
添加了一个注解SpringBootApplication，表明这个类是启动类；接下来点击右上角的三角启动按钮；不出意外，翻车了
配置数据库
*************************** APPLICATION FAILED TO START *************************** Description: Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured. Reason: Failed to determine a suitable driver class Action: Consider the following: If you want an embedded database (H2, HSQL or Derby), please put it on the classpath. If you have database settings to be loaded from a particular profile you may need to activate it (no profiles are currently active).
大概意思是：
错误描述：配置DataSource失败，连接数据库的url属性没有指定和没有配置内嵌的数据源
原因：Mybatis没有找到合适的加载类,其实是大部分spring - datasource - url没有加载成功的原因，分析可能如下所示
-
DataSourceAutoConfiguration会自动加载.
-
没有配置spring - datasource - url 属性.
-
spring - datasource - url 配置的地址格式有问题.
-
配置 spring - datasource - url的文件没有加载.
解决办法如下：因为在新建工程的时候在SQL选项时选择了MySql，JDBC，mybatis，所以需要修改application.properties，配置数据库的一些属性；但是这个文件使用起来不简洁，没有代码提示，所以将其后缀改成 .yml，然后添加如下配置
# Web服务器端口 server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://10.88.88.88/isp?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&serverTimezone=UTC&useSSL=false username: root password: mango
driver-class-name: com.mysql.cj.jdbc.Driver这句可能会报错，需要修改pom文件中的mysql依赖
配置MyBatis
同样是在application.yml中添加
# Mybatis mybatis: config-location: classpath:mybatis/mybatis-config.xml mapper-locations: classpath:mybatis/mapper/*/*.xml type-aliases-package: com.maven.demo.pojo
config-location和mapper-locations的配置需要在resources下面新建目录和文件
type-aliases-package的配置需要在包名下新建一个pojo的包
启动
再次启动就能看到控制台提示启动成功了
. ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v2.1.4.RELEASE) 2019-04-30 09:40:55.604 INFO 62636 --- [ main] com.mango.demo.DemoApplication : Starting DemoApplication on DESKTOP-L1PKA9E with PID 62636 (D:\Web\Workspaces\demo\target\classes started by lenovo in D:\Web\Workspaces\demo) 2019-04-30 09:40:55.606 INFO 62636 --- [ main] com.mango.demo.DemoApplication : No active profile set, falling back to default profiles: default 2019-04-30 09:40:56.040 WARN 62636 --- [ main] o.m.s.mapper.ClassP 8000 athMapperScanner : No MyBatis mapper was found in '[com.mango.demo]' package. Please check your configuration. 2019-04-30 09:40:56.420 INFO 62636 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http) 2019-04-30 09:40:56.434 INFO 62636 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat] 2019-04-30 09:40:56.434 INFO 62636 --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/9.0.17] 2019-04-30 09:40:56.507 INFO 62636 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext 2019-04-30 09:40:56.508 INFO 62636 --- [ main] o.s.web.context.ContextLoader : Root WebApplicationContext: initialization completed in 872 ms 2019-04-30 09:40:56.641 INFO 62636 --- [ main] o.s.s.concurrent.ThreadPoolTaskExecutor : Initializing ExecutorService 'applicationTaskExecutor' 2019-04-30 09:40:56.901 INFO 62636 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path '' 2019-04-30 09:40:56.904 INFO 62636 --- [ main] com.mango.demo.DemoApplication : Started DemoApplication in 1.57 seconds (JVM running for 2.002)
然后打开浏览器看下：localhost:8080；你可能看到的是下面这个画面
Whitelabel Error Page This application has no explicit mapping for /error, so you are seeing this as a fallback. Tue Apr 30 09:44:40 CST 2019 There was an unexpected error (type=Not Found, status=404). No message available
这是因为没有获取到指定页面，因为我们还没有写任何的html；但是我们可以写个Controller来返回个页面显示，如下
@RestController
@RequestMapping("/welcome")
public class LoginController {
@ResponseBody
@RequestMapping(value = "/hello")
public String hello(){
return "hello";
}
}
然后根据路径在浏览器打开就能看到了：http://localhost:8080/welcome/hello，页面会显示一个hello
配置Spring boot默认启动页
如果想要默认打开一个html的话，需要做一个配置，比如我在resource/static目录下新增一个index.html文件，想我们的服务一打开就是这个页面，做法是：
新增一个类，实现WebMvcConfigurer接口，不要继承WebMvcConfigurerAdapter，因为在Spring Boot2.0中它已经过时了；最后重写addViewControllers方法
@Configuration
public class DefaultPager implements WebMvcConfigurer {
/**
* 配置Spring Boot 默认启动页
* @param registry
*/
@Override
public void addViewControllers(ViewControllerRegistry registry) {
registry.addViewController("/index").setViewName("index");
}
}
连接MySql
idea工具有一个database插件，可以直接在这里连接数据库并操作，如图
这篇文章就到这里了，至于一些框架的使用后续再给出
- Maven快速使用教程（二） spring boot 项目构建
- Maven快速使用教程（二） spring boot 项目构建
- 第一个SpringBoot web 应用使用maven构建Docker镜像并容器化运行
- 【项目管理和构建】十分钟教程，eclipse配置maven + 创建maven项目（三）
- 使用IntelliJ IDEA 14和Maven创建java web项目（以及maven管理本地仓库）
- 使用springboot创建第一个helloworld项目
- 使用spring boot快速构建spring框架的maven项目
- Spring boot框架项目，使用maven命令将配置文件打包到jar包外,项目运行读取jar外配置文件
- SpringBoot + MyBatis + MySQL + Maven在Intellij IDEA下开发环境的搭建
- 【项目管理和构建】十分钟教程，eclipse配置maven + 创建maven项目（三）
- 【项目管理和构建】十分钟教程，eclipse配置maven + 创建maven项目（三）
- 项目管理和构建】十分钟教程，eclipse配置maven + 创建maven项目
- 使用Maven管理项目-----创建Struts2,Spring,Hibernate项目
- SpringBoot + MyBatis + MySQL + Maven在Intellij IDEA下开发环境的搭建
- IDEA创建maven管理的springMVC+spring+Mybatis项目
- 【项目管理和构建】十分钟教程，eclipse配置maven + 创建maven项目（三）
- 图文详解 IntelliJ IDEA 15 创建 Maven 构建的 Java Web 项目（使用 Jetty 容器）
- Idea使用Maven创建多模块SpringBoot项目问题记录
- IntelliJ IDEA下SSM框架整合、创建Maven项目流程（Spring + SpringMVC + MyBatis）
- IntelliJ IDEA使用Maven创建Spring和Mybatis工程出现...BindingException: Invalid bound statement (not found)