【maven】入门教程

一：Maven简介

1、Maven是什么？

　　是一个跨平台的项目管理工具。使用java语言开发(Maven 3.3+ require JDK 1.7 or above to execute)
2、 为什么使用Maven？
2.1 Maven主要有两大功能：依赖管理、项目构建。
　　依赖可以理解成jar包。
　　项目构建包括以下环节：清理、编译、测试、报告、打包、部署
　　项目构建的方式对比如下：eclipse ant maven
　　eclipse：使用eclipse进行项目的构建，相对来说，步骤零散，不好操作
　　ant：是一个专门的项目构建工具，通过一些配置来完成项目构建，这些配置要明确的告诉ant，源码包在哪？目标class文件应存放在哪？资源文件应该在哪？
　　maven：是一个项目管理工具，通过使用maven,可以对项目进行快速简单的构建，不需要告诉maven很多信息，但需要按照maven的规范去进行代码的开发，也就是说maven是有约束的。
2.2 官网地址和官方包目录结构
　　官网： http://maven.apache.org
　　maven官方压缩包的目录结构

二：配置Maven运行环境

　　1、配置Maven环境变量(MAVEN_HOME和path)

　　测试maven是否安装成功：在系统命令行中执行mvn -v

三：maven仓库

　　在 Maven 的术语中，仓库是一个位置（place）。

　　Maven 仓库是项目中依赖的第三方库，这个库所在的位置叫做仓库。

　　在 Maven 中，任何一个依赖、插件或者项目构建的输出，都可以称之为构件。

　　Maven 仓库能帮助我们管理构件（主要是JAR），它就是放置所有JAR文件（WAR，ZIP，POM等等）的地方。

Maven 仓库有三种类型：

• 本地（local）
• 中央（central）
• 远程（remote）

---

本地仓库

Maven 的本地仓库，在安装 Maven 后并不会创建，它是在第一次执行 maven 命令的时候才被创建。

运行 Maven 的时候，Maven 所需要的任何构件都是直接从本地仓库获取的。如果本地仓库没有，它会首先尝试从远程仓库下载构件至本地仓库，然后再使用本地仓库的构件。

默认情况下，不管Linux还是 Windows，每个用户在自己的用户目录下都有一个路径名为 .m2/respository/ 的仓库目录。

Maven 本地仓库默认被创建在 %USER_HOME% 目录下。要修改默认位置，在 %M2_HOME%conf 目录中的 Maven 的 settings.xml 文件中定义另一个路径。

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 
   http://maven.apache.org/xsd/settings-1.0.0.xsd">
      <localRepository>C:/MyLocalRepository</localRepository>
</settings>　

当你运行 Maven 命令，Maven 将下载依赖的文件到你指定的路径中。

---

中央仓库

Maven 中央仓库是由 Maven 社区提供的仓库，其中包含了大量常用的库。

中央仓库包含了绝大多数流行的开源Java构件，以及源码、作者信息、SCM、信息、许可证信息等。一般来说，简单的Java项目依赖的构件都可以在这里下载到。

中央仓库的关键概念：

• 这个仓库由 Maven 社区管理。
• 不需要配置。
• 需要通过网络才能访问。

要浏览中央仓库的内容，maven 社区提供了一个 URL：http://search.maven.org/#browse。使用这个仓库，开发人员可以搜索所有可以获取的代码库。

---

远程仓库

如果 Maven 在中央仓库中也找不到依赖的文件，它会停止构建过程并输出错误信息到控制台。为避免这种情况，Maven 提供了远程仓库的概念，它是开发人员自己定制仓库，包含了所需要的代码库或者其他工程中用到的 jar 文件。

举例说明，使用下面的 pom.xml，Maven 将从远程仓库中下载该 pom.xml 中声明的所依赖的（在中央仓库中获取不到的）文件。

<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.companyname.projectgroup</groupId>
   <artifactId>project</artifactId>
   <version>1.0</version>
   <dependencies>
      <dependency>
         <groupId>com.companyname.common-lib</groupId>
         <artifactId>common-lib</artifactId>
         <version>1.0.0</version>
      </dependency>
   <dependencies>
   <repositories>
      <repository>
         <id>companyname.lib1</id>
         <url>http://download.companyname.org/maven2/lib1</url>
      </repository>
      <repository>
         <id>companyname.lib2</id>
         <url>http://download.companyname.org/maven2/lib2</url>
      </repository>
   </repositories>
