在我们做配置管理系统和gitlab系统集成的时候,有一个常见的场景,就是要获取某个文件的commitId,来记录本次配置文件提交的版本。这个通过gitlabApi很容易实现:

GET /projects/:id/repository/files/:file_path?ref=:ref

其中:

  • id:是项目id
  • file_path:文件路径,注意,这里的file_path需要指定到文件,否则会报错,例如:abc/file.txt
  • ref:分支名称,例如:develop

通过此api就能很容易获取到某个项目中的文件commitId和其他一些相关信息。文档地址

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/13083/repository/files/app%2Fmodels%2Fkey%2Erb?ref=master"

响应结果:

{
"file_name": "key.rb",
"file_path": "app/models/key.rb",
"size": 1476,
"encoding": "base64",
"content": "IyA9PSBTY2hlbWEgSW5mb3...",
"content_sha256": "4c294617b60715c1d218e61164a3abd4808a4284cbc30e6728a01ad9aada4481",
"ref": "master",
"blob_id": "79f7bbd25901e8334750839545a9bd021f0e4c83",
"commit_id": "d5a3ff139356ce33e37e73add446f16869741b50",
"last_commit_id": "570e7b2abdd848b95f2f578043fc23bd6f6fd24d",
"execute_filemode": false
}

  但是如果现在需要获取一个文件夹的commitId,如果还是用以上方法,file_path如果传一个文件夹路径,则该方法会报错,显然不适用。那么我们如果要获取一个文件夹的commitId,从而记录本次文件夹(包括其中所有文件)的提交版本,该如何实现呢?为此本人找遍了网上所有的资料,没有一个明确的解决方案,甚至询问了时下最流行的人工智能chatGpt,得到的回答如下:



  这里多说一句题外话,不得不说,chatGpt还是非常强大的,他的回答可以说秒杀了我在网上找的90%的资料,写得是有理有据,看上去很有道理的样子,而且回答的逻辑也很严谨,如果我没验证一番,看这个回答,几乎挑不出任何毛病。

  但是遗憾的是,chatGpt答对了开头,却没答对结尾。为啥这么说呢?因为第一个获取文件夹的api确实没给错,但是获取到的文件夹返回对象返回的id,却不是我期待已久的commitId,而是一个treeId,我们chatGpt给出来的信息,似乎告诉我们必须要通过这个treeId来找到commitId,这才算是找到了这个文件夹的commitId。

  按照chatGpt提供的第二个api,我们看到可以直接通过treeId获取到commitId,于是我验证了一番,发现这个api并不是这么用的,为此我查阅了官方文档的api之后,发现这个api根本没有这个treeId的传参,而且官方文档也根本没有通过treeId来找到commitId的相应api(我猜测可能是chatGpt的最新数据库只更新到了2021年,所以他了解到的gitlabApi版本落后的缘故,但是他的回答确实已经给了我很大的参考价值,确实是个很棒的人工智能)。

  就此,开发陷入卡壳状态,苦思冥想不得其姐,按道理来说不应该呀,gitlab页面上明明能显示出文件夹的commitId,gitlab却没有提供相应api能拿到这个commitId?这不科学,莫非是方向走错了,其实并没一个通过treeId获取commitId的概念,是我被chatGpt误导了?

  这逼得我不得不研究了一下gitlab项目仓库中文件的commitId、文件夹commitId以及整个项目commitId的更新规律,看看他们到底是怎么变化的,文件夹的commitId和文件的commitId到底是不是同一回事,为此,我用一个gitlab的文档仓库的develop分支做了如下实验:

先记录下几个值:

project的commitId:d1a982d706df99ac4e1c5c0c331b9f65c6d16e6d

project根目录下文件夹abc的commitId:44ef733bb2fdd0b8d0661473351efd662b2e33b4

project根目录下文件hello.txt的commitId:621fe03c295f36c8e1941e43afcd82021daecb00

然后做如下操作:

  1. 修改abc文件夹下的文件hello.txt,此时,此文件的commitId更新为:a61557d137efb0ba2f578461bad10ec101270d88
  2. 此时,观察abc文件夹的commitId,我们发现,他的commitId也变为了:a61557d137efb0ba2f578461bad10ec101270d88
  3. 此时,再观察此project项目的commitId,我们发现,他的commitId也变为了:a61557d137efb0ba2f578461bad10ec101270d88
  4. 此时,在观察abc文件夹中其他文件以及和abc文件夹同级的其他文件,他们的commitId还是保持原样未变。

  此时,我们似乎隐隐约约得出了这样一个结论,某文件夹内的任一文件做了最新的一次修改,其所在文件夹也会更新为这最新的一次修改,但是与这个文件同级的此文件夹下的其他文件,commitId不会变化。

