首页 > 代码库 > Maven使用笔记

Maven使用笔记

2024-08-12 06:32:43   232人阅读

Maven是一个项目管理工具，它包含了一个项目对象模型 (Project Object Model)，
一组标准插件(生命周期各阶段是绑定插件中的目标来完成项目构建工作)
一个项目生命周期(Project Lifecycle)，
一个依赖管理系统(Dependency Management System).

一、Maven私服搭建(管理jar包依赖的JavaEE Web系统)：
    nexus下载地址：http://www.sonatype.org/nexus/
    1. 安装私服。
       a. 解压nexus-2.10.0-02-bundle.zip。
          nexus-2.10.0-02：核心目录。
          -- bin/jsw：存放了操作Nexus应用的命令。
          -- conf ：nexus.properties 配置文件可更改port、host、nexus-work、runtime。
 sonatype-work：工作目录。
    sonatype-work\nexus\storage：所有仓库存储目录。

       b. 配置启动nexus应用
          nexus-2.10.0-02/bin/jsw/ windows-x86-32：
 - console-nexus.bat ：控制台运行nexus
 - start-nexus.bat：启动nexus服务
 - stop-nexus.bat：停止nexus服务
 - install-nexus.bat ：安装nexus到window服务中
 - uninstall-nexus.bat：从window服务中删除nexus
 cmd启动nexus：sc start nexus-webapp
 cmd停止nexus： sc stop nexus-webapp

    2. nexus应用使用。
      a. 启动进入Nexus主界面：
         - http://localhost:8081/nexus/index.html
      b. 登录Nexus：admin/admin123
      c. 点击左边菜单Repositories查看所有仓库：
         - Public Repositories：仓库组。
         - 3rd party：第三方的仓库。
         - Maven Central：Maven中央仓库。
         - Releases：发行版存放仓库。
         - Snapshots：快照版存放仓库。
         - itcast Central： 自定义的仓库。

说明：四种类型的仓库：group(组)、proxy(代理)、hosted(本地)、virtual(虚拟)

      d. 创建自己的仓库。
         -- Add按钮后在configuration选项中进行配置.

         maven中央库地址: http://repo1.maven.org/maven2/
maven中央库搜索地址：http://search.maven.org/
    

二、Maven下载与安装：
   a. maven 官网地址：http://maven.apache.org/

   b. 安装maven: 
      -- 设置M2_HOME 变量  E:\apache-maven-3.2.1
      -- 设置系统环境变量path.  E:\apache-maven-3.2.1\bin
      -- 在E:\apache-maven-3.2.1/conf/settings.xml文件中更改本地仓库路径:
         <localRepository>E:/apache-maven-3.2.1/repo</localRepository>

   c. 配置私服(镜像)。
        在conf/settings.xml文件中给定仓库下载的镜像：
-- id : 镜像唯一标识符，用来区分不同的mirror
        -- mirrorOf : 镜像哪些仓库 *：代表所有的仓库 central: 代表仓库id为central的仓库.
-- name : 镜像名称
        -- url : 镜像的URL
<mirror>
  <id>public</id>
  <mirrorOf>*</mirrorOf>
  <name>public Mirror</name>
  <url>http://localhost:8081/nexus/content/groups/public</url>
</mirror>


三、MyEclipse配置关联自己的Maven: 

     Window --> Preferences --> MyEclipse --> Maven4MyEclipse --> User setting 配置关联自已的Maven.


四、 Maven的核心概念

    1. Maven 插件和目标  (Plugins and Goals) 
    -- Maven构建项目由一组标准插件组成。
    -- 一个maven插件是由一个或者多个目标组成的。
    -- 一个目标是一个明确的任务，它可以作为单独的目标运行，
或者作为一个大的构建的一部分和其它目标一起运行。
一个目标是Maven中的一个“工作单元”。
目标的例子包括Compiler插件中的compile目标，它用来编译项目中的所有源文件，
或者Surefire插件中的test目标，用来运行单元测试。

    2. Maven 生命周期 (Lifecycle) mvn 
    -- Clean Lifecycle 在构建项目之前进行一些清理工作。
        pre-clean