</project>

---

Maven 依赖搜索顺序

当我们执行 Maven 构建命令时，Maven 开始按照以下顺序查找依赖的库：

• 步骤 1 － 在本地仓库中搜索，如果找不到，执行步骤 2，如果找到了则执行其他操作。
• 步骤 2 － 在中央仓库中搜索，如果找不到，并且有一个或多个远程仓库已经设置，则执行步骤 4，如果找到了则下载到本地仓库中以备将来引用。
• 步骤 3 － 如果远程仓库没有被设置，Maven 将简单的停滞处理并抛出错误（无法找到依赖的文件）。
• 步骤 4 － 在一个或多个远程仓库中搜索依赖的文件，如果找到则下载到本地仓库以备将来引用，否则 Maven 将停止处理并抛出错误（无法找到依赖的文件）。

Maven 阿里云(Aliyun)仓库

Maven 仓库默认在国外， 国内使用难免很慢，我们可以更换为阿里云的仓库。

第一步:修改 maven 根目录下的 conf 文件夹中的 setting.xml 文件，在 mirrors 节点上，添加内容如下：

<mirrors>
    <mirror>
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
      <mirrorOf>central</mirrorOf>        
    </mirror>
</mirrors>

本地仓库、中央仓库、远程库(私服)关系统图：

3.3JDK版本配置
默认maven的jdk编译版本不是自己安装的1.8版本。需要进行版本配置，修改settings.xml 如下

3.4mirror 镜像配置
镜像就相当于是中央仓库的一个副本,内容和中央仓库完全一样。目前有不少国内镜像，其中阿里云算是比较稳定的，同时也能保证下载速度

修改settings.xml如下：
<mirror>
　　<id>alimaven</id>
　　<name>aliyun maven</name>
　　<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
　　<mirrorOf>central</mirrorOf>
</mirror>

四：Maven项目的生命周期

在maven中存在"三套"生命周期，每一套生命周期相互独立，互不影响。在一套生命周期内,执行后面的命令则前面操作会自动执行。
CleanLifeCycle：清理生命周期
　　clean
DefaultLifeCycle：默认生命周期
　　compile、test、package、install、deploy
SiteLifeCycle：站点生命周期
　　site(生成html文档描述项目的一些信息)

五：eclipse集成Maven

第一步：安装m2e插件。将插件拷贝到eclipse的dropins目录下，重启Eclipse

第二步：设置maven的安装路径(maven解压路径)

第三步：修改User Settings 指定本地仓库(settings.xml本地仓库修改后，必须先执行updata settings)

六：Maven项目之间的关系

1、依赖[具有传递性]
在工程之中需要依赖各种各样的jar包，也可能需要依赖其他的maven工程打包好的包。这个时候就需要在pom.xml中使用依赖关系进行配置。
例子：让Maven02项目依赖与Maven01项目，在Maven02项目添加Maven01的坐标信息

方法一：进入Maven01项目中复制gav坐标信息到Maven02项目中
方法二：选中Maven02项目右击 =>Maven =>Add Dependency =>OK 自动生成maven01项目的gav坐标
2、继承 
继承为了消除重复，我们把很多相同的配置提取出来。所以maven提供了一个父类maven项目(新建类型为pom的maven工程Parent)来装所有公共使用的jar，只要继承都可以使用。
例子：让Maven02项目继承Maven03项目，在Maven02项目添加Maven03的坐标信息

3、聚合(拆分：将每一层代码放到一个工程里面，降低耦合度，提高可复用性，为其他工程依赖。然后对拆分后的项目进行聚合)
　　如果我们想一次构建多个项目模块,那我们就需要对多个项目模块进行聚合。这样做，我们只需要对父工程进行mvn install命令，它就会依次把继承依赖的所有工程都自动执行mvn compile test package install命令了。
创建好的父工程目录中只有pom.xml，可以判断出父工程不进行编码。
父工程的作用：项目需要的依赖信息在父工程的pom文件中定义，子模块继承即可将子模块聚合到一起

