Java工具篇-Maven_02 IDEA搭建Maven项目

---

在IDEA中配置Maven

使用IDEA工具进行maven项目的搭建
我们需要注意的是：Maven和IDEA在版本上存在一些兼容性问题，因为要合理的选择Maven和IDEA的版本，一般来讲都是高版本的IDEA兼容低版本的Maven，也就是说，IDEA的版本尽量要高，我现在用的版本是2020.1的idea和3.6.3的maven。

在设置中找到maven，按图中的步骤，local repository是根据配置文件setting.xml中的对应标签的路径自动修改的。

创建Maven工程（带你深入理解Maven）

new project中找到Maven
需要等待一会，它会加载骨架。
对于骨架archetype就跟模板是差不多的。

如果我们现在想创建一个Java SE的项目，你可以不勾选骨架，自己去做自定义的配置。我们这里勾选骨架，并且找到一个名叫quickstart的骨架

点击下一步

上面的版本号不用管

注意这里maven的安装目录和配置文件要选好或者确认好。
下面的Properties就是这个项目的配置情况，你可以在这里确认一下。
点击finish。

插件下载中，需要等待一会。
这里提一下，第一创建maven时，会提示需要下载

最后提示项目创建成功

项目创建完的界面是这样

它自动打开了pom.xml文件，这个文件就是整个项目的核心文件。
当前的文件中的配置都是来自quickstart这个骨架的。

现在我们来看一下创建的目录

main下是写源码的，同时根据这个骨架自动建好了包。
test中需要是用来测试的。

我们现在将pom.xml的配置修改一下，
我这里把properties标签下的1.7改成1.8

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

这里需要提一下，当我们项目的pom.xml发生变动时（可能修改配置，可能添加新的依赖），idea会提示你重新加载，或者提示project need to imported

点击一下修改即可。
如果没有这个提示也别慌，我们找到view-tool windows-maven

或者在右侧直接找到这个图标，我们会看到这个环形箭头的图标，点一下它也是一样的。

我这么做的目的是让目录变成蓝色和绿色

蓝色里面写源码，绿色的写测试。
对于代码的运行，与Java项目都是一样的，
我这里提一下测试，测试方法上面有个Test注解

点击这个三角形测试，或者右键运行一样的，测试成功如图：

这里在提一个，这个注解@Test的类库，我们发现它自动导入了，这个类库何时导入的呢？

答案就在pom.xml文件中，它这里添加了一个依赖

    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>

根据这个pom.xml文件它自动执行我们的需求。
也就是说，maven的作用是能够帮你编译，测试，打包，部署，运行，除此之外，还会自动清理，初始化，站点生成等，你的需求全放到pom.xml文件，maven根据这个文件全部帮你实现。
这里的pom文件的配置都是当前骨架自带的，你也可以再添加配置，也可以不通过骨架创建maven项目，自定义自己需要的配置。

创建Web的Maven工程（详细分析各种问题）

这次我使用骨架创建一个web项目，我们用的是webapp，注意这里有两个，选maven的，别选错了。

next，依旧是Groupid，ArtifactId分别填公司名，项目名

填写maven安装目录，setting配置文件，仓库位置，并确认项目信息。

创建成功控制台如下显示

创建之后我们发现它的目录是这样的，发现main目录下多个webapp文件夹，这是很熟悉的web项目结构。但是Maven是有一套标准的，main里就是写代码的，我们还需要建一个测试，目录结构需要保持一致，否则编译打包部署这些都是失败的。所以一定要按照这个标准来。

现在要将目录补齐：
右键找到新建目录

我的idea提示我需要建哪些目录，全选创建即可。

现在目录结构是这样：

如果不提示你，你也可以手动创建，但是，你的目录名必须跟这个一样，一个字母都不能差，因为这个规定的。

还有，创建完的目录一定是蓝的绿的，还有resources都需要跟我图片中一样，你可以这么调：
选择目录右键找到Mark Directory as ，选择对应的颜色或样式。

现在对于这个web项目处理还有一个问题，我们找到web.xml配置文件

我们发现它的版本是2.3的，这个版本根本不支持注解。这个原因主要是maven的版本低。

如何解决？很简单，从其他web项目复制替换就可以了，或者直接复制我这里的也可以。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
</web-app>

好了，现在就可以使用注解了。

然而，还有个问题，我们现在创建不了Servlet。这是什么原因呢？相信Javaweb学得好的同学看出来了，就是没有对应的jar包，没有导入Tomcat的类库，Servlet是Tomcat提供的，以前的web项目应当这样：

现在我们的Maven工程类库并没有这两个jar包，好的，你清晰了原因，现在Maven工程如何导入jar呢？注意这里特别重要，这也是个误区，maven工程中的jar不是我们自己手动去导入的，而是用更简洁的方式，写入对应的依赖。

我们打开pom.xml文件，找到dependencies标签，所有的依赖都写在这里

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>

这里原本有一个junit的依赖，它就是我们项目模板中自带的junit的jar包的依赖。
现在我们要加入Servlet的依赖

    <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>

我这里说一下我这个依赖是怎么获取的，一个是你的本地仓库，你可以自己找；一个是私服，就是你公司提供的仓库；还有一个是中央仓库，我这里说一下中央仓库。
中央仓库可以理解为在线仓库，就是大家都能用的，开源的，搜索我们想要的，点进去

找到使用人数最多的版本，我个人认为生态好的问题也少。

这里点击一下maven窗口的内容，自动复制

最后粘贴到我们的pom.xml中的依赖中就可以了
别忘记点击转换，这样新的配置才能生效。
转换后我们的类库也自动添加了对应的jar包

现在，我可以使用Servlet了，我们来试一下

@WebServlet("/myServlet")
public class MyServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        doPost(req,resp);
    }

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        resp.getWriter().write("Hello! This is my first maven for web.");
    }
}

配置tomcat：

与javaee项目一样的配置


可以自己修改虚拟路径

然后可以回到server这一栏确认一下，点击ok
启动服务器测试吧！


我在运行时到了 运行时程序包不存在 对于这个问题，我检查了一下类库是没问题的，然后我发现我的项目目录中没有target，正常的idea是不会这样的，可能我这个2020.1版本问题比较多。解决办法在这里

这个过程有些麻烦，我这里总结一下：

1. 新建，找到maven，勾选骨架，找到webapp骨架，创建工程；
2. 补齐目录，main和test目录，检查目录是否正确，就像本例缺少了target目录是不可以的；
3. 找到web.xml文件并重构。
4. pom.xml文件配置，比如通过添加依赖来给项目导入jar包；
5. 配置tomcat。

不使用原型（骨架）创建一个项目

创建方式都一样，这里我们不勾选骨架就可了。

没有骨架我们这里就是这样的：

这里的目录需要我们手动补全。
需要改配置文件的位置和本地仓库

检查一下目录，项目就能使用了。

不使用模板的话他直接就建好了，省时间。

上面那两个使用原型例子的项目创建了好几分钟。
然后我们就在pom.xml中添加我们需要的依赖。其实创建maven项目的模板都是一回事，少了可以自己添。