Maven

Maven 的依赖管理

• maven 工程中不直接将 jar 包导入到工程中，而是通过在 pom.xml 文件中添加所需 jar 包的坐标，这样就很好的避免了 jar 直接引入进来，在需要用到 jar 包的时候，只要查找 pom.xml 文 件，再通过 pom.xml 文件中的坐标，到一个专门用于”存放 jar 包的仓库”(maven 仓库)中根据坐标从 而找到这些 jar 包，再把这些 jar 包拿去运行。
• 为了解决上述过程中速度慢的问题，maven 中也有索引的概念，通 过建立索引，可以大大提高加载 jar 包的速度，使得我们认为 jar 包基本跟放在本地的工程文件中再 读取出来的速度是一样的

Maven 本地仓库的配置

• 在 MAVE_HOME/conf/settings.xml 文件中配置本地仓库位置（maven 的安装目录下）：
  
  
  

<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
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  <localRepository>/path/to/local/repo</localRepository>
  -->
  <!-- 本地仓库配置路径 -->
<localRepository>E:\maven-warehouse</localRepository>

全局 setting 与用户 setting

• maven 仓库地址、私服等配置信息需要在 setting.xml 文件中配置，分为全局配置和用户配置。
• 在 maven 安装目录下的有 conf/setting.xml 文件，此 setting.xml 文件用于 maven 的所有 project 项目，它作为 maven 的全局配置。
  • 如需要个性配置则需要在用户配置中设置，用户配置的 setting.xml 文件默认的位置在：${user.dir} /.m2/settings.xml 目录中。
  • ${user.dir} 指windows 中的用户目录。 maven会先找用户配置，如果找到则以用户配置文件为准，否则使用全局配置文件。
    
    
    

Maven 工程的目录结构

• Maven 工程的目录结构 :
  
• 作为一个 maven 工程，它的 src目录和 pom.xml 是必备的。 进入 src目录后，我们发现它里面的目录结构如下：

• src/main/java —— 存放项目的.java 文件
• src/main/resources —— 存放项目资源文件，如 spring, hibernate 配置文件
• src/test/java —— 存放所有单元测试.java 文件，如 JUnit 测试类
• src/test/resources —— 测试资源文件
• target —— 项目输出位置，编译后的class 文件会输出到此目录
• pom.xml——maven 项目核心配置文件

注意： 如果是普通的 java 项目，那么就没有webapp 目录。

Maven 常用命令

• compile
  compile 是 maven 工程的编译命令，作用是将 src/main/java 下的文件编译为 class 文件输出到 target 目录下。
  cmd 进入命令状态，执行mvn compile

• test
  test 是 maven 工程的测试命令 mvn test，会执行src/test/java下的单元测试类。 cmd 执行 mvn test 执行 src/test/java 下单元测试类

• clean
  clean 是 maven 工程的清理命令，执行 clean 会删除 target 目录及内容。

• package
  package 是 maven 工程的打包命令，对于 java 工程执行 package 打成 jar 包，对于web 工程打成war 包。

• install
  install 是 maven 工程的安装命令，执行 install 将 maven 打成 jar 包或 war 包发布到本地仓库。
  
  
  

maven 的概念模型

• Maven 包含了一个项目对象模型 (Project Object Model)，一组标准集合，一个项目生命周期(Project Lifecycle)，一个依赖管理系统(Dependency Management System)，和用来运行定义在生命周期阶段 (phase)中插件(plugin)目标(goal)的逻辑。

• 项目对象模型 (Project Object Model) 一个 maven 工程都有一个 pom.xml 文件，通过 pom.xml 文件定义项目的坐标、项目依赖、项目信息、 插件目标等。

• 依赖管理系统(Dependency Management System) 通过 maven 的依赖管理对项目所依赖的 jar 包进行统一管理。 比如：项目依赖 junit4.9，通过在 pom.xml 中定义 junit4.9 的依赖即使用 junit4.9，如下所示是 junit4.9 的依赖定义：