clean
post-clean 

    -- Default Lifecycle 构建的核心部分，初始化、编译、测试、打包、验证、部署和站点生成等。
       validate    验证项目是否正确，以及所有为了完整构建必要的信息是否可用
       generate-sources     生成所有需要包含在编译过程中的源代码
       process-sources    处理源代码，比如过滤一些值
       generate-resources   生成所有需要包含在打包过程中的资源文件
       process-resources    复制并处理资源文件至目标目录，准备打包
       compile            编译项目的源代码
       process-classes    后处理编译生成的文件，例如对Java类进行字节码增强（bytecode enhancement）
       generate-test-sources 生成所有包含在测试编译过程中的测试源码
       process-test-sources 处理测试源码，比如过滤一些值
       generate-test-resources 生成测试需要的资源文件
       process-test-resources 复制并处理测试资源文件至测试目标目录
       test-compile        编译测试源码至测试目标目录
       test                使用合适的单元测试框架运行测试。这些测试应该不需要代码被打包或发布
       prepare-package        在真正的打包之前，执行一些准备打包必要的操作。这通常会产生一个包的展开的处理过的版本（将会在Maven 2.1+中实现）
       package                将编译好的代码打包成可分发的格式，如JAR，WAR，或者EAR
       pre-integration-test 执行一些在集成测试运行之前需要的动作。如建立集成测试需要的环境
       integration-test 如果有必要的话，处理包并发布至集成测试可以运行的环境
       post-integration-test 执行一些在集成测试运行之后需要的动作。如清理集成测试环境。
       verify                执行所有检查，验证包是有效的，符合质量规范
       install                安装包至本地仓库，以备本地的其它项目作为依赖使用
       deploy                复制最终的包至远程仓库，共享给其它开发人员和项目（通常和一次正式的发布相关）

    -- Site Lifecycle 生成项目报告，站点，发布站点。
       pre-site
       site
       post-site
       site-deploy
 
       说明：生命周期各阶段Phase由一个或多个插件的Goal目标集合而成。
             用mvn命令直接执行生命周期中的指定阶段(phase)
             mvn phase(阶段名称)
        

    3. Maven 坐标 (Coordinates) 
      坐标解释(groupId、artifactId、version):
      groupId:    创建这个项目的组织名称(一般为组织的域名反写)
      artifactId: 表示一个单独项目的唯一标识符(项目名或jar包)
      version:    项目的版本号

      注意：groupId、artifactId、version它们标识了一个唯一的项目。

    4. Maven 资源库(Repositories)  
        什么是Maven资源库? 资源存储的地方，即所有项目的jar库，插件库。
Maven库中有三种类型
        -- local : 本地库  
  <localRepository>C:/MyLocalRepository</localRepository>
        -- remote  : 远程仓库(代理仓库也就是自已的私服)
