com.jdroid.github.service

Class IssueService

java.lang.Object

com.jdroid.github.service.GitHubService

com.jdroid.github.service.IssueService

public class IssueService
extends GitHubService

Issue service class for listing, searching, and fetching Issue objects using a GitHubClient.

See Also:

GitHub Issues API documentation

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DIRECTION_ASCENDING Ascending direction sort order
static java.lang.String	DIRECTION_DESCENDING Descending direction sort order
static java.lang.String	FIELD_BODY Issue body field name
static java.lang.String	FIELD_DIRECTION Sort direction of output
static java.lang.String	FIELD_FILTER Filter field key
static java.lang.String	FIELD_SINCE Since date field
static java.lang.String	FIELD_SORT Sort field key
static java.lang.String	FIELD_TITLE Issue title field name
static java.lang.String	FILTER_ASSIGNED Filter by assigned issues for user
static java.lang.String	FILTER_ASSIGNEE Filter by issue assignee
static java.lang.String	FILTER_CREATED Filter by created issues by user
static java.lang.String	FILTER_LABELS Filter by issue's labels
static java.lang.String	FILTER_MENTIONED Filter by user mentioned in issue
static java.lang.String	FILTER_MILESTONE Filter by issue's milestone
static java.lang.String	FILTER_STATE Filter by issue's state
static java.lang.String	FILTER_SUBSCRIBED Filter by subscribed issues for user
static java.lang.String	SORT_COMMENTS Sort by commented on at
static java.lang.String	SORT_CREATED Sort by created at
static java.lang.String	SORT_UPDATED Sort by updated at
static java.lang.String	STATE_CLOSED Issue closed state filter value
static java.lang.String	STATE_OPEN Issue open state filter value

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

ACCEPT_FULL, ACCEPT_HTML, ACCEPT_RAW, ACCEPT_TEXT, client

Constructor Summary

Constructors

Constructor and Description
IssueService() Create issue service
IssueService(GitHubClient client) Create issue service

Method Summary

