com.jdroid.github.service

Class GistService

java.lang.Object

com.jdroid.github.service.GitHubService

com.jdroid.github.service.GistService

public class GistService
extends GitHubService

Service class for interacting with Gists and Gist comments.

See Also:

GitHub Gist API documentation, GitHub Gist comments API documentation

Field Summary

Fields inherited from class com.jdroid.github.service.GitHubService

ACCEPT_FULL, ACCEPT_HTML, ACCEPT_PREVIEW_DRAX, ACCEPT_PREVIEW_IRONMAN, ACCEPT_PREVIEW_LOKI, ACCEPT_RAW, ACCEPT_TEXT, client

Constructor Summary

Constructors

Constructor and Description
GistService() Create gist service
GistService(GitHubClient client) Create gist service

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	checkGistId(java.lang.String gistId) Check that gist id is non-null and non-empty
Comment	createComment(java.lang.String gistId, java.lang.String comment) Create comment on specified gist id
Gist	createGist(Gist gist) Create a gist
protected PagedRequest<Gist>	createUserGistRequest(java.lang.String user, int start, int size) Create user gist paged request
void	deleteComment(long commentId) Delete the Gist comment with the given id
void	deleteGist(java.lang.String gistId) Delete the Gist with the given id
Comment	editComment(Comment comment) Edit gist comment
Gist	forkGist(java.lang.String gistId) Fork gist with given id
Comment	getComment(long commentId) Get gist comment with id
java.util.List<Comment>	getComments(java.lang.String gistId) Get comments for specified gist id
Gist	getGist(java.lang.String id) Get gist
java.util.List<Gist>	getGists(java.lang.String user) Get gists for specified user
java.util.List<Gist>	getStarredGists() Get starred gists for currently authenticated user
boolean	isStarred(java.lang.String gistId) Check if a gist is starred
PageIterator<Gist>	pageGists(java.lang.String user) Create page iterator for given user's gists
PageIterator<Gist>	pageGists(java.lang.String user, int size) Create page iterator for given user's gists
PageIterator<Gist>	pageGists(java.lang.String user, int start, int size) Create page iterator for given user's gists
PageIterator<Gist>	pagePublicGists() Create page iterator for all public gists
PageIterator<Gist>	pagePublicGists(int size) Create page iterator for all public gists
PageIterator<Gist>	pagePublicGists(int start, int size) Create page iterator for all public gists
PageIterator<Gist>	pageStarredGists() Create page iterator for the current user's starred gists
PageIterator<Gist>	pageStarredGists(int size) Create page iterator for the current user's starred gists
PageIterator<Gist>	pageStarredGists(int start, int size) Create page iterator for the current user's starred gists
void	starGist(java.lang.String gistId) Star the gist with the given id
void	unstarGist(java.lang.String gistId) Unstar the gist with the given id
Gist	updateGist(Gist gist) Update a gist

Methods inherited from class com.jdroid.github.service.GitHubService

check, createPagedRequest, createPagedRequest, createPageIterator, createRequest, getAll, getAll, getClient, getId, verifyRepository

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GistService

public GistService()

Create gist service

GistService

public GistService(GitHubClient client)

Create gist service

Parameters:

client -

Method Detail

checkGistId

protected java.lang.String checkGistId(java.lang.String gistId)

Check that gist id is non-null and non-empty

Parameters:

gistId -

Returns:

gist id

getGist

public Gist getGist(java.lang.String id)
             throws java.io.IOException

Get gist

Parameters:

id -

Returns:

gist

Throws:

java.io.IOException

pageStarredGists

public PageIterator<Gist> pageStarredGists()

Create page iterator for the current user's starred gists

Returns:

gist page iterator

pageStarredGists

public PageIterator<Gist> pageStarredGists(int size)

Create page iterator for the current user's starred gists

Parameters:

size - size of page

Returns:

gist page iterator

pageStarredGists

public PageIterator<Gist> pageStarredGists(int start,
                                           int size)

Create page iterator for the current user's starred gists

Parameters:

size - size of page

