IntelliJ 2016.2 IDEA 中进行 Java Web 项目开发配置

本文介绍 Mac 上 IntelliJ IDEA 2016.2 版本进行 Java Web 开发配置的步骤，并记录一些配置时可能遇到的坑。这里默认大家已经正确安装了 JDK 和 Tomcat。

1. 新建一个 Web Application 项目

1. 打开 IntelliJ，选择新建项目：
   

2. 左边栏选择 Java Enterprise，右侧勾选 Web Application，具体如下：
   

3. 输入项目名：
   

2. 基本配置

2.1 配置输出目录和库目录

1. 在 project/web/WEB-INF 目录下新建两个目录：lib 和 classes，前者用来保存后期引入的 jar 包，后者用于存放编译输出的文件：
   

2. 点击右上角的方块按钮：
   

3. 在 Modules > Paths 中设置编译输出目录为之前创建的 classes 文件夹，如下图所示：
   

4. 在 Modules > Dependencies 中点击下方加号按钮，将之前创建的 lib 文件夹添加进库目录（之后选择 Jar Directory）：
   

5. 在 Artifacts > Output Layout 中，将右侧 Available Elements 中的 lib 文件夹加入到左侧，使得 lib 中的文件会在编译的时候输出：
   

2.2 添加部署目录

1. Tomcat 目录下有一个 webapps 文件夹，是服务启动的根目录，类似于 Apache 的 htdocs。当启动 Tomcat 服务时，访问 localhost:8080 相当于访问 webapps 目录；

2. 如果我们把项目输出的文件放到 webapps 中的项目文件夹中（如：/myproject），就可以通过访问 localhost:8080/myproject 的方式访问到这一项目；

3. IntelliJ 默认的部署目录是当前工程目录下的 out 文件夹。即在写好代码并点击右上角的运行按钮后，IntelliJ 会将项目文件输出到当前项目目录下的 out 文件夹而不是 webapps 中，也就意味着，此时如果采用手动启动 Tomcat 服务的方式，是无法通过访问 localhost:8080/myproject 访问项目的；

这里修改 Artifacts > Output Directory 为 webapps/myproject：

2.3 端口和 Tomcat 设定

1. 点击右上角的 Edit Configurations：
   

2. 设定启动端口，这里可以取消勾选 Open Brwoser After launch 选项（是否在点击运行按钮后自动打开浏览器并访问项目）
   

3. 点击 Configure 按钮，设置 Tomcat 位置为安装的 Tomcat 路径。如果在新建项目界面时已经设定了 Tomcat，则这里无需再设置：
   

4. 在 deployment 中设定项目 Context：
   

如这里设定为 /test 则点击运行按钮后，访问 localhost:8080/test 即可访问该项目。

3. 备忘

1. 如果使用 IntelliJ 的运行按钮启动的 Tomcat，且没有修改默认端口（即和 Tomcat 默认端口 8080 一致），也没有修改项目 Context（仍为 /），则可能会使得设置的 servlet 无法生效，即在访问设定的 url-pattern 时提示 404 错误。解决方法是在 IntelliJ 中修改默认端口号、修改默认 Context，或是在修改了部署目录后，使用手动方式启动 Tomcat，并访问该项目；

2. Servlet 的设置方式在 Servlet 3.0 之后除了修改 web.xml 文件，还可以以添加 servlet 注解的方式设置：
   

3. 查看 Servlet 版本的方式是解压 Tomcat 目录下的 lib/servlet-api.jar，并查看解压后的 META-INF/MANIFEST.MF 文件：
   

4. 手动启动 Tomcat 的方法：
   cd you/path/to/tomcat 然后执行 ./startup.sh 或是 ./catalina.sh start。当然，需要给这两个文件以执行权限：sudo chmod a+x catalina.sh startup.sh。

5. 在某一项目中进行全局设置：File > Other Setting > DefaultSetting；

4. 参考

1. intellij idea 创建servlet的时候如何自动更新web.xml文件 - 知乎

2. IntelliJ IDEA 14.x 与 Tomcat 集成，并运行Web项目 - 推酷

3. java web开发中，如何查看JSP和Servlet版本 - 163博客

4. Mac OS X上IntelliJ IDEA 13与Tomcat 8的Java Web开发环境搭建 - 博客园

5. javaweb学习总结(五)——Servlet开发(一) - 博客园

6. Intellij IDEA的基本使用 - CSDN