Modifier and Type	Method and Description
Comment	createComment(IRepositoryIdProvider repository, int issueNumber, java.lang.String comment) Create comment on specified issue number
Comment	createComment(IRepositoryIdProvider repository, java.lang.String issueNumber, java.lang.String comment) Create comment on specified issue number
Comment	createComment(java.lang.String user, java.lang.String repository, int issueNumber, java.lang.String comment) Create comment on specified issue number
Comment	createComment(java.lang.String user, java.lang.String repository, java.lang.String issueNumber, java.lang.String comment) Create comment on specified issue number
Issue	createIssue(IRepositoryIdProvider repository, Issue issue) Create issue
Issue	createIssue(java.lang.String user, java.lang.String repository, Issue issue) Create issue
protected java.util.Map<java.lang.Object,java.lang.Object>	createIssueMap(Issue issue, boolean newIssue) Create issue map for issue
protected PagedRequest<Issue>	createIssuesRequest(java.lang.String repoId, java.util.Map<java.lang.String,java.lang.String> filterData, int start, int size) Get bulk issues request
void	deleteComment(IRepositoryIdProvider repository, long commentId) Delete the issue comment with the given id
void	deleteComment(IRepositoryIdProvider repository, java.lang.String commentId) Delete the issue comment with the given id
void	deleteComment(java.lang.String user, java.lang.String repository, long commentId) Delete the issue comment with the given id
void	deleteComment(java.lang.String user, java.lang.String repository, java.lang.String commentId) Delete the issue comment with the given id
Comment	editComment(IRepositoryIdProvider repository, Comment comment) Edit issue comment
Comment	editComment(java.lang.String user, java.lang.String repository, Comment comment) Edit issue comment
Issue	editIssue(IRepositoryIdProvider repository, Issue issue) Edit issue
Issue	editIssue(java.lang.String user, java.lang.String repository, Issue issue) Edit issue
Comment	getComment(java.lang.String user, java.lang.String repository, long commentId) Get issue comment
java.util.List<Comment>	getComments(IRepositoryIdProvider repository, int issueNumber) Get an issue's comments
java.util.List<Comment>	getComments(IRepositoryIdProvider repository, java.lang.String issueNumber) Get an issue's comments
java.util.List<Comment>	getComments(java.lang.String user, java.lang.String repository, int issueNumber) Get an issue's comments
java.util.List<Comment>	getComments(java.lang.String user, java.lang.String repository, java.lang.String issueNumber) Get an issue's comments
Issue	getIssue(IRepositoryIdProvider repository, int issueNumber) Get issue
Issue	getIssue(IRepositoryIdProvider repository, java.lang.String issueNumber) Get issue
Issue	getIssue(java.lang.String user, java.lang.String repository, int issueNumber) Get issue
Issue	getIssue(java.lang.String user, java.lang.String repository, java.lang.String issueNumber) Get issue
IssueEvent	getIssueEvent(java.lang.String user, java.lang.String repository, long eventId) Get issue event for repository
java.util.List<RepositoryIssue>	getIssues() Get issues for currently authenticated user
java.util.List<Issue>	getIssues(IRepositoryIdProvider repository, java.util.Map<java.lang.String,java.lang.String> filterData) Get a list of Issue objects that match the specified filter data
java.util.List<RepositoryIssue>	getIssues(java.util.Map<java.lang.String,java.lang.String> filterData) Get issues for currently authenticated user
java.util.List<Issue>	getIssues(java.lang.String user, java.lang.String repository, java.util.Map<java.lang.String,java.lang.String> filterData) Get a list of Issue objects that match the specified filter data
PageIterator<IssueEvent>	pageEvents(java.lang.String user, java.lang.String repository) Page issue events for repository
PageIterator<IssueEvent>	pageEvents(java.lang.String user, java.lang.String repository, int size) Page issue events for repository
PageIterator<IssueEvent>	pageEvents(java.lang.String user, java.lang.String repository, int start, int size) Page events for issue in repository
PageIterator<IssueEvent>	pageIssueEvents(java.lang.String user, java.lang.String repository, int issueId) Page events for issue in repository
PageIterator<IssueEvent>	pageIssueEvents(java.lang.String user, java.lang.String repository, int issueId, int size) Page events for issue in repository
PageIterator<IssueEvent>	pageIssueEvents(java.lang.String user, java.lang.String repository, int issueId, int start, int size) Page issue events for repository
PageIterator<RepositoryIssue>	pageIssues() Page issues for currently authenticated user
PageIterator<Issue>	pageIssues(IRepositoryIdProvider repository) Get page iterator over issues query
PageIterator<Issue>	pageIssues(IRepositoryIdProvider repository, java.util.Map<java.lang.String,java.lang.String> filterData) Get page iterator over issues query
PageIterator<Issue>	pageIssues(IRepositoryIdProvider repository, java.util.Map<java.lang.String,java.lang.String> filterData, int size) Get page iterator over issues query
PageIterator<Issue>	pageIssues(IRepositoryIdProvider repository, java.util.Map<java.lang.String,java.lang.String> filterData, int start, int size) Get page iterator over issues query
PageIterator<RepositoryIssue>	pageIssues(java.util.Map<java.lang.String,java.lang.String> filterData) Page issues for currently authenticated user
PageIterator<RepositoryIssue>	pageIssues(java.util.Map<java.lang.String,java.lang.String> filterData, int size) Page issues for currently authenticated user
PageIterator<RepositoryIssue>	pageIssues(java.util.Map<java.lang.String,java.lang.String> filterData, int start, int size) Page issues for currently authenticated user
PageIterator<Issue>	pageIssues(java.lang.String user, java.lang.String repository) Get page iterator over issues query
PageIterator<Issue>	pageIssues(java.lang.String user, java.lang.String repository, java.util.Map<java.lang.String,java.lang.String> filterData) Get page iterator over issues query
PageIterator<Issue>	pageIssues(java.lang.String user, java.lang.String repository, java.util.Map<java.lang.String,java.lang.String> filterData, int size) Get page iterator over issues query
PageIterator<Issue>	pageIssues(java.lang.String user, java.lang.String repository, java.util.Map<java.lang.String,java.lang.String> filterData, int start, int size) Get page iterator over issues query
java.util.List<SearchIssue>	searchIssues(IRepositoryIdProvider repository, java.lang.String state, java.lang.String query) Search issues in the given repository using the given query

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

