搭建Maven项目

  • 在IDEA中配置Maven
  • 创建Maven工程(带你深入理解Maven)
  • 创建Web的Maven工程(详细分析各种问题)
  • 不使用原型(骨架)创建一个项目



在IDEA中配置Maven

使用IDEA工具进行maven项目的搭建

我们需要注意的是:Maven和IDEA在版本上存在一些兼容性问题,因为要合理的选择Maven和IDEA的版本,一般来讲都是高版本的IDEA兼容低版本的Maven,也就是说,IDEA的版本尽量要高,我现在用的版本是2020.1的idea和3.6.3的maven。

maven项目创建步骤 maven项目搭建_maven项目创建步骤


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

创建Maven工程(带你深入理解Maven)

new project中找到Maven

需要等待一会,它会加载骨架。

对于骨架archetype就跟模板是差不多的。

maven项目创建步骤 maven项目搭建_maven_02


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

maven项目创建步骤 maven项目搭建_xml_03


点击下一步

maven项目创建步骤 maven项目搭建_idea_04


上面的版本号不用管

maven项目创建步骤 maven项目搭建_maven_05


注意这里maven的安装目录和配置文件要选好或者确认好。

下面的Properties就是这个项目的配置情况,你可以在这里确认一下。

点击finish。插件下载中,需要等待一会。

这里提一下,第一创建maven时,会提示需要下载

maven项目创建步骤 maven项目搭建_maven_06


最后提示项目创建成功

maven项目创建步骤 maven项目搭建_idea_07


项目创建完的界面是这样

maven项目创建步骤 maven项目搭建_java_08


它自动打开了pom.xml文件,这个文件就是整个项目的核心文件。

当前的文件中的配置都是来自quickstart这个骨架的。现在我们来看一下创建的目录

maven项目创建步骤 maven项目搭建_idea_09


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

maven项目创建步骤 maven项目搭建_maven项目创建步骤_10


点击一下修改即可。

如果没有这个提示也别慌,我们找到view-tool windows-maven

maven项目创建步骤 maven项目搭建_java_11


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

maven项目创建步骤 maven项目搭建_maven项目创建步骤_12


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

maven项目创建步骤 maven项目搭建_maven项目创建步骤_13


蓝色里面写源码,绿色的写测试。

对于代码的运行,与Java项目都是一样的,

我这里提一下测试,测试方法上面有个Test注解

maven项目创建步骤 maven项目搭建_xml_14


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

maven项目创建步骤 maven项目搭建_java_15


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

maven项目创建步骤 maven项目搭建_maven项目创建步骤_16


答案就在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的,别选错了。

maven项目创建步骤 maven项目搭建_maven项目创建步骤_17


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

maven项目创建步骤 maven项目搭建_java_18


填写maven安装目录,setting配置文件,仓库位置,并确认项目信息。创建成功控制台如下显示

maven项目创建步骤 maven项目搭建_maven_19

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

maven项目创建步骤 maven项目搭建_idea_20


现在要将目录补齐:

右键找到新建目录

maven项目创建步骤 maven项目搭建_maven_21


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

maven项目创建步骤 maven项目搭建_xml_22


现在目录结构是这样:

maven项目创建步骤 maven项目搭建_idea_23


如果不提示你,你也可以手动创建,但是,你的目录名必须跟这个一样,一个字母都不能差,因为这个规定的。还有,创建完的目录一定是蓝的绿的,还有resources都需要跟我图片中一样,你可以这么调:

选择目录右键找到Mark Directory as ,选择对应的颜色或样式。

maven项目创建步骤 maven项目搭建_java_24


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

maven项目创建步骤 maven项目搭建_xml_25


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

maven项目创建步骤 maven项目搭建_xml_26


如何解决?很简单,从其他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项目创建步骤 maven项目搭建_maven_27


现在我们的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项目创建步骤 maven项目搭建_idea_28


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

maven项目创建步骤 maven项目搭建_idea_29


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

maven项目创建步骤 maven项目搭建_maven_30


最后粘贴到我们的pom.xml中的依赖中就可以了

别忘记点击转换,这样新的配置才能生效。

转换后我们的类库也自动添加了对应的jar包

maven项目创建步骤 maven项目搭建_java_31


现在,我可以使用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:

maven项目创建步骤 maven项目搭建_java_32


与javaee项目一样的配置

maven项目创建步骤 maven项目搭建_maven项目创建步骤_33


maven项目创建步骤 maven项目搭建_idea_34


可以自己修改虚拟路径

maven项目创建步骤 maven项目搭建_idea_35

然后可以回到server这一栏确认一下,点击ok

启动服务器测试吧!

maven项目创建步骤 maven项目搭建_maven_36


maven项目创建步骤 maven项目搭建_maven_37


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

maven项目创建步骤 maven项目搭建_java_38


这个过程有些麻烦,我这里总结一下:

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

不使用原型(骨架)创建一个项目

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

maven项目创建步骤 maven项目搭建_maven_39


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

maven项目创建步骤 maven项目搭建_maven_40


这里的目录需要我们手动补全。

需要改配置文件的位置和本地仓库

maven项目创建步骤 maven项目搭建_maven_41


检查一下目录,项目就能使用了。不使用模板的话他直接就建好了,省时间。

maven项目创建步骤 maven项目搭建_maven项目创建步骤_42


上面那两个使用原型例子的项目创建了好几分钟。

然后我们就在pom.xml中添加我们需要的依赖。其实创建maven项目的模板都是一回事,少了可以自己添。