我们继续实验:

先记录下几个值:

project的commitId:a61557d137efb0ba2f578461bad10ec101270d88

project根目录下文件夹abc的commitId:a61557d137efb0ba2f578461bad10ec101270d88

project根目录下文件README.md

(和abc文件夹同级)的commitId:f6815e7bb31f7cf34a9f774a4c4b1966f6ae33e2

  1. 修改project根目录下文件README.md,其commitId变为:7eb3a4f553196ea21867b97ab60c3e94163b8b25
  2. 观察project的commitId,竟然也变成了:7eb3a4f553196ea21867b97ab60c3e94163b8b25
  3. 再次观察abc文件夹的commitId,还是之前的:a61557d137efb0ba2f578461bad10ec101270d88,并没有变化。

  到此,我们似乎真的可以得出一个肯定的结论:项目下任一文件做了最新的一次修改(或是添加、删除),生成了一个新的commitId值,这个值除了会更新文件本身的commitId,还会更新其所在文件夹的commitId值,这个规律一直向上一级文件夹延伸,一直延伸到根目录更新project的commitId,但其他文件或非此文件的父文件夹的commitId不会随之变化。

  换句话说,project的commitId会一直随着他下面任一文件或文件夹的最新的一次更新而变化(可以把project根目录当做是这个项目所有文件的父文件夹)。project下任意的子文件夹,也会随着其文件夹下任一文件或文件夹的最新一次更新而变化,并且也会引起最高层父文件夹,也就是project根目录commitId的变化。

  根据以上在gitlab仓库的亲身体验,我们形成了一个概念,那就是文件夹本身的commitId其实就是这个文件夹下最新的一次文件提交的commitId,那我们似乎有了一个新的思路:前面chatGpt提供的获取文件夹commitId的解决方案,我们是不是可以这么变通一下,第一个api获取某路径下的文件树,获取到的文件树的集合,我们来过滤判断此文件夹存不存在,如果存在,那么第二个获取commits的api的真是用法,可以传路径参数,查出此文件夹路径下所有的commitId的提交集合,然后从这个集合中根据提交时间排序,找出最新的一次提交的commitId,即为这个文件夹的commitId。

代码实现如下(这里为了调用gitlabApi的方便,我们在项目中引入了gitlab4j-api的jar包,实际就是对http请求gitlabApi的封装):

override fun getFileInfoTest(
token: String,
domain: String,
projectId: String,
filePath: String,
dirName: String,
ref: String
) {
val host = if (domain.startsWith("http")) {
domain
} else {
"https://$domain"
}
val gitlab = GitLabApi(host, token)
//获取指定文件目录下的文件树
val fileTree = gitlab.repositoryApi.getTree(projectId, filePath, ref)
//过滤目标文件夹,判断文件夹在指定目录存不存在
val dirExsit = fileTree?.filter { it.path == "$filePath/$dirName" && it.name == dirName }
if (CollectionUtil.isEmpty(dirExsit)) {
println("文件夹不存在")
}
//如果名称不为空,说明此文件夹存在,则找出此文件夹下所有的commit提交记录
val commits = gitlab.commitsApi.getCommits(projectId, ref, "$filePath/$dirName")
if (CollectionUtil.isEmpty(commits)) {
println("commits不存在")
}
//返回的提交记录结果集已经按照提交时间从大到小排序,只需要拿出第一条记录,
//即为此文件夹下所有文件的最新一次提交,即为此文件夹的提交commitId
val commit = commits[0].toString()
println(commit)
}

