程序博客网 > 天庭淘宝店txt下载无常

maven 打包1

来源：互联网 发布：天庭淘宝店txt下载无常 编辑：程序博客网 时间：2024/06/18 11:46
“打包“这个词听起来比较土，比较正式的说法应该是”构建项目软件包“，具体说就是将项目中的各种文件，比如源代码、编译生成的字节码、配置文件、文档，按照规范的格式生成归档，最常见的当然就是JAR包和WAR包了，复杂点的例子是Maven官方下载页面的分发包， 它有自定义的格式，方便用户直接解压后就在命令行使用。作为一款”打包工具“，Maven自然有义务帮助用户创建各种各样的包，规范的JAR包和WAR包 自然不再话下，略微复杂的自定义打包格式也必须支持，本文就介绍一些常用的打包案例以及相关的实现方式，除了前面提到的一些包以外，你还能看到如何生成源 码包、Javadoc包、以及从命令行可直接运行的CLI包。

Packaging的含义

任何一个Maven项目都需要定义POM元素packaging（如果不写则默认值为jar）。顾名思义，该元素决定了项目的打包方式。实际的情形 中，如果你不声明该元素，Maven会帮你生成一个JAR包；如果你定义该元素的值为war，那你会得到一个WAR包；如果定义其值为POM（比如是一个 父模块），那什么包都不会生成。除此之外，Maven默认还支持一些其他的流行打包格式，例如ejb3和ear。你不需要了解具体的打包细节，你所需要做 的就是告诉Maven，”我是个什么类型的项目“，这就是约定优于配置的力量。

为了更好的理解Maven的默认打包方式，我们不妨来看看简单的声明背后发生了什么，对一个jar项目执行mvn package操作，会看到如下的输出：

[INFO] --- maven-jar-plugin:2.3.1:jar (default-jar) @ git-demo ---[INFO] Building jar: /home/juven/git_juven/git-demo/target/git-demo-1.2-SNAPSHOT.jar

相比之下，对一个war项目执行mvn package操作，输出是这样的：

[INFO] --- maven-war-plugin:2.1:war (default-war) @ webapp-demo ---[INFO] Packaging webapp[INFO] Assembling webapp [webapp-demo] in [/home/juven/git_juven/webapp-demo/target/webapp-demo-1.0-SNAPSHOT][INFO] Processing war project[INFO] Copying webapp resources [/home/juven/git_juven/webapp-demo/src/main/webapp][INFO] Webapp assembled in [90 msecs][INFO] Building war: /home/juven/git_juven/webapp-demo/target/webapp-demo-1.0-SNAPSHOT.war

对应于同样的package生命周期阶段，Maven为jar项目调用了maven-jar-plugin，为war项目调用了maven-war-plugin，换言之，packaging直接影响Maven的构建生命周期。了解这一点非常重要，特别是当你需要自定义打包行为的时候，你就必须知道去配置哪个插件。一个常见的例子就是在打包war项目的时候排除某些web资源文件，这时就应该配置maven-war-plugin如下：

