❤️“一篇文章教你解决maven”从环境到应用--非常值得阅读❤️

本篇文章主要是关于maven从环境配置到可以在IDEA中使用，基本上遇到的问题也有提及。如果没有提到的欢迎来交流

在javaweb开发中需要手动导入大量的jar包，而maven就是帮我们导入和配置这个jar包，

1.maven项目架构管理工具

我们目前用它来就是为了导入jar包的。

核心思想：约定大于配置。（有约束不要去违反）

Maven会规定好自己如何去编写我们的java代码，必须要按照这个规范来；

2.下载安装Maven

官网：https://maven.apache.org/

解压bin

3.配置环境变量

在系统环境变量中配置如下配置

• M2_HOME：maven目录下的bin目录
• MAVEN_HOME：maven的目录
• 在系统的path中配置%MAVEN_HOME%\bin

path中添加

cmd中输入mvn -version 出现自己的maven版本就是配置好了

4.阿里云镜像

点击打开conf中的setting.xml文件找到mirrors

• 镜像：mirrors

  • 作用：加速我们的下载

  • 国内建议使用阿里云的镜像

  • //将下面的放在图示中的位置
    <mirror>
            <id>alimaven</id>
            <mirrorOf>central</mirrorOf>
            <name>aliyun maven</name>
            <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
    </mirror>
    

    <mirror>
            <id>nexus-aliyun</id>
            <mirrorOf>*,!jeecg,!jeecg-snapshots</mirrorOf>
            <name>Nexus aliyun</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public</url>
    </mirror>
    

5.本地仓库

有本地就有远程仓库。

建立一个本地的仓库：localRepository

默认是default下的目录。可以自己创建一个文件夹用于存放

6.在idea中使用Maven

6.1启动IDEA

6.2创建一个Maven项目

sdk：选择java的安装目录

勾选是可以使用Maven的模板

下面这个地方是项目名和保存的位置，项目名最好加上-要不然太多会看起来不好

finish即可，之后在右下角会有这个，要点击Enable Auto-Import这个是自动导入包。导入前一定要有阿里云下载。否则会通过国外的链接下载，会很慢

6.3等待项目初始化完毕。

6.4观察maven仓库中的变化

6.5IDEA中的Maven设置

File->Settings

注意：经常在idea中出现一个问题，就是项目在自动创建完成后，MavenHome会使用IDEA默认的，这个时候就需要及时改进。

6.6出现这个页面，Maven项目就ok了

7.创建一个普通的Maven项目

• 注意一点，如果在这里增加一个webapp只需要右键点击Add framework support就可以创建出来

这个只有在web应用下才有

8.标记文件夹

有两种方式进行标记

上面的target是java-class

9.在IDEA中配置Tomcat

• 解决警告问题：

而为什么会出现这个问题，是由于我们访问一个网站，需要指定一个文件夹的名字

完成上述步骤后，IDEA中的Tomcat就会亮

启动

这里访问到的内容就是默认的index.jsp中的内容

• maven侧边栏

clean一下会把左边的target清理掉

10.pom文件

新版的idea 2020.X，不能设置自动导入，我们修改pom文件后在后上方有个小图案是m右下角有个刷新的，点击即可。

pom.xml是Maven的核心配置文件

<?xml version="1.0" encoding="UTF-8"?>
<!--Maven版本和头文件-->
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
<!--之前配置的GAV-->
  <groupId>com.hxl</groupId>
  <artifactId>javaweb-01-maven</artifactId>
  <version>1.0-SNAPSHOT</version>
<!--Package：项目的打包方式
  jar：java应用
  war：javaWeb应用-->
  <packaging>war</packaging>

  <name>javaweb-01-maven Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

<!--  配置-->
  <properties>
<!--    项目的默认构建编码-->
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!--    编码版本，可以修改为1.8-->
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

<!--  项目依赖-->
  <dependencies>
<!--    具体依赖的jar包配置文件-->
<!--    Maven的高级之处在于他会帮你导入这个jar包所依赖的其他jar包-->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>

<!--  项目构建用的东西-->
  <build>
    <finalName>javaweb-01-maven</finalName>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.1.0</version>
        </plugin>
        <!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.22.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-war-plugin</artifactId>
          <version>3.2.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

