git学习之jgit
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了git学习之jgit相关的知识,希望对你有一定的参考价值。
一、简介
jgit是存java实现的git版本控制,学习jgit可以更好的理解学习git,其源代码托管在github上JGit。主要的模块如下:
- org.eclipse.jgit 核心实现,包括git命令、协议等
- org.eclipse.jgit.archive 支持导出各种压缩的格式
- org.eclipse.jgit.http.server 支持http协议的服务器,主要提供GitServlet
使用JGit的软件有:EGit(Eclipse git版本管理插件)、Gitblit等。其maven配置坐标为:
<dependency>
<groupId>org.eclipse.jgit</groupId>
<artifactId>org.eclipse.jgit</artifactId>
<version>4.11.0.201803080745-r</version>
</dependency>
二、API使用
1.基本概念
- Repository 包括所有的对象和引用,用来管理源码
- AnyObjectId 表示SHA1对象,可以获得SHA1的值,进而可以获得git对象
- Ref 引用对象,表示.git/refs下面的文件引用 Ref HEAD = repository.getRef("refs/heads/master");
- RevWalk 可以遍历提交对象,并按照顺序返回提交对象
- RevCommit 代表一个提交对象
- RevTag 代表标签对象
-
RevTree 代表树对象
2. 创建本地仓库
Git.init().setGitDir(new File("D:\\source-code\\temp\\.git")).call();--------------不推荐,因为这样新建出来在.git/config文件下面多了一个core.workTree属性,其值为user.dir属性,而不是工作区为temp目录 //推荐如下方式: File dir = new File("D:\\source-code\\temp\\.git"); Git.init().setGitDir(dir).setDirectory(dir.getParentFile()).call();
只需要简单的一行代码就可以创建本地仓库,可以调用setBare方法来设置版本库是否为裸版本库。
注意org.eclipse.jgit.api.Git这个类,其方法返回所有支持的git命令
另外对于所有的命令,使用Builder模式。3.配置本地仓库
Repository build = null; try { build = new RepositoryBuilder().setGitDir(new File("D:\\source-code\\temp\\.git")).setMustExist(true) .build(); build.getConfig().setString(ConfigConstants.CONFIG_USER_SECTION, null, ConfigConstants.CONFIG_KEY_NAME, "xxxx"); build.getConfig().save(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } finally { if (null != build) { //为了节省篇幅,后续代码省略调Git对象和Repository对象的close方法 build.close(); } }
设置完以后可以到.git/config目录下面看到配置生效。版本库api并没有直接提供修改系统或者用户级别的配置(--system、--global),如果用户需要修改这两个级别的,可以参考FileRepository 的构造函数:
if (StringUtils.isEmptyOrNull(SystemReader.getInstance().getenv(
Constants.GIT_CONFIG_NOSYSTEM_KEY)))
systemConfig = SystemReader.getInstance().openSystemConfig(null,
getFS());
else
systemConfig = new FileBasedConfig(null, FS.DETECTED) {
@Override
public void load() {
// empty, do not load
}
@Override
public boolean isOutdated() {
// regular class would bomb here
return false;
}
};
userConfig = SystemReader.getInstance().openUserConfig(systemConfig,
getFS());
loadSystemConfig(); //load完以后,可以直接修改config对象了,最后save一下就可以了
loadUserConfig();
4.修改本地仓库
AddCommand可以把工作区的内容添加到暂存区。
Git git = Git.open(new File("D:\\source-code\\temp\\.git"));
git.add().addFilepattern(".").call(); // 相当与git add -A添加所有的变更文件git.add().addFilepattern("*.java")这种形式是不支持的
git.add().addFilepattern("src/main/java/").call(); // 添加目录,可以把目录下的文件都添加到暂存区
//jgit当前还不支持模式匹配的方式,例如*.java
CommitCommand用于提交操作
Git git =Git.open(new File("D:\\source-code\\temp\\user1\\.git"));
CommitCommand commitCommand = git.commit().setMessage("master 23 commit").setAllowEmpty(true);
commitCommand.call();
5.查看本地仓库
StatusCommand命令等同于git status命令
Git git = Git.open(new File("D:\\source-code\\temp-1\\.git"));
Status status = git.status().call(); //返回的值都是相对工作区的路径,而不是绝对路径
status.getAdded().forEach(it -> System.out.println("Add File :" + it)); //git add命令后会看到变化
status.getRemoved().forEach(it -> System.out.println("Remove File :" + it)); ///git rm命令会看到变化,从暂存区删除的文件列表
status.getModified().forEach(it -> System.out.println("Modified File :" + it)); //修改的文件列表
status.getUntracked().forEach(it -> System.out.println("Untracked File :" + it)); //工作区新增的文件列表
status.getConflicting().forEach(it -> System.out.println("Conflicting File :" + it)); //冲突的文件列表
status.getMissing().forEach(it -> System.out.println("Missing File :" + it)); //工作区删除的文件列表
LogCommand相当于git log命令
//提取某个作者的提交,并打印相关信息
Git git = Git.open(new File("D:\\source-code\\temp-1\\.git"));
DateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Iterable<RevCommit> results = git.log().setRevFilter(new RevFilter() {
@Override
public boolean include(RevWalk walker, RevCommit cmit)
throws StopWalkException, MissingObjectException, IncorrectObjectTypeException, IOException {
return cmit.getAuthorIdent().getName().equals("xxxxx dsd");
}
@Override
public RevFilter clone() {
return this;
}
}).call();
results.forEach(commit -> {
PersonIdent authoIdent = commit.getAuthorIdent();
System.out.println("提交人: " + authoIdent.getName() + " <" + authoIdent.getEmailAddress() + ">");
System.out.println("提交SHA1: " + commit.getId().name());
System.out.println("提交信息: " + commit.getShortMessage());
System.out.println("提交时间: " + format.format(authoIdent.getWhen()));
});
5.远程代码库命令
1.clone命令
CloneCommand等价与git clone命令
Git.cloneRepository().setURI("https://[email protected]:8443/r/game-of-life.git")
.setDirectory(new File("D:\\source-code\\temp-1")).call();
2.push、fetch命令
Repository rep = new FileRepository("D:\\source-code\\temp-1\\.git");
Git git = new Git(rep);
git.pull().setRemote("origin").call();
//fetch命令提供了setRefSpecs方法,而pull命令并没有提供,所有pull命令只能fetch所有的分支
git.fetch().setRefSpecs("refs/heads/*:refs/heads/*").call();
而PushCommand和git push相同,一般都需要我们提供用户名和密码,需要用到CredentialsProvider类
Repository rep = new FileRepository("D:\\source-code\\temp-1\\.git");
Git git = new Git(rep);
git.push().setCredentialsProvider(new UsernamePasswordCredentialsProvider("myname", "password")).call();
6.RevWalk API
RevWalk基本是jgit中使用最多的api了,很多jgit的命令就是使用该api实现的。
我们当前实现这样一个功能,查找某个文件的历史记录,并把每个提交的文件内容打印出来。
DateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Repository repository = new RepositoryBuilder().setGitDir(new File("D:\\source-code\\temp-1\\.git")).build();
try (RevWalk walk = new RevWalk(repository)) {
Ref head = repository.findRef("HEAD");
walk.markStart(walk.parseCommit(head.getObjectId())); // 从HEAD开始遍历,
for (RevCommit commit : walk) {
RevTree tree = commit.getTree();
TreeWalk treeWalk = new TreeWalk(repository, repository.newObjectReader());
PathFilter f = PathFilter.create("pom.xml");
treeWalk.setFilter(f);
treeWalk.reset(tree);
treeWalk.setRecursive(false);
while (treeWalk.next()) {
PersonIdent authoIdent = commit.getAuthorIdent();
System.out.println("提交人: " + authoIdent.getName() + " <" + authoIdent.getEmailAddress() + ">");
System.out.println("提交SHA1: " + commit.getId().name());
System.out.println("提交信息: " + commit.getShortMessage());
System.out.println("提交时间: " + format.format(authoIdent.getWhen()));
ObjectId objectId = treeWalk.getObjectId(0);
ObjectLoader loader = repository.open(objectId);
loader.copyTo(System.out); //提取blob对象的内容
}
}
}
7.参考资料
以上是关于git学习之jgit的主要内容,如果未能解决你的问题,请参考以下文章