文章目录
  1. 1. Maven仓库搭建原理
  2. 2. HTTP服务器搭建Maven仓库
  3. 3. jar包部署到仓库
    1. 3.1. 方法一：手动部署
    2. 3.2. 方法二：SSH自动部署
  4. 4. Maven仓库使用

作为一个Java老程序员，多多少少都会有一些自己写的各种常用代码，如果每写一个项目都把这些代码拷贝一份到新项目比较麻烦的，打成jar包引入到项目会方便很多。如果想让这些jar包能通过Maven引入进项目，那就需要搭建Maven仓库。

说到Maven仓库搭建，很多人第一想到的一般都是Nexus。Nexus的确是非常好的方案，但是总归需要一台服务器，一台服务器需要花钱买和花时间维护，成本比较大。Nexus一般是公司用的比较多，个人不建议使用。

实际上除了Nexus外，还有很多Maven仓库的搭建方案。例如可以将Maven仓库搭建在GitHub等代码托管平台上，免费。甚至也可以搭建在七牛云、又拍云、阿里云对象存储OSS、腾讯云对象存储服务COS等云存储上，加上CDN可以有很快的下载速度，虽然云存储是收费的，但是一般都有免费额度，例如一个月10G流量，通常来说已经很够用了。

本篇博文主要内容是使用HTTP服务器搭建Maven仓库，用于学习Maven仓库搭建原理，并不是想替代Nexus。在本系列接下来的博文中会讲到如何用代码托管平台（如GitHub）、云存储平台（如七牛、阿里云OSS）来搭建Maven仓库。

Maven仓库搭建原理

首先，Maven有个中央仓库：http://repo.maven.apache.org/maven2/，里面包含很多常用的开源项目的包。

在自己项目的pom.xml文件中加入一个dependency，例如Spring框架的一个包：

1
2
3
4
5
<dependency>
	<groupId>org.springframework</groupId>
	<artifactId>spring-core</artifactId>
	<version>4.1.6.RELEASE</version>
</dependency>

Maven会将仓库地址、groupId、artifactId、version四个部分拼接起来，得到最终的jar包下载地址：
http://repo.maven.apache.org/maven2/org/springframework/spring-core/4.1.6.RELEASE/spring-core-4.1.6.RELEASE.jar

当然，除了jar包外还有一些其他需要的文件，具体可以查看目录：
http://repo.maven.apache.org/maven2/org/springframework/spring-core/4.1.6.RELEASE/

Maven中央仓库中的Spring

如果是自己的或公司内部使用的jar包，在中央仓库肯定是没有的，这就需要配置一个自己的repository，指定包的下载地址。

1
2
3
4
5
6
7
8
9
10
<repository>
	<id>my-repository</id>
	<url>http://115.159.216.216:8080/</url>
</repository>
...
<dependency>
	<groupId>com.xxg.cloudstorage</groupId>
	<artifactId>cloudstorage</artifactId>
	<version>1.0.0</version>
</dependency>

同理，此时Maven会根据repository配置的url生成文件下载地址：
http://115.159.216.216:8080/com/xxg/cloudstorage/cloudstorage/1.0.0/cloudstorage-1.0.0.jar

HTTP服务器搭建Maven仓库

有了上面的理论基础，用HTTP服务器搭建Maven仓库就不难了，无非是把所需要的文件按照以上规则放到对应的目录下，HTTP服务器的作用说白了仅仅就是提供文件的HTTP下载地址。

首先需要一台服务器，再安装一个HTTP服务器软件，如Tomcat、Apache、Nginx等，任选其一即可。

例如使用Java程序员喜闻乐见的Tomcat，使用Tomcat的webapps/ROOT目录作为Maven仓库的文件存放目录。

jar包部署到仓库

如果想把自己的jar包部署到仓库上供自己或别人引用，只有jar文件是不够的，里面上面Spring仓库的目录可以看到除了jar，还有pom、md5、sha1等各种文件，这些文件都可以通过mvn deploy命令来生成。

方法一：手动部署

在项目的pom.xml中添加：

1
2
3
4
5
6
<distributionManagement>
	<repository>
		<id>file-repository</id>
		<url>file://D:\abc</url>
	</repository>
</distributionManagement>

运行mvn deploy命令可以看到在D:\abc目录下生成了目录和各种文件。将整个目录上传到Tomcat的webapps/ROOT，此时在浏览器上访问以下地址即可通过HTTP直接下载jar包：
http://115.159.216.216:8080/com/xxg/cloudstorage/cloudstorage/1.0.0/cloudstorage-1.0.0.jar

方法二：SSH自动部署

如果服务器是Linux服务器，还可以直接通过mvn deploy通过scp方式将整个目录直接传到服务器的Tomcat的webapps/ROOT目录下，省去手动上传文件的步骤。

pom.xml配置服务器地址和文件路径：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<distributionManagement>
	<repository>
		<id>my-server</id>
		<url>scp://115.159.216.216/home/ubuntu/coder/apache-tomcat-8.5.5/webapps/ROOT</url>
	</repository>
</distributionManagement>

<build>
	<extensions>
		<extension>
			<groupId>org.apache.maven.wagon</groupId>
			<artifactId>wagon-ssh</artifactId>
			<version>2.10</version>
		</extension>
	</extensions>
</build>

在Maven的settings.xml中配置服务器的SSH用户名和密码：

1
2
3
4
5
<server>
	<id>my-server</id>
	<username>root</username>
	<password>your-password</password>
</server>

Maven仓库使用

部署完成后，已经可以直接下载jar包，那么就可以在其他项目中通过dependency加入这个包的依赖了。

1
2
3
4
5
6
7
8
9
10
<repository>
	<id>my-repository</id>
	<url>http://115.159.216.216:8080/</url>
</repository>
...
<dependency>
	<groupId>com.xxg.cloudstorage</groupId>
	<artifactId>cloudstorage</artifactId>
	<version>1.0.0</version>
</dependency>

文章目录
  1. 1. Maven仓库搭建原理
  2. 2. HTTP服务器搭建Maven仓库
  3. 3. jar包部署到仓库
    1. 3.1. 方法一：手动部署
    2. 3.2. 方法二：SSH自动部署
  4. 4. Maven仓库使用