org.kohsuke.github

Class GHIssue

java.lang.Object

org.kohsuke.github.GHObject

org.kohsuke.github.GHIssue

Direct Known Subclasses:

GHPullRequest

public class GHIssue
extends GHObject

Represents an issue on GitHub.

Author:

Eric Maupin, Kohsuke Kawaguchi

See Also:

GHRepository.getIssue(int), GitHub.searchIssues(), GHIssueSearchBuilder

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GHIssue.Label Deprecated. use GHLabel
static class	GHIssue.PullRequest

Field Summary

Fields

Modifier and Type	Field and Description
protected GHUser	assignee
protected java.lang.String	body
protected java.lang.String	closed_at
protected GHUser	closed_by
protected int	comments
protected java.lang.String	html_url
protected java.util.List<GHIssue.Label>	labels
protected GHMilestone	milestone
protected int	number
protected GHIssue.PullRequest	pull_request
protected java.lang.String	state
protected java.lang.String	title
protected GHUser	user

Fields inherited from class org.kohsuke.github.GHObject

created_at, id, updated_at, url

Constructor Summary

Constructors

Constructor and Description
GHIssue()

Method Summary

Modifier and Type	Method and Description
void	assignTo(GHUser user)
void	close() Closes this issue.
GHIssueComment	comment(java.lang.String message) Updates the issue by adding a comment.
protected java.lang.String	getApiRoute()
java.net.URL	getApiURL()
GHUser	getAssignee()
java.lang.String	getBody() The description of this pull request.
java.util.Date	getClosedAt()
GHUser	getClosedBy() Reports who has closed the issue.
java.util.List<GHIssueComment>	getComments() Obtains all the comments associated with this issue.
int	getCommentsCount()
java.net.URL	getHtmlUrl() The HTML page of this issue, like https://github.com/jenkinsci/jenkins/issues/100
protected java.lang.String	getIssuesApiRoute()
java.util.Collection<GHLabel>	getLabels()
GHMilestone	getMilestone()
int	getNumber() ID.
GHIssue.PullRequest	getPullRequest() Returns non-null if this issue is a shadow of a pull request.
GHRepository	getRepository() Repository to which the issue belongs.
GHIssueState	getState()
java.lang.String	getTitle()
GHUser	getUser() User who submitted the issue.
boolean	isPullRequest()
PagedIterable<GHIssueComment>	listComments() Obtains all the comments associated with this issue.
void	reopen() Reopens this issue.
void	setBody(java.lang.String body)
void	setLabels(java.lang.String... labels)
void	setTitle(java.lang.String title)

Methods inherited from class org.kohsuke.github.GHObject

getCreatedAt, getId, getUpdatedAt, getUrl, toString

Methods inherited from class java.lang.Object

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

Field Detail

assignee

protected GHUser assignee

state

protected java.lang.String state

number

protected int number

closed_at

protected java.lang.String closed_at

comments

protected int comments

body

protected java.lang.String body

labels

protected java.util.List<GHIssue.Label> labels

user

protected GHUser user

title

protected java.lang.String title

html_url

protected java.lang.String html_url

pull_request

protected GHIssue.PullRequest pull_request

milestone

protected GHMilestone milestone

closed_by

protected GHUser closed_by

Constructor Detail

GHIssue

public GHIssue()

Method Detail

getRepository

public GHRepository getRepository()

Repository to which the issue belongs.

getBody

public java.lang.String getBody()

The description of this pull request.

getNumber

public int getNumber()

ID.

getHtmlUrl

public java.net.URL getHtmlUrl()

The HTML page of this issue, like https://github.com/jenkinsci/jenkins/issues/100

Specified by:

getHtmlUrl in class GHObject

getTitle

public java.lang.String getTitle()

getState

public GHIssueState getState()

getLabels

public java.util.Collection<GHLabel> getLabels()
                                        throws java.io.IOException

Throws:

java.io.IOException

getClosedAt

public java.util.Date getClosedAt()

getApiURL

public java.net.URL getApiURL()

comment

@WithBridgeMethods(value=void.class)
public GHIssueComment comment(java.lang.String message)
                                                            throws java.io.IOException

Updates the issue by adding a comment.

Returns:

Newly posted comment.

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Closes this issue.

Throws:

java.io.IOException

reopen

public void reopen()
            throws java.io.IOException

Reopens this issue.

Throws:

java.io.IOException

setTitle

public void setTitle(java.lang.String title)
              throws java.io.IOException

Throws:

java.io.IOException

setBody

public void setBody(java.lang.String body)
             throws java.io.IOException

Throws:

java.io.IOException

assignTo

public void assignTo(GHUser user)
              throws java.io.IOException

Throws:

java.io.IOException

setLabels

public void setLabels(java.lang.String... labels)
               throws java.io.IOException

Throws:

java.io.IOException

getComments

public java.util.List<GHIssueComment> getComments()
                                           throws java.io.IOException

Obtains all the comments associated with this issue.

Throws:

java.io.IOException

See Also:

listComments()

listComments

public PagedIterable<GHIssueComment> listComments()
                                           throws java.io.IOException

Obtains all the comments associated with this issue.

Throws:

java.io.IOException

getApiRoute

protected java.lang.String getApiRoute()

getIssuesApiRoute

protected java.lang.String getIssuesApiRoute()

getAssignee

public GHUser getAssignee()

getUser

public GHUser getUser()

User who submitted the issue.

getClosedBy

public GHUser getClosedBy()

Reports who has closed the issue.

Note that GitHub doesn't always seem to report this information even for an issue that's already closed. See https://github.com/kohsuke/github-api/issues/60.

getCommentsCount

public int getCommentsCount()

getPullRequest

public GHIssue.PullRequest getPullRequest()

Returns non-null if this issue is a shadow of a pull request.

isPullRequest

public boolean isPullRequest()

getMilestone

public GHMilestone getMilestone()