Field Detail

FIELD_FILTER

public static final java.lang.String FIELD_FILTER

Filter field key

See Also:

Constant Field Values

FILTER_ASSIGNEE

public static final java.lang.String FILTER_ASSIGNEE

Filter by issue assignee

See Also:

Constant Field Values

FILTER_MILESTONE

public static final java.lang.String FILTER_MILESTONE

Filter by issue's milestone

See Also:

Constant Field Values

FILTER_MENTIONED

public static final java.lang.String FILTER_MENTIONED

Filter by user mentioned in issue

See Also:

Constant Field Values

FILTER_SUBSCRIBED

public static final java.lang.String FILTER_SUBSCRIBED

Filter by subscribed issues for user

See Also:

Constant Field Values

FILTER_CREATED

public static final java.lang.String FILTER_CREATED

Filter by created issues by user

See Also:

Constant Field Values

FILTER_ASSIGNED

public static final java.lang.String FILTER_ASSIGNED

Filter by assigned issues for user

See Also:

Constant Field Values

FILTER_LABELS

public static final java.lang.String FILTER_LABELS

Filter by issue's labels

See Also:

Constant Field Values

FILTER_STATE

public static final java.lang.String FILTER_STATE

Filter by issue's state

See Also:

Constant Field Values

STATE_OPEN

public static final java.lang.String STATE_OPEN

Issue open state filter value

See Also:

Constant Field Values

STATE_CLOSED

public static final java.lang.String STATE_CLOSED

Issue closed state filter value

See Also:

Constant Field Values

FIELD_BODY

public static final java.lang.String FIELD_BODY

Issue body field name

See Also:

Constant Field Values

FIELD_TITLE

public static final java.lang.String FIELD_TITLE

Issue title field name

See Also:

Constant Field Values

FIELD_SINCE

public static final java.lang.String FIELD_SINCE

Since date field

See Also:

Constant Field Values

FIELD_DIRECTION

public static final java.lang.String FIELD_DIRECTION

Sort direction of output

See Also:

Constant Field Values

DIRECTION_ASCENDING

public static final java.lang.String DIRECTION_ASCENDING

Ascending direction sort order

See Also:

Constant Field Values

DIRECTION_DESCENDING

public static final java.lang.String DIRECTION_DESCENDING

Descending direction sort order

See Also:

Constant Field Values

FIELD_SORT

public static final java.lang.String FIELD_SORT

Sort field key

See Also:

Constant Field Values

SORT_CREATED

public static final java.lang.String SORT_CREATED

Sort by created at

See Also:

Constant Field Values

SORT_UPDATED

public static final java.lang.String SORT_UPDATED

Sort by updated at

See Also:

Constant Field Values

SORT_COMMENTS

public static final java.lang.String SORT_COMMENTS

Sort by commented on at

See Also:

Constant Field Values

Constructor Detail

IssueService

public IssueService()

Create issue service

IssueService

public IssueService(GitHubClient client)

Create issue service

Parameters:

client - cannot be null

Method Detail

getIssues

public java.util.List<RepositoryIssue> getIssues()
                                          throws java.io.IOException

Get issues for currently authenticated user

Returns:

non-null but possibly empty list of issues

Throws:

java.io.IOException

getIssues

public java.util.List<RepositoryIssue> getIssues(java.util.Map<java.lang.String,java.lang.String> filterData)
                                          throws java.io.IOException

Get issues for currently authenticated user

Parameters:

filterData -

Returns:

non-null but possibly empty list of issues

Throws:

java.io.IOException

pageIssues

public PageIterator<RepositoryIssue> pageIssues()

Page issues for currently authenticated user

Returns:

iterator over pages of issues

pageIssues

public PageIterator<RepositoryIssue> pageIssues(java.util.Map<java.lang.String,java.lang.String> filterData)

Page issues for currently authenticated user

Parameters:

