Maven仓库、将本地Jar包安装到仓库、打可执行的Jar总结

xingyun86 2019-7-20 1256

先说说Maven 仓库的分类：

maven的仓库只有两大类：1.本地仓库 2.远程仓库，在远程仓库中又分成了3种：2.1 中央仓库 2.2 私服 2.3 其它公共库

1.本地仓库，顾名思义，就是Maven在本地存储构件的地方。

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

maven本地仓库的默认位置：无论是Windows还是Linux，在用户的目录下都有一个.m2/repository/的仓库目录，这就是Maven仓库的默认位置

如何更改maven默认的本地仓库的位置：这里要引入一个新的元素：localRepository，它是存在于maven的settings.xml文件中

1.1 更改配置用户范围的本地仓库：先在/.m2/目录下创建settings.xml文件，然后在~/.m2/settings.xml

设置localRepository元素的值为想要的仓库地址

<localRepository>D:\maven_new_repository</localRepository>

</settings>

这时候，maven的本地仓库地址就变成了 D:\maven_new_repository ，注：此时配置的maven的本地仓库是属于用户范围的。

1.2 更改配置全局范围的本地仓库：在M2_HOME/conf/settings.xml中更改配置，更改配置的方法同上

注：此时更改后，所有的用户都会受到影响，而且如果maven进行升级，那么所有的配置都会被清除，所以要提前复制和备份M2_HOME/conf/settings.xml文件

故：一般情况下不推荐配置全局的settings.xml

2. 远程仓库

2.1 说到远程仓库先从最核心的中央仓库开始，中央仓库是默认的远程仓库，maven在安装的时候，自带的就是中央仓库的配置

在maven的聚合与继承中我们说过，所有的maven项目都会继承超级pom，具体的说，包含了下面配置的pom我们就称之为超级pom

<id>central</id>

<name>Central Repository</name>

<url>http://repo.maven.apache.org/maven2</url>

<layout>default</layout>

<enabled>false</enabled>

</snapshots>

</repository>

</repositories>

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

2.2 私服

私服是一种特殊的远程仓库，它是架设在局域网内的仓库服务，私服代理广域网上的远程仓库，供局域网内的Maven用户使用。当Maven需要下载构件的时候，它从私服请求，如果私服上不存在该构件，则从外部的远程仓库下载，缓存在私服上之后，再为Maven的下载请求提供服务。我们还可以把一些无法从外部仓库下载到的构件上传到私服上。

Maven私服的个特性：

1.节省自己的外网带宽：减少重复请求造成的外网带宽消耗

2.加速Maven构件：如果项目配置了很多外部远程仓库的时候，构建速度就会大大降低

3.部署第三方构件：有些构件无法从外部仓库获得的时候，我们可以把这些构件部署到内部仓库(私服)中，供内部maven项目使用

4.提高稳定性，增强控制：Internet不稳定的时候，maven构建也会变的不稳定，一些私服软件还提供了其他的功能

5.降低中央仓库的负荷：maven中央仓库被请求的数量是巨大的，配置私服也可以大大降低中央仓库的压力

当前主流的maven私服：

1.Apache的Archiva

2.JFrog的Artifactory

3.Sonatype的Nexus

三、远程仓库配置

3.1、配置远程仓库

将引入新的配置元素：<repositories> <repository>在<repositories>元素下，可以使用<repository>子元素声明一个或者多个远程仓库。

例子：

<id>jboss</id>

<name>JBoss Repository</name>

<url>http://repository.jboss.com/maven2/</url>

<updatePolicy>daily</updatePolicy>

</releases>

<enabled>false</enabled>

</snapshots>

<layout>default</layout>

</repository>

</repositories>

<updatePolicy>元素：表示更新的频率，值有：never, always,interval,daily, daily 为默认值

<checksumPolicy>元素：表示maven检查和检验文件的策略，warn为默认值

