一步步学习java后台（一）(IDEA, Spring, Maven, MyBatis)

后台是网络开发的重中之重，复制逻辑与数据的开发。但是后台开发IDE有多个家族，框架多种多样；Spring系列虽然应用最为广泛，但是依赖多种配置，各种xml的配置项多如牛毛，而网上的教程，多数直接给出配置文件，让学习者直接复制。对纯新手而言，这样做非常容易出现无法解决的报错，导致非常难以入门。

我做这个系列，就是想作为一个纯后台新手，通过记录自己一步步搭建后台程序的过程，既让自己学会操作，也帮助大家在学习过程中少绕弯路。因为我也是一个纯新手，肯定会有各种错误，希望大家不吝指正，多谢大家！！

开发环境选择

操作系统：macOS Catalina 10.15.4
java版本： JDK-1.8
IDE: IDEA2019.2.03
第三方管理库：Maven 3.6.3 https://maven.apache.org/
框架：Spring（前期使用Spring MVC，后期转向 Spring Boot）
数据库管理：Mybatis + MySql https://mybatis.org/mybatis-3/
容器：Tomcat8 https://tomcat.apache.org/download-80.cgi

下面的教程默认大家已经装好了这些软件。

非常非常非常非常非常推荐大家采用跟我一样的版本, 因为软件版本不一致,会出现一些奇怪的bug; 而IDE如果不一致，很可能菜单栏位置都不一样，导致大家无法完成操作。当然，这些问题99%是可以解决的，但是为此浪费时间实在不值得。

本期目标

在浏览器中运行Hello world
添加在工程中添加java代码和Resource资源
引入SpringMVC

dist

Let's Go

一、配置maven

请保证IDEA的maven标签中，选项如下：

image.png

User setting file中是maven的配置文件路径，打开setting.xml,在 mirrors标签下添加如下代码：

  <mirrors>
    <mirror>
      <id>nexus</id>
      <name>internal nexus repository</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>

防止无法从google中下载软件

二、使用IDEA的模板初始化工程

image.png

要注意Project SDK中的javaSDK不要是红色，如果是的话，请重新配置java的环境变量。

image.png

maven的setting和Local一定要选上，不选的话有可能导致mvn install失败

新建完成后，我们应该只能看到一个pom文件，这是maven用的索引文件，这时maven会自己更新库，一定要等待更新完，千万不要在这时候修改pom文件。否则发现工程目录为空，没有java source，没有Web app不要怪我没提醒。。

image.png

结束之后，我们应该得到这样一个工程：

image.png

由于我们一般使用中文，我们要添加maven compiler encode改成UTF-8:
打开pom文件:

image.png

<maven.compiler.encoding>UTF-8</maven.compiler.encoding>

index.jsp就是在容器中要展示的页面，我们可以尽情的编辑它：

image.png

三、使用Maven打war包

war包是后台工程的输出结果，将war包放到如tomcat等容器中就可以访问后端代码了。

image.png

如果代码是从网上引入的，有可能 Tool Windows中没有Maven，这时候我们要右击pom.xml文件，选择按 Add as Maven. 然后就可以看到这个标签了。

注意 maven 命令的区别

package命令完成了项目编译、单元测试、打包功能，但没有把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库和远程maven私服仓库
install命令完成了项目编译、单元测试、打包功能，同时把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库，但没有布署到远程maven私服仓库
deploy命令完成了项目编译、单元测试、打包功能，同时把打好的可执行jar包（war包或其它形式的包）布署到本地maven仓库和远程maven私服仓库

四、添加运行容器

当前我们是无法运行的，需要本地配置容器：

image.png

这个Artifact就是要运行的war包，要注意，如果没有完成maven package，是不会有Artifact这个选项的。

image.png

war包是自己打包生成的，默认是一个已经完成准备部署发布的项目，将WEB工程以包的形式上传到服务器，不包含源码

war exploded包是IDEA在工程创建的时候就自动生成的，是给用户放在服务器上调试用的，并不是一个完成的准备发布的项目。将WEB工程以当前文件夹的位置关系上传到服务器，包含源码

我们自测使用exploded就可以，但是实际工程里一定要用war包

image.png

这时我们就可以运行了，点击之后，应该会在浏览器中默认打开 Hello world。

五、添加Java Package

看实际例子时，我们会发现java代码一般存放在 src/java 目录下。然而我们新建 java 目录时，却发现无法里面添加java代码。

java源码package在IDEA中默认为蓝色，灰色是普通文件

我们需要在project setting中配置文件夹的类型

image.png

选择之后，我们可以看到，java文件夹变成蓝色，在文件夹下右击 -> new 出现java class。

同样的，资源文件也是在这里选择，我们在java文件夹同一层建立一个resource文件夹备用

顺便一提，如果我们误删了WebApp，也是在这里重新配置或重新生成。
在java目录下，我们开始创建Java Package：

image.png

如果不想拼合空package，可以打开这个选项

image.png

六、通过Maven添加SpringMVC

我们首先要登录 https://mvnrepository.com/search?q=spring ，这里可以查到最新的maven spring 的版本号。（当前是5.2.5.RELEASE）

由于所有的Spring家族的版本号相同，我们可以在pom.xml中为其设置一个属性：

 <properties>
....
<spring.version>5.2.5.RELEASE</spring.version>
....
</properties>

然后，在pom.xml的<dependencies> 中添加spring-mvc的依赖：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>RELEASE</version>
</dependency>
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
</dependency>
<dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>javax.servlet.jsp-api</artifactId>
    <version>2.3.3</version>
</dependency>

保存之后，会自动下载依赖包。Maven下载的第三方包会在External Libraries里体现：

image.png

如果没有的话，是maven下载有问题，可以考虑以下几个办法：

1.查看Pom中的dependency，是否包裹在dependencyManagement中，这样包裹是声明的意思，不会下载的

2.查看setting.xml中镜像是否正确配置

七、创建 HelloWorld Controller验证是否配置maven成功

在java包下添加这个HelloWorldController.java, 如果文件中没有报错或飘红，说明 SpringMVC 引入配置成功。

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;


import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;


public class HelloWorldController implements Controller {


    @Override
    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
        return null;
    }
}

要注意现在还没有做任何关联，运行不会有结果的。

当前源码地址：
https://github.com/milawoai/fed-teacher.git
tag：1.0.0