filterData -

Returns:

iterator over pages of issues

pageIssues

public PageIterator<RepositoryIssue> pageIssues(java.util.Map<java.lang.String,java.lang.String> filterData,
                                                int size)

Page issues for currently authenticated user

Parameters:

filterData -

size -

Returns:

iterator over pages of issues

pageIssues

public PageIterator<RepositoryIssue> pageIssues(java.util.Map<java.lang.String,java.lang.String> filterData,
                                                int start,
                                                int size)

Page issues for currently authenticated user

Parameters:

filterData -

start -

size -

Returns:

iterator over pages of issues

getIssue

public Issue getIssue(java.lang.String user,
                      java.lang.String repository,
                      int issueNumber)
               throws java.io.IOException

Get issue

Parameters:

user -

repository -

issueNumber -

Returns:

issue

Throws:

java.io.IOException

getIssue

public Issue getIssue(java.lang.String user,
                      java.lang.String repository,
                      java.lang.String issueNumber)
               throws java.io.IOException

Get issue

Parameters:

user -

repository -

issueNumber -

Returns:

issue

Throws:

java.io.IOException

getIssue

public Issue getIssue(IRepositoryIdProvider repository,
                      int issueNumber)
               throws java.io.IOException

Get issue

Parameters:

repository -

issueNumber -

Returns:

issue

Throws:

java.io.IOException

getIssue

public Issue getIssue(IRepositoryIdProvider repository,
                      java.lang.String issueNumber)
               throws java.io.IOException

Get issue

Parameters:

repository -

issueNumber -

Returns:

issue

Throws:

java.io.IOException

getComments

public java.util.List<Comment> getComments(java.lang.String user,
                                           java.lang.String repository,
                                           int issueNumber)
                                    throws java.io.IOException

Get an issue's comments

Parameters:

user -

repository -

issueNumber -

Returns:

list of comments

Throws:

java.io.IOException

getComments

public java.util.List<Comment> getComments(java.lang.String user,
                                           java.lang.String repository,
                                           java.lang.String issueNumber)
                                    throws java.io.IOException

Get an issue's comments

Parameters:

user -

repository -

issueNumber -

Returns:

list of comments

Throws:

java.io.IOException

getComments

public java.util.List<Comment> getComments(IRepositoryIdProvider repository,
                                           int issueNumber)
                                    throws java.io.IOException

Get an issue's comments

Parameters:

repository -

issueNumber -

Returns:

list of comments

Throws:

java.io.IOException

getComments

public java.util.List<Comment> getComments(IRepositoryIdProvider repository,
                                           java.lang.String issueNumber)
                                    throws java.io.IOException

Get an issue's comments

Parameters:

repository -

issueNumber -

Returns:

list of comments

Throws:

java.io.IOException

createIssuesRequest

protected PagedRequest<Issue> createIssuesRequest(java.lang.String repoId,
                                                  java.util.Map<java.lang.String,java.lang.String> filterData,
                                                  int start,
                                                  int size)

Get bulk issues request

Parameters:

repoId -

filterData -

start -

size -

Returns:

paged request

getIssues

public java.util.List<Issue> getIssues(java.lang.String user,
                                       java.lang.String repository,
                                       java.util.Map<java.lang.String,java.lang.String> filterData)
                                throws java.io.IOException

Get a list of Issue objects that match the specified filter data

Parameters:

user -

repository -

filterData -

Returns:

list of issues

Throws:

java.io.IOException

getIssues

public java.util.List<Issue> getIssues(IRepositoryIdProvider repository,
                                       java.util.Map<java.lang.String,java.lang.String> filterData)
                                throws java.io.IOException

Get a list of Issue objects that match the specified filter data

Parameters:

repository -

filterData -

Returns:

list of issues

Throws:

java.io.IOException

pageIssues

public PageIterator<Issue> pageIssues(java.lang.String user,
                                      java.lang.String repository)

Get page iterator over issues query

Parameters:

user -

repository -

Returns:

iterator over issue pages

pageIssues

public PageIterator<Issue> pageIssues(java.lang.String user,
                                      java.lang.String repository,
                                      java.util.Map<java.lang.String,java.lang.String> filterData)