七：创建War类型Maven项目

1、选择simple project 进行创建 =>打包方式选择war

2、添加web.xml =>webapp下

方法一：从以前的项目拷贝web.xml
方法二：手动创建 =>创建文件夹WEB-INF,添加web.xml
方法三：选中项目右击 =>Java EE Tools =>Generte Deployment Descriptor Stub(自动生成web.xml)

添加web.xml后报错信息就自动消失了

3、war项目运行时必须依赖的几个jar，不然jsp页面创建出来就会报错

在项目的pom.xml文件中添加一些必要的依赖jar =>servlet and jsp

保存后就报错信息自动消失

4、<dependency> 标签
依赖servlet-api时需要配置<scope>
5、<scope>四个属性
依赖范围scope（compile estprovided untime）

说明：如果使用到tomcat自带jar包，将项目中依赖范围设置成provided
6、运行项目
maven项目可以在本地tomcat中运行，也可以在pom.xml中添加tomcat插件，配置插件内容,并运行。编写一个jsp页面，查看运行效果。

运行：选中项目=>Run As =>Maven build..

观察控制台Tomcat加载信息

Google运行 http://localhost:8080/

八：创建聚合项目

1、不是写Maven一定需要写聚合项目，只是通过聚合项目来演示SSM搭建过程。具体根据需求来确定Maven项目的粒度
2、项目结构

例子：改造ssm整合项目成maven聚合项目
1：首先创建一个父工程，打包方式选择pom
2：选择父工程 =>创建子模块 =>Maven Module =>打包方式除controller打包成war,外其他的都是jar
2-1：pojo

2-2：mapper(会报错，mapper需要依赖pojo)

注意：mapepr操作的是持久层,需要导入一些配置文件等

2-3：service

2-4：controller(打包方式创建成war)

web.xml 一些跳转jsp页面

全部完成后打开父项目的pom.xml文件会多出<modules>标签

3：运行项目(controller 或者 parent)
选中ssm-parent =>Run As =>Maven install 存放一份到本地仓库 出现以下截图就说明构建项目成功

如果出现报错信息下图

就去把Installed JREs =>换成JDK =>重新Maven install

4：运行maven项目(Run As =>Maven build..)
观察console =>Google运行测试 =>数据库确认

九：私服安装及应用

1、私服安装 
1.1下载安装包 
1.2进入解压后的bin目录下，打开命令窗口，输入命令：nexus.exe /run 运行(注意目录中不能有中文) 
1.3访问私服 http://localhost:8081/ 登录私服：admin/admin123 默认用户名和密码
2、私服仓库类型 
Hosted：宿主仓库。存放本公司开发的jar包（正式版本、测试版本、第三方：存在版权问题的jar包,例如oracle） 
Proxy：代理仓库。代理中央仓库、Apache测试版本的jar包。 
Group：组仓库。包含宿主仓库和代理仓库。组仓库比较常用
3、上传本地jar包到私服（会应用） 
3.1认证：在C:UsersAdministrator.m2目录下的settings.xml中配置用户名和密码
<!-- server的账户 --> 
<server> 
　　<id>releases</id> 
　　<username>admin</username> 
　　<password>admin123</password> 
</server> 
<server> 
　　<id>snapshots</id> 
　　<username>admin</username> 
　　<password>admin123</password> 
</server>
3.2配置jar包上传路径：在需要上传的项目的pom.xml中进行配置 

3.3执行maven的deploy命令发布项目到私服(上传)
4、下载jar包到本地仓库(会应用)
4.1 配置镜像：在C:UsersAdministrator.m2目录下的settings.xml中配置 
<mirror> 
　　<id>nexus</id> 
　　<mirrorOf>*</mirrorOf> 
　　<!-- 私服上组仓库的url地址 --> 
　　<url>http://localhost:8081/repository/maven-public/</url> 
</mirror>
4.2 配置模板：在C:UsersAdministrator.m2目录下的settings.xml中配置

<activeProfiles> 
　　<!—激活上面配置的模板--> 
　　<activeProfile>dev</activeProfile> 
</activeProfiles>

　　参考：https://www.runoob.com/maven/maven-repositories.html

　　　　　https://www.cnblogs.com/cao-yin/p/10561012.html