Skip to content

Commit 2b3a8df

Browse files
committed
more javadoc comments.
1 parent 8e0d7b6 commit 2b3a8df

File tree

6 files changed

+310
-9
lines changed

6 files changed

+310
-9
lines changed

library/src/main/java/io/syslogic/github/api/model/QueryString.java

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,25 +25,32 @@
2525
@Entity(tableName = Constants.TABLE_QUERY_STRINGS)
2626
public class QueryString extends BaseModel implements IContentProvider {
2727

28+
/** ID */
2829
@PrimaryKey(autoGenerate = true)
2930
@ColumnInfo(name = "id")
3031
private long id;
3132

33+
/** Title */
3234
@ColumnInfo(name = "title")
3335
private String title = null;
3436

37+
/** Search */
3538
@ColumnInfo(name = "search")
3639
private String search = null;
3740

41+
/** Condition */
3842
@ColumnInfo(name = "condition")
3943
private String condition = "pushed";
4044

45+
/** Operator */
4146
@ColumnInfo(name = "operator")
4247
private String operator = ">";
4348

49+
/** Parameter */
4450
@ColumnInfo(name = "parameter")
4551
private int parameter = 7;
4652

53+
/** Is raw? */
4754
@ColumnInfo(name = "is_raw")
4855
private boolean isRaw = false;
4956

library/src/main/java/io/syslogic/github/api/model/Repository.java

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,74 +27,91 @@
2727
@SuppressWarnings(RoomWarnings.PRIMARY_KEY_FROM_EMBEDDED_IS_DROPPED)
2828
public class Repository extends BaseModel implements IContentProvider {
2929

30+
/** ID */
3031
@PrimaryKey()
3132
@ColumnInfo(name = "id")
3233
@SerializedName("id")
3334
private Long id;
3435

36+
/** NodeId */
3537
@ColumnInfo(name = "node_id")
3638
@SerializedName("node_id")
3739
private String nodeId;
3840

41+
/** Name */
3942
@ColumnInfo(name = "name")
4043
@SerializedName("name")
4144
private String name;
4245

46+
/** Full Name */
4347
@ColumnInfo(name = "full_name")
4448
@SerializedName("full_name")
4549
private String fullName;
4650

51+
/** File-Name */
4752
@Ignore
4853
private String fileName;
4954

55+
/** Url */
5056
@ColumnInfo(name = "url")
5157
@SerializedName("url")
5258
private String url;
5359

60+
/** HtmlUrl */
5461
@ColumnInfo(name = "html_url")
5562
@SerializedName("html_url")
5663
private String htmlUrl;
5764

65+
/** Owner */
5866
@Ignore
5967
@SerializedName("owner")
6068
private Owner owner;
6169

70+
/** OwnerId */
6271
@ColumnInfo(name = "owner_id")
6372
private Long ownerId = 0L;
6473

74+
/** License */
6575
@Ignore
6676
@SerializedName("license")
6777
private License license;
6878

79+
/** LicenseId */
6980
@SerializedName("license_id")
7081
@ColumnInfo(name = "license_id")
7182
private Long licenseId = 0L;
7283

84+
/** Forks */
7385
@SerializedName("forks_count")
7486
@ColumnInfo(name = "forks")
7587
private Long forkCount = 0L;
7688

89+
/** Stargazers */
7790
@SerializedName("stargazers_count")
7891
@ColumnInfo(name = "stargazers")
7992
private Long stargazerCount = 0L;
8093

94+
/** Watchers */
8195
@SerializedName("watchers_count")
8296
@ColumnInfo(name = "watchers")
8397
private Long watcherCount = 0L;
8498

99+
/** Subscribers */
85100
@SerializedName("subscribers_count")
86101
@ColumnInfo(name = "subscribers")
87102
private Long subscriberCount = 0L;
88103

104+
/** Network */
89105
@SerializedName("network_count")
90106
@ColumnInfo(name = "network")
91107
private Long networkCount = 0L;
92108

109+
/** Topics */
93110
@SerializedName("topics")
94111
@TypeConverters(StringArrayConverter.class)
95112
private String[] topics;
96113

97-
/** Being populated asynchronously. */
114+
/** Workflows are being populated asynchronously. */
98115
@Ignore
99116
private ArrayList<Workflow> workflows = new ArrayList<>();
100117

library/src/main/java/io/syslogic/github/api/model/Resources.java

Lines changed: 28 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,28 +20,52 @@ public class Resources {
2020
@SerializedName("graphql")
2121
private RateLimit graphql;
2222

23-
public void setSearch(@NonNull RateLimit value) {
24-
this.search = value;
25-
}
26-
23+
/**
24+
* Setter for core {@link RateLimit}.
25+
* @param value the rate limit.
26+
*/
2727
public void setCore(@NonNull RateLimit value) {
2828
this.core = value;
2929
}
3030

31+
/**
32+
* Setter for search {@link RateLimit}.
33+
* @param value the rate limit.
34+
*/
35+
public void setSearch(@NonNull RateLimit value) {
36+
this.search = value;
37+
}
38+
39+
/**
40+
* Setter for graphql {@link RateLimit}.
41+
* @param value the rate limit.
42+
*/
3143
public void setGraphql(@NonNull RateLimit value) {
3244
this.graphql = value;
3345
}
3446

47+
/**
48+
* Getter for core {@link RateLimit}.
49+
* @return the rate limit.
50+
*/
3551
@NonNull
3652
public RateLimit getCore() {
3753
return this.core;
3854
}
3955

56+
/**
57+
* Getter for search {@link RateLimit}.
58+
* @return the rate limit.
59+
*/
4060
@NonNull
4161
public RateLimit getSearch() {
4262
return this.search;
4363
}
4464

65+
/**
66+
* Getter for graphql {@link RateLimit}.
67+
* @return the rate limit.
68+
*/
4569
@NonNull
4670
public RateLimit getGraphql() {
4771
return this.graphql;

library/src/main/java/io/syslogic/github/api/model/User.java

Lines changed: 88 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -106,92 +106,178 @@ public class User {
106106
@SerializedName("updated_at")
107107
private Date updatedAt;
108108

109-
/* Getters */
109+
/**
110+
* Getter for login.
111+
* @return the login of the user.
112+
*/
110113
@NonNull public String getLogin() {
111114
return this.login;
112115
}
113116

117+
/**
118+
* Getter for id.
119+
* @return the id of the user.
120+
*/
114121
@NonNull public Long getId() {
115122
return this.id;
116123
}
117124

125+
/**
126+
* Getter for nodeId.
127+
* @return the nodeId of the user.
128+
*/
118129
@NonNull public String getNodeId() {
119130
return this.nodeId;
120131
}
121132

133+
/**
134+
* Getter for avatarUrl.
135+
* @return the avatarUrl of the user.
136+
*/
122137
@NonNull public String getAvatarUrl() {
123138
return this.avatarUrl;
124139
}
125140

141+
/**
142+
* Getter for gravatarId.
143+
* @return the gravatarId of the user.
144+
*/
126145
@NonNull public String getGravatarId() {
127146
return this.gravatarId;
128147
}
129148

149+
/**
150+
* Getter for url.
151+
* @return the url of the user.
152+
*/
130153
@NonNull public String getUrl() {
131154
return this.url;
132155
}
133156

157+
/**
158+
* Getter for htmlUrl.
159+
* @return the htmlUrl of the user.
160+
*/
134161
@NonNull public String getHtmlUrl() {
135162
return this.htmlUrl;
136163
}
137164

165+
/**
166+
* Getter for reposUrl.
167+
* @return the reposUrl of the user.
168+
*/
138169
@NonNull public String getReposUrl() {
139170
return this.reposUrl;
140171
}
141172

173+
/**
174+
* Getter for type.
175+
* @return the type of the user.
176+
*/
142177
@NonNull public String getType() {
143178
return this.type;
144179
}
145180

181+
/**
182+
* Getter for siteAdmin.
183+
* @return is siteAdmin.
184+
*/
146185
@NonNull public Boolean getSiteAdmin() {
147186
return this.siteAdmin;
148187
}
149188

189+
/**
190+
* Getter for name.
191+
* @return the name of the user.
192+
*/
150193
@NonNull public String getName() {
151194
return this.name;
152195
}
153196

154-
/* Setters */
197+
/**
198+
* Setter for login.
199+
* @param value the login of the user.
200+
*/
155201
public void setLogin(@NonNull String value) {
156202
this.login = value;
157203
}
158204

205+
/**
206+
* Setter for id.
207+
* @param value the id of the user.
208+
*/
159209
public void setId(@NonNull Long value) {
160210
this.id = value;
161211
}
162212

213+
/**
214+
* Setter for nodeId.
215+
* @param value the nodeId of the user.
216+
*/
163217
public void setNodeId(@NonNull String value) {
164218
this.nodeId = value;
165219
}
166220

221+
/**
222+
* Setter for avatarUrl.
223+
* @param value the avatarUrl of the user.
224+
*/
167225
public void setAvatarUrl(@NonNull String value) {
168226
this.avatarUrl = value;
169227
}
170228

229+
/**
230+
* Setter for gravatarId.
231+
* @param value the gravatarId of the user.
232+
*/
171233
public void setGravatarId(@NonNull String value) {
172234
this.gravatarId = value;
173235
}
174236

237+
/**
238+
* Setter for url.
239+
* @param value the url of the user.
240+
*/
175241
public void setUrl(@NonNull String value) {
176242
this.url = value;
177243
}
178244

245+
/**
246+
* Setter for htmlUrl.
247+
* @param value the htmlUrl of the user.
248+
*/
179249
public void setHtmlUrl(@NonNull String value) {
180250
this.htmlUrl = value;
181251
}
182252

253+
/**
254+
* Setter for reposUrl.
255+
* @param value the reposUrl of the user.
256+
*/
183257
public void setReposUrl(@NonNull String value) {
184258
this.reposUrl = value;
185259
}
186260

261+
/**
262+
* Setter for type.
263+
* @param value the type of the user.
264+
*/
187265
public void setType(@NonNull String value) {
188266
this.type = value;
189267
}
190268

269+
/**
270+
* Setter for siteAdmin.
271+
* @param value if the user is site-admin.
272+
*/
191273
public void setSiteAdmin(@NonNull Boolean value) {
192274
this.siteAdmin = value;
193275
}
194276

277+
/**
278+
* Setter for name.
279+
* @param value the name of the user.
280+
*/
195281
public void setName(@NonNull String value) {
196282
this.name = value;
197283
}

0 commit comments

Comments
 (0)