Get page iterator over issues query

Parameters:

user -

repository -

filterData -

Returns:

iterator

pageIssues

public PageIterator<Issue> pageIssues(java.lang.String user,
                                      java.lang.String repository,
                                      java.util.Map<java.lang.String,java.lang.String> filterData,
                                      int size)

Get page iterator over issues query

Parameters:

user -

repository -

filterData -

size -

Returns:

iterator

pageIssues

public PageIterator<Issue> pageIssues(java.lang.String user,
                                      java.lang.String repository,
                                      java.util.Map<java.lang.String,java.lang.String> filterData,
                                      int start,
                                      int size)

Get page iterator over issues query

Parameters:

user -

repository -

filterData -

size - page size

start - starting page number

Returns:

iterator

pageIssues

public PageIterator<Issue> pageIssues(IRepositoryIdProvider repository)

Get page iterator over issues query

Parameters:

repository -

Returns:

iterator over issue pages

pageIssues

public PageIterator<Issue> pageIssues(IRepositoryIdProvider repository,
                                      java.util.Map<java.lang.String,java.lang.String> filterData)

Get page iterator over issues query

Parameters:

repository -

filterData -

Returns:

iterator

pageIssues

public PageIterator<Issue> pageIssues(IRepositoryIdProvider repository,
                                      java.util.Map<java.lang.String,java.lang.String> filterData,
                                      int size)

Get page iterator over issues query

Parameters:

repository -

filterData -

size -

Returns:

iterator

pageIssues

public PageIterator<Issue> pageIssues(IRepositoryIdProvider repository,
                                      java.util.Map<java.lang.String,java.lang.String> filterData,
                                      int start,
                                      int size)

Get page iterator over issues query

Parameters:

repository -

filterData -

size - page size

start - starting page number

Returns:

iterator

createIssueMap

protected java.util.Map<java.lang.Object,java.lang.Object> createIssueMap(Issue issue,
                                                                          boolean newIssue)

Create issue map for issue

Parameters:

issue -

newIssue -

Returns:

map

createIssue

public Issue createIssue(java.lang.String user,
                         java.lang.String repository,
                         Issue issue)
                  throws java.io.IOException

Create issue

Parameters:

user -

repository -

issue -

Returns:

created issue

Throws:

java.io.IOException

createIssue

public Issue createIssue(IRepositoryIdProvider repository,
                         Issue issue)
                  throws java.io.IOException

Create issue

Parameters:

repository -

issue -

Returns:

created issue

Throws:

java.io.IOException

editIssue

public Issue editIssue(java.lang.String user,
                       java.lang.String repository,
                       Issue issue)
                throws java.io.IOException

Edit issue

Parameters:

user -

repository -

issue -

Returns:

created issue

Throws:

java.io.IOException

editIssue

public Issue editIssue(IRepositoryIdProvider repository,
                       Issue issue)
                throws java.io.IOException

Edit issue

Parameters:

repository -

issue -

Returns:

created issue

Throws:

java.io.IOException

createComment

public Comment createComment(java.lang.String user,
                             java.lang.String repository,
                             int issueNumber,
                             java.lang.String comment)
                      throws java.io.IOException

Create comment on specified issue number

Parameters:

user -

repository -

issueNumber -

comment -

Returns:

created issue

Throws:

java.io.IOException

createComment

public Comment createComment(java.lang.String user,
                             java.lang.String repository,
                             java.lang.String issueNumber,
                             java.lang.String comment)
                      throws java.io.IOException

Create comment on specified issue number

Parameters:

user -

repository -

issueNumber -

comment -

Returns:

created issue

Throws:

java.io.IOException

createComment

public Comment createComment(IRepositoryIdProvider repository,
                             int issueNumber,
                             java.lang.String comment)
                      throws java.io.IOException

Create comment on specified issue number

Parameters:

repository -

issueNumber -

comment -

Returns:

created issue

Throws:

java.io.IOException

createComment

public Comment createComment(IRepositoryIdProvider repository,
                             java.lang.String issueNumber,
                             java.lang.String comment)
                      throws java.io.IOException

