springCloud使用maven

深藏阁楼爱情的钟 2023-10-10 18:28 30阅读 0赞

#### springCloud项目使用maven集成nexus ####

*  一：故事背景
 *  二：基础概念
 *   *  2.1 什么是Maven
     *  2.2 什么是nexus
 *  三：实操
 *   *  3.1 setting文件配置
     *  3.2 项目内pom.xml配置
     *  3.3 jar上传
     *   *  3.3.1 maven插件上传
         *  3.3.2 mvn命令上传
         *  3.3.3 页面上传
         *  3.3.4 通过Rest的方式进行上传
         *   *  3.4.1 pom依赖
             *  3.4.2上传代码
 *  四：jar包下拉
 *  五：总结提升

## 一：故事背景 ##

我们的ar项目要开发第三版。现在要进行框架的搭建。搭建的是一个springCloud的项目。项目结构是参照第二版进行搭建的。不过这次搭建的过程中，集成了nexus，使用nexus做仓库，管理我们的项目。今天就总结一下，**如何在springCloud项目集成nexus**

## 二：基础概念 ##

### 2.1 什么是Maven ###

Maven是一个**Java项目管理和自动构建工具**。它使用**基于XML**的配置文件来定义项目的结构和依赖关系，并使用这些信息来自动生成项目的构建脚本。Maven可以自动下载所需的依赖项并将它们添加到项目的classpath中，还可以自动生成项目文档和报告，并且可以与许多其他工具集成。通过使用Maven，开发人员可以更加专注于编写代码，而不必担心配置文件和依赖项管理等问题。

### 2.2 什么是nexus ###

Nexus是一个开源的仓库管理器，它用于管理软件**构件和依赖项**。它提供了一个集中式的存储库来存储各种类型的构件，例如Jar文件、WAR文件、ZIP文件、RPM包等。Nexus还提供了一组工具和API，使得开发人员可以方便地发布、管理和下载构件。Nexus的一个主要优势是它可以与Maven集成，这使得在使用Maven进行构建时更加容易地管理依赖项和存储构件。此外，Nexus还提供了对安全性和访问控制的支持，以确保仓库中的构件仅被授权的用户访问。  
了解

## 三：实操 ##

实操前，默认大家已经安装好了maven和nexus，这里不多做介绍，如果大家需要可以网上查询，相关博客很多。

### 3.1 setting文件配置 ###

<settings>
      
      <servers>
        <server>
          <id>my-server</id> 
          <username>user</username> 
          <password>password</password> 
        </server>
      </servers>
    
      
      <mirrors>
        <mirror>
          <id>aliyun</id> 
          <name>aliyun maven mirror</name> 
          <url>http://maven.aliyun.com/nexus/content/groups/public/</url> 
          <mirrorOf>central</mirrorOf> 
        </mirror>
      </mirrors>
    
      
      <proxies>
        <proxy>
          <id>my-proxy</id> 
          <active>true</active> 
          <protocol>http</protocol> 
          <host>proxy.mycompany.com</host> 
          <port>8080</port> 
          <username>user</username> 
          <password>password</password> 
          <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts> 
        </proxy>
      </proxies>
    
      
      <localRepository>${user.home}/.m2/repository</localRepository>
    
      
      <offline>false</offline>
    
      
      <pluginGroups>
        <pluginGroup>org.apache.tomcat.maven</pluginGroup> 
      </pluginGroups>
    
      
      <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
      </properties>
    </settings>

### 3.2 项目内pom.xml配置 ###

你需要在你的父项目里添加如下配置。如果你的项目之间有父子依赖关系，只在子项目内进行jar包上传，在下拉的时候，有子项目会去找父项目的依赖而导致报错

<distributionManagement>
            
            <repository>
                
                <id>test_hosted</id>
                
                <name>Releases</name>
                
                <url>http://xxx.xxx.xx.xxx:port/repository/test_hosted/</url>
            </repository>
            
            <snapshotRepository>
                
                <id>test_snapshot_hosted</id>
                
                <name>Snapshot</name>
                
                <url>http://xxx.xxx.xx.xxx:port/repository/test_snapshot_hosted/</url>
            </snapshotRepository>
        </distributionManagement>

### 3.3 jar上传 ###

配置好之后，我们就可以尝试进行上传了。上传一共有四种方式

#### 3.3.1 maven插件上传 ####

我们可以直接通过idea带的插件，进行上传，他会去setting读取我们配置的账号，密码，去pom文件读取上传的地址和仓库，上传之后，nexus内会有我们项目对应的jar包  
![在这里插入图片描述][2b6c876be1134ca0a855132bd474856b.png]  
上传成功后在我们的nexus上可以看到对应的文件  
![在这里插入图片描述][0b737f24a9ed48cbb200397075ceae77.png]

#### 3.3.2 mvn命令上传 ####

我们也可以直接通过命令将jar包进行上传，上传到nexus，这里只会读取setting里配置的账号密码，上传的路径，版本等信息，需要我们自己配置

mvn deploy:deploy-file -DgroupId=<group-id> -DartifactId=<artifact-id> \
    -Dversion=<version> -Dpackaging=<packaging> -Dfile=<path-to-file> \
    -DrepositoryId=nexus -Durl=<nexus-url>