出于安全方面的考虑，有时我们要对远程仓库的访问进行认证，一般将认证信息配置在settings.xml中：

<id>same with repository id in pom</id>

<username>username</username>

</server>

</servers>

注：这里的id必须与POM中需要认证的repository元素的Id一致。

3.2、如何将生成的项目部署到远程仓库

完成这项工作，也需要在POM中进行配置，这里有新引入了一个元素：<distributionManagement>

distributionManagement包含了2个子元素：repository和snapshotRepository, 前者表示发布版本构件的仓库，后者表示快照版本的仓库

这两个元素都需要配置 id(该远程仓库的唯一标识)，name，url(表示该仓库的地址)

向远程仓库中部署构件，需要进行认证。配置同上

配置正确后运行： mvn clean deploy

3.3、正确的看待快照

之前我们在配置pom的时候，对于快照的配置都很谨慎，或者说很少用快照的版本，原因是它还很不稳定，极容易给我们的系统带来未知的错误，让我们很难查找。其实快照版本也并不是一无是处，快照最大的用途是用在开发的过程中，尤其是有模块依赖的时候，比如说AB两个模块同时开发，A依赖于B，开发过程中AB都是持续集成的开发，不断的修改POM文件和构建工程，这时候版本同步就成了一个很大的问题。使用快照就可以达到这一目的。

其实在快照版本在发布的过程中，Maven会自动为构件以当前时间戳做标记，有了这个时间戳，我们就可以随时找到最新的快照版本，这样也就解决刚才说的协作开发的问题。

至于A如何检查B的更新，刚刚在讲配置的时候说过，快照配置中有一个元素可以控制检查更新的频率------updatePolicy

我们也可以使用命令行加参数的形式强制执行让maven检查更新：

mvn clean install-U

3.4、maven到底是如何从仓库中解析构件的呢？----maven从仓库解析依赖的机制

1. 当依赖的范围是system的时候，Maven直接从本地文件系统解析构件

2. 根据依赖坐标计算仓库路径后，尝试直接从本地仓库寻找构件，如果发现相应构件，则解析成功

3. 在本地仓库不存在相应的构件情况下，如果依赖的版本是显示的发布版本构件，则遍历所有的远程仓库，发现后下载使用

4. 如果依赖的版本是RELEASE或LATEST, 则基于更新策略读取所有远程仓库的元数据，将其于本地仓库的对应元数据合并后，计算出RELEASE或者LATEST的真实值，然后基于这个真实值检查本地仓库

5. 如果依赖的版本是SNAPSHOT，则基于更新策略读取所有远程仓库的元数据，将其与本地仓库的对应元数据合并后，得到最新快照版本的值，然后基于该值检查本地仓库或从远程仓库下载

6. 如果最后解析到的构件版本是时间戳格式的快照，则复制其时间戳格式的文件至非时间戳格式，并使用该非时间戳格式的构件

注：一定要记得<release> <enabled> & <snapshot> <enabled> ，对于快照也是一样

在POM的依赖声明的时候不推荐使用LATEST & RELEASE, 在Maven3中也不再支持在插件配置中使用LATEST & RELEASE，如果不设置插件版本，那么最终版本和release一样，maven只会解析最新的发布版本构建。

四、Maven依赖关系中Scope的作用

Dependency Scope 在POM 4中，<dependency>中还引入了<scope>，它主要管理依赖的部署。目前依赖项的作用域<scope>可以使用5个值：

在定义项目的依赖项的时候，我们可以通过scope来指定该依赖项的作用范围。scope的取值有compile、runtime、test、provided、system和import。

compile：这是依赖项的默认作用范围，即当没有指定依赖项的scope时默认使用compile。compile范围内的依赖项在所有情况下都是有效的，包括运行、测试和编译时。

runtime：表示该依赖项只有在运行时才是需要的，在编译的时候不需要。这种类型的依赖项将在运行和test的类路径下可以访问。

