blob: 53fa12bc9f9ae244acbae2669cf6f66f4a6b2a1a (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
/******************************************************************************
* Copyright (c) 2011 GitHub Inc.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
*
* Contributors:
* Kevin Sawicki (GitHub Inc.) - initial API and implementation
*****************************************************************************/
package org.eclipse.egit.github.core.service;
import static org.eclipse.egit.github.core.client.IGitHubConstants.SEGMENT_CONTENTS;
import static org.eclipse.egit.github.core.client.IGitHubConstants.SEGMENT_README;
import static org.eclipse.egit.github.core.client.IGitHubConstants.SEGMENT_REPOS;
import com.google.gson.reflect.TypeToken;
import java.io.IOException;
import java.util.Collections;
import java.util.List;
import org.eclipse.egit.github.core.IRepositoryIdProvider;
import org.eclipse.egit.github.core.RepositoryContents;
import org.eclipse.egit.github.core.client.GitHubClient;
import org.eclipse.egit.github.core.client.GitHubRequest;
/**
* Service for accessing repository contents
*
* @see <a href="http://developer.github.com/v3/repos/contents">GitHub contents
* API documentation</a>
*/
public class ContentsService extends GitHubService {
/**
* Create contents service
*/
public ContentsService() {
super();
}
/**
* Create contents service
*
* @param client
*/
public ContentsService(final GitHubClient client) {
super(client);
}
/**
* Get repository README
*
* @param repository
* @return README
* @throws Exception
*/
public RepositoryContents getReadme(IRepositoryIdProvider repository)
throws Exception {
return getReadme(repository, null);
}
/**
* Get repository README
*
* @param repository
* @param ref
* @return README
* @throws IOException
*/
public RepositoryContents getReadme(IRepositoryIdProvider repository,
String ref) throws IOException {
String id = getId(repository);
StringBuilder uri = new StringBuilder(SEGMENT_REPOS);
uri.append('/').append(id);
uri.append(SEGMENT_README);
GitHubRequest request = createRequest();
request.setUri(uri);
if (ref != null && ref.length() > 0)
request.setParams(Collections.singletonMap("ref", ref)); //$NON-NLS-1$
request.setType(RepositoryContents.class);
return (RepositoryContents) client.get(request).getBody();
}
/**
* Get contents at the root of the given repository on master branch
*
* @param repository
* @return list of contents at root
* @throws IOException
*/
public List<RepositoryContents> getContents(IRepositoryIdProvider repository)
throws IOException {
return getContents(repository, null);
}
/**
* Get contents at path in the given repository on master branch
*
* @param repository
* @param path
* @return list of contents at path
* @throws IOException
*/
public List<RepositoryContents> getContents(
IRepositoryIdProvider repository, String path) throws IOException {
return getContents(repository, path, null);
}
/**
* Get contents of path at reference in given repository
* <p>
* For file paths this will return a list with one entry corresponding to
* the file contents at the given path
*
* @param repository
* @param path
* @param ref
* @return list of contents at path
* @throws IOException
*/
@SuppressWarnings("unchecked")
public List<RepositoryContents> getContents(
IRepositoryIdProvider repository, String path, String ref)
throws IOException {
String id = getId(repository);
StringBuilder uri = new StringBuilder(SEGMENT_REPOS);
uri.append('/').append(id);
uri.append(SEGMENT_CONTENTS);
if (path != null && path.length() > 0) {
if (path.charAt(0) != '/')
uri.append('/');
uri.append(path);
}
GitHubRequest request = createRequest();
request.setUri(uri);
request.setType(RepositoryContents.class);
request.setArrayType(new TypeToken<List<RepositoryContents>>() {
}.getType());
if (ref != null && ref.length() > 0)
request.setParams(Collections.singletonMap("ref", ref)); //$NON-NLS-1$
Object body = client.get(request).getBody();
if (body instanceof RepositoryContents)
return Collections.singletonList((RepositoryContents) body);
else
return (List<RepositoryContents>) body;
}
}
|