Xml代码  收藏代码
  1. <plugin>  
  2.     <groupId>org.apache.maven.plugins</groupId>  
  3.     <artifactId>maven-war-plugin</artifactId>  
  4.     <version>2.1.1</version>  
  5.     <configuration>  
  6.       <webResources>  
  7.         <resource>  
  8.           <directory>src/main/webapp</directory>  
  9.           <excludes>  
  10.             <exclude>**/*.jpg</exclude>  
  11.           </excludes>  
  12.         </resource>  
  13.       </webResources>  
  14.     </configuration>  
  15. </plugin>  

 

源码包和Javadoc包

本专栏的《坐标规划》一 文中曾解释过，一个Maven项目只生成一个主构件，当需要生成其他附属构件的时候，就需要用上classifier。源码包和Javadoc包就是附属 构件的极佳例子。它们有着广泛的用途，尤其是源码包，当你使用一个第三方依赖的时候，有时候会希望在IDE中直接进入该依赖的源码查看其实现的细节，如果 该依赖将源码包发布到了Maven仓库，那么像Eclipse就能通过m2eclipse插件解析下载源码包并关联到你的项目中，十分方便。由于生成源码 包是极其常见的需求，因此Maven官方提供了一个插件来帮助用户完成这个任务：

Xml代码  收藏代码
  1. <plugin>  
  2.     <groupId>org.apache.maven.plugins</groupId>  
  3.     <artifactId>maven-source-plugin</artifactId>  
  4.     <version>2.1.2</version>  
  5.     <executions>  
  6.       <execution>  
  7.         <id>attach-sources</id>  
  8.         <phase>verify</phase>  
  9.         <goals>  
  10.           <goal>jar-no-fork</goal>  
  11.         </goals>  
  12.       </execution>  
  13.     </executions>  
  14.   </plugin>  

 

类似的，生成Javadoc包只需要配置插件如下：

Xml代码  收藏代码
  1. <plugin>            
  2.     <groupId>org.apache.maven.plugins</groupId>  
  3.     <artifactId>maven-javadoc-plugin</artifactId>  
  4.     <version>2.7</version>  
  5.     <executions>  
  6.       <execution>  
  7.         <id>attach-javadocs</id>  
  8.           <goals>  
  9.             <goal>jar</goal>  
  10.           </goals>  
  11.       </execution>  
  12.     </executions>  
  13.   </plugin>   

 

为了帮助所有Maven用户更方便的使用Maven中央库中海量的资源，中央仓库的维护者强制要求开源项目提交构件的时候同时提供源码包和Javadoc包。这是个很好的实践，读者也可以尝试在自己所处的公司内部实行，以促进不同项目之间的交流。

可执行CLI包

除了前面提到了常规JAR包、WAR包，源码包和Javadoc包，另一种常被用到的包是在命令行可直接运行的CLI（Command Line）包。默认Maven生成的JAR包只包含了编译生成的.class文件和项目资源文件，而要得到一个可以直接在命令行通过java命令运行的 JAR文件，还要满足两个条件：

  • JAR包中的/META-INF/MANIFEST.MF元数据文件必须包含Main-Class信息。
  • 项目所有的依赖都必须在Classpath中。

Maven有好几个插件能帮助用户完成上述任务，不过用起来最方便的还是maven-shade-plugin， 它可以让用户配置Main-Class的值，然后在打包的时候将值填入/META-INF/MANIFEST.MF文件。关于项目的依赖，它很聪明地将依 赖JAR文件全部解压后，再将得到的.class文件连同当前项目的.class文件一起合并到最终的CLI包中，这样，在执行CLI JAR文件的时候，所有需要的类就都在Classpath中了。下面是一个配置样例：

Xml代码  收藏代码
  1. <plugin>  
  2.     <groupId>org.apache.maven.plugins</groupId>  
  3.     <artifactId>maven-shade-plugin</artifactId>  
  4.     <version>1.4</version>  
  5.     <executions>  
  6.       <execution>  
  7.         <phase>package</phase>  
  8.         <goals>  
  9.           <goal>shade</goal>  
  10.         </goals>  
  11.         <configuration>  
  12.           <transformers>  
  13.             <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">  
  14.               <mainClass>com.juvenxu.mavenbook.HelloWorldCli</mainClass>  
  15.             </transformer>  
  16.           </transformers>  
  17.         </configuration>  
  18.       </execution>  
  19.     </executions>  
  20.   </plugin>  

 

上述例子中的，我的Main-Class是com.juvenxu.mavenbook.HelloWorldCli，构建完成后，对应于一个常规 的hello-world-1.0.jar文件，我还得到了一个hello-world-1.0-cli.jar文件。细心的读者可能已经注意到了，这里 用的是cli这个classifier。最后，我可以通过java -jar hello-world-1.0-cli.jar命令运行程序。

 

自定义格式包

实际的软件项目常常会有更复杂的打包需求，例如我们可能需要为客户提供一份产品的分发包，这个包不仅仅包含项目的字节码文件，还得包含依赖以及相关脚本文件以方便客户解压后就能运行，此外分发包还得包含一些必要的文档。这时项目的源码目录结构大致是这样的：

pom.xmlsrc/main/java/src/main/resources/src/test/java/src/test/resources/src/main/scripts/src/main/assembly/README.txt

除了基本的pom.xml和一般Maven目录之外，这里还有一个src/main/scripts/目录，该目录会包含一些脚本文件如 run.sh和run.bat，src/main/assembly/会包含一个assembly.xml，这是打包的描述文件，稍后介绍，最后的 README.txt是份简单的文档。

我们希望最终生成一个zip格式的分发包，它包含如下的一个结构：

bin/lib/README.txt

其中bin/目录包含了可执行脚本run.sh和run.bat，lib/目录包含了项目JAR包和所有依赖JAR，README.txt就是前面提到的文档。

描述清楚需求后，我们就要搬出Maven最强大的打包插件：maven-assembly-plugin。 它支持各种打包文件格式，包括zip、tar.gz、tar.bz2等等，通过一个打包描述文件（该例中是src/main /assembly.xml），它能够帮助用户选择具体打包哪些文件集合、依赖、模块、和甚至本地仓库文件，每个项的具体打包路径用户也能自由控制。

如下 就是对应上述需求的打包描述文件src/main/assembly.xml：

Xml代码  收藏代码
  1. <assembly>  
  2.   <id>bin</id>  
  3.   <formats>  
  4.     <format>zip</format>  
  5.   </formats>  
  6.   <dependencySets>  
  7.     <dependencySet>  
  8.       <useProjectArtifact>true</useProjectArtifact>  
  9.       <outputDirectory>lib</outputDirectory>  
  10.     </dependencySet>  
  11.   </dependencySets>  
  12.   <fileSets>  
  13.     <fileSet>  
  14.       <outputDirectory>/</outputDirectory>  
  15.       <includes>  
  16.         <include>README.txt</include>  
  17.       </includes>  
  18.     </fileSet>  
  19.     <fileSet>  
  20.       <directory>src/main/scripts</directory>  
  21.       <outputDirectory>/bin</outputDirectory>  
  22.       <includes>  
  23.         <include>run.sh</include>  
  24.         <include>run.bat</include>  
  25.       </includes>  
  26.     </fileSet>  
  27.   </fileSets>  
  28. </assembly>  

 

  • 首先这个assembly.xml文件的id对应了其最终生成文件的classifier。
  • 其次formats定义打包生成的文件格式，这里是zip。因此结合id我们会得到一个名为hello-world-1.0-bin.zip的文件。（假设artifactId为hello-world，version为1.0）
  • dependencySets用来定义选择依赖并定义最终打包到什么目录，这里我们声明的一个depenencySet默认包含所有所有 依赖，而useProjectArtifact表示将项目本身生成的构件也包含在内，最终打包至输出包内的lib路径下（由 outputDirectory指定）。
  • fileSets允许用户通过文件或目录的粒度来控制打包。这里的第一个fileSet打包README.txt文件至包的根目录下，第二个fileSet则将src/main/scripts下的run.sh和run.bat文件打包至输出包的bin目录下。

打包描述文件所支持的配置远超出本文所能覆盖的范围，为了避免读者被过多细节扰乱思维，这里不再展开，读者若有需要可以去参考这份文档。

最后，我们需要配置maven-assembly-plugin使用打包描述文件，并绑定生命周期阶段使其自动执行打包操作：

Xml代码  收藏代码
  1. <plugin>  
  2.     <groupId>org.apache.maven.plugins</groupId>  
  3.     <artifactId>maven-assembly-plugin</artifactId>  
  4.     <version>2.2.1</version>  
  5.     <configuration>  
  6.       <descriptors>  
  7.         <descriptor>src/main/assembly/assembly.xml</descriptor>  
  8.       </descriptors>  
  9.     </configuration>  
  10.     <executions>  
  11.       <execution>  
  12.         <id>make-assembly</id>  
  13.         <phase>package</phase>  
  14.         <goals>  
  15.           <goal>single</goal>  
  16.         </goals>  
  17.       </execution>  
  18.     </executions>  
  19.   </plugin>  

 

运行mvn clean package之后，我们就能在target/目录下得到名为hello-world-1.0-bin.zip的分发包了。

小结

打包是项目构建最重要的组成部分之一，本文介绍了主流Maven打包技巧，包括默认打包方式的原理、如何制作源码包和Javadoc包、如何制作命 令行可运行的CLI包、以及进一步的，如何基于个性化需求自定义打包格式。这其中涉及了很多的Maven插件，当然最重要，也是最为复杂和强大的打包插件 就是maven-assembly-plugin。事实上Maven本身的分发包就是通过maven-assembly-plugin制作的，感兴趣的读 者可以直接查看源码一窥究竟。

来源：http://www.infoq.com/cn/news/2011/06/xxb-maven-9-package

 

========================================================

 自己项目：

路径：

database下包含mysql和oracle文件夹。
 

根目录POM.xml（配置模块和assembly打包插件）：

Xml代码  收藏代码
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <project xmlns="http://maven.apache.org/POM/4.0.0"  
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  4. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">  
  5.   
  6.   <modelVersion>4.0.0</modelVersion>  
  7.     
  8.   <!-- Coordinate -->  
  9.   <groupId>com.test.so.practice</groupId>  
  10.   <artifactId>Light2ESB</artifactId>  
  11.   <version>2.2.0</version>  
  12.     
  13.   <packaging>pom</packaging>  
  14.     
  15.   <!-- Info -->  
  16.   <name>practice</name>  
  17.     
  18.   <!-- Properties -->  
  19.   <properties>  
  20.     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
  21.   </properties>  
  22.     
  23.   <build>  
  24.     <plugins>  
  25.       <plugin>  
  26.         <groupId>org.apache.maven.plugins</groupId>  
  27.         <artifactId>maven-assembly-plugin</artifactId>  
  28.         <version>2.2.1</version>  
  29.         <configuration>  
  30.           <descriptors>  
  31.             <descriptor>assembly.xml</descriptor>  
  32.           </descriptors>  
  33.         </configuration>  
  34.         <executions>  
  35.           <execution>  
  36.             <id>make-assembly</id>  
  37.             <phase>package</phase>  
  38.             <goals>  
  39.               <goal>single</goal>  
  40.             </goals>  
  41.           </execution>  
  42.         </executions>  
  43.       </plugin>  
  44.     </plugins>  
  45.   </build>  
  46.     
  47.   <!-- Modules -->  
  48.   <modules>  
  49.     <module>projects</module>  
  50.     <module>servlets</module>  
  51.     <module>ejbs</module>  
  52.     <module>ear</module>  
  53.   </modules>  
  54. </project>  

  module配的是子模块文件夹名。

 

打包描述文件assembly.xml:

Xml代码  收藏代码
  1. <assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0"  
  2. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  3. xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 http://maven.apache.org/xsd/assembly-1.1.0.xsd">  
  4.   
  5.   <id>pkg</id>  
  6.   <formats>  
  7.     <format>zip</format>  
  8.   </formats>  
  9.   <fileSets>  
  10.     <!-- 数据库脚本 -->  
  11.     <fileSet>  
  12.       <directory>${project.basedir}/database/mysql</directory>  
  13.     </fileSet>  
  14.     <!-- 资源 -->  
  15.     <fileSet>  
  16.       <directory>${project.basedir}/resource</directory>  
  17.     </fileSet>  
  18.     <!-- 应用 -->  
  19.     <fileSet>  
  20.       <directory>${project.basedir}/ear/ESB2Console/target/</directory>  
  21.       <includes>  
  22.         <include>*.ear</include>  
  23.       </includes>  
  24.       <outputDirectory>/app/</outputDirectory>  
  25.     </fileSet>  
  26.     <fileSet>  
  27.       <directory>${project.basedir}/ear/ESB2Assistant/target/</directory>  
  28.       <includes>  
  29.         <include>*.ear</include>  
  30.       </includes>  
  31.       <outputDirectory>/app/</outputDirectory>  
  32.     </fileSet>  
  33.     <fileSet>  
  34.       <directory>${project.basedir}/ejbs/com.practice.so.ws.core/target/</directory>  
  35.       <includes>  
  36.         <include>*.jar</include>  
  37.       </includes>  
  38.       <outputDirectory>/app/</outputDirectory>  
  39.     </fileSet>  
  40.     <!-- 文档 -->  
  41.     <fileSet>  
  42.       <directory>${project.basedir}/doc/External/</directory>  
  43.       <outputDirectory>/doc/</outputDirectory>  
  44.     </fileSet>  
  45.   </fileSets>  
  46. </assembly>  

 

最后的输出包文件名为：Light2ESB-2.2.0-pkg.zip

目录如下：


其中只配directory表示将文件夹resource输出到打包文件中作为文件夹resource。如：
Xml代码  收藏代码
  1. <fileSet>  
  2.       <directory>${project.basedir}/resource</directory>  
  3.     </fileSet>  
 
  1. <fileSet>  
  2.       <directory>${project.basedir}/doc/External/</directory>  
  3.       <outputDirectory>/doc/</outputDirectory>  
  4.     </fileSet>  
表示将doc/External下所有文件输出到doc 文件夹中。
0 0
天庭淘宝店txt下载无常 天庭淘宝店txt下载无常
原创粉丝点击
热门IT博客
怎么优化搜索引擎怎么优化搜索引擎
交换机sfp端口交换机sfp端口
怎么判断端口是否连通
mac怎么保存文档到本地
自动还原软件
乔丹98年总决赛数据
ssh管理系统源码
奥数最优化问题
wit.ai api.ai 知乎
淘宝销量互刷平台
effect java 书籍下载
网络上btc是什么意思
淘宝双十二活动
德国难民知乎
苹果最新软件功能
知乎查看匿名回答
windows平板电脑排行榜
淘宝公益宝贝质量好吗
ui设计师美工的区别
订单生产进度跟踪软件
热门问题 老师的惩罚 人脸识别 我在镇武司摸鱼那些年 重生之率土为王 我在大康的咸鱼生活 盘龙之生命进化 天生仙种 凡人之先天五行 春回大明朝 姑娘不必设防，我是瞎子 无贱道双色争艳 双色l球预测号 今日双色预测专家6十l 双色预测下期号码 双色绘画的地理 双色求综合走势图 神武3小欣双色礼包 双色求开结果 双色求走势近500期 双色走势分析 古今对照双色绘画 双色求走势50期 今日双色预测专家精准号 双色近100期走势图 甜辣双色芋头 双色预测专家总汇 双色走势图球 双色蓝球下期预测号 双色注塑厂家 双色注塑加工 双色基本走势图 玫珂菲双色修容饼 蜘蛛纸牌双色技巧 双色下期预测 双色预测号码 双色椒蒸鲫鱼 双色鞋带系法 双色起走势图 单双 双拼音节 双拼音节有哪些 双十一购物狂欢节 双拼音节表 双十一什么节 什么是双十一节 双十一网购狂欢节 中秋国庆双节活动主题 双节安全教育 双节铁皮文件柜 淘宝双十一购物狂欢节 双节距链条参数表

程序博客网，程序员的互联网技术博客家园。csdn论坛精品 msdn技术资料都在这里