《实现 DevOps 平台（1） · GitLab API 交互》

大家好，我是 【战神刘玉栋】，有10多年的研发经验，致力于前后端技术栈的知识沉淀和传播。
CSDN入驻不久，希望大家多多支持，后续会继续提升文章质量，绝不滥竽充数，欢迎多多交流。

写在前面的话

本系列文章，打算介绍一下如何开发一个企业常用的 DevOps 工具。
此系列的第一篇，先介绍基础的GitLabAPI，看代码如何与之交互。。

技术栈：后端 SpringCloud + 前端 Vue/Nuxt

Gitlab4j 交互

Step1、引入 Maven 依赖

<dependency>
    <groupId>org.gitlab4j</groupId>
    <artifactId>gitlab4j-api</artifactId>
    <version>4.9.0</version> <!-- 使用合适的版本号 -->
</dependency>

Step2、将 GitLabService封装为 Spring 的 Service Bean，以便在 Spring Boot 应用程序中使用。

@Service
public class GitLabServiceBean implements GitLabService {

    private final GitLabApi gitLabApi;

    @Value("${gitlab.url}")
    private String gitLabUrl;

    @Value("${gitlab.private.access.token}")
    private String privateAccessToken;

    public GitLabServiceBean() {
        gitLabApi = new GitLabApi(gitLabUrl, privateAccessToken);
    }

    /**
     * 获取所有群组信息
     */
    public List<Group> getGroups() throws GitLabApiException {
        List<Group> groups = gitLabApi.getGroupApi().getGroups();
        for (Group group : groups) {
            System.out.println("Group ID: " + group.getId() + ", Name: " + group.getName());
        }
        return groups;
    }
}

Step3、使用 @RestController 注解来创建一个控制器，它将使用 GitLabService 来处理 HTTP 请求。

@RestController
@RequestMapping("/gitlab")
public class GitLabRestController {

    @Autowired
    private GitLabServiceBean gitLabServiceBean;

    @GetMapping("/getGroups")
    public ResponseEntity<?> listProjects() {
        List<Group> groups = gitLabServiceBean.getGroups();
        return ResponseEntity.ok(groups);
    }
}

以上是使用 gitlab4j-api 在 Spring Boot 应用程序中进行基本操作的一个简单示例。请确保你已经正确配置了 GitLab API 的访问权限，并且根据你的需求调整代码。

示例二：

public static void main(String[] args) {
    String gitLabUrl = "http://192.168.4.113";
    String privateToken = "glpat-9LLBZh1hzShcH_HFtqjo";
    try (GitLabApi gitLabApi = new GitLabApi(gitLabUrl, privateToken)) {
        
        // 获取项目信息
        Project project = gitLabApi.getProjectApi().getProject("onelink/service", "onelink-micro-portal");
        System.out.println("Project Info: " + JSON.toJSONString(project));
        System.out.println("-----");
        
        // 获取标签列表
        List<Tag> tags = gitLabApi.getTagsApi().getTags(project.getId());
        for (Tag tag : tags) {
            System.out.println("Tag Name: " + tag.getName());
            System.out.println("Commit ID: " + tag.getCommit().getId());
            System.out.println("-----");
        }
        
        // 获取提交记录
        List<Commit> commits = gitLabApi.getCommitsApi().getCommits(project.getId());
        System.out.println(commits.size());
    } catch (Exception e) {
        e.printStackTrace();
    }
}

总结陈词

此篇文章介绍了 GitLabAPI 项目中如何与代码交互，是本系列文章的基础部分，仅供学习参考。
后续会逐步分享企业实际开发中的实战经验，有需要交流的可以联系博主。