gitlabApi如何获取项目文件夹的commitId的更多相关文章

  1. Android程序入口以及项目文件夹的含义和使用总结—入门

    新接触一门程序或者开发框架,我一般都要先弄清楚程序的入口在哪里,程序怎么运行的:建立一个项目后,各个文件夹有什么作用以及如何使用等等.理清楚这些东西对以后开发是很有好处的,古话说得好,工欲善其事,必先 ...

  2. android 获取文件夹、文件的大小 以B、KB、MB、GB 为单位

    android 获取文件夹.文件的大小 以B.KB.MB.GB 为单位   public class FileSizeUtil { public static final int SIZETYPE_B ...

  3. Web 在线文件管理器学习笔记与总结(11)获取文件夹信息 (12)返回上一级操作

    (11)获取文件夹信息 文件夹没有修改操作. index.php: <?php require 'dir.func.php'; require 'file.func.php'; require ...

  4. OC获取文件(夹)的代码行数

    /* 考察NSString NSArray NSFileManager */ #import <Foundation/Foundation.h> /* 计算单个文件的代码行数 path:文 ...

  5. cocos2d-x3.2下获取文件夹下所有文件名的方法

    这里提供一个函数获取文件夹下所有文件名的方法,直接上代码了. 原文地址:http://blog.csdn.net/qqmcy/article/details/36184733 // //  Visib ...

  6. 运用CMD命令关于快速获取文件夹名称和快速建立文件夹

    前些天头儿让我建立一本本的文件夹,让后交给我了几个命令,快速获取文件夹的名称和快速建立文件夹,省去了一个个的按F2,一个个的复制,粘贴,一个个的新建,再复制粘贴. 首先讲一下第一个问题,快速获取文件夹 ...

  7. C#获取文件夹下指定格式的所有文件

    C#获取文件夹下指定格式的所有文件的方法,虽然很简单,但还是分享一下吧,用到时可以稍加修改和优化就可以使用. 获取指定目录下所有文件 //最要使用 System.IO.Directory.GetFil ...

  8. C++ 获取文件夹下的所有文件名

    获取文件夹下所有的文件名是常用的功能,今天再一次有这样的需求,所有就在网上查找了很多,并记下以供后用. 原文:http://blog.csdn.NET/cxf7394373/article/detai ...

  9. asp.net -mvc框架复习(2)-创建ASP.NET MVC 第一个程序以及MVC项目文件夹说明

    建议vs2013或2013以上版本的vs,要是跨平台的话最好用vs2015或vs2017的asp.net mvc core . 1.创建ASP.NET MVC 第一个程序 打开vs2013->文 ...

  10. Eclipse导入项目文件夹

    Eclipse项目导入出现感叹号解决方法 出现这样的情况怎么办 右击项目名-Bulid path -configure Bulid path 选择Libraries-Remove(移去错的)-Add ...

随机推荐

  1. Sql Server日期转汉字字符串

    以下脚本转至互联网,增加了自己需要的功能并改成了函数的方式 SET ANSI_NULLS ON GO SET QUOTED_IDENTIFIER ON GO -- ================== ...

  2. 解决sox报错sox FAIL formats: no handler for given file type `mp3

    sudo apt-get install libsox-fmt-mp3

  3. volatile关键字在并发中有哪些作用?

    作者:小牛呼噜噜 | https://xiaoniuhululu.com 计算机内功.JAVA源码.职业成长.项目实战.面试相关资料等更多精彩文章在公众号「小牛呼噜噜」 前言 读过笔者之前的一篇文章J ...

  4. Visual Studio高版本 ArcObject for .Net 低版本

    在基于ArcGIS的开发中,经常会存在Visual Studio版本高,ArcObject for .Net 版本低的问题.例如Visual Studio 2015的环境下,安装ArcObject f ...

  5. jquery操作内容

    <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8&quo ...

  6. 【Java框架】SSM-Spring总结:IOC、DI、AOP、JDBC、事务管理、实际案例

    〇.概述 1.常用资料 2.组成 一.控制反转与依赖注入 (一)Spring概述 1.介绍 以IOC和AOP为内核的框架 通过IOC实现控制,使用spring创建对象,与DI描述同一个概念 DI是对象 ...

  7. 4.1:简单python爬虫

    简单python爬虫 在创建的python文件中输入下列代码: # coding:utf-8 import requests from bs4 import BeautifulSoup def spi ...

  8. AssertionError: Class XXXXX missing "Meta.model" attribute

    源码示例: from rest_framework import serializers from set.models import Set class SetSerializers(seriali ...

  9. Linux下“减速”查看日志的方法

    Linux下"减速"查看日志的方法 需求场景 今天查看日志,有个需求,需要按照指定"速率"输出日志信息到终端屏幕上,方便查看. 这个需求日常应该也经常会碰到,比 ...

  10. prometheus-添加监控linux服务器

    1. prometheus-添加监控linux服务器 prometheus添加监控linux服务器 node_exporter:用于监控Linux系统的指标采集器. 常用指标: CPU 内存 硬盘 网 ...