test：表示该依赖项只对测试时有用，包括测试代码的编译和运行，对于正常的项目运行是没有影响的。

provided：表示该依赖项将由JDK或者运行容器在运行时提供，也就是说由Maven提供的该依赖项我们只有在编译和测试时才会用到，而在运行时将由JDK或者运行容器提供。

system：当scope为system时，表示该依赖项是我们自己提供的，不需要Maven到仓库里面去找。指定scope为system需要与另一个属性元素systemPath一起使用，它表示该依赖项在当前系统的位置，使用的是绝对路径。

五、POM文件里面可以引用一些内置属性(Maven预定义可以直接使用)

${basedir} 项目根目录

${version}表示项目版本;

${project.basedir}同${basedir};

${project.version}表示项目版本,与${version}相同;

${project.build.directory} 构建目录，缺省为target

${project.build.sourceEncoding}表示主源码的编码格式;

${project.build.sourceDirectory}表示主源码路径;

${project.build.finalName}表示输出文件名称;

${project.build.outputDirectory} 构建过程输出目录，缺省为target/classes

六、如何在Maven项目中引入本地包呢？

比如我从其它项目打一个jar包，引入到现有项目中。

6.1、将待引入的包放在目录下如lib目录下，修改pom文件，加入依赖并且scope要设置为system

<groupId>com.fbcds</groupId>

<artifactId>fbcds</artifactId>

<scope>system</scope>

<systemPath>${project.basedir}/lib/fbcds.jar</systemPath>

</dependency>

</dependencies>

上面设置完成后，运行mvn package命令执行成功。但打出来的包里面不包含lib目录和fbcds.jar这个引用的包，即打出来的包不是可执行的jar。所以个人开发的话可以使用这种方式，如果团队开发请使用方法二。

6.2、将待引入的jar包安装到本地repository中

1、先把待引入的jar包放在一个目录下，需要改一下包名，如fbcds.jar修改成fbcds-1.0.jar，如F:\lib目录，在命令行CD到lib目录，执行以下命令:

mvn install:install-file -Dfile=fbcds-1.0.jar -DgroupId=fbcds -DartifactId=fbcds -Dversion=1.0 -Dpackaging=jar

mvn install:install-file -Dfile=ojdbc7-1.0.jar -DgroupId=ojdbc7 -DartifactId=ojdbc7 -Dversion=1.0 -Dpackaging=jar

2、修改项目pom文件加入包对应的依赖

</dependency>

<groupId>fbcds</groupId>

<artifactId>fbcds</artifactId>

</dependency>

<groupId>ojdbc7</groupId>

<artifactId>ojdbc7</artifactId>

</dependency>

</dependencies>

上面的fbcds和ojdbc7就是新加的引用包的依赖。

完成后，在本地仓库可看到对应的文件夹内容：

七、Maven如何打可执行的JAR包

前提条件：已成功将待引入的jar包安装到本地repository中

7.1、使用maven-shade-plugin插件打可执行的jar包

插件查找链接：http://maven.apache.org/plugins/

1、测试类代码

package com.zhy.test;

import java.sql.Connection;

import java.sql.DriverManager;

import java.sql.ResultSet;

import java.sql.SQLException;

import java.sql.Statement;

import com.eclink.fbcis.store.StoreDao;

