title: Maven
tag: maven的使用
categories: 分类
comment: 是否允许评论(true or false)
description: 描述
top_img: https://z3.ax1x.com/2021/10/06/4xq2s1.png
cover: https://z3.ax1x.com/2021/10/06/4xq2s1.png
一 项目基础
1.完成一个java项目,需要做哪些工作
- 分析项目要做什么,知道项目有哪些组成部分
- 设计项目,通过哪些步骤,使用哪些技术,需要多少人,多长时间
- 组件团队,招人、购置设备、服务器、软件、笔记本
- 开发人员写代码。开发人员需要测试自己写的代码。重复多次工作
- 测试人员,测试项目功能是否符合要求
2传统开发项目的问题,没有使用maven管理的项目
- 很多模块、模块之间有关系,手工管理关系,比较繁琐
- 需要很多第三方功能,需要很多jar文件,需要手工从网络中获取各个jar
- 需要管理jar的版本,并且版本要一样
- 管理jar文件之间的依赖,如果你的项目要使用a.jar需要使用b.jar,那么必须先获取b.jar里面的类。
3.需要改进项目的开发和管理,需要maven
- maven可以管理jar文件
- 自动下载jar和他的文档,源代码
- 管理jar直接的依赖,a.jar需要b.jar,maven会自动下载b.jar
- 帮你编译程序,把java编译为class
- 帮你测试你的代码是否正确
- 帮你打包文件,形成jar文件,或者war文件
- 帮你部署项目
4.构建:项目的构建
构建是面向过程的,就是一些步骤,完成项目代码的编译,测试,运行,打包,部署等等。
maven支持的构建包括有:
- 清理,把之前项目编译的东西清理掉,为新的编译代码提供准备
- 编译,把程序源代码编译为执行代码,java-class
- 测试,maven可以测试程序代码,验证你的功能是否正确
- 报告,生成测试结果的文件,同时测试很多功能
- 打包,把你的项目中所有的class文件,配置文件等所有资源放到一个压缩文件中,这个压缩文件就是项目的结果文件,通常java程序,压缩文件是jar扩展名的
- 安装,把5中生成的文件jar,war安装到本机仓库
- 部署,把程序安装好可以执行
5 maven核心概念:用好maven,了解这些概念
-
POM:一个文件,名称是pom.xml,pom翻译过来叫做项目对象模型
maven把一个项目当做一个模型使用。控制maven构建项目的过程,管理jar依赖。
-
约定的目录结构:maven项目的目录和文件的位置都是规定的
-
坐标:是一个唯一的字符串,用来表示资源的
-
依赖管理:管理你的项目可以使用jar文件
-
仓库管理:你的资源存放的位置
-
生命周期(了解):maven工具构建项目的过程,就是生命周期。
6.maven工具的安装和配置
1)需要从maven的官网下载maven的安装包 apache-maven-3.3.9-bin.zip 我用3.8.1
2)解压安装包,解压到一个目录,非中文目录。
子目录 bin :执行程序,主要是mvn.cmd
conf :maven工具本身的配置文件 settings.xml
3)配置环境变量
在系统的环境变量中,指定一个M2_HOME的名称, 指定它的值是maven工具安装目录,bin之前的目录
M2_HOME=D:\work\maven_work\apache-maven-3.3.9
再把M2_HOME加入到path之中,在所有路径之前加入 %M2_HOME%\bin;
4)验证,新的命令行中,执行mvn -v
注意:需要配置JAVA_HOME ,指定jdk路径
C:\Users\Administrator>mvn -v
出现如下内容,maven安装,配置正确。
Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-11T00:41:4
Maven home: D:\work\maven_work\apache-maven-3.3.9
Java version: 1.8.0_40, vendor: Oracle Corporation
Java home: C:\java\JDK8-64\jre
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 7", version: "6.1", arch: "amd64", family: "dos"
二 Maven基础知识
1.maven约定的目录结构,约定是大家都遵循的一个规则。
每一个maven项目在磁盘中都是一个文件夹(项目-Hello)
每一个maven项目在磁盘中都是一个文件夹(项目-Hello)
Hello/
-------/src
------/main #放你主程序java代码和配置文件
----------/java #你的程序包和包中的java文件
----------/resources #你的java程序中要使用的配置文件
------/test #放测试程序代码和文件的(可以没有)
----------/java #测试程序包和包中的java文件
----------/resources #测试java程序中要使用的配置文件
---/pom.xml #maven的核心文件(maven项目必须有)
2.疑问: 命令行中 mvn compile 指令是编译src/main目录下的所有java文件的。
-
命令行中为什么有下载现象
maven工具执行的操作需要很多插件(java类-jar文件)完成
-
下载什么东西了
jar文件-叫做插件-插件用来完成某些功能
3)下载的东西存放到哪里了。 默认仓库(本机仓库): C:\Users\(登录操作系统的用户名)Administrator\.m2\repository Downloading: https://repo.maven.apache.org/maven2/org/apache/maven/maven-plugin-parameter-documenter-2.0.9.pom
https://repo.maven.apache.org :中央仓库的地址
执行mvn compile, 结果是在项目的根目录下生成target目录(结果目录,与src同级), maven编译的java程序,最后的class文件都放在target目录中 设置本机存放资源的目录位置(设置本机仓库): 1. 修改maven的配置文件, maven安装目录/conf/settings.xml 先备份 settings.xml 2. 修改 <localRepository> 指定你的目录(不要使用中文目录) D:\work\maven_work\maven_repository 我的:D:\JavaEnvironment\Maven\maven_repository 【记得上面的 \ 统统得改成 / 】
3.仓库
-
仓库是什么:仓库是存放东西的,存放maven使用的jar和我们项目使用的Jar
-
> maven使用的插件(各种jar)
> 我项目使用的jar(第三方的工具)
2)仓库的分类
本地仓库, 就是你的个人计算机上的文件夹,存放各种jar
远程仓库, 在互联网上的,使用网络才能使用的仓库
①:中央仓库,最权威的, 所有的开发人员都共享使用的一个集中的仓库,
https://repo.maven.apache.org :中央仓库的地址
②:中央仓库的镜像:就是中央仓库的备份, 在各大洲,重要的城市都是镜像。
————————————————
③:私服,在公司内部,在局域网中使用的, 不是对外使用的。
3)仓库的使用,maven仓库的使用不需要人为参与
如: 开发人员需要使用mysql驱动--->maven首先查本地仓库--->私服--->镜像--->中央仓库
4.pom:项目对象模型,是一个pom.xml文件
![img](https://img-blog.csdnimg.cn/c03ec3e7456a46ba99f5f8f8e1fe3c26.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FhYV9oYW8=,size_16,color_FFFFFF,t_70#pic_center
-
坐标:唯一值,在互联网中唯一标识一个项目的
公司域名的倒写
自定义项目名称
自定版本号https://mvnrepository.com/ 搜索使用的中央仓库, 使用groupId 或者 artifactId作为搜索条件
-
packaging:打包后压缩文件的扩展名,默认是jar,web应用是war
packaging可以不写,默认是jar
-
依赖
dependencies和dependency,相当于java代码中import
你的项目中要使用的各种资源说明,比如我的项目要使用Mysql驱动
<dependencies> <!--配置依赖 相当于java代码中 import --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.9</version> </dependency> </dependencies>
-
properties:设置属性
-
build:maven在进行项目的构建时,配置信息,例如指定编译java代码使用的jdk的版本等
5.maven生命周期,maven的命令,maven的插件
maven的生命周期:就是maven构建项目的过程,清理,编译,测试,报告,打包,安装,部署
maven的命令:maven独立使用,通过命令,完成maven的生命周期的执行
-
单元测试:用的是junit,junit是一个专门为用于测试的框架(工具)
junit测试的内容:测试的是类中的方法,每一个方法都是独立测试的
-
使用步骤:
加入依赖,在pom.xml加入单元测试依赖
<!-- 单元测试 --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.11</version> <scope>test</scope> </dependency>
2.在maven项目中的src/test/java目录下,创建测试程序。 推荐的创建类和方法的提示: 1.测试类的名称 是Test + 你要测试的类名 2.测试的方法名称 是:Test + 方法名称 例如你要测试HelloMaven , 创建测试类 TestHelloMaven @Test public void testAdd(){ 测试HelloMaven的add方法是否正确 } 其中testAdd叫做测试方法,它的定义规则 1.方法是public的,必须的 2.方法没有返回值, 必须的 3.方法名称是自定义的,推荐是test + 方法名称 4.在方法的上面加入 @Test 3)mvn compile 编译main/java/目录下的 java 为class文件, 同时把class拷贝到 target/classes目录下面 把main/resources目录下的所有文件 都拷贝到target/classes目录下
插件的配置
Maven的常用命令
Maven对所有的功能提供相对应的命令,要想知道maven都有哪些命令,就需要知道mave有哪些功能。maven的主要三个功能:管理依赖,构建项目,管理项目信息。管理依赖,需要声明就可以自动到仓库下载:管理项目信息其实就是生成一个站点文档,一个命令就可以解决,maven功能的主体其实就是项目的创建。
Maven提供一个项目构建的模型,把编译、测试、打包、部署等都对应成一个个生命周期阶段,并对每一个阶段提供相应的命令,程序员只需要掌握一小堆命令,就可以完成项目的构建过程。
mvn clean 清理(会删除原来编译和测试的目录,即target目录,但是已经install到仓库里的包不会删除)
mvn compile 编译测试程序(会在当前目录下生成一个target,里边存放编译测试程序之后生成的字节码文件)
mvn test 测试(会生成一个目录surefire-reports ,保存测试结果)
mvn install 安装主程序(会把本工程打包,并且按照本工程的坐标保存到本地仓库中)
mvn deploy 部署主程序(会把本工程打包,按照本工程的坐标保存到本地库中,并且还会保存到私服仓库中,还会自动把项目部署到web容器中)
三、IDEA使用Maven
-
在idea中设置maven,让idea和maven结合使用
idea中内置了maven,但是一般都是不适用内置的,因为内置修改maven的设置不方便。使用自己安装的maven,需要覆盖idea中的默认设置,让idea知道maven安装位置等信息。
配置的入口 ①:配置当前工程的设置, file–settings —Build, Excution,Deployment–Build Tools
–Maven
Maven Home directory: maven的安装目录
User Settings File : 就是maven安装目录conf/setting.xml配置文件
Local Repository : 本机仓库的目录位置--Build Tools--Maven--Runner VM Options : -DarchetypeCatalog=internal JRE: 你项目的jdk -DarchetypeCatalog=internal : maven项目创建时,会联网下载模版文件, 比较大, 使用-DarchetypeCatalog=internal,不用下载, 创建maven项目速度快。 (现在没有other settings了) ②:配置以后新建工程的设置, file--other settings--Settings for New Project
-
使用模板创建项目
1)maven-archetype-quickstart : 普通的java项目
2)maven-archetype-webapp : web工程
添加模板的流程:
这里会需要坐标的三个值,以quickstart为例,直接到这个网址找:https://maven.apache.org/archetypes/maven-archetype-quickstart/summary.htm
进入网址后:可以看到Build Information即为我们需要的坐标值,将坐标值填入上面即可
用maven-archetype-quickstart 模板创建了java项目后得自己手动在main和test添加目录下添加resources文件夹,右键new下面的Directory选中后下面可以选resources类型的文件夹,选中回车就好了。
普通java项目的完整目录:
其中App和AppTest是默认生成的,可以删掉
Web工程的完整目录:
其中main下的java、resource还有test及其下所有文件夹都得自己添加,new Directory后会有提示。
普通java项目的pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<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.kaho</groupId>
<artifactId>ch01-javase-maven</artifactId>
<version>1.0</version>
<!-- 这里指明包的类型 -->
<packaging>jar</packaging>
<properties>
<!-- maven构建项目使用的是utf-8,避免中文的乱码 -->
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!-- 编译java代码使用的jdk版本 -->
<maven.compiler.source>1.8</maven.compiler.source>
<!-- 你的java项目应该运行在什么样的jdk版本 -->
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
<!-- 依赖 -->
<dependencies>
<!-- 单元测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
</dependencies>
<!-- 插件配置管理,这一块自动生成的,可以删掉,写不写都实际存在 -->
<build>
<pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
<plugins>
<!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
<plugin>
<artifactId>maven-clean-plugin</artifactId>
<version>3.1.0</version>
</plugin>
<!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_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-jar-plugin</artifactId>
<version>3.0.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>
<!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
<plugin>
<artifactId>maven-site-plugin</artifactId>
<version>3.7.1</version>
</plugin>
<plugin>
<artifactId>maven-project-info-reports-plugin</artifactId>
<version>3.0.0</version>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>
Web项目的pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<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>
<groupId>com.kaho</groupId>
<artifactId>ch02-maven-web</artifactId>
<version>1.0</version>
<!-- web项目是war文件 -->
<packaging>war</packaging>
<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>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<finalName>ch02-maven-web</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工具窗口
例如:双击clean,则会把左侧目录中的target目录清除
双击compile,则会编译生成target
双击test,则会执行test中的测试代码,如:
双击package,则会将工程打包并生成在target目录下,如:
双击install,就会将工程jar安装到本地仓库中,如:
插件和依赖:
Maven配置web环境
不需要和以往一样,而是用依赖的方式,在pom.xml文件中加入下面代码,这样就可以写servlet程序了
<!-- 加入servlet依赖(servlet的jar)-->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
<!-- jsp的依赖(jsp相关的jar加入进来) -->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.1</version>
<scope>provided</scope>
</dependency>
<!-- Tomcat的依赖,添加后就能在new中就可以找到servlet了 -->
<dependency>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat</artifactId>
<version>8.0.50</version>
<type>pom</type>
</dependency>
注意:如果加入上述代码后会爆红,只需要进入maven工具串口中刷新一下即可。
IDEA中导入模块module
选择项目文件夹,点击OK
导入之后记得在这里设置JDK
四 maven Scope的使用范围
-
依赖范围,使用scope表示的
scope的值有compile,test,provided,默认是compile(所有过程都起作用)
scope:表示依赖使用的范围,也就是在maven构建项目的哪些阶段中起作用
maven构建项目:编译、测试、打包、安装、部署过程
junit的依赖范围是test,即只是在测试过程中起作用
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>a</groupId>
<artifactId>b</artifactId> b.jar 是compile,即所有过程都起作用
<version>4.11</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version> servlet.jar
<scope>provided</scope> 提供者:在编译、测试过程起作用,但打包、安装、部署不需要
</dependency>
在写项目的过程中的用到的所有依赖jar,必须在本地仓库中有。
没有的话必须通过maven下载,包括provided的都必须下载
你在servlet需要继承HttpServlet( provided) , 你使用的HttpServlet是maven仓库中的。
当你的写好的程序, 放到 tomat服务器中运行时, 此时你的程序中不包含servlet的jar
因为tomcat提供了 servlet的.jar
五、maven的常用操作
1.maven的属性设置
设置maven的常用属性
2.maven的全局变量
自定义的属性
1.在 通过自定义标签声明变量(标签名就是变量名)
2.在pom.xml文件中的其它位置,使用 ${标签名} 使用变量的值
自定义全局变量一般是定义 依赖的版本号, 当你的项目中要使用多个相同的版本号,
先在<properties>中使用全局变量定义,再在<version>中使用${变量名}表示这个统一的版本号
3.资源插件
<build>
<resources>
<resource>
<directory>src/main/java</directory><!--所在的目录-->
<includes><!--包括目录下的.properties,.xml 文件都会扫描到-->
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<!--filtering 选项 false 不启用过滤器, *.property 已经起到过滤的作用了 -->
<filtering>false</filtering>
</resource>
</resources>
</build>
在mybatis中一般会用到这个
1. 默认没有使用resources的时候, maven执行编译代码时, 会把src/main/resources目录中的文件拷贝到target/classes目录中。对于src/main/java目录下的非java文件不处理,不拷贝到target/classes目录中
2.我们的程序有需要把一些文件放在src/main/java目录中,当执行java程序时,需要用到src/main/java目录中的文件。需要告诉maven 在 mvn compile 编译 src/main/java目录下的程序时,需要把这些文件一同拷贝到target/classes目录中。此时就需要在 <build> 中加入 <resources>
es>
src/main/java
/*.properties
/*.xml
false
在mybatis中一般会用到这个
```xml
1. 默认没有使用resources的时候, maven执行编译代码时, 会把src/main/resources目录中的文件拷贝到target/classes目录中。对于src/main/java目录下的非java文件不处理,不拷贝到target/classes目录中
2.我们的程序有需要把一些文件放在src/main/java目录中,当执行java程序时,需要用到src/main/java目录中的文件。需要告诉maven 在 mvn compile 编译 src/main/java目录下的程序时,需要把这些文件一同拷贝到target/classes目录中。此时就需要在 <build> 中加入 <resources>