|
1 | | -# Eclipse 的 Java Web 项目环境搭建 |
| 1 | +# Maven 的单模块 / 多模块之 Spring MVC + Spring + Mybatis 项目讲解 |
2 | 2 |
|
3 | | -## Eclipse 项目结构 |
4 | 3 |
|
5 | | - |
| 4 | +## 初衷 |
6 | 5 |
|
7 | | -> * 如上图 Gif 演示，在 Eclipse 下，一般中小项目的项目结构基本都是这种模式的，所以我们这里也网络上一个开源项目 JspRun 进行讲解。 |
8 | | -> * 下载地址：<http://pan.baidu.com/s/1i3zrSf7> |
| 6 | +- 为了更加明了地展示 IntelliJ IDEA 的设置，本章教程为视频教程 |
| 7 | +- 本章展示 IntelliJ IDEA 高度集成化的效果，降低 IntelliJ IDEA 入门时间 |
9 | 8 |
|
10 | | -## Eclipse 项目配置 |
11 | 9 |
|
12 | | - |
| 10 | +## 视频下载 |
13 | 11 |
|
14 | | -> * 如上图箭头所示，在 IntelliJ IDEA 下是支持直接打开 Eclipse 项目的，无需导入。 |
15 | | -> * 如上图标注 1 所示，选择项目的 `.project` 文件打开即可。 |
| 12 | +- **单模块的 Spring MVC + Spring + Mybatis 讲解（基于 IntelliJ IDEA）** |
| 13 | + - 百度云盘：<http://pan.baidu.com/s/1dEuxWh7> |
| 14 | + - 360 云盘（6d49）：<https://yunpan.cn/cY444GphNgMe3> |
| 15 | +- **多模块的 Spring MVC + Spring + Mybatis 讲解（基于 IntelliJ IDEA）** |
| 16 | + - 百度云盘：<http://pan.baidu.com/s/1hr0x6sc> |
| 17 | + - 360 云盘（e319）：<https://yunpan.cn/cY4INmfJn8yvm> |
16 | 18 |
|
17 | | - |
18 | 19 |
|
19 | | -> * 如上图标注 1 所示，IntelliJ IDEA 能自动识别到可编译的 `src` 类目录，所以这里文件夹是蓝色的。 |
20 | | -> * 如上图标注 2 所示，Java Web 项目 `WebRoot` 是整个项目输出的根目录，所以这个区域也是非常重要的，只是无需配置。 |
21 | | -> * 如上图标注 3 所示，`WEB-INF` 下的一些配置文件，以及两个目录 `classes` 和 `lib` 都是至关重要的，其中 `classes` 是红色目录，也就是被排除的，因为编译的文件对开发来讲是没有多大意义的，所以进行了排除。但是这并不会影响容器去使用它。 |
| 20 | +## 开发环境 |
22 | 21 |
|
23 | | - |
| 22 | +- JDK 7（理论上支持 JDK 6、JDK 7、JDK 8） |
| 23 | +- Mysql 5.6 |
| 24 | +- Maven 3.1.1 |
| 25 | +- Tomcat 7 |
| 26 | +- Git 2.7.0.2-64-bit |
| 27 | +- IntelliJ IDEA 15.0.4 |
| 28 | +- 所有编码：UTF-8 |
24 | 29 |
|
25 | | -> * 如上图标注 1 所示，因为这个项目是单 Module 的，所以我们这里在 `Project compiler output` 可以选择项目 `WEB-INF` 下的 `classes` 编译目录。 |
26 | 30 |
|
27 | | - |
| 31 | +## 演示内容 |
28 | 32 |
|
29 | | -> * 如上图红圈所示，我们可以根据对项目的任意目录进行这五种目录类型标注，这个知识点非常非常重要，必须会。 |
30 | | ->> * `Sources` 一般用于标注类似 `src` 这种可编译目录。有时候我们不单单项目的 `src` 目录要可编译，还有其他一些特别的目录也许我们也要作为可编译的目录，就需要对该目录进行此标注。只有 `Sources` 这种可编译目录才可以新建 Java 类和包，这一点需要牢记。 |
31 | | ->> * `Tests` 一般用于标注可编译的单元测试目录。在规范的 maven 项目结构中，顶级目录是 `src`，maven 的 `src` 我们是不会设置为 `Sources` 的，而是在其子目录 `main` 目录下的 `java` 目录，我们会设置为 `Sources`。而单元测试的目录是 `src - test - java`，这里的 `java` 目录我们就会设置为 `Tests`，表示该目录是作为可编译的单元测试目录。一般这个和后面几个我们都是在 maven 项目下进行配置的，但是我这里还是会先说说。从这一点我们也可以看出 IntelliJ IDEA 对 maven 项目的支持是比较彻底的。 |
32 | | ->> * `Resources` 一般用于标注资源文件目录。在 maven 项目下，资源目录是单独划分出来的，其目录为：`src - main -resources`，这里的 `resources` 目录我们就会设置为 `Resources`，表示该目录是作为资源目录。资源目录下的文件是会被编译到输出目录下的。 |
33 | | ->> * `Test Resources` 一般用于标注单元测试的资源文件目录。在 maven 项目下，单元测试的资源目录是单独划分出来的，其目录为：`src - test -resources`，这里的 `resources` 目录我们就会设置为 `Test Resources`，表示该目录是作为单元测试的资源目录。资源目录下的文件是会被编译到输出目录下的。 |
34 | | ->> * `Excluded` 一般用于标注排除目录。被排除的目录不会被 IntelliJ IDEA 创建索引，相当于被 IntelliJ IDEA 废弃，该目录下的代码文件是不具备代码检查和智能提示等常规代码功能。 |
35 | | ->> * 通过上面的介绍，我们知道对于非 maven 项目我们只要会设置 `src` 即可。 |
36 | 33 |
|
37 | | -> * 如上图箭头所示，被标注的目录会在右侧有一个总的概括。其中 `classes` 虽然是 `Excluded` 目录，但是它有特殊性，可以不显示在这里。 |
38 | | -> * 如上图标注 1 所示，如果要去掉目录的标记含义，可以点击打叉按钮进行删除。 |
| 34 | +- 环境相关： |
| 35 | + - Maven 环境说明：<http://code.youmeek.com/2016/03/09/2016/03/Maven/> |
| 36 | + - 我的 Maven 环境分享下载：<http://pan.baidu.com/s/1bnPZU2b> |
| 37 | + - 建议你也跟我一样直接解压在 D 盘根目录，这样其他就不需要设置了 |
| 38 | + - Git 环境的说明：<http://code.youmeek.com/2016/02/28/2016/02/Hexo/> |
| 39 | + - IntelliJ IDEA 基础教程系列：<https://github.com/judasn/IntelliJ-IDEA-Tutorial> |
39 | 40 |
|
40 | | - |
| 41 | +--- |
41 | 42 |
|
42 | | -> * 如上图标注 1 所示，这是一个单 Module 的项目，Module 的编译输出目录可以跟 Project 的项目输出目录一致，都是 `WebRoot` 下的 `classes` 目录。 |
| 43 | +- IntelliJ IDEA 设置： |
| 44 | + - Fork 单模块项目：<https://github.com/judasn/Basic-Single-Module-SSM> |
| 45 | + - Fork 多模块项目：<https://github.com/judasn/Basic-Multi-Module-SSM> |
| 46 | + - Checkout 项目并导入 |
| 47 | + - IntelliJ IDEA Maven 设置 |
| 48 | + - IntelliJ IDEA 文件编码设置 |
| 49 | + - IntelliJ IDEA Mybatis 插件安装（该插件收费）：<https://plugins.jetbrains.com/plugin/7293?pr=> |
43 | 50 |
|
44 | | - |
| 51 | +--- |
45 | 52 |
|
46 | | -> * 如上图红圈所示，这里显示项目的所有依赖包，其中红色表示 IntelliJ IDEA 无法识别。IntelliJ IDEA 支持一个一个导入依赖包，也支持直接导入一个目录下的所有依赖包。上图的这种就是一个一个具体化的依赖包。除非你的项目各个依赖包有存在依赖顺序关系，不然不建议一个一个引入，这样比较麻烦。所以我这里会先把这些零散的依赖包全部去除掉，然后按目录来引入。 |
47 | | -> * 如上图标注 1 所示，依赖包支持这五种操作。 |
48 | | -> |
49 | | ->> * 加号，表示可以引入新依赖包。 |
50 | | ->> * 减号，表示可以去除对应的依赖包。 |
51 | | ->> * 向上箭头，表示依赖包可以向上移动位置。依赖包越上面的表示在项目加载的时候越是优先，所以对于同一个依赖包，不同版本，依赖顺序不同，结果可能也是很有会不同的。 |
52 | | ->> * 向下箭头，表示依赖包可以向下移动位置，原因同上。 |
53 | | ->> * 笔，表示可以编辑依赖包的名称和路径。 |
| 53 | +- 项目设置： |
| 54 | + - 项目 JDK 设置 |
| 55 | + - 项目 Facet 加入 Spring 配置 |
54 | 56 |
|
55 | | - |
| 57 | +--- |
56 | 58 |
|
57 | | -> * 如上图所示，引入依赖包支持 `jar` 包和目录。以及已经导入项目的 `Libraries` 中的依赖包。多 Module 的项目还可以依赖其他 Module。 |
58 | | -
|
59 | | - |
60 | | - |
61 | | -> * 由于我们刚刚去掉了红圈中的所有依赖包，所以我们现在还需要导入依赖包。到导入之前我们先把项目的 `lib` 作为一个总的依赖包进行放置到项目 `Libraries` 中。如上图 Gif 演示，就是把 `lib` 目录转换成一个依赖包。这样的好处是，当我们项目有新添加依赖包，我们只要放置在 `lib` 目录下即可自动被项目引入，原因就是因为我们这里引的是目录，而不是一个一个依赖包。 |
62 | | -
|
63 | | - |
64 | | - |
65 | | -> * 如上图标注 1 所示，引入刚刚放置好的 `Libraries` 下 `lib` 依赖包。 |
66 | | -
|
67 | | - |
68 | | - |
69 | | -> * 对于传统的 Java Web 项目，我们一般还需要指定配置 web.xml 位置。如上图 Gif 演示，这个一般在 `Facts` 中进行配置。`Facts` 可以理解为用于配置项目的框架区，在这里管理项目使用的框架配置文件。这个是 IntelliJ IDEA 特有的一个配置点。 |
70 | | -> * 除了 web.xml 一般我们要配置外，其他一些框架，即使我们不在这里配置也是不会影响项目的运行的，但是是有缺点的。比如我们项目中一般都是有 Spring 框架的，而 Spring 是有很多配置文件的，如果我们在这里进行了配置，那你会发现 IntelliJ IDEA 编辑区底部会多出现几个跟 Spring 项目的设置区，原因就是你告诉了 IntelliJ IDEA，你的项目使用了 Spring 框架，那 IntelliJ IDEA 就会出现其对应的配置功能给你。Hibernate 等其他框架道理一样。 |
71 | | -
|
72 | | - |
73 | | - |
74 | | -> * `Artifacts` 也是 IntelliJ IDEA 特有的一个概念，我们可以理解这里是配置项目最终输出结果的地方。比如 Java Web 项目我们一般必备一个配置就是要配置成一个 war 包展开的方式，这样容器才能运行该项目。上图 Gif 演示的就是配置一个 war 包展开的输出结构。其结构是由于前面的几项配置决定，所以如果前面的 Module 配置没有多大问题，这里可以省去一些配置步骤。但是有些时候我们也是需要做一些修改，比如此项目的输出目录默认生成的是错误，我改为了项目中的 `webRoot` 目录。 |
75 | | -> * 该 `Artifacts` 配置，等下在配置 Tomcat 的时候也会引用到，所以这里需要重点注意下。 |
76 | | -
|
77 | | -## Tomcat 配置 |
78 | | - |
79 | | - |
80 | | - |
81 | | -> * 如上图 Gif 所示，为项目整体的一个 Tomcat 配置过程，有些需要特别讲解的，我们将在下面进行分解。 |
82 | | -
|
83 | | - |
84 | | - |
85 | | -> * 如上图弹出层所示，IntelliJ IDEA 支持目前市场上主流的应用容器，所以基本上一个 IntelliJ IDEA 足够我们开发常见的项目。但是这里有一点需要提醒的，IntelliJ IDEA 支持这些容器但是不等同于帮我们自带了这些容器的文件，所以上面的 Gif 演示中，原本我只有引入 Tomcat 7，但是为了这个项目我又引入了 Tomcat 6，而引入的 Tomcat 6 我只是指定了其存放的目录位置 IntelliJ IDEA 自动会识别到。 |
86 | | -
|
87 | | - |
88 | | - |
89 | | -> * 如上图标注 1 所示，我们可以切换随时为项目切换不同的容器。 |
90 | | -> * 如上图标注 2 所示，我们可以指定给运行的容器设置 VM 参数。 |
91 | | -> * 如上图标注 3 所示，这分别是在两种命令下的触发的事件。这个是 IntelliJ IDEA 特有的，也是重点。 |
92 | | -> |
93 | | ->> * `On Update action` 当我们按 `Ctrl + F10` 进行容器更新的时候，可以根据我们配置的这个事件内容进行容器更新。其中我选择的 `Update classes and resources` 事件是最常用的，表示我们在按 `Ctrl + F10` 进行容器更新的时候，我们触发更新编译的类和资源文件到容器中。在 Debug 模式下，这个也就是所谓的 `HotSwap`。这是这种热部署没有 JRebel 插件那样好用。 |
94 | | ->> * `On frame deactivation` 当我们切换 IntelliJ IDEA 到浏览器的时候进行指定事件更新，这个一般是因为 Web 开发的时候，我们需要经常在 IntelliJ IDEA 和各个浏览器之间来回切换测试，所以才有了这种需求。IntelliJ IDEA 是为了帮我们在做这种无聊切换的时候做一些指定事情。当然了，如果切换过于频繁，这个功能还是很耗资源的，所以我设置的是 `Do nothing` 表示切换的时候什么都不做。 |
95 | | -> * 如上图标注 4 所示，默认 Tomcat 的 HTTP 端口是 8080，如果你需要改其端口可以在这里设置。 |
96 | | -> * 如上图标注 5 所示，这个知识点在前面的文章已经有讲过了。这里表示在 Tomcat 容器运行前做什么事情，这里分别了：Make 和 Build Artifacts 操作。如上面 Gif 演示，这里的 `Build Artifacts` 是我们在 `Deployment` 选项卡中添加了 Artifact 之后自动出现的。 |
97 | | -
|
98 | | -## Tomcat 启动 |
99 | | - |
100 | | -> * 通过上面的配置，IntelliJ IDEA 环境配置算是配置好了，现在配置下该项目相关的。 |
101 | | -> * 打开你的 Mysql，执行下面脚本，创建一个新的数据库和用户： |
102 | | -
|
103 | | -```sql |
104 | | -CREATE DATABASE `jsprun` CHARACTER SET utf8; |
105 | | -CREATE USER 'jsprun'@'localhost' IDENTIFIED BY 'jsprun'; |
106 | | -GRANT ALL PRIVILEGES ON jsprun.* TO 'jsprun'@'localhost'; |
107 | | -FLUSH PRIVILEGES; |
108 | | -``` |
109 | | - |
110 | | -> * 切换到上面新建的 `jsprun` 数据库中执行项目中这个数据脚本，文件位置：`JspRun\WebRoot\install\jsprun_zh_CN.sql`。 |
111 | | -> * 修改 `JspRun\WebRoot\config.properties` 文件中的几个属性为下面内容： |
112 | | -> * `dbuser = jsprun` |
113 | | -> * `dbpw = jsprun` |
114 | | -
|
115 | | - |
116 | | - |
117 | | -> * 如上图 Gif 演示，我们缺少引入 Tomcat 的依赖包。 |
118 | | -
|
119 | | - |
120 | | - |
121 | | -> * 如上图 Gif 演示，我们引入 Tomcat 的依赖包之后，可以运行该项目。 |
122 | | -
|
123 | | - |
124 | | - |
125 | | -> * 如上图所示，为最终项目运行效果图。 |
126 | | -
|
127 | | -## Tomcat 停止 |
128 | | - |
129 | | - |
130 | | - |
131 | | -> * 如上图所示，停止按钮是要按两次，第一按完出现一个骷髅头并不是停止，需要再点击一次。 |
132 | | -> * 有时候即使点了两次，Tomcat 容器也不一定能完全停掉，这时候很容易出现端口被占用的操作，这时候你需要打开系统的资源管理器，手动 kill 系统上所有的 java 进程。 |
133 | | -
|
134 | | -## 输出 war 压缩包 |
135 | | - |
136 | | - |
137 | | - |
138 | | -> * 如上图 Gif 所示，除了在 Artifacts 中需要配置，还需要在容器中也跟着配置，这样在启动容器的时候才会输出一个 war 压缩包。 |
139 | | -> * 通过配置，我们也知道 war 的压缩包本质是根据展开的 war 输出包进行压缩的得来。 |
| 59 | +- 代码相关： |
| 60 | + - 简单讲解 pom.xml 文件 |
| 61 | + - 用 IntelliJ IDEA 的 Database 初始化数据库 |
| 62 | + - 单元测试 |
| 63 | + - 启动 Tomcat 加上 Make Project 事件 |
| 64 | + - 访问 Controller 演示 Debug |
| 65 | + - 讲解 Controller 中代码左侧的各个按钮效果 |
| 66 | + - JSP 页面直接点击请求地址直接跳转到 Controller |
| 67 | + - 静态资源映射特别提醒下，比如你做图片上传等等，如果你没有映射好可能都会遇到 404 |
| 68 | + - 查看 Druid 提供监控 |
| 69 | + - 演示用 Mybatis 插件自动生成代码 |
0 commit comments