-- central : 中央存储库(http://repo1.maven.org/maven2/)
Maven的依赖jar包搜索序列:
第一种：本地库 ---> 中央库
第二种：本地库 ---> 远程库 ---> 中央库


    5. Maven 依赖管理 (Dependency Management) 

      a、Transitive Dependency (传递依赖)
          你的项目依赖于A，A又依赖于B。你的项目是否要声明你依赖于B？ 
 Maven的回答是它帮你自动管理这种依赖的传递，
 你不需要声明你依赖于B，由Maven来做。

      b、Dependency Scope （依赖范围）

         举例来说，你开发时需要做测试，你需要依赖于junit的jar，但是部署应用时并不需要它，
因为单元测试不会在生产环境上跑，也就是说最终打包的jar或者war不包含junit的jar。
又如你开发web程序，你的servlet/jsp进行编译需要依赖于servlet-jsp的标准api（J2EE的jar），
但是部署时也是不需要它的，因为你的应用服务器肯定有这些东西。

         因此，Maven考虑了6中可能的scope供选择：
         - compile: 默认的scope。编译、测试、打包全都需要。compile参与依赖传递，就是说，
你的项目A依赖于B(依赖scope是compile)，项目C依赖于你的项目A，那么C也就依赖于B。

         - provided: 表示JDK或者容器会在Runtime时提供这些(jar)，
如上面说到的servlet api。provided的东西在编译和测试时会用到，不参与传递依赖。

         - runtime: 表示编译时不需要，但测试和运行时需要，最终打包时会包含进去。

         - test: 只用于测试阶段（测试的编译和测试的运行），典型的就是junit的jar。

         - system: 和provided类似，但要求jar是你的系统里已有的，
   不会在repository里找，如rt.jar,tools.jar这些。

         - import: 简单的说，你的项目的pom可以继承另一个项目的pom，
  从而继承了父项目的依赖关系，但是因为之后single inheritance的限制，
  所以创造了import，使得你可以“导入”或者说“继承”任何一到多个项目的依赖关系。

      c. Dependency Classier (依赖jdk版本)
         在jdk1.4下编译的还是jdk1.5 

      d. 解决依赖冲突(排除指定的依赖)
         <exclusions>
    <exclusion>
<artifactId>servlet-api</artifactId>
<groupId>javax.servlet</groupId>
    </exclusion>
        </exclusions>

    6. 站点生成和报告  (Site Generation and Reporting)
       -- mvn site 命令
          运行site生命周期阶段

五、Maven标准插件说明(-D指定属性)：

    注意：标准插件的位置(第一次使用时它会去Maven中央库下载)：
          Maven本地仓库\org\apache\maven\plugins\
 
   mvn 插件:goal -D属性名=属性值 ……

   1. 编译源代码: mvn compiler:compile.

   2. 清除项目：mvn clean:clean (只留下源文件).

   3. 测试命令: 
      -- mvn surefire:test : 运行测试代码

   4. 安装：mvn install:install
      
   5. 只打jar包: mvn jar:jar (java项目)

   6. 只打war包: mvn war:war (web项目)

   7. 部署最终的包至远程仓库： mvn deploy:deploy

   8. 生成站点目录：mvn site:site   

   说明：Maven标准插件使用地址: http://maven.apache.org/plugins/index.html

六、Maven创建项目：
    1.创建web项目的两种方式: 
       第一种方式：选择原型目录创建项目：
mvn 插件名:目标 -D参数
mvn archetype:generate -DarchetypeCatalog=internal (10种原型目录来创建项目)
 说明：
 -- archetypeCatalog属性：internal(内部10), remote(远程1千多种)
 -- 7：代表java项目、10: 代表web项目

        第二种方式：通过myeclipse创建web项目(掌握).


    2.Maven创建出来的Web项目结构：
       src/main/java       java源文件
       src/main/resources  java资源文件
       src/main/webapp     webapp根目录

       src/test/java       test源文件
       src/test/resources  test资源文件


七、myeclipse创建Web项目(maven-archetype-webapp)：
    1. mvn compile 编译java项目.
    2. mvn test 运行测试用例.
    3. mvn package 编译java项目并打成war包.
    4. mvn clean  清理java项目.

    a. 配置web项目依赖的jar包
       <dependency>
      <groupId>org.apache.tomcat</groupId>
      <artifactId>tomcat-jsp-api</artifactId>
      <version>7.0.65</version>
      <scope>provided</scope>
       </dependency>
       <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
      <scope>runtime</scope>
       </dependency>
    b. 配置web项目运行web容器插件
       <plugin>
    <groupId>org.apache.tomcat.maven</groupId>
    <artifactId>tomcat7-maven-plugin</artifactId>
    <version>2.2</version>
    <configuration>
    <port>8080</port>
    </configuration>
    </plugin>
     
     c. 设置jdk版本：
         1. 配置编译插件
         <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.1</version>
    <configuration>
    <source>1.8</source>
    <target>1.8</target>
<encoding>utf-8</encoding>
    </configuration>
    </plugin>
         2. 更新Maven项目
    
   
八、POM(Project Object Model)项目对象模型(pom.xml)配置:

    a、基础元素配置：
        <!-- 指定POM对象模型的版本号 -->
  <modelVersion>4.0.0</modelVersion>
  <!-- 指定组织ID(公司域名反写) -->
  <groupId>cn.itcast</groupId>
  <!-- 指定项目名 -->
  <artifactId>Struts2-MyBatis3</artifactId>
  <!-- 指定项目的版本  RELEASE(发行版)、SNAPSHOT(快照版) -->
  <version>1.0.0-RELEASE</version>
  <!-- 指定项目打包的产物(jar、ear、war、pom) -->
  <packaging>war</packaging>

    b、全局属性配置:
  <properties>
  <currentVersion>${project.version}</currentVersion>
<struts2.version>2.3.16.3</struts2.version>
<mybatis.version>3.2.7</mybatis.version>
<mysql.version>5.1.27</mysql.version>
<tomcat.version>7.0.47</tomcat.version>
  </properties>
  
    c、依赖关系配置：
  <dependencies>
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
<scope>runtime</scope>
<type>jar</type>
    <classifier>jdk15</classifier>
      </dependency>
  </dependencies>

    d、构建元素配置：
        <!-- 构建项目元素 -->
  <build>
  <finalName>hrm</finalName>
  <!-- 定义默认的目标 -->
  <defaultGoal>package</defaultGoal>
  <!-- 源码目录 -->
  <sourceDirectory>${basedir}/src/main/java</sourceDirectory>
  <!-- 测试代码目录 -->
  <testSourceDirectory>${basedir}/src/test/java</testSourceDirectory>
  <!-- 资源文件 -->
  <resources>
  <resource>
  <!-- 源目录 -->
  <directory>${basedir}/src/main/resources</directory>
  </resource>
  </resources>
<plugins>
<plugin>
</plugin>
...
</plugins>
  </build>

   e、常用插件配置：

      1. 编译插件: 
        <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.1</version>
<configuration>
<source>1.7</source>
<target>1.7</target>
<encoding>utf-8</encoding>
</configuration>
        </plugin>
    
      2. 生成API文档插件
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.9.1</version>
<!-- 指定插件需要的配置信息 -->
<configuration>
<!-- 源文件编码 -->
<encoding>UTF-8</encoding> 
<!-- 生成时的编码 -->
<charset>UTF-8</charset> 
<!-- 文档的编码 -->
<docencoding>UTF-8</docencoding>
<!-- 文档标题 -->
<doctitle>传智播客</doctitle>
<!-- 窗口标题 -->
<windowtitle>OA办公管理系统</windowtitle>
</configuration>
<executions>
<execution>
<!-- 指定目标 -->
<goals><goal>javadoc</goal></goals>
<!-- 生命周期哪个阶段时，执行上面javadoc目标 -->
<phase>compile</phase>
</execution>
</executions>
 </plugin>
       3. tomcat插件:
 <plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<!-- 指定插件需要的配置信息 -->
<configuration> 
<!-- 设置端口 -->
<port>8080</port>
<!-- 设置支持热部署 -->
<contextReloadable>true</contextReloadable>
</configuration>  
 </plugin> 
       4. jetty插件:
 <plugin>
<groupId>org.mortbay.jetty</groupId>
<artifactId>jetty-maven-plugin</artifactId>
<version>7.6.16.v20140903</version>
<configuration>
  <!-- 设置web项目配置信息 -->
  <webApp>
     <contextPath>/${project.artifactId}</contextPath>
  </webApp>
  <!-- 设置支持热部署 -->
  <scanIntervalSeconds>1</scanIntervalSeconds>
              <connectors>
                     <connector implementation="org.eclipse.jetty.server.nio.SelectChannelConnector">
                         <port>9090</port>
                     </connector>
                   </connectors>       
    </configuration>
 </plugin>

 注意：需换成jre路径(不要引用jdk路径)

   f、站点元素配置:
      
        <!-- 指定项目名称，一般用于文档生成 -->
<name>ssh</name>
<!-- 指定公司网站地址 -->
<url>http://maven.apache.org</url>
<!-- 指定项目描述 -->
<description>传智播客java架构项目</description>
<!-- 指定项目的开始时间 -->
<inceptionYear>2015</inceptionYear>


来自为知笔记(Wiz)


Maven使用笔记


联系
我们