• Maven由于它的约定大于配置，我们之后可能会遇到我们写的配置文件无法被导出或者生效的问题，解决方案：

  <!-- 在build中配置resources，来防止我们资源导出失败的问题-->  
  <build>
          <resources>
              <resource>
                  <directory>src/main/resources</directory>
                  <includes>
                      <include>**/*.properties</include>
                      <include>**/*.xml</include>
                  </includes>
                  <filtering>true</filtering>
              </resource>
              <resource>
                  <directory>src/main/java</directory>
                  <includes>
                      <include>**/*.properties</include>
                      <include>**/*.xml</include>
                  </includes>
                  <filtering>true</filtering>
              </resource>
          </resources>
  </build>
  

11.IDEA中的操作

12.解决遇到的问题

• Maven3.8.2爆红

  • 我们发现在setting.xml文件中我们配置了本地仓库和阿里云镜像。看到没问题之后我们直接修改环境变量
  • 将版本降一下。需要改的位置是M2_HOME和MAVEN_HOME

• Tomcat闪退

  • 点击start.bat，点进去我们往下看会看到java环境的一些配置，由于环境不对会导致错误
  • 可以在最后:end前加一个pause

• IDEA中每次都要重复配置MAVEN

  在IDEA中的全局默认配置中去配置。

  

  
  

  在这个地方配置后，以后每次都是这样了。

• Maven项目中Tomcat无法配置

• Maven默认web项目中的web.xml版本太老了

  

  我们可以查看下面的路径

  

  看一下里面的版本，将webapp里面的和tomcat的一致

• Maven仓库的使用

  • Maven仓库地址：https://mvnrepository.com/

  • 在搜索栏进行搜索；如果搜不到就查看一些其他的，还搜不到这时候就想一下，这是用Tomcat启动的，那是不是就去Tomcat中找一下相关的，然后大概的锁定，再去Maven中去搜，一般搜出来用的最多的就是正确的。点进去可以下载jar包也可以看到maven的依赖

  • 以HttpServlet为例，发现爆红我们在Tomcat中找到关于servlet的，再去Maven仓库中查找

    <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <!-- 这个是个范围，要把他删掉-->
        <scope>provided</scope>
    </dependency>
    

    再进去的时候缺少点东西。我们再下载一个jsp-api。我们进去的时候看一下下载哪一个，会看到有一个是2011年更新的，我们选择2018年更新的那个。

    <dependency>
          <groupId>javax.servlet.jsp</groupId>
          <artifactId>javax.servlet.jsp-api</artifactId>
          <version>2.3.3</version>
        </dependency>
    

    再次进去的时候就可以了。

• 我们接下来创建一个页面

  

  package com.hxl;
  
  import javax.servlet.ServletException;
  import javax.servlet.http.HttpServlet;
  import javax.servlet.http.HttpServletRequest;
  import javax.servlet.http.HttpServletResponse;
  import java.io.IOException;
  import java.io.PrintWriter;
  
  public class HelloServlet extends HttpServlet {
      @Override
      protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
          //响应的类型html
          resp.setContentType("text/html");
          //这个地方是设置编码，因为有可能进入浏览器后成乱码
          resp.setCharacterEncoding("utf-8");
          //获取响应的输出流
          PrintWriter out = resp.getWriter();
          out.println("<html>");
          out.println("<head>");
          out.println("<title>Hello World!</title>");
          out.println("</head>");
          out.println("<body>");
          out.println("<h1>你好呀</h1>");
          out.println("</body>");
          out.println("</html>");
      }
  
      @Override
      protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
          doGet(req, resp);
      }
  }
  

  <!DOCTYPE web-app PUBLIC
   "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
   "http://java.sun.com/dtd/web-app_2_3.dtd" >
  
  <web-app>
    <display-name>Archetype Created Web Application</display-name>
  
  <!--  web.xml中是配置我们web的核心应用-->
  <!--  注册Servet-->
    <servlet>
      <servlet-name>HelloServlet</servlet-name>
      <servlet-class>com.hxl.HelloServlet</servlet-class>
    </servlet>
  <!--  一个Servlet对应一个Mapping：映射-->
    <servlet-mapping>
      <servlet-name>HelloServlet</servlet-name>
  <!--    请求路径-->
      <url-pattern>/hxl</url-pattern>
    </servlet-mapping>
  </web-app>
  

  header.html中是一个测试，可以随便写点内容。

  • 这样启动柜tomcat后，进入localhost:8080，会进入到index.jsp中。进入到localhost:8080/header.html是进入到了header.html中的内容；然后再进入到localhost:8080/hxl中是进入到我们HelloServlet中的内容。