<!-- 依赖关系 -->  
<dependencies>   
<!-- 此项目运行使用 junit，所以此项目依赖 junit -->
	<dependency>    
<!-- junit 的项目名称 -->    
		<groupId>junit</groupId>    
<!-- junit 的模块名称 -->
		<artifactId>junit</artifactId>    
<!-- junit 版本 -->    
		<version>4.9</version>    
<!-- 依赖范围：单元测试时使用 junit -->  
		<scope>test</scope>   
	</dependency> 
 

坐标的来源方式

• 添加依赖需要指定依赖 jar 包的坐标，但是很多情况我们是不知道 jar 包的的坐标，可以通过如下方 式查询：
  • 从互联网搜索
    http://search.maven.org/
    http://mvnrepository.com/
    
    

坐标定义

• 在 pom.xml 中定义坐标，内容包括：groupId、artifactId、version，详细内容如下：

	<!--项目名称，定义为组织名+项目名，类似包名-->
	<groupId>cn.myp666.maven</groupId>
	<!-- 模块名称 --> 
	<artifactId>maven-first</artifactId> 
	<!-- 当前项目版本号，snapshot 为快照版本即非正式版本，release为正式发布版本 --> 
	<version>0.0.1-SNAPSHOT</version>
	<packaging > :打包类型
	jar：执行 package 会打成 jar 包  
	war：执行 package 会打成 war 包  
	pom ：用于 maven 工程的继承，通常父工程设置为 pom

依赖范围

• A 依赖 B，需要在 A 的 pom.xml 文件中添加 B 的坐标，添加坐标时需要指定依赖范围，依赖范围包括:

  • compile：编译范围，指 A在编译时依赖 B，此范围为默认依赖范围。编译范围的依赖会用在 编译、测试、运行，由于运行时需要所以编译范围的依赖会被打包。

  • provided：provided 依赖只有在当 JDK 或者一个容器已提供该依赖之后才使用， provided 依赖在编译和测试时需要，在运行时不需要，比如：servlet api 被 tomcat 容器提供。

  • runtime：runtime 依赖在运行和测试系统的时候需要，但在编译的时候不需要。比如：jdbc 的驱动包。由于运行时需要所以 runtime 范围的依赖会被打包。

  • test：test 范围依赖 在编译和运行时都不需要，它们只有在测试编译和测试运行阶段可用， 比如：junit。由于运行时不需要所以test范围依赖 不会被打包。

  • system：system 范围依赖与 provided 类似，但是你必须显式的提供一个对于本地系统中 JAR 文件的路径，需要指定 systemPath 磁盘路径，system依赖不推荐使用。
    
    
    
    

设置 jdk 编译版本

由于学习中使用 jdk1.8，需要设置编译版本为 1.8，这里需要使用 maven 的插件来设置： 在 pom.xml 中加入

 <build>
   <plugins>
      <plugin>  
         <groupId>org.apache.maven.plugins</groupId>  
         <artifactId>maven-compiler-plugin</artifactId> 
         <configuration>    
           	<source>1.8</source>   
           	<target>1.8</target> 
     	   	<encoding>UTF-8</encoding>  
         </configuration> 
   </plugin> 

pom 基本配置

• pom.xml 是 Maven 项目的核心配置文件，位于每个工程的根目录，基本配置如下：

• < project > ：文件的根节点 .

• < modelversion > ： pom.xml 使用的对象模型版本

• < groupId > ：项目名称，一般写项目的域名

• < artifactId > ：模块名称，子项目名或模块名称

• < version > ：产品的版本号

  • < packaging > ：打包类型，一般有 jar、war、pom 等

• < name > ：项目的显示名，常用于 Maven 生成的文档。

• < description > ：项目描述，常用于 Maven 生成的文档

• < dependencies> ：项目依赖构件配置，配置项目依赖构件的坐标

• < build> ：项目构建配置，配置编译、运行插件等。