public class TestClass {

public static void main(String[] args) {

StoreDao a = new StoreDao();

System.out.println("------" + a.toString());

Connection con = null;

Statement st = null;

ResultSet rs = null;

try {

String sql = "select * from temp_head where temp_no='C530015I19008015'";

Class.forName("oracle.jdbc.driver.OracleDriver");

con = DriverManager.getConnection("jdbc:oracle:thin:@//10.101.2.19:1521/pdbqmytcis","qmytcis","qmytcis123");

st = con.createStatement();

rs = st.executeQuery(sql);

if(rs.next()){

System.out.println(rs.getString("temp_no"));

}

} catch (Exception e) {

e.printStackTrace();

} finally{

try {

rs.close();

st.close();

con.close();

} catch (SQLException e) {

e.printStackTrace();

}

上面类中引用到了fbcds和ojdbc7包的内容。

2、对应pom文件

<version>0.0.1-SNAPSHOT</version>

</dependency>

<groupId>fbcds</groupId>

<artifactId>fbcds</artifactId>

</dependency>

<groupId>ojdbc7</groupId>

<artifactId>ojdbc7</artifactId>

</dependency>

</dependencies>

<build>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-shade-plugin</artifactId>

<phase>package</phase>

<goals>

<goal>shade</goal>

</goals>

<mainClass>com.lwf.test.TestClass</mainClass>

</transformer>

</transformers>

</configuration>

</execution>

</executions>

</plugin>

</plugins>

</build>

</project>

在eclipse中右键项目run as 选择Maven package，可看打包的target目录内容：

比较两个包内容：

执行包：cmd下original-MavenPackage-0.0.1-SNAPSHOT.jar中没有主清单属性是执行不了的。

参见：http://www.mkyong.com/maven/create-a-fat-jar-file-maven-shade-plugin/

7.2、使用maven-assembly-plugin插件打可执行的jar包

测试类与方法一中一样，只是pom不一样，pom文件如下:

<groupId>com.lwf.MavenPackage</groupId>

<artifactId>MavenPackage</artifactId>

<version>0.0.1-SNAPSHOT</version>

<name>MavenPackage</name>

</dependency>

<groupId>fbcds</groupId>

<artifactId>fbcds</artifactId>

</dependency>

<groupId>ojdbc7</groupId>

<artifactId>ojdbc7</artifactId>

</dependency>

</dependencies>

<build>

<!--

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-shade-plugin</artifactId>

<phase>package</phase>

<goals>

<goal>shade</goal>

</goals>

<mainClass>com.lwf.test.TestClass</mainClass>

</transformer>

</transformers>

</configuration>

</execution>

</executions>

</plugin>

-->

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-assembly-plugin</artifactId>

<descriptorRef>jar-with-dependencies</descriptorRef>

</descriptorRefs>

<mainClass>com.lwf.test.TestClass</mainClass>

</manifest>

</archive>

</configuration>

<id>make-assembly</id>

<phase>package</phase>

<goals>

<goal>single</goal>

</goals>

</execution>

</executions>

</plugin>

</plugins>

</build>

</project>

修改完pom后，在eclipse中右键项目run as 选择Maven package，可看打包的target目录内容：

两个jar文件比较：

参见：http://www.mkyong.com/maven/create-a-fat-jar-file-maven-assembly-plugin/

7.3、使用onejar-maven-plugin插件打可执行的jar包

测试类与方法一中一样，只是pom不一样，pom文件如下:

<groupId>com.lwf.MavenPackage</groupId>

<artifactId>MavenPackage</artifactId>

<version>0.0.1-SNAPSHOT</version>

<name>MavenPackage</name>

</dependency>

<groupId>fbcds</groupId>

<artifactId>fbcds</artifactId>

</dependency>

<groupId>ojdbc7</groupId>

<artifactId>ojdbc7</artifactId>

</dependency>

</dependencies>

<build>

<!--

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-shade-plugin</artifactId>

<phase>package</phase>

<goals>

<goal>shade</goal>

</goals>

<mainClass>com.lwf.test.TestClass</mainClass>

</transformer>

</transformers>

</configuration>

</execution>

</executions>

</plugin>

-->

<!--

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-assembly-plugin</artifactId>

<descriptorRef>jar-with-dependencies</descriptorRef>

</descriptorRefs>

<mainClass>com.lwf.test.TestClass</mainClass>

</manifest>

</archive>

</configuration>

<id>make-assembly</id>

<phase>package</phase>

<goals>

<goal>single</goal>

</goals>

</execution>

</executions>

</plugin>

-->

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-jar-plugin</artifactId>

<mainClass>com.lwf.test.TestClass</mainClass>

</manifest>

</archive>

</configuration>

</plugin>

<groupId>com.jolira</groupId>

<artifactId>onejar-maven-plugin</artifactId>

<classifier>onejar</classifier>

</configuration>

<goals>

</goals>

</execution>

</executions>

</plugin>

</plugins>

</build>

</project>

7.4：使用maven-jar-plugin和maven-dependency-plugin打可执行包，引用的包放包外面文件夹下

其他不变，pom文件如下

<groupId>com.lwf.MavenPackage</groupId>

<artifactId>MavenPackage</artifactId>

<version>0.0.1-SNAPSHOT</version>

<name>MavenPackage</name>

</dependency>

<groupId>fbcds</groupId>

<artifactId>fbcds</artifactId>

</dependency>

<groupId>ojdbc7</groupId>

<artifactId>ojdbc7</artifactId>

</dependency>

</dependencies>

<build>

<!--

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-shade-plugin</artifactId>

<phase>package</phase>

<goals>

<goal>shade</goal>

</goals>

<mainClass>com.lwf.test.TestClass</mainClass>

</transformer>

</transformers>

</configuration>

</execution>

</executions>

</plugin>

-->

<!--

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-assembly-plugin</artifactId>

<descriptorRef>jar-with-dependencies</descriptorRef>

</descriptorRefs>

<mainClass>com.lwf.test.TestClass</mainClass>

</manifest>

</archive>

</configuration>

<id>make-assembly</id>

<phase>package</phase>

<goals>

<goal>single</goal>

</goals>

</execution>

</executions>

</plugin>

-->

<!--

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-jar-plugin</artifactId>

<mainClass>com.lwf.test.TestClass</mainClass>

</manifest>

</archive>

</configuration>

</plugin>

<groupId>com.jolira</groupId>

<artifactId>onejar-maven-plugin</artifactId>

<classifier>onejar</classifier>

</configuration>

<goals>

</goals>

</execution>

</executions>

</plugin>

-->

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-jar-plugin</artifactId>

<exclude>**/log4j.properties</exclude>

</excludes>

<mainClass>com.lwf.test.TestClass</mainClass>

</manifest>

</archive>

</configuration>

</plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-dependency-plugin</artifactId>

<id>copy-dependencies</id>

<phase>package</phase>

<goals>

<goal>copy-dependencies</goal>

</goals>

<includeScope>runtime</includeScope>

<outputDirectory>${project.build.directory}/lib/</outputDirectory>

</configuration>

</execution>

</executions>

</plugin>

</plugins>

</build>

</project>

可以看到依赖的包拷贝到了lib目录下，打的包里没有依赖包的信息，只是简单的包，不过Manifest文件class-path要包含引用名的路径

Manifest-Version: 1.0

Built-By: lweifeng

Build-Jdk: 1.7.0_17

Class-Path: lib/log4j-1.2.17.jar lib/fbcds-1.0.jar lib/ojdbc7-1.0.jar

Created-By: Apache Maven 3.3.9

Main-Class: com.lwf.test.TestClass

Archiver-Version: Plexus Archiver

在以上前三种插件打包方式中，maven-shade-plugin和maven-assembly-plugin采取的是将依赖包解压再一并打到新包中，这样依赖包可能存在冲突的时候，导致运行时可能出现未知问题，而onejar-maven-plugin打包是将依赖包自动归入lib目录，不解压原包，相当于在原包基础上加壳，这样可以避免冲突的发生。第四种方法即是我们原来ant打包所使用的方法。

最新回复 (0)

只看楼主

全部楼主

Maven仓库、将本地Jar包安装到仓库、打可执行的Jar总结

xingyun86

作者最近主题：