Create comment on specified issue number

Parameters:

repository -

issueNumber -

comment -

Returns:

created issue

Throws:

java.io.IOException

getComment

public Comment getComment(java.lang.String user,
                          java.lang.String repository,
                          long commentId)
                   throws java.io.IOException

Get issue comment

Parameters:

user -

repository -

commentId -

Returns:

comment

Throws:

java.io.IOException

editComment

public Comment editComment(java.lang.String user,
                           java.lang.String repository,
                           Comment comment)
                    throws java.io.IOException

Edit issue comment

Parameters:

user -

repository -

comment -

Returns:

edited comment

Throws:

java.io.IOException

editComment

public Comment editComment(IRepositoryIdProvider repository,
                           Comment comment)
                    throws java.io.IOException

Edit issue comment

Parameters:

repository -

comment -

Returns:

edited comment

Throws:

java.io.IOException

deleteComment

public void deleteComment(java.lang.String user,
                          java.lang.String repository,
                          long commentId)
                   throws java.io.IOException

Delete the issue comment with the given id

Parameters:

user -

repository -

commentId -

Throws:

java.io.IOException

deleteComment

public void deleteComment(java.lang.String user,
                          java.lang.String repository,
                          java.lang.String commentId)
                   throws java.io.IOException

Delete the issue comment with the given id

Parameters:

user -

repository -

commentId -

Throws:

java.io.IOException

deleteComment

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

Delete the issue comment with the given id

Parameters:

repository -

commentId -

Throws:

java.io.IOException

deleteComment

public void deleteComment(IRepositoryIdProvider repository,
                          java.lang.String commentId)
                   throws java.io.IOException

Delete the issue comment with the given id

Parameters:

repository -

commentId -

Throws:

java.io.IOException

pageEvents

public PageIterator<IssueEvent> pageEvents(java.lang.String user,
                                           java.lang.String repository)

Page issue events for repository

Parameters:

user -

repository -

Returns:

iterator over issue event pages

pageEvents

public PageIterator<IssueEvent> pageEvents(java.lang.String user,
                                           java.lang.String repository,
                                           int size)

Page issue events for repository

Parameters:

user -

repository -

size -

Returns:

iterator over issue event pages

pageEvents

public PageIterator<IssueEvent> pageEvents(java.lang.String user,
                                           java.lang.String repository,
                                           int start,
                                           int size)

Page events for issue in repository

Parameters:

user -

repository -

start -

size -

Returns:

iterator over issue event pages

pageIssueEvents

public PageIterator<IssueEvent> pageIssueEvents(java.lang.String user,
                                                java.lang.String repository,
                                                int issueId)

Page events for issue in repository

Parameters:

user -

repository -

issueId -

Returns:

iterator over issue event pages

pageIssueEvents

public PageIterator<IssueEvent> pageIssueEvents(java.lang.String user,
                                                java.lang.String repository,
                                                int issueId,
                                                int size)

Page events for issue in repository

Parameters:

user -

repository -

issueId -

size -

Returns:

iterator over issue event pages

pageIssueEvents

public PageIterator<IssueEvent> pageIssueEvents(java.lang.String user,
                                                java.lang.String repository,
                                                int issueId,
                                                int start,
                                                int size)

Page issue events for repository

Parameters:

user -

repository -

issueId -

start -

size -

Returns:

iterator over issue event pages

getIssueEvent

public IssueEvent getIssueEvent(java.lang.String user,
                                java.lang.String repository,
                                long eventId)
                         throws java.io.IOException

Get issue event for repository

Parameters:

user -

repository -

eventId -

Returns:

iterator over issue event pages

Throws:

java.io.IOException

searchIssues

public java.util.List<SearchIssue> searchIssues(IRepositoryIdProvider repository,
                                                java.lang.String state,
                                                java.lang.String query)
                                         throws java.io.IOException

Search issues in the given repository using the given query

Parameters:

repository -

state - STATE_OPEN or STATE_CLOSED

query -

Returns:

issues matching query

Throws:

java.io.IOException