start - starting page

Returns:

gist page iterator

getStarredGists

public java.util.List<Gist> getStarredGists()
                                     throws java.io.IOException

Get starred gists for currently authenticated user

Returns:

list of gists

Throws:

java.io.IOException

createUserGistRequest

protected PagedRequest<Gist> createUserGistRequest(java.lang.String user,
                                                   int start,
                                                   int size)

Create user gist paged request

Parameters:

user -

start -

size -

Returns:

request

getGists

public java.util.List<Gist> getGists(java.lang.String user)
                              throws java.io.IOException

Get gists for specified user

Parameters:

user -

Returns:

list of gists

Throws:

java.io.IOException

pageGists

public PageIterator<Gist> pageGists(java.lang.String user)

Create page iterator for given user's gists

Parameters:

user -

Returns:

gist page iterator

pageGists

public PageIterator<Gist> pageGists(java.lang.String user,
                                    int size)

Create page iterator for given user's gists

Parameters:

user -

size - size of page

Returns:

gist page iterator

pageGists

public PageIterator<Gist> pageGists(java.lang.String user,
                                    int start,
                                    int size)

Create page iterator for given user's gists

Parameters:

user -

size - size of page

start - starting page

Returns:

gist page iterator

pagePublicGists

public PageIterator<Gist> pagePublicGists()

Create page iterator for all public gists

Returns:

gist page iterator

pagePublicGists

public PageIterator<Gist> pagePublicGists(int size)

Create page iterator for all public gists

Parameters:

size - size of page

Returns:

gist page iterator

pagePublicGists

public PageIterator<Gist> pagePublicGists(int start,
                                          int size)

Create page iterator for all public gists

Parameters:

start - starting page number

size - size of page

Returns:

gist page iterator

createGist

public Gist createGist(Gist gist)
                throws java.io.IOException

Create a gist

Parameters:

gist -

Returns:

created gist

Throws:

java.io.IOException

updateGist

public Gist updateGist(Gist gist)
                throws java.io.IOException

Update a gist

Parameters:

gist -

Returns:

updated gist

Throws:

java.io.IOException

createComment

public Comment createComment(java.lang.String gistId,
                             java.lang.String comment)
                      throws java.io.IOException

Create comment on specified gist id

Parameters:

gistId -

comment -

Returns:

created issue

Throws:

java.io.IOException

getComments

public java.util.List<Comment> getComments(java.lang.String gistId)
                                    throws java.io.IOException

Get comments for specified gist id

Parameters:

gistId -

Returns:

list of comments

Throws:

java.io.IOException

deleteGist

public void deleteGist(java.lang.String gistId)
                throws java.io.IOException

Delete the Gist with the given id

Parameters:

gistId -

Throws:

java.io.IOException

getComment

public Comment getComment(long commentId)
                   throws java.io.IOException

Get gist comment with id

Parameters:

commentId -

Returns:

comment

Throws:

java.io.IOException

editComment

public Comment editComment(Comment comment)
                    throws java.io.IOException

Edit gist comment

Parameters:

comment -

Returns:

edited comment

Throws:

java.io.IOException

deleteComment

public void deleteComment(long commentId)
                   throws java.io.IOException

Delete the Gist comment with the given id

Parameters:

commentId -

Throws:

java.io.IOException

starGist

public void starGist(java.lang.String gistId)
              throws java.io.IOException

Star the gist with the given id

Parameters:

gistId -

Throws:

java.io.IOException

unstarGist

public void unstarGist(java.lang.String gistId)
                throws java.io.IOException

Unstar the gist with the given id

Parameters:

gistId -

Throws:

java.io.IOException

isStarred

public boolean isStarred(java.lang.String gistId)
                  throws java.io.IOException

Check if a gist is starred

Parameters:

gistId -

Returns:

true if starred, false if not starred

Throws:

java.io.IOException

forkGist

public Gist forkGist(java.lang.String gistId)
              throws java.io.IOException

Fork gist with given id

Parameters:

gistId -

Returns:

forked gist

Throws:

java.io.IOException