上面的参数对应  
\-DgroupId：Maven项目的groupId。  
\-DartifactId：Maven项目的artifactId。  
\-Dversion：Maven项目的版本号。  
\-Dpackaging：文件的类型，例如jar、war等。  
\-Dfile：要上传的文件的路径。  
\-DrepositoryId：在Maven的settings.xml中定义的服务器的id。在这个例子中，我们使用nexus作为id。  
\-Durl：Nexus服务器的URL地址。

大家使用的时候，请将<group-id>、<artifact-id>、<version>和<packaging>替换为您的Maven项目的实际值，
    将<path-to-file>替换为要上传的文件的路径。将<nexus-url>替换为您Nexus服务器的URL地址。

#### 3.3.3 页面上传 ####

这个没有什么技术含量，将对应信息填对就可以了

1.  选择要上传到那个仓库  
    ![在这里插入图片描述][b86b2c8be45447ec859c23672fef9940.png]
2.  填写信息，选择文件，完成之后进行上传就可以了。  
    ![3.][]

#### 3.3.4 通过Rest的方式进行上传 ####

可以通过接口的方式进行上传，官方文档里也有具体的api文档，但是做起来比较复杂，我们这里只做了研究，并没有在项目里实际进行应用。

##### 3.4.1 pom依赖 #####

<dependencies>
            <dependency>
                <groupId>org.apache.httpcomponents</groupId>
                <artifactId>httpcore</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-web</artifactId>
            </dependency>
        </dependencies>

##### 3.4.2上传代码 #####

public static void main(String[] args)  {
        
        RestTemplate restTemplate = new RestTemplate(); // 创建RestTemplate实例
        String username = "admin"; // 用户名
        String password = "admin"; // 密码
        restTemplate.getInterceptors().add(
                new BasicAuthenticationInterceptor(username, password)); // 添加Basic Authentication拦截器，用于进行Http Basic认证
    
        String filename = "D:\\项目开发\\metaverse3-backend\\metaverse3-gateway\\target\\metaverse3-gateway-1.0-SNAPSHOT.jar"; // 文件路径
        File file = new File(filename); // 创建文件对象
        FileSystemResource resource = new FileSystemResource(file); // 创建文件系统资源对象
        MultiValueMap<String, Object> requestMap = new LinkedMultiValueMap<>(); // 创建请求参数Map
        requestMap.add("file", resource); // 添加文件系统资源对象到请求参数Map中
        HttpHeaders headers = new HttpHeaders(); // 创建HttpHeaders对象
        headers.setContentType(MediaType.MULTIPART_FORM_DATA); // 设置Content-Type为multipart/form-data
        HttpEntity<MultiValueMap<String, Object>> requestEntity = new HttpEntity<>(requestMap, headers); // 创建HttpEntity对象，用于发送POST请求
    
        test(restTemplate, requestEntity); // 调用test方法发送请求
    }
    
    public static void test(RestTemplate restTemplate, HttpEntity<MultiValueMap<String, Object>> requestEntity){
        
        String url = "http://xxx.xxx.xx.xxx:port/repository/test_snapshot_hosted/"; // Nexus仓库URL
        String groupId = "com.mycompany"; // Maven groupId
        String artifactId = "my-artifact"; // Maven artifactId
        String version = "1.0-SNAPSHOT"; // Maven版本号
        String packaging = "jar"; // 打包类型
        String classifier = "my-classifier"; // 分类器
        String repositoryPath = groupId.replace('.', '/') + '/' + artifactId + '/' + version + '/' + artifactId + '-' + version + (classifier == null ? "" : '-' + classifier) + '.' + packaging; // Nexus仓库中存储的路径
        String nexusUrl = url + repositoryPath; // 完整的Nexus仓库URL
        ResponseEntity<String> responseEntity = restTemplate.exchange(nexusUrl, HttpMethod.PUT, requestEntity, String.class); // 发送PUT请求，将文件上传到Nexus仓库
    }

通过以上代码可以将对应jar包上传到对应nexus。大家可以基于次部分代码进行相应改造

## 四：jar包下拉 ##

jar包下拉的方式很简单，只要找到我们上传的jar包，然后再需要使用的项目的pom文件下使用 **dependency**标签引入就可以了，大家都应该有过引入的经验，这里就不多解释了  
![在这里插入图片描述][7c3974ad730149619797a9a64809eb89.png]

## 五：总结提升 ##

本文介绍了如何集成nexus，并且给出上传jar包的各种方式，大家可以根据自己的需求进行实操。

[2b6c876be1134ca0a855132bd474856b.png]: https://img-blog.csdnimg.cn/2b6c876be1134ca0a855132bd474856b.png
[0b737f24a9ed48cbb200397075ceae77.png]: https://img-blog.csdnimg.cn/0b737f24a9ed48cbb200397075ceae77.png
[b86b2c8be45447ec859c23672fef9940.png]: https://img-blog.csdnimg.cn/b86b2c8be45447ec859c23672fef9940.png
[3.]: https://img-blog.csdnimg.cn/aaceccc4017c4551a510d4b186b3217f.png
[7c3974ad730149619797a9a64809eb89.png]: https://img-blog.csdnimg.cn/7c3974ad